tangweijie 3eccab2cf9 docs: 文档治理统一 — AGENTS.md 生命周期规则 + 模块归档 + DDL 修正
1. AGENTS.md 更新
   - water-docs: 新增 specs/ 与 docs/design/ 生命周期规则章节
   - water-backend: 更新协作引用(建设期/建成后、evidence 模块化)

2. specs/ 重复合并
   - 006-reminder-event-design 合并入 003-rev006-reminder-event-design
   - 001-rev004-accounting 删除冗余 data-model.md + contracts/
   - 002-rev005-invoice-flow 删除冗余 data-model.md + contracts/

3. evidence 按模块归档
   - 35 个 REV-004 文件归入 evidence/rev004-accounting/
   - 7 个通用 bugfix 文件归入 evidence/bugfix/ 和 bugfix/frontend/
   - 新建 rev005-invoice/、rev006-reminder/、rev007-statistics/ 目录

4. guides/ 清理
   - 14 个 REV004_*.md 移入 evidence/rev004-accounting/

5. 遗留文件处理
   - docs/research/ 归档到 Archive/06_Migration_Plans/
   - backend-check detached worktrees 清理

6. 交叉引用修复
   - 006-reminder-event-design → 003-rev006-reminder-event-design
   - docs/guides/REV004_ → docs/evidence/rev004-accounting/REV004_

7. DB 设计文档修正(01_Database_Design.md)
   - biz_invoice 明确为开票配置表,非发票记录表
   - 新增 biz_invoice_record 为发票申请/结果主表
   - 新增 biz_charge_invoice_rel 账单-发票关联说明
   - REV-005 承接口径表名全部修正

8. 发票审计证据
   - 新增 evidence/rev005-invoice/2026-06-16-invoice-document-audit.md
2026-06-16 11:47:16 +08:00
..

docs 研究与指南入口

目录用途

docs/ 用于维护研究资料、映射说明、工具使用指南与历史版本参考。

子目录说明

  • docs/design/00_Management/:项目管理、治理基线与 AI 维护规范
  • docs/design/01_Overview/:概要设计主文档与总体架构
  • docs/design/02_Detailed_Design/:详细设计主文档与模块设计
  • docs/design/03_Technical_Design/:数据库、接口、安全、部署等技术专项
  • docs/design/04_Appendix/:附录与历史归档资料
  • guides/:执行指南与映射口径(优先使用)
  • design/:设计辅助文档
  • research/:调研资料
  • v1.6/:历史版本材料

推荐阅读顺序

  1. guides/SPECKIT_WORKFLOW_HUMAN_GUIDE.md
  2. guides/SYSTEM_CAPABILITY_CLOSURE_MAP.md
  3. guides/BACKEND_CURRENT_STATUS.md
  4. guides/BACKEND_TABLE_MAPPING.md
  5. 其他辅助资料

维护原则

  • 该目录作为“辅助事实来源”,不替代主文档
  • 如与主文档冲突,优先以主文档与当次用户要求为准