软件架构设计文档模板

2、表与模型阅读指南53.架构设计目标53.1关键功能53.2关键质量属性53.3业务需求和约束因素54.架构设计原则64.1架构设计原则64.2备选架构设计方案及被否原因64.3架构设计对后续工作的限制（详设，部署等）65.逻辑架构视图65.1职责划分与职责确定75.2接口设计与协作机制85.3重要设计包106.开发架构视图116.1Project划分116.2Project1116.2.1Project目录结构指导126.2.2程序单元组织126.2.3框架与应用之间的关系（可选）126.3Project2……136.4Projectn……137.运行架构视图137.1控制流

3、组织137.2控制流的创建、销毁、通信137.3加锁设计148.物理架构视图148.1物理拓扑148.2软件到硬件的映射15Page18of18Version:<1.0>SoftwareArchitectureDocumentDate:8.3优化部署169.数据架构视图169.1持久化机制的选择179.2持久化存储方案179.3数据同步与复制策略1710.关键质量属性的设计原理17Page18of18Version:<1.0>SoftwareArchitectu

4、reDocumentDate:1.文档简介[帮助读者对本文档建立基本印象，并为阅读后续内容扫清障碍。]1.1文档目的[文档目的，非项目目的。否则造成同一项目多个文档之间的内容重复，不利于文档维护。本小节应指明文档针对的读者对象，最好列出各种读者角色，并说明每种读者角色应该重点阅读的章节。]1.2文档范围[文档的Scope，非项目的Scope。否则造成同一项目多个文档之间的内容重复，不利于文档维护。]1.3定义、缩写词和缩略语[集中列举文档中的定义、缩写词和缩略语。]1.4参考资料[本项目经审核的计划书、合同、上级

5、批文；本项目的其他已发表文件；本文档引用的文件资料，如软件开发标准。具体而言，应包括参考资料的题目（必须）、编号、版本号（必须）、发表日期、发布方，必要时还可以说明如何使用这些资料。]2.架构描述方式[为了让读者更好地理解《架构文档》，在本节应当说明文档涉及的架构视图，并指明为了描述设计决策用到了哪些图表和模型。]2.1架构视图阅读指南[以多视图的方式来组织《架构文档》是大势所趋。ADMEMS推荐的是经过优化的5视图方法，如下图所示。]Page18of18Version:<1.0>SoftwareArchitectureDocumentDate:

6、yyy-mm-dd>1.1图表与模型阅读指南[对后续文档内容中所用到的建模语言（例如UML）、表格（例如目标-场景-决策表）等进行说明。]2.架构设计目标[功能、质量、约束，一个都不能少。]2.1关键功能[对架构设计至关重要的功能，包括如下4类：核心功能、必做功能、高风险功能、独特功能。所谓独特功能，指这个功能覆盖了上述3类功能没有涉及到的职责。]2.2关键质量属性[人之所以痛苦，很多时候是因为追求错误的东西。下图是ADMEMS方法确定关键质量的5大原则的整体思路图。]2.3业务需求和约束因素[ADMEMS方法创造性地提出约束需求的4大

7、类型，这是一种极为实用的分类方式。特别是业务需求对架构设计而言是一种约束的观点，解决了很多架构师的现实困惑。下图标明了4类约束在“需求层次-需求方面矩阵（又称ADMEMS矩阵）”中的位置，可以帮助我们理解产生约束需求的根源。]Page18of18Version:<1.0>SoftwareArchitectureDocumentDate:1.架构设计原则[投标时经常讲“架构设计原则”，但到了《架构文档》，这些着眼大局