| 名称 | 相对地址 | 内容描述 | 使用场景 | 使用要求 | |------|----------|----------|----------|----------| | 系统架构 | 暂无 | 系统怎么切、依赖朝哪、为什么这样切;ADR 在 `决策/` | 跨模块、改边界、选技术底座、写 ADR 时 | 架构或架构决策变化时 | | 领域模型 | 暂无 | 业务概念、词什么意思、概念边界;术语全文在 `术语表.md` | 改业务行为、起名、对术语有分歧时 | 新术语或概念边界确认时 | | 数据模型 | 暂无 | 数据长什么样、存在哪、怎么一致 | 改存储、迁移、字段、一致性时 | schema / 数据生命周期变化时 | | 模块设计 | 暂无 | 代码按什么模块分、职责与依赖 | 动模块边界、新代码往哪放拿不准时 | 模块职责或依赖变化时 | | 功能规格 | 暂无 | 功能方案、验收标准与实施执行计划/Runbook(spec) | 实现或评审某功能前 | 功能范围、方案或实施步骤确认时 | | 接口契约 | 暂无 | 对外/对内接口契约 | 改接口、联调、生成客户端时 | 契约变化时 | | 业务需求 | 暂无 | 要解决谁的什么问题、不做哪些 | 功能还没方案、对齐目标和范围时 | 需求确认或变更时 | | 调用链路 | 暂无 | 一条真实路径经过哪些代码 | 改这条链路、排障、清理相关代码时 | 关键路径稳定或被改写后 | | 模块概要 | 暂无 | 某模块一页纸:干什么、入口在哪 | 第一次接触某模块、给别人指路时 | 模块对外形状变了 | | 实现回顾 | 暂无 | 功能实际怎么落地、和设计有何出入 | 后续改同一功能、交接、对照设计时 | 功能合并后留回顾 | | 缺陷回顾 | 暂无 | bug 根因、修法、如何防再发 | 同类故障、改相关代码前 | 非平凡 bug 修完留根因时 | | acceptance | acceptance/ | | | | | design | design/ | | | | | plans | plans/ | | | | | research | research/ | | | | | write-chapter | write-chapter/ | | | |