技术文档中的各种架构图该怎么画? by彭文华

本文涉及的产品
云原生数据仓库AnalyticDB MySQL版,8核32GB 100GB 1个月
简介: 技术文档中的各种架构图该怎么画? by彭文华

这是彭文华的第173篇原创

哎呀妈呀,现在催稿群里的要求越来越高了啊!你看看这哥们的要求,太难了好吗???

不过这还真是系统架构师该干的事情。话说我最近写的东西的确有些偏了,我认真反省,坚决改正!感谢兄弟们。


系统架构,架构啥?

虽然我本硕都是软件工程专业,软件设计是一直在学的,软件架构设计思想也早早的学过,但是很长一段时间都不知道架构到底是个啥东西。刚入行的时候只会写代码,后来变老手了,就开始写项目文档。

一开始还接触不到核心,只是写自己工作内容相关的。之后当项目经理,就能看到完整的项目文档,但是仍然不太明白为啥要那么多架构图。什么总体架构、逻辑架构、数据架构、功能架构、网络架构、运行架构等等。

我反正是一头的雾水,只顾把自己那摊子事儿搞定就完事了。其他的就追着开发那边给画。而且乙方做项目,基本都是先干活,后补文档。后来,随着项目越做越多,学习的知识也越来越丰富,最重要的是文档越写越多,慢慢的我也就明白了。

其实系统架构,说白了,就相当于房子的设计过程。需要一个总体的样子,还得有里面的支撑结构,还要设计好水暖管线,外壳的装饰以及样板房的设计。每一个内容都得要一套图纸,产出结果自然就是各种架构图了。


这些架构图都表达啥?

讲真,要写好这篇文章,得把《系统架构师》的考试内容细细的读一遍才行。

我这糙就糙一些吧,你看个大概,回头我再细化,写的不对的地方,可以加我微信,给我提意见,我给发红包。


总体架构

总体架构呢,就是买房的时候进门看到的那个大沙盘:整个小区有多大,楼有多高、里面的环境是咋样的?都有哪些配套?方方面面看个大概。所以总体架构基本上把下面所有的架构都体现了。下面所有的架构也都是要与总体架构保持一致。

总体架构需要说明几件事情:

1、整个系统的硬件设置是怎么回事?

2、数据大概是从哪里来,怎么采集、存储、处理、交换的?

3、做了哪些功能抽象,以便于支撑上层的应用?

4、提供些业务应用?管理、控制等功能有哪些?

5、终端用户怎么访问和使用这些应用?

6、该系统与外部系统是怎么进行对接的?

7、如何保障整个系统的安全、可靠、高质量的建设?

这个整体架构还是比较简单的,复杂的手机上没法看。你打开看个意思就行了。


逻辑架构

其实总体架构有了,逻辑架构也就有了。为啥呢?如果说总体架构是整个小区的沙盘,那逻辑架构就是这栋楼房了。把小区大门、绿地、路等保障小区安全、有序的东西去掉。所以逻辑架构里会去掉各种保障、底层的硬件基础等非软件开发逻辑核心的内容。

所以有很多简单的项目压根就不写逻辑架构,直接用总体架构就行了。复杂的呢,就要把上面总体架构中间分层的逻辑给写清楚一些。

逻辑架构设计的目的就是为了告诉读者,整个系统是怎么产生左右的。所谓的系统架构,主要说的就是这部分。早期的单体架构、后面的各种分层架构、微服务、服务网格等,说的都是在这里进行设计。

在设计的时候,会用到很多种设计模式,比如你看到有一个应用支撑层/服务层之类的,这就是做了一个MVC,把业务逻辑和用户前端分离。而所有的逻辑架构都有数据层,这是最早的MVP,即数据、用户视图和处理逻辑分离。当然,系统越复杂,架构图就越复杂。这里只是给一个简单的图供你参考了。

应用架构

顾名思义,就是应用太丰富了,需要整理整理。内部有哪些应用,怎么对外部提供服务。很多项目都没有这个,因为应用比较少,不值得多废点人工单独写。

技术架构

