架构设计说明书该怎么写?
前言
架构设计是需求分析到软件实现的桥梁,也是决定软件质量的关键。编制架构设计说明书是开发人员向架构师转变必定会经历的过程。
承接上文:
如何做架构设计说明书 (点击直达)
本文来说一下如何写架构设计说明书
需求
那么到底如何编写架构设计说明书?该说明书应该包括哪些方面的内容呢?我们知道,架构设计说明书是阐述系统架构具体内容的,
架构的本质是呈现三大能力:
系统如何面向最终用户提供支撑能力
如何面向外部系统提供交互能力
如何面向企业数据提供处理能力
因此从这个角度看,对架构设计说明书的章节的设置及章节内容安排应该要能说明清楚系统架构到底是如何呈现这三种能力的,
让我们逐个分析:
系统如何面向最终用户提供支撑能力:
这一点是要从系统自身的能力来看,即本系统到底应该具备哪些功能,各功能间如何协作以满足支撑最终用户的使用,其实就是要讲系统的功能架构或逻辑架构,
回答系统从功能粒度上划分了几个功能模块或子系统,各模块或子系统之间的内部接口关系如何等问题。
当然还有一个需要考虑的问题,在纵向维度上,随着架构设计理念的不断发展,
逻辑架构模型从最初的展示-数据两层模型,到展示-逻辑-数据(所谓的MVC)三层模型,甚至到展示-调用接口-逻辑-数据接口-数据五层模型,
不同层次表明系统内部设计的精细程度,因此在逻辑架构设计中也需要针对实际情况加上这种分层设计的内容。尤其是对于Browser/Server架构模式的MIS类系统,这种层次更为常见。
另外,用户相对于机器来说对系统提供的能力是有个人喜好要求的,不仅要求系统能提供支撑,而且还要更加稳定的、更方便的、灵活的、快速的等提供,
这就需要在架构设计说明书中增加所谓非功能性的设计,
通过参考技术评审指标,保证系统架构设计满足用户和系统对非功能质量的需求:
非功能质量需求的概述
核心非功能质量:
核心质量 | 描述 |
---|---|
高性能 | 运行效率高,性价比高 |
可用性 | 持续可用性,缩短宕机时间,出错恢复,可靠性 |
可伸缩 | 垂直伸缩,水平伸缩 |
可扩展 | 可插拔,组件重用 |
安全性 | 数据安全,加密,熔断,防攻击 |
其他非功能质量:
核心质量 | 描述 |
---|---|
可监控性 | 快速发现,快速定位,快速解决 |
可测试性 | 可灰度,可预览,可Mock,可拆解 |
鲁棒性 | 容错性,可恢复性 |
可维护性 | 易于维护,监控,运营,扩展 |
可重用性 | 可移植性,解耦 |
易用性 | 可操作性 |
非功能质量需求的具体指标
主要分为4部分:应用服务器、数据库、缓存和消息队列。
应用服务器
应用服务器是服务的入口,请求流量从这里进入系统,数据库,缓存和消息队列的访问量取决于应用服务器的访问量,
对应用服务器的访问量进行评估至关重要,应用服务器主要关心每秒请求的峰值,请求响应时间等指标,
通过这些指标可以评估需要的应用服务器资源的数量
数据库
根据应用层的访问量和访问峰值,计算出需要的数据库资源的QPS,TPS,每天的数据总量等,
由此来评估所需数据库资源的数量和配置,部署结构等。
缓存
根据应用层的访问量和访问峰值,通过评估热数据占比,计算出的缓存资源的大小,存取缓存资源的峰值,
由此来计算所需缓存资源的数量和配置,部署结构等。
消息队列
根据应用层的访问量和访问峰值,计算需要消息队列传递的数据内容和数据量,
计算出的消息队列资源的数量和配置,部署结构等。
部署结构 | 容量与性能 | 其他 |
---|---|---|
复制模型 | 每天平均数据增量 | 消费线程池模型 |
失效转移 | 消息持久的过期时间 | 分片策略 |
持久策略 | 每秒读峰值 | 消息的可靠投递 |
每秒写峰值 | ||
每条消息的大小 | ||
平均延迟 | ||
最大延迟 |
系统如何面向外部系统提供交互能力:
这一点是要把系统当成一个完整的整体,阐述它如何与外部的系统发生调用关系,外部系统为它提供了哪些开放接口,它又为外部系统提供了哪些外部接口和能力,
同时,在这种相互的调用关系中它处于整个IT架构的何种位置,这其实就是在说系统的整体架构。另外,如果我们把操作系统和硬件服务器也当成一类特殊的外部系统的话,
就需要说明系统如何基于操作系统利用硬件服务器来提供计算、存储、网络等能力,系统如何把自己拆分成不同的部分以便部署在服务器上,这其实说的是部署架构。
如何面向企业数据提供处理能力:
信息系统的原始驱动力就是人们需要借助计算机的强大计算能力来辅助处理大量数据,从而形成可理解的信息,并最终形成可掌握的知识。
因此数据处理是系统的根本目的,至关重要,在架构设计说明书中需要单独描述系统对数据的处理能力,即我们所谓的系统数据架构。
这还是可以从对外和对内两个角度来看,对外即需要说明本系统处理的数据在整个企业数据流中所处的位置,与相关的上下游数据之间的关系,
本系统需要从数据上游的外部系统获取哪些数据?又需要为数据下游的系统提供哪些数据;对内需要说明本系统根据业务需求设计了哪些关键数据表,
它们之间是何种主外键关系,是否需要从外部导入数据为系统做数据初始化等。当然还有对数据管理的描述,包括如何做数据冗余设计,备份机制,数据安全管理机制等。
好,分析完这三种能力,我们几乎就找出了架构设计说明书中应该包括的内容,包括:
整体架构、
逻辑架构、
数据架构、
部署架构、
内外部接口、
非功能性设计等,
如果纯把架构设计作为理论研究,有这些也就够了。
但是现实中我们编制架构设计说明书毕竟是用来指导我们后续系统开发的,是需要真正落地实施的,
因此就会涉及使用何种技术实现?有哪些关键技术?用到了何种成熟或开源技术组件?复用了哪些之前的技术成果?等等,
同时也包括对技术风险的考虑与预防措施。所有这些就是技术架构的内容。
综上,我们就可以得到一份完整的架构设计说明书的结构及应该包含的内容,其大致章节应该是这样的:
文档概述:包含项目背景、项目目标、文档版本信息、目标读者、参考文档、名词解释之类的一般文档都会有的章节;
整体架构:主要从整个IT层描述系统所处的位置,与周边关联系统之间的调用关系;
逻辑架构:系统内部功能模块的划分以及各模块功能介绍、相互之间的关系表述;
接口设计:包括系统间的接口设计以及内部功能模块之间的接口设计;
数据架构:本系统与上下游系统间的数据流关系,以及本系统关键数据表设计、数据管理策略等;
技术架构:实施此架构需要用到哪些技术能力,有哪些复用能力及风险;
部署架构:系统如何部署,网络拓扑上有何要求,对硬件服务器有何要求,需要几台,是否需要优化服务器参数;
非功能性设计:性能、高可用、可扩展性、可维护、安全性、可移植性等。
其他说明:如特别约束条件、风险考虑、进度要求、政策限制、环境影响等;
以上,便是我认为一份较为完整的架构设计说明书应该包括的内容了。
历
如何做架构设计说明书
史
我必须得告诉大家的MySQL优化原理
文
UML (统一建模语言) 各种图总结
章
真实项目案例实战—【状态设计模式】使用场景
欢迎分享转发,有帮助的话点个“在看”
架构设计说明书该怎么写?相关推荐
- 架构设计之如何写架构设计说明书
架构设计是需求分析到软件实现的桥梁,也是决定软件质量的关键.编制架构设计说明书是开发人员向架构师转变必定会经历的过程.在架构师整个的成长过程中,必定会经历编制架构设计说明书.评审架构设计说明书以及根据 ...
- 架构设计说明书究竟应该包含什么
软件的架构设计说明书主要包括功能和技术两个部分,其中功能是说明解决的某一类痛点问题:技术是为功能架构服务,通过技术架构来完成功能架构的落地和实现. 功能架构和技术架构两者是相辅相成的,相互独立而又无法 ...
- 【系统设计】架构设计说明书
文章目录 1. 引言 1.1. 编写目的 1.2. 读者对象 1.3. 名词术语定义 1.4. 参考资料 2. 系统概述 3. 架构设计目标和约束 3.1. 架构设计目标 3.2. 约束需求 3.3. ...
- 【软件工程】架构设计说明书
文章目录 1. 引言 1.1. 编写目的 1.2. 读者对象 1.3. 名词术语定义 1.4. 参考资料 2. 系统概述 3. 架构设计目标和约束 3.1. 架构设计目标 3.2. 约束需求 3.3. ...
- 自动驾驶代客泊车架构设计说明书
目 录 0 修订历史... 2 1. 概要... 5 1.1. 目的... 5 1.2. 适用范围... 5 1.3. 参考文档... 5 2. 缩写或定义... 5 3 ...
- 嵌入式软件架构设计----中控机NIOS软件系统架构设计说明书
下面文档系本人开发的流媒体数字会议系统中控机的软件架构,有写的不好的地方,欢迎拍砖 1 .引言 1.1编写目的和使用范围 1.1.1 编写目的 本文档用来确定Nios的软件架构,以便帮助软件工程师更好 ...
- 架构设计-读扩散和写扩散
写扩散 用户发消息,气球池,泡泡池等消息池同步写入消息 气球查询走气球池,泡泡查询走泡泡池 相当于数据写入时维护更多的数据池更新多数据源 优点: 数据查询简单,主要是写入维护控制逻辑 不同的数据池独立 ...
- 多AZ双活容灾部署的云端系统架构设计说明书框架
1.简介 1.1 范围 1.2 背景 1.3 参考文献 1.4 缩略语 2.需求分析 2.1 需求描述 2.2 需求范围 3. 设计描述 3.1 顶层设计 3.1.1 系统上下文 3.1.2 逻辑视图 ...
- 架构设计 例子和实践
系统设计说明书(架构.概要.详细)目录结构 虽然这些文档一般来说公司都是有模板的,但我写这些文档以来基本上是每写一次就把目录结构给改一次,应该说这是因为自己对这些文档的理解开始加深,慢慢的越来越明白这 ...
- 自学架构设计的一个好方法
架构设计,讲起来,比较虚,不像算法和代码.你写了一段巧妙的代码,编译,运行,如果最终结果是正确的,那就是正确的. 但架构设计就不同了,你就算自己脑子YY了一个架构出来,好不好,有时候自己还真不好判断, ...
最新文章
- Gmail新增新功能 支援四种语言等智能功能
- PHP 面向对象:类的属性
- 97.5%准确率的深度学习中文分词(字嵌入+Bi-LSTM+CRF)
- Linux Graphic DRI Wayland 显示子系统
- html中可以有两个h1,在一个HTML中h1标签能出现几次?h1标签和标题标签
- Asterisk 可加载模块
- 深入分析FreeDos -- 前言
- iterator adapter reverse_iterator
- 2018年秋招笔试面试----小学渣求职历险记(中南篇)
- 趋势软件卸载去除密码提示
- mysql 删除表的方法_MySQL 删除表的三种方式
- 【Pr】视频剪辑学习记录——导出
- 网络流行语“不作不死”英文入选美国词典
- kubernetes笔记
- Uipath Try Catch 妙用
- 接龙管家-Python自动打卡
- E9000刀片服务器维护记录
- 2022煤炭生产经营单位(安全生产管理人员)判断题及在线模拟考试
- 电路仿真软件proteus简单使用
- 优盘安装红帽linux系统,从U盘安装 redhat linux 6.0及centos 6.4