1.0 KiB
1.0 KiB
系统架构设计模板
输入
- 产品需求文档 (PRD)
- 技术约束(已有技术栈、团队能力)
- 非功能性需求(性能、安全、可扩展性)
输出结构
1. 架构概述
- 一句话描述架构核心思路
- 系统边界和范围
2. 架构图(文字描述 + ASCII)
- 模块划分和职责
- 模块间通信方式
- 数据流向
3. 技术选型
- 每个模块的技术栈及理由
- 对比方案及淘汰原因
- 风险点和缓解措施
4. 接口设计
- 模块间接口定义
- API 契约(请求/响应格式)
- 数据模型概要
5. 非功能性设计
- 性能目标及实现策略
- 安全设计(认证、授权、数据保护)
- 可扩展性考虑
6. 部署架构
- 运行环境
- 服务拓扑
- CI/CD 流程
注意事项
- 架构文档面向 Arch AI 和 Dev AI,不要写人类才需要的背景介绍
- 决策必须写理由,方便后续 AI 理解为什么这样设计
- 每个模块标注影响范围(HIGH/MEDIUM/LOW),供 QA AI 确定回归测试范围