需求分析与建模61 条

arc42 架构文档模板

arc42 是开源的架构文档模板,按目标与约束、上下文、策略、构建块、运行时、部署、横切概念、决策、质量、风险、术语等章节组织,适合中小团队裁剪使用。

  • 1 引言与目标
  • 2 约束
  • 3 上下文与范围
  • 4 解决方案策略
  • 5 构建块视图
  • 6 运行时视图
  • 7 部署视图
  • 8 横切概念
  • 9 架构决策
  • 10 质量需求
  • 11 风险与技术债
  • 12 术语表
模板价值在于“有话可写、无处可躲”:质量需求与风险两节强制留下可验证内容。

易错点

  • 把模板当交付清单逐节填满,产出无人维护的文档
  • 文档与决策记录、代码仓库不联动,三个月后过期

数据来源与参考

  • arc42 官方模板(arc42.org)
  • 《Software Architecture Documentation with arc42》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