正文
获取原文件references/architecture-checklist.md
架构驱动力
- FR/NFR、规模、延迟、可用性、数据敏感度、团队能力、预算和期限都有来源。
- 未知值使用范围、公式或测量计划,不用臆测的生产数字。
边界与接口
- 系统范围、外部参与者、信任边界和数据所有权清晰。
- 同步接口、事件、批任务和人工流程职责不重叠。
- 外部依赖包含认证、超时、重试、幂等、限流、降级和审计。
- 配置、事件和关键对象的产出方、使用方、版本、生效时机及业务终态明确。
- 架构目标保留批准需求,代码现状不足时继续记录未实现能力。
数据与安全
- 数据分类、最小化、加密、保留、删除、备份和租户隔离有要求。
- AI 输入/输出、RAG 数据、工具调用和人工审批在信任流中可见。
- 威胁模型、合规映射和残余风险有负责人,不宣称未经认证的合规。
可靠性与运营
- 关键链路有 SLO/SLI、容量假设、RTO/RPO、故障域和降级顺序。
- 可观测性覆盖日志、指标、追踪、成本和 AI 质量信号。
- 部署、迁移、兼容、灰度、回滚和灾备具备可执行验证点。
ADR 最小字段
ADR-ID,context,decision,options,tradeoffs,consequences,validation,status,owner
状态建议:PROPOSED、ACCEPTED、SUPERSEDED、REJECTED。
详细设计交接
每项架构决定引用 决策记录,明确影响的 FR/NFR、接口或组件、接收设计技能及验证条件。ADR 生命周期与决定确认状态分别使用其原有字段;接受架构方案不能代替运行验证。
依照 设计维护责任 指定数据、后端、Agent 和前端规范的维护位置。共同字段或状态存在不同版本时,查证当前批准依据,更新实际受影响设计与任务,不能让后续执行者自行猜测采用哪个版本。