软件架构设计模板讲解

架构设计说明书产品发布标识/填写说明：模板中用方括号括起来并以蓝色斜体显示的文本，用于向作者提供指导，在文档编辑完成后应该将其删除。文档正文应使用常规、黑色、五号字体即系统设置的“正文”样式文档页眉处的，%%%%系统”和“版本号”仅为示例，请注意更新封页与页眉符合实际情况。此处的版本号指的是产品版本号封页简要表中的产品名，如无可以不填写。当某一章节没有内容时，必须注蜘4，同时标注理由。例如：本脚内容无需考虑。特别说明：当某章节内容参见其它文档时，不能注瞰幺，而应该写明参见某文档的具体章节。］文档版本号：文档编号：文档密级：归属部门/项目：产品名：子系统名：编写人：编写日期：华为科技（深圳）有限公司版权所有内部资料注意保密

文档存盘名称文档存盘名称修订记录:版本号修订人修订日期修订描述V1.0A王巍2004-5-11创建初稿V1.0B周昀2006-4-23根据CMMI新流程予以修订V1.0CENG-TWG2006-8-9根据CMMI要求予以修订注意保密内部资料

注意保密文档存盘名称文档存盘名称派发清单:发文人/部门日期电^/传真受文人/部门动作类型*日期电^/传真大动作类型：批准、审核、通知、归档、参与会议，其它（请说明）注意保密内部资料注意保密文档存盘名称目录TOC\o"1-5"\h\z1简介 6目的 6\o"CurrentDocument"文档范围 6\o"CurrentDocument"预期的读者和阅读建议 6\o"CurrentDocument"参考文档 8包含文档 8相关文档 8\o"CurrentDocument"缩略语和术语 8\o"CurrentDocument"2总体设计思路 9\o"CurrentDocument"设计方法 9\o"CurrentDocument"设计可选方案 9\o"CurrentDocument"3系统逻辑结构 10\o"CurrentDocument"总体结构 10\o"CurrentDocument"子系统定义 10子系统一 11子系统二 11\o"CurrentDocument"接口设计 11产品外部接口 11子系统间接口 11\o"CurrentDocument"主要数据模型 11\o"CurrentDocument"4系统物理结构 12\o"CurrentDocument"总体结构 12\o"CurrentDocument"组件定义 12组件一 12\o"CurrentDocument"组件接口设计 12\o"CurrentDocument"组件与子系统对应关系 12\o"CurrentDocument"5系统部署 13\o"CurrentDocument"网络结构图 13\o"CurrentDocument"部署模式 13\o"CurrentDocument"6关键技术及公用机制 13\o"CurrentDocument"关键技术设计 13\o"CurrentDocument"公用机制说明 13\o"CurrentDocument"7系统重用设计 13\o"CurrentDocument"第三方硬件设备说明 15注意保密内部资料注意保密文档存盘名称TOC\o"1-5"\h\z\o"CurrentDocument"第三方软件说明 15\o"CurrentDocument"8系统非功能特性设计 15\o"CurrentDocument"可扩展性 15\o"CurrentDocument"可维护性 15\o"CurrentDocument"安全 16\o"CurrentDocument"容错性 16\o"CurrentDocument"可移植性 16\o"CurrentDocument"可部署性 16\o"CurrentDocument"16\o"CurrentDocument"9总体约束 16\o"CurrentDocument"遵循标准 16\o"CurrentDocument"文件约定 17\o"CurrentDocument"目录约定 17\o"CurrentDocument"对后续设计的约束 17\o"CurrentDocument"17\o"CurrentDocument"10风险 17\o"CurrentDocument"11附录 17注意保密内部资料

注意保密文档存盘名称文档存盘名称1简介目的［描述本架构设计文档的主要目的。架构文档从构架方面对系统进行综合概述，描述了系统最高层次上的逻辑结构、物理结构以及各种指南。它用于记录并表述已在构架方面对系统作出的重要决定，并对相关子系统的设计起总体上的指导作用/文档范E［简要说明此文档的范围：它的相关项目以及受到此文档影响的任何其它事物例如，本文档适用的产品、模块，覆盖的范围等，受这份文档影响的相关产品、模块等，不在该文档覆盖范围内的但可能引起疑义的问函。预期的读者和阅读建议［说明此文档的阅读对象，简要说明此文档中其它章节包含的内容与文档组织方式，对于不同读者的阅读方式建议。如：XXX系统开发过程的各角色：产品角色、系统分析架构角色、项目管理角色、代码角色、测试角色、文档角色XXX系统的部署角色、培训角色、维护角色；XXX公司售前技术支持角色此文档的第2章描述…系统体系结构图注意保密内部资料

注意保密文档存盘名称系统子系统物理上划分二逻辑上划分:模块组件于模块进程、线程、

类库等文档存盘名称系统子系统物理上划分二逻辑上划分:模块组件于模块进程、线程、

