---
name: architecture-design
when: '架构设计, 模块设计, 系统设计, 技术方案'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-artifact_template-架构设计模版
asset_kind: acceptance_template
lifecycle_status: active
owner_mechanism_id: mc-generic-artifact
authority: supporting
routes:
  - '*'
primary_triggers:
  - 架构设计
  - 架构文档
  - 模块设计
  - 系统设计
  - 技术方案
priority: P2
specificity: 3
version: 1.1.0
last_reviewed: '2026-06-01'
consumes: []
emits:
  - acceptance_report
secondary_triggers: []
negative_triggers: []
type: acceptance_template
artifact_schema:
  kind: design_doc
  required_sections:
    - 决策记录
    - 架构决策状态总表
    - 需求概要
    - 模块划分
    - 业务流程
    - 基础设施架构
    - 技术选型与依据
    - 数据库与API专项产物引用
    - 状态机定义
    - 非功能需求
    - 未决项
    - 扩展点
  required_tables:
    - 架构决策状态总表
    - 技术选型表
    - 风险表
  required_fields:
    架构决策状态总表:
      - 架构域
      - 状态
      - 结论
      - 影响产物
    技术选型表:
      - 技术决策
      - 候选方案
      - 最终选择
      - 选择理由
    风险表:
      - 风险
      - 影响
      - 概率
      - 应对方案
  required_artifacts:
    - Mermaid 架构图
  forbidden_gaps:
    - 空章节标题
    - 缺失 Mermaid 代码块
process_rules:
  extract:
    instructions:
      - 从架构决策记录和需求文档中提取信息，按 Schema 定义的 12 个章节组织
      - 技术选型表必须列出候选方案和选择理由
    constraints:
      - 所有架构决策必须有决策记录引用
  review:
    instructions:
      - 逐章节与决策记录和需求对比，标记偏差项和遗漏项
      - 重点检查架构决策是否全部落实
stages: ["架构设计"]
---

# 架构设计文档

## 1. 决策记录、范围与证据
- 架构决策记录引用：`docs/architecture/00-架构决策记录.md`
- 用户确认引用：
- 输入证据引用：

## 2. 六类架构决策状态总表

| 架构域 | 状态 | 结论 | decision_id | user_confirmation_ref | 影响产物 |
|--------|------|------|-------------|-----------------------|----------|

## 3. 需求概要
- 业务背景：
- 核心需求：
- 非功能需求（性能/安全/可用性）：

## 4. 模块划分
- 模块清单与职责边界
- 模块间依赖关系图
- 核心接口契约（模块间调用方式）

## 5. 业务流程、数据流向与关键 Mermaid 时序图
- 主流程数据流向图
- 关键数据结构定义
- 数据存储方案（数据库/缓存/文件）

## 6. 前端、后端、安全与基础设施架构

### 6.1 系统上下文
<!-- 系统与外部系统/用户的关系，可使用上下文图 -->

### 6.2 部署方案
<!-- 部署架构、环境规划、CI/CD 策略 -->

## 7. 技术选型与依据
| 技术决策 | 候选方案 | 最终选择 | 选择理由 | 放弃方案原因 |
|---------|---------|---------|---------|------------|
|         |         |         |         |            |

## 8. 数据库与 API 专项产物引用
- 数据库设计：`docs/architecture/02-数据库设计文档.md`
- API 规格：`docs/architecture/03-API接口规格文档.md`
- OpenAPI：`docs/api/openapi.yaml`
- SQL/migration：

## 9. 状态机定义
- 核心业务状态流转
- 触发条件、守卫条件、失败/回滚动作

## 10. 非功能需求、验证策略、风险与回滚
| 风险 | 影响 | 概率 | 应对方案 |
|------|------|------|---------|
|      |      |      |         |

## 11. 未决项、延期影响和变更追踪

## 12. 扩展点
- 已识别的未来扩展方向
- 预留的扩展机制（接口/配置/插件）
