文档介绍:该【系统架构设计说明书模版 】是由【guoxiachuanyue】上传分享,文档一共【25】页,该文档可以免费在线阅读,需要了解更多关于【系统架构设计说明书模版 】的内容,可以使用淘豆网的站内搜索功能,选择自己适合的文档,以下文字是截取该文章内的部分文字,如需要获得完整电子版,请下载此文档到您的设备,方便您编辑和打印。文件编号
版本号
页码
共22页
编制人/部门
审批人
编制日期
发放对象
研发部
系统架构设计说明书模版
文件修改控制
序号
版本
*变化状态
修改内容、页码及条款
修改人
批准人
修改日期
1
A
初稿
柴肖娟
张军
2016-3-22
*变化状态:A——增加,M——修改,D——删除
目录
1简介4
、缩写词和缩略语4
架构描述方式4
架构视图阅读指南4
图表与模型阅读指南5
架构设计目标5
关键质量属性5
架构设计原则7
架构设计原则7
备选架构设计方案及被否原因7
架构设计对后续工作的限制(详设,部署等)7
Make-Buy-Reuse分析7
知识点贡献情况8
逻辑架构视图8
接口设计与协作机制10
重要设计包12
开发架构视图13
Project划分13
Project目录结构指导14
程序单元组织14
(可选)14
Project216
Projectn16
运行架构视图16
控制流组织17
控制流的创建、销毁、通信17
加锁设计17
物理架构视图17
数据架构视图20
持久化存储方案21
关键质量属性的设计原理21
1简介
【简要说明编写本设计说明书的目的】。
/文档的Scope,非项目的Scope。否则造成多个文档之间的内容重复,不利于文档维护。]
、缩写词和缩略语
[集中列举文档中的定义、缩写词和缩略语。]
[本项目经审核的计划书、合同、上级批文;本项目的其他已发表文件;本文档引用的文件资料,如软件开发标准。具体而言,应包括参考资料的题目(必须)、编号、版本号(必须)、发表日期、发布方,必要时还可以说明如何使用这些资料。]
2架构描述方式
[为了让读者更好地理解《架构文档》,在本节应当说明文档涉及的架构视图,并指明为了描述设计决策所到了哪些图表和模型]。
架构视图阅读指南
(以多视图的方式来组织《架构文档》是大势所趋。MEMS推荐的是经
过优化的5视图方法,如下图所示。]
面向文件
面向节点
面向Table或文件
面向对象或结构化
谡辑架构
职三训分睨贵间协炉
运行架构'
控制流控制J
/fl发架构、
•程耳单元组织
数据架构
持久数廷□元籾狂疗悻格弍
'物理架构、
书"匡壬丈圧T网
而向控制流
图表与模型阅读指南
/对后续文档内容中所用到的建模语言(例如ML)、表格(例如目标场景-决策表)等进行说明。]
3架构设计目标
[功能、质量、约束,一个都不能少。]
[对架构设计至关重要的功能,包括如下4类:核心功能、必做功能、高风险功能、独特功能。所谓独特功能,指这个功能覆盖了上述3类功能没有涉及到的职责。]
/人之所以痛苦,很多时候是因为追求错误的东西。下图是?MEMS方
法确定关键质量的5大原则的整体思路图。]
业务需求和约束因素
[ADMEMS方法创造性地提出约束需求的4大类型,这是一种极为实用的分类方式。特别是业务需求对架构设计而言是一种约束的观点解,决了很多架构师的现实困惑。下图标明了4类约束在“需求层次-需求方面矩阵(又称ADMEMS矩阵)”中的位置,可以帮助我们理解产生约束需求的根源。
广义功龍质量勢束
川八需求
厅为需求
业务环境
运行期质量
川发期质冰
芍术件纠束
』—J4-.LlL
质用
环境
XII_jI.----.JI•汁开发旨陆磨音程住■[-I1'.■I■-I—nmI.'I-J—
口朋
亠
<
■II
构建
环境
4架构设计原则
[投标时经常讲“架构设计原则”,但到了《架构文档》,这些着眼大局的考虑却ADMEMS方法推荐的本文档模板,认为应当把它“找回来”。]
架构设计原则
[着重描述重大的权衡取舍考虑。]
备选架构设计方案及被否原因
[在概念架构一级,对备选架构设计方案进行描述,并阐述它们未被采用的原因。这有利于团队了解当前架构设计方案的来龙去脉提,高团队对当前架构设计方案的认可度。]
架构设计对后续工作的限制(详设,部署等)
[架构设计不仅应该包含“指导”,也应该包含重要的“限制”。例如,一份只是说明“性能和可扩展性都重要”的《架构文档》,实际上忽视了“可扩展性和性能之间存在的矛盾关系”。此时,最有效的办法就是在《架构文档》中明确说明“任何提升可扩展性的架构设计和详细设计,都应通过架构团队的评审才能引入,以确保性能目标不受重大影”响。]
5Make-Buy-Reuse分析
识别出需要进行Mark-Buy-Reuse分析的子系统或模块
管理中心子系统
机房管理子系统
采集模块
根据公司、项目关心的各种因素,分析Make-Buy-Reuse的各种活动影响权值
(有益影响为1,无影响为0,有害影响为-1),并得出最终结论
模块二:xxx
Make
Buy
Reuse
结论
成本
技术
进度
资源
•…
总计
[由项目经理提供可供其他项目复用的知识点]
逻辑架构视图
[关注点:此架构设计视图的关注点是职责划分]。
[注意:逻辑架构视图无疑是最重要的,但同时也应避“免架构=模块+接口”等以偏概全的认识。]
[参考:任何复杂系统的架构设计都不是一蹴而就的,所以架构师需要理性思维过程的指导。针对逻辑架构设计这个关键环节《,一线架构师实践指南》一书给出了2条建议:一是“以质疑驱动的螺旋思维”,二是相对分
离地考虑“结构方面的切分和“行为方面的定义。下图所示即为力DMEMS方法推荐的逻辑架构设计理性思维过程。