类库等单元例如：本文档组织方式：第一章简介，描述文档的目的；第二章描述总体设计思路，包括设计方法及备选设计方案和方案的选择；第三章描述系统的逻辑结构。从最高层次上描述系统的逻辑组成；第四章描述系统的物理结构。从最高层次上描述系统的物理组成；第五章描述系统的部署情况；第六章对系统架构中的关键技术及公用设计机制进行描述；第七章如何重用以往设计产物及现有设计如何对将来重用产生影响进行描述；第八章对系统中重要的用例或者有技术难度的部分进行功能实现的描述，以方便设计人员在进行设计、开发时进行参考；第九章对系统依赖的第三方软硬件进行描述；第十章对系统的非功能特性设计进行描述；产品经理应当关注该部分的描述是否与产品需求中产品的非功能性需求一致；开发人员应当在后续设计过程中对这部分设计进行关注，避免遗漏；测试人员应当根据这部分的描述制定测试案例，验证是否可以达到产品需求的要求。第十一章描述系统架构设计中的约束条件；第十二章描述架构设计中识别的风险，产品经理、设计人员、开发人员和测试人员都应当随时关注这些风险，避免风险发生并及时采取规避、减轻措施。第十三章附录注意保密内部资料注意保密文档存盘名称］参考文档/架构设计的参考文档应当包括但不限于：产品需求说明书等；同时，文档中说明为引用、参考的文档也应该在这里列出。参考文档需要按包含、相关的关系分别在下面的小节中列出。包含文档［当本文有包含文档时，需要提供相关的包含文档列表。包含文档：作为本架构设计的一部分，是不可分割的组成部分，读者阅读本架构设计时必须同时也阅读的文档。如当架构设计非常复杂而有分册时，则分册就属于本文档的包含文档。］相关文档［当本文有相关文档时，需要提供相关文档列表。相关文档：具有关联关系的文档。读者在阅读架构说明书时如果有必要可以参考阅读的文档。］缩略语和术语［适当时，提供与此文档相关的术语及缩略语的定必。~~缩略语/术语 全称 说明注意保密内部资料

注意保密文档存盘名称文档存盘名称2总体设计思路设计方法［本软件系统所采取的设计方法，以及主要的设计原则。设计方法可包括但不限于：1）采用RU尸的设计方法论；2）采用从业务而下的系统分解，从技术至上的系统抽象方法以及具体应用系统的特定设计方法等J设计可选方案网本系统的几种设计方案进行分析、比较，并确定所采用的方案。可选方案不仅是对同一需求的不同处理方式，也可以是需求与设计元素之间配置的不同思考，包括新研发的技术，或者是不同应用的成熟技术及维持现有方法，目标是将整体的解决方案最佳化，而非个别设计的优劣。可选解决方案涵盖可接受的成本、计划、效能的范围。产品关键需求与设计问题、限制及准则一起用于开发备选方案。评选的准则通常必须强调成本（例如：时间、人员、费用）、效益（例如：性能、有效性）及风险（例如：技术、成本、计划）。详细的可选解决方案及评选的准则可包括但不限于：成本（研发、购买、支持、产品生命周期）技术性能技术限制产品的扩展及成长性需求与技术的演进最终用户及操作者的能力与限制构建方法与材料的敏感度风险以上为最基本的考虑因素，研发团队应该开发与目标一致的备选方案节选准则，以缩小可选清单，并可以通过决策分析的方法来进行评估选择。注意保密内部资料

