Files
Neo-ZQYY/docs/audit/changes/2026-03-22__ddl_bd_manual_consistency_fix.md
Neo 14a12342b5 chore(audit): 补追 96 份未入仓审计孤本 — 覆盖 2026-02-26 ~ 2026-04-08
这些审计记录原本堆积在 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>
2026-04-20 06:35:42 +08:00

2.6 KiB
Raw Blame History

变更审计记录Change Audit Record

  • 日期/时间2026-03-22 19:30:00
  • Prompt-IDP20260322-DDL-BD-CONSISTENCY
  • 原始原因Prompt用户要求对比 10 个主 DDL 与当前数据库结构是否完全契合,并修复数据库手册和文档中的遗漏,要求"从头审核走查"。
  • 直接原因DDL 基线文件与实际数据库存在 2 处字段级差异BD 手册存在 6 处文档错误/遗漏(旧表名引用、字段缺失、计数错误等)。

变更范围Changed

DDL 文件修复

  • docs/database/ddl/zqyy_app__auth.sqlauth.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.md3 处旧表名 auth.site_code_mappingauth._archived_site_code_mapping
  • docs/database/BD_Manual_fdw_etl_setup.md:快捷别名视图计数 "6 张" → "7 张"
  • docs/database/BD_Manual_member_retention_clue.md:验证 SQL 步骤 3 列数 "10 列" → "11 列",字段列表补充 is_hidden
  • apps/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_logsSELECT count(*) FROM information_schema.columns WHERE table_schema='biz' AND table_name='ai_run_logs' 预期 15 列

文件清单Files changed

  • docs/database/ddl/zqyy_app__auth.sqlDDL 补字段+索引)
  • 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 字段+更新时间+历史变更)