技术架构要干啥也就很清楚了,就是每一层,我们都用什么组件、什么技术解决什么问题。

数据架构

数据架构其实就是从数据侧描述数据怎么来、怎么存、怎么加工、怎么使用。就像这样:

从数据源开始,数据通过哪些方式集成过来;集成到数仓之后,都存在哪里,数仓怎么分层,每一层都干啥;在数据集市中又怎么存、怎么管;到数据应用层又提供些应用。上面所有的一切,都用什么技术,什么组件,解决什么问题。

部署架构

部署架构也叫网络架构,就是底层服务器、网路的设计,提供网络安全、服务可靠性的设计。再简单一些理解,就是你这些应用、数据库都放在那台服务器上,这些服务器都在哪个ip端,怎么进行访问。

功能架构

这个没啥好说的,就是你的前台页面的功能菜单的目录结构。你怎么组织系统的所有功能,给用户提供相应的服务。

运行架构

运行架构其实就是软件内部,这些系统内部是怎么运转的,一般会画很多时序图、状态图、活动图。这玩意可费劲了,我们一般不单独画一个运行架构,而是在概要和详细设计里画。


区别与联系

传统信息系统项目和大数据项目还是有很显著的区别的。从架构层面上来说,该有的肯定都得有,只不过其中的内容会有侧重点。我简单对比一下,您将就着看:

对比项 传统IT项目 大数据项目
重点 80%应用 80%数据
类型 OLTP事务处理 OLAP分析处理
安全 应用安全 数据安全、质量、治理
总体架构 侧重业务应用 放大数据层
逻辑架构 各种SOA、微服务 各种DW、OLAP分层
技术架构 什么Spring、JSP、Ajax 各种Hadoop生态组件
数据架构 侧重关系型数据库 侧重分布式数据库
部署架构 一般主从即可 集群
功能/运行 看项目,无偏向 看项目,无偏向


总结

所的架构都是基于业务出发的,因此脱离实际业务的架构都是无意义的。

我们在进行架构设计的时候,需要用不同的图形来解释、阐释整个系统运行的肌理。

总体架构涵盖系统的方方面面;

逻辑架构阐述整个系统是如何实现业务需求的;

技术架构则从技术实现的角度阐述系统的构造;

数据架构讲解数据从哪来,到哪里去;

部署架构则讲清楚系统放在那台服务器上,怎么才能访问到;

功能架构用来组织业务功能;

运行架构则解析系统内部运行机理。

