这些审计记录原本堆积在 docs/audit/changes/changes/ 嵌套误产物目录下(由开发机迁移
79d3c2e 前后的不明批量操作产生)。由于同期 .gitignore 屏蔽了 docs/audit/ 全目录,
它们从未入过 git 任何分支 history。删除即永久丢失。
按 docs/specs/audit-gap-recovery/tasks.md 阶段 1 执行,将全部 96 份 D 类孤本
(主目录无同名、git history 亦无记录)复制到 docs/audit/changes/ 主目录入仓。
涵盖主题: P1-P18 全栈集成 / 多模块累积变更 / ETL bug 修复 / 业务日切 /
召回与任务引擎改造 / 租户管理与审批 / 董事会财务 / 客户与助教详情 /
DDL 基线合并 / Kiro 到 Claude Code 迁移
阶段 2(B 类内容漂移 1 份)和阶段 4(嵌套目录删除)独立推进。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3.1 KiB
3.1 KiB
变更审计记录:NS4 DDL 合并 — deleted_at 字段并入主迁移脚本
| 字段 | 值 |
|---|---|
| 日期 | 2026-03-22 17:52:39 |
| Prompt-ID | P20260322-173709 |
| Session-ID | 8d92cd0c |
| Session 路径 | docs/audit/session_logs/2026-03/22/50_4945f994_173026 |
操作摘要
将 auth.tenant_admins 的 deleted_at 软删除字段从独立迁移脚本(2026-03-22__add_deleted_at_to_tenant_admins.sql)合并到主迁移脚本(2026-03-20__ns4_tenant_admin_tables.sql)中,使 DDL 定义保持单一来源。同步更新 BD 手册文档,补充字段说明和索引信息。
风险标签
root-file · dir:admin-web · dir:backend · dir:etl · dir:miniprogram · dir:db · db-schema-change
本次对话文件变更
新增文件
docs/audit/prompt_logs/prompt_log_20260322_173709.md— Prompt 日志docs/audit/session_logs/2026-03/22/50_4945f994_173026/main_01_10805755.md— Session 日志
删除文件
db/zqyy_app/migrations/2026-03-22__add_deleted_at_to_tenant_admins.sql— 独立迁移脚本(已合并入主 DDL)docs/audit/session_logs/2026-03/22/50_4945f994_173026/main_01_e1cf6056.md— Session 日志(被替换)
改动注解
db/zqyy_app/migrations/2026-03-20__ns4_tenant_admin_tables.sql
- 变更类型:修改
- 原始原因:用户要求将
deleted_at字段的 DDL 合并到主迁移脚本中,避免多个迁移脚本定义同一张表的结构,保持 DDL 单一来源 - 思路分析:将原本通过
ALTER TABLE ADD COLUMN添加的deleted_at TIMESTAMPTZ DEFAULT NULL直接写入CREATE TABLE语句中;同时将部分索引idx_tenant_admins_active_not_deleted的CREATE INDEX也移入主脚本。注释中标注(2026-03-22 新增)保留变更溯源 - 修改结果:
auth.tenant_admins表定义从 10 列扩展为 11 列(含deleted_at),索引从 2 个增加到 3 个。独立迁移脚本2026-03-22__add_deleted_at_to_tenant_admins.sql不再需要,已删除
db/zqyy_app/migrations/2026-03-22__add_deleted_at_to_tenant_admins.sql
- 变更类型:删除
- 原始原因:该脚本的内容已合并入
2026-03-20__ns4_tenant_admin_tables.sql,保留会导致重复执行 DDL
其他修改文件(session 日志索引更新)
docs/audit/session_logs/2026-02/*/及docs/audit/session_logs/2026-03/*/下的_day_index.json/_day_index_full.json— 批量重建 session 日志索引,非业务变更
DDL/迁移检查
- 迁移文件:
db/zqyy_app/migrations/2026-03-20__ns4_tenant_admin_tables.sql - ⚠️ DDL 基线待合并(
compliance.has_ddl_baseline = false) - 迁移执行状态:待验证(测试库连接未执行)
BD 手册同步
已更新 docs/database/BD_Manual_tenant_admin_tables.md:
auth.tenant_admins表结构新增deleted_at字段行- 索引表新增
idx_tenant_admins_active_not_deleted部分索引 - 验证 SQL 预期列数从 10 更新为 11
- 索引预期数从 2 更新为 3
- NS4.1 变更补充段落更新,说明
deleted_at已合并入主 DDL - 迁移脚本路径修正为
2026-03-20__ns4_tenant_admin_tables.sql