软件架构设计及开发文档两篇.pdfVIP

软件架构设计及开发文档两篇

篇一：软件架构设计文档

文档简介

[帮助读者对本文档建立基本印象，并为阅读后续内容扫清障碍。]

文档目的

[文档目的，非项目目的。否则造成同一项目多个文档之间的内容重复，不利于

文档维护。本小节应指明文档针对的读者对象，最好列出各种读者角色，并说明

每种读者角色应该重点阅读的章节。]

文档范围

[文档的Scope，非项目的Scope。否则造成同一项目多个文档之间的内容重复，

不利于文档维护。]

定义、缩写词和缩略语

[集中列举文档中的定义、缩写词和缩略语。]

参考资料

[本项目经审核的计划书、合同、上级批文；本项目的其他已发表文件；本文档

引用的文件资料，如软件开发标准。具体而言，应包括参考资料的题目（必须）、

编号、版本号（必须）、发表日期、发布方，必要时还可以说明如何使用这些资

料。]

架构描述方式

[为了让读者更好地理解《架构文档》，在本节应当说明文档涉及的架构视图，

第1页共31页

并指明为了描述设计决策用到了哪些图表和模型。]

架构视图阅读指南

[以多视图的方式来组织《架构文档》是大势所趋。ADMEMS推荐的是经过优化的

5视图方法，如下图所示。]

图表与模型阅读指南

[对后续文档内容中所用到的建模语言（例如UML）、表格（例如目标-场景-决

策表）等进行说明。]

架构设计目标

[功能、质量、约束，一个都不能少。]

关键功能

[对架构设计至关重要的功能，包括如下4类：核心功能、必做功能、高风险功

能、独特功能。所谓独特功能，指这个功能覆盖了上述3类功能没有涉及到的职

责。]

关键质量属性

[人之所以痛苦，很多时候是因为追求错误的东西。下图是ADMEMS方法确定关键

第2页共31页

质量的5大原则的整体思路图。]

业务需求和约束因素

[ADMEMS方法创造性地提出约束需求的4大类型，这是一种极为实用的分类方式。

特别是业务需求对架构设计而言是一种约束的观点，解决了很多架构师的现实困

惑。下图标明了4类约束在“需求层次-需求方面矩阵（又称ADMEMS矩阵）”中

的位置，可以帮助我们理解产生约束需求的根源。]

架构设计原则

[投标时经常讲“架构设计原则”，但到了《架构文档》，这些着眼大局的考虑

第3页共31页

却“丢了”。ADMEMS方法推荐的本文档模板，认为应当把它们“找回来”。]

架构设计原则

[着重描述重大的权衡取舍考虑。]

备选架构设计方案及被否原因

[在概念架构一级，对备选架构设计方案进行描述，并阐述它们未被采用的原因。

这有利于团队了解当前架构设计方案的来龙去脉，提高团队对当前架构设计方案

的认可度。]

架构设计对后续工作的限制（详设，部署等）

[架构设计不仅应该包含“指导”，也应该包含重要的“限制”。例如，一份只

是说明“性能和可扩展性都重要”的《架构文档》，实际上忽视了“可扩展性和

性能之间存在的矛盾关系”。此时，最有效的办法就是在《架构文档》中明确说

明“任何提升可扩展性的架构设计和详细设计，都应通过架构团队的评审才能引

入，以确保性能目标不受重大影响”。]

逻辑架构视图

[关注点：此架构设计视图的关注点是职责划分。]

[注意：逻辑架构视图无疑是最重要的，但同时也应避免“架构=模块+接口”

等以偏概全的认识。]

[参考：任何复杂系统的架构设计都不是一蹴而就的，所以架构师需要理性思维

过程的指导。针对逻辑架构设计这个关键环节，《一线架构师实践指南》一书给

出了2条建议：一是“以质疑驱动的螺旋思维”，二是相对分离地考虑“结构方

面的切分”和“行为方面的定义”。下图所示即为ADMEMS方法推荐的逻辑架构

设计理性思维过程。]

第4页共31页

职责划分与职责确定

[内容：将系统切分成更小的单元，并明确这些单元的职责。具体而言，职责单

元可以是层、子系统、模块、关键类等。]

[意义：一句话，职责划分不合理，功能和质量都会受到影响。也就是说，功能

需求和质量需求无一不和职责划分相关：一方面，每个功能都是由一条职责协作

链完成的；另一方面，职责划分方式也影响着质量，于是需要职责模型针对特定

质量属性要求做出相应调整和优化。很多人认为架构设计就是职责划分的艺术，

虽略显片面，但足以表明职责划分