相关实践学习
AnalyticDB MySQL海量数据秒级分析体验
快速上手AnalyticDB MySQL,玩转SQL开发等功能!本教程介绍如何在AnalyticDB MySQL中,一键加载内置数据集,并基于自动生成的查询脚本,运行复杂查询语句,秒级生成查询结果。
阿里云云原生数据仓库AnalyticDB MySQL版 使用教程
云原生数据仓库AnalyticDB MySQL版是一种支持高并发低延时查询的新一代云原生数据仓库,高度兼容MySQL协议以及SQL:92、SQL:99、SQL:2003标准,可以对海量数据进行即时的多维分析透视和业务探索,快速构建企业云上数据仓库。 了解产品 https://www.aliyun.com/product/ApsaraDB/ads
相关文章
|
Java 程序员 数据库
黄山归来不看岳:《Java开发手册(黄山版)》新增 11 条规约
黄山归来不看岳:《Java开发手册(黄山版)》新增 11 条规约
5615 0
黄山归来不看岳:《Java开发手册(黄山版)》新增 11 条规约
|
8天前
|
程序员 测试技术 数据安全/隐私保护
“阿里味”GitHub新春上新NO.1软件架构设计与业务架构融合手册
软件架构设计的本质,是对问题域空间反复运用演绎、抽象、归纳等方法,进而找到适合当前阶段的设计方案的过程。既要考虑软件随业务发展的纵横向扩展性,也要考虑软件自身的可行性、稳定性和可维护性等技术因素。
|
12月前
|
设计模式 架构师 算法
限量!阿里技术官纯手打架构师进阶宝典全网首发,理论+项目齐飞
可能有些人会常常有这样的感觉,同是开发有些人比我工资高却什么代码都不写呢?当我听到这个问题的时候第一次映入脑海的就是:工程师的分类。 大家可以来看看Java工程师在招聘网站上的区分:
限量!阿里技术官纯手打架构师进阶宝典全网首发,理论+项目齐飞
|
12月前
|
消息中间件 安全 Java
全网首发!消息中间件神仙笔记,涵盖阿里十年技术精髓
消息中间件是分布式系统中的重要组件,在实际工作中常用消息中间件进行系统间数据交换,从而解决应用解耦、异步消息、流量削峰等问题,实现高性能、高可用、可伸缩和最终一致性架构。
|
12月前
|
运维 算法 架构师
又爆新作!阿里甩出架构师进阶必备神仙笔记,底层知识全梳理
据有关数据表明,目前Java程序员这个群体的数量不减反增,行业内的竞争也是越来越严重。在同一时间入行的人,经过一段时间的学习后,差距就会显示出来。其实出现这样的原因大多数都是因为学习的方向出了问题。大多数人学Java刚开始只是为了快速就业,但是在工作了之后却没有一个好的学习路线,那些其实很重要的东西只是因为工作上用不到从而忽略掉了,慢慢的才发现自己与别人之间已经存在很大差距了!
|
人工智能 程序员 Linux
【猿如意】CSDN推出的程序猿开发百宝箱
【猿如意】CSDN推出的程序猿开发百宝箱
171 0
|
测试技术
[雪峰磁针石博客]2018软件测试标准汇总下载
标题有链接的,点击标题即可下载 国际标准 ISO/IEC 25010 系统和软件质量模型 英文原版: BS ISO IEC 25010-2011 Systems and software engineering — Systems and software Quality Requirement.
|
测试技术 API Android开发
[雪峰磁针石博客]软件测试专家工具包3移动端
UI Automator UI Automator提供了一组API来构建基于交互UI的测试。API允许你执行操作,如打开设置菜单,非常适合黑盒自动化测试,在测试代码不依赖于应用的内部实现 uiautomatorviewer提供了一个方便的图形用户界面进行扫描和分析在Android设备上当前显示的UI组件。

热门文章

最新文章

  • 1
    流量控制系统,用正则表达式提取汉字
    25
  • 2
    Redis09-----List类型,有序,元素可以重复,插入和删除快,查询速度一般,一般保存一些有顺序的数据,如朋友圈点赞列表,评论列表等,LPUSH user 1 2 3可以一个一个推
    26
  • 3
    Redis08命令-Hash类型,也叫散列,其中value是一个无序字典,类似于java的HashMap结构,Hash结构可以将对象中的每个字段独立存储,可以针对每字段做CRUD
    25
  • 4
    Redis07命令-String类型字符串,不管是哪种格式,底层都是字节数组形式存储的,最大空间不超过512m,SET添加,MSET批量添加,INCRBY age 2可以,MSET,INCRSETEX
    27
  • 5
    S外部函数可以访问函数内部的变量的闭包-闭包最简单的用不了,闭包是内层函数+外层函数的变量,简称为函数套函数,外部函数可以访问函数内部的变量,存在函数套函数
    23
  • 6
    Redis06-Redis常用的命令,模糊的搜索查询往往会对服务器产生很大的压力,MSET k1 v1 k2 v2 k3 v3 添加,DEL是删除的意思,EXISTS age 可以用来查询是否有存在1
    30
  • 7
    Redis05数据结构介绍,数据结构介绍,官方网站中看到
    21
  • 8
    JS字符串数据类型转换,字符串如何转成变量,+号只要有一个是字符串,就会把另外一个转成字符串,- * / 都会把数据转成数字类型,数字型控制台是蓝色,字符型控制台是黑色,
    19
  • 9
    JS数组操作---删除,arr.pop()方法从数组中删除最后一个元素,并返回该元素的值,arr.shift() 删除第一个值,arr.splice()方法,删除指定元素,arr.splice,从第一
    19
  • 10
    定义好变量,${age}模版字符串,对象可以放null,检验数据类型console.log(typeof str)
    19