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