Neo-ZQYY/docs/audit/changes/2026-02-15__docs-database-merge.md

审计记录：docs/bd_manual + docs/dictionary → docs/database 合并

• 日期：2026-02-15（Asia/Shanghai）
• Prompt：用户要求将 docs/bd_manual 和 docs/dictionary 合并为统一路径 docs/database/，按数据层分目录

直接原因

两个目录都是数据库相关文档，但分散在不同路径下，对新人不友好且维护时容易遗漏。合并为 docs/database/ 统一入口，原 dictionary 的概览文件放入 overview/ 子目录，表级文档按 ODS/DWD/DWS/ETL_Admin 分层。

变更类型

纯文档/配置路径重组，无逻辑改动、无 DB schema 变更、无业务规则变化。

修改文件清单

目录操作

• docs/bd_manual/ → 内容复制到 docs/database/，旧目录已删除
• docs/dictionary/ → 内容复制到 docs/database/overview/，旧目录已删除
• docs/database/main/、docs/database/Ex/、docs/database/changes/（之前未完成迁移的残留）已清理

路径引用更新

• docs/database/README.md — 重写为新结构索引
• docs/database/overview/ods_tables_dictionary.md — 内部链接更新
• docs/database/ODS/changes/2026-02-13_ddl_sync_ods.md — 引用路径
• docs/database/DWD/changes/2026-02-13_ddl_sync_dwd.md — 引用路径
• docs/database/DWD/changes/20260214_drop_dwd_settle_list.md — 引用路径
• docs/database/DWS/changes/2026-02-13_ddl_sync_dws.md — 引用路径
• docs/README.md — 子目录索引表
• scripts/validate_bd_manual.py — BD_MANUAL_ROOT 和 ODS_DICT_PATH 常量
• .kiro/steering/governance.md — 审计产物路径
• .kiro/steering/db-docs.md — BD 手册目录路径
• .kiro/skills/bd-manual-db-docs/SKILL.md — description + 输出路径
• .kiro/skills/steering-readme-maintainer/SKILL.md — 联动规则引用
• .kiro/hooks/db-docs-sync.kiro.hook — description + prompt
• .kiro/hooks/db-schema-doc-enforcer.kiro.hook — description + prompt

未修改（历史记录，保留原样）

• docs/开发笔记/DWS/记录1.md — 开发备忘历史
• .kiro/specs/bd-manual-docs-consolidation/ — 已完成的 spec 历史

风险点

• 风险极低：纯路径重组，无运行时代码变更
• 如果有外部工具/脚本硬编码了旧路径，需要手动更新

回滚要点

• git revert 即可恢复旧目录结构
• 或手动将 docs/database/ 内容拆回 docs/bd_manual/ + docs/dictionary/

验证步骤

1. 确认旧目录不存在：Test-Path docs/bd_manual → False，Test-Path docs/dictionary → False
2. 确认新结构完整：docs/database/ 下有 ODS/DWD/DWS/ETL_Admin/overview 五个子目录
3. 全文搜索 docs/bd_manual 确认活跃文件中无残留引用（specs/开发笔记除外）
4. 运行 python scripts/validate_bd_manual.py --help 确认脚本路径常量正确