这些审计记录原本堆积在 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>
2.6 KiB
2.6 KiB
变更审计记录(Change Audit Record)
- 日期/时间:2026-03-22 19:30:00
- Prompt-ID:P20260322-DDL-BD-CONSISTENCY
- 原始原因(Prompt):用户要求对比 10 个主 DDL 与当前数据库结构是否完全契合,并修复数据库手册和文档中的遗漏,要求"从头审核走查"。
- 直接原因:DDL 基线文件与实际数据库存在 2 处字段级差异;BD 手册存在 6 处文档错误/遗漏(旧表名引用、字段缺失、计数错误等)。
变更范围(Changed)
DDL 文件修复
docs/database/ddl/zqyy_app__auth.sql:auth.tenant_admins表定义补充deleted_at字段 +idx_tenant_admins_active_not_deleted部分索引
数据库迁移执行
test_zqyy_app.biz.ai_run_logs:执行 P15 迁移(alert_status字段 + CHECK 约束 + 2 索引),使测试库与 DDL 一致
BD 手册修复
docs/database/BD_Manual_auth_tables.md:3 处旧表名auth.site_code_mapping→auth._archived_site_code_mappingdocs/database/BD_Manual_fdw_etl_setup.md:快捷别名视图计数 "6 张" → "7 张"docs/database/BD_Manual_member_retention_clue.md:验证 SQL 步骤 3 列数 "10 列" → "11 列",字段列表补充is_hiddenapps/etl/connectors/feiqiu/docs/database/DWS/main/BD_manual_cfg_area_category.md:字段说明表补充sort_order(第 14 字段),更新时间 → 2026-03-20,历史变更表补充 2026-03-20 条目
风险与回滚(Risk & Rollback)
- 风险点:均为文档/DDL 基线修复,不影响运行时逻辑。测试库 P15 迁移为追加字段+索引,不影响已有数据。
- 回滚要点:DDL 文件和 BD 手册通过 git revert 即可回滚。测试库 P15 迁移可通过
ALTER TABLE biz.ai_run_logs DROP COLUMN alert_status+ 删除索引回滚。
验证(Verification)
- DDL vs DB 一致性:对 10 个 DDL 文件重新执行字段级比对脚本,确认 0 差异
- BD 手册:逐文件检查修改点与实际数据库结构一致
test_zqyy_app.biz.ai_run_logs:SELECT count(*) FROM information_schema.columns WHERE table_schema='biz' AND table_name='ai_run_logs'预期 15 列
文件清单(Files changed)
docs/database/ddl/zqyy_app__auth.sql(DDL 补字段+索引)docs/database/BD_Manual_auth_tables.md(旧表名修正 ×3)docs/database/BD_Manual_fdw_etl_setup.md(视图计数修正)docs/database/BD_Manual_member_retention_clue.md(验证 SQL 列数+字段列表修正)apps/etl/connectors/feiqiu/docs/database/DWS/main/BD_manual_cfg_area_category.md(补 sort_order 字段+更新时间+历史变更)