注意保密文档存盘名称文档存盘名称例如：1）可选方案2）可选方案二3）方案的评选策略及准则需要包括决策分析单。因口:\app^erverselect\d4）最佳化的方案3系统逻辑结构/本章描述系统的总体逻辑结构，包括子系统的划分与依赖关系定义、子系统之间的接口定义、子系统功能定义/总体结构[本节定义系统的总体逻辑结构，定义子系统划分以及子系统之间的依赖关系。为了统一与便于理解，当用图形化表示子系统子系统之间的依赖关系时建议采用UML的符号与表示方法。]子系统定义[本节明确定义各个子系统的功能以及子系统的设计思本，节通常按照子系统进行组织。]内部资料第10页内部资料第10页注意保密文档存盘名称文档存盘名称子系统［包括：子系统概述子系统功能子系统设计思路子系统二接口设计［定义接口设计的策略，识别接口，以及接口完成的功能，具体接口定义另行定义文档承载，采用接口设计说明书模板/产品外部接口［描述产品对外接口的相关定义/子系统间接口［描述产品内部子系统间接口的相关定义。主要数据模型［本节在逻辑层面上定义系统所包含的主要数据模型1常以E-R图形式来表现。具体的数据字典及数据结构在数据库设计文档中定义在高层设计阶段完成。］内部资料第11页内部资料第11页注意保密文档存盘名称文档存盘名称4系统物理结构［,定义系统总体物理结构、包括组件划分及依赖关系定义，每个组件中要完成的功能及组件间接口。如功能已经在前面的子系统分解中有描述，则重点描述本组件完成了哪些子系统的哪些功能。组件是物理上的运行结构元素。例如：进程、线程等。总体结构［本节定义系统的总体物理结构，定义组件划分以及组件之间的关系。组件定义组件一［包括：组件名称组件类型组件功能组件接口设计［定义接口设计的策略，组件间的接口主要是描述一些共享内存，协议数据，消息等，具体接口如有需要可另行定义文档承载，采用接口设计说明书模板组件与子系统对应关系［定义组件与子系统的关系，即各组件实现哪些子系统功能，可通过列表的形式定义，如有需要，可通过图示的形式加以说明j内部资料第12页内部资料第12页注意保密文档存盘名称5系统部署［本章描述系统部署，说明用来部署并运行该系统的一种或多种物理网络（硬件）配置。对于每种配置，应该指出执行该系统的物理节点（计算机、网络设备）配置情况（包括硬件、操作系统、支撑软件）、节点之间的连接方式、采用何种通信协议、网络带宽。另外还要包括各进程到物理节点的映射/网络结构图［描述系统所处的整体网络结构/部署模式［描述系统几种可能的部署模式，并解释在定义配置时要遵循的一般映射规则。例如：在不同的业务规模情况下，存在的不同部署模式。6关键技术及公用机制关键技术设计［描述系统的关键技术设计，以解决重要或高风险的问题公用机制说明［描述系统实现所需要的公用机制，例如采用的中间件技术、通用缓存等7系统重用设计［软件重用是指通过对已有软件的各种有关知识来建立新的软件，这些知识包括：领域知识、开发经验、设计经验、设计决定、体系结构、需求、设计、编码、测试和文档等。这个定义蕴含着软件重用所必须包含的两个方面：.系统地开发可重用的软件产品。2,系统地使用这些软件产品作为构筑新的软件产品，来建立新的系统。软件重用目的是降低软件开发和维护的成本，提高软件开发效率，提高软件的质量。软件重用的过程一般包括，抽象、选取、特化、集成：抽象，对已有软件产品的概念描述，从中抽取该产品的本质信息（即可重用部分）内部资料第13页内部资料第13页注意保密文档存盘名称选取：用户根据已有软件产品的抽象，寻找、比较和选择最适合需要的软件产品（可重用件）。特化：对已有软件产品（可重用件）的修改或形成它的一个实例（实例化后的重用件）集成：将实例化后的重用件集成到应用系统。软件重用的形式，常用的为垂直式重用和水平式重用：垂直式重用：指在一类具有较多公共性的应用领域之间进行软件重用，由于存在许多共性或相似性，因此重用面较广，且有助于获得系统的通用模型首先进行领域分析，根据应用领域的特征及相似性预测软件的可重用性；然后进行相应的软件开发。一旦确认了软件的重用价值，即可进行通用化，以便能够适应新的类似的应用领域；最后，对软件及其文档进行管理，成为可供后续项目使用的可重用资源。水平式重用：重用不同应用领域中的软件元素，例如数据结构、分类算法、人机界面构件等。标准函数库是一种典型的原始的水平式重用机制。软件重用的粒度主要有以下几种：.源代码模块或者类一级的重用。这是最基本的软件重用形式。2,二进制形式的重用。如组件重用。.组装式重用。比如：把好几个应用程序的功能集成在一起。例如，要建立一个门户站点应用，登陆用户既可以查询天气情况，又可以查看股市行情，还可以在线购物。这些功能由不同网络应用服务供应商提供，通过这种组装式重用，就可以非常容易地把上述功能都集成到新的门户站点中。.分析级别重用。.设计级别重用。.软件文档重用。软件重用技术软件重用技术包括库函数，模板，面向对象、设计模式、构件、体系架构、体系架构模式/风格等。.库函数对于库函数的使用者，只要知道函数的名称，返回值的类型函数参数和函数功能就可以对其进行调用。.面向对象面向对象技术通过方法、消息、类、继承、封装、和实例等机制构造软件系统，并为软件重用提供强有力的支持。如C++中的MFC。.模板模板相当于工业生产中所用的模具”。有各种各样的模板（如文档模板，网页模板等）内部资料第14页内部资料第14页注意保密文档存盘名称利用这些模板可以比较快速地建立对应的软件产品。模板把不变的封装在内部，对可能变化本号，运行环境，参数以及简要描述第三方硬件设备说明［描述系统可使用的第三方硬件需求，以及第三方硬件的简要描述。例如：需要加密卡提供高速逻辑加密功能；需要网络交换机提供四层交换功能等。第三方软件说明［描述系统可使用的第三方软件需求，以及第三方软件的简要描述。8系统非功能特性设计［本章描述系统的整体性能、安全性、可用性、可扩展性、容错等非功能特性设计。可扩展性［描述系统可扩展性设计与实现方案。需要对性能、功能、网管十、报表的可扩展性进行描述。例如：考虑组件化设计，以使系统能够适应将来可能出现的新业务和可能出现的一些变化。新增业务功能时不应需要改造原