APP推广合作
联系“鸟哥笔记小乔”
技术文档中的各种架构图该怎么画? by彭文华
2021-02-27 20:00:00

这是彭文华的第173篇原创

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

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



系统架构,架构啥?



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

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

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

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




这些架构图都表达啥?



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

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


总体架构

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

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

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

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

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

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

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

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

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

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


逻辑架构

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

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

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

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

应用架构

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

技术架构

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

数据架构

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

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

部署架构

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

功能架构

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

运行架构

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




区别与联系



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

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






总结



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

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

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

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

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

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

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

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

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


扩展阅读:《系统架构设计师考试宝典+各种系统架构图》,公众号“大数据架构师”后台回复“系统架构”即可下载。

我建了一个群,每天分享各种技术文档。加我微信shirenpengwh,咱进群聊~~

配合以下文章享受更佳







下载 | 实时数仓架构设计与选型

干货 | 一口气讲完数据仓建模方法

干货 | 一口气说透中台--给你架构师的视角

干货 |  一口气说穿数据中台-给你架构师的视角


下载 | 贝壳的数据中台工程架构实践之大数据开发平台


我需要你的转发,小小的满足一下我的虚荣心

大数据架构师
分享到朋友圈
收藏
收藏
评分

综合评分:

我的评分
Xinstall 15天会员特权
Xinstall是专业的数据分析服务商,帮企业追踪渠道安装来源、裂变拉新统计、广告流量指导等,广泛应用于广告效果统计、APP地推与CPS/CPA归属统计等方面。
20羽毛
立即兑换
一书一课30天会员体验卡
领30天VIP会员,110+门职场大课,250+本精读好书免费学!助你提升职场力!
20羽毛
立即兑换
顺丰同城急送全国通用20元优惠券
顺丰同城急送是顺丰推出的平均1小时送全城的即时快送服务,专业安全,准时送达!
30羽毛
立即兑换
大数据架构师
大数据架构师
发表文章272
历任多家公司大数据总监、大数据架构师,专注于数字化转型领域。
确认要消耗 羽毛购买
技术文档中的各种架构图该怎么画? by彭文华吗?
考虑一下
很遗憾,羽毛不足
我知道了

我们致力于提供一个高质量内容的交流平台。为落实国家互联网信息办公室“依法管网、依法办网、依法上网”的要求,为完善跟帖评论自律管理,为了保护用户创造的内容、维护开放、真实、专业的平台氛围,我们团队将依据本公约中的条款对注册用户和发布在本平台的内容进行管理。平台鼓励用户创作、发布优质内容,同时也将采取必要措施管理违法、侵权或有其他不良影响的网络信息。


一、根据《网络信息内容生态治理规定》《中华人民共和国未成年人保护法》等法律法规,对以下违法、不良信息或存在危害的行为进行处理。
1. 违反法律法规的信息,主要表现为:
    1)反对宪法所确定的基本原则;
    2)危害国家安全,泄露国家秘密,颠覆国家政权,破坏国家统一,损害国家荣誉和利益;
    3)侮辱、滥用英烈形象,歪曲、丑化、亵渎、否定英雄烈士事迹和精神,以侮辱、诽谤或者其他方式侵害英雄烈士的姓名、肖像、名誉、荣誉;
    4)宣扬恐怖主义、极端主义或者煽动实施恐怖活动、极端主义活动;
    5)煽动民族仇恨、民族歧视,破坏民族团结;
    6)破坏国家宗教政策,宣扬邪教和封建迷信;
    7)散布谣言,扰乱社会秩序,破坏社会稳定;
    8)宣扬淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪;
    9)煽动非法集会、结社、游行、示威、聚众扰乱社会秩序;
    10)侮辱或者诽谤他人,侵害他人名誉、隐私和其他合法权益;
    11)通过网络以文字、图片、音视频等形式,对未成年人实施侮辱、诽谤、威胁或者恶意损害未成年人形象进行网络欺凌的;
    12)危害未成年人身心健康的;
    13)含有法律、行政法规禁止的其他内容;


2. 不友善:不尊重用户及其所贡献内容的信息或行为。主要表现为:
    1)轻蔑:贬低、轻视他人及其劳动成果;
    2)诽谤:捏造、散布虚假事实,损害他人名誉;
    3)嘲讽:以比喻、夸张、侮辱性的手法对他人或其行为进行揭露或描述,以此来激怒他人;
    4)挑衅:以不友好的方式激怒他人,意图使对方对自己的言论作出回应,蓄意制造事端;
    5)羞辱:贬低他人的能力、行为、生理或身份特征,让对方难堪;
    6)谩骂:以不文明的语言对他人进行负面评价;
    7)歧视:煽动人群歧视、地域歧视等,针对他人的民族、种族、宗教、性取向、性别、年龄、地域、生理特征等身份或者归类的攻击;
    8)威胁:许诺以不良的后果来迫使他人服从自己的意志;


3. 发布垃圾广告信息:以推广曝光为目的,发布影响用户体验、扰乱本网站秩序的内容,或进行相关行为。主要表现为:
    1)多次发布包含售卖产品、提供服务、宣传推广内容的垃圾广告。包括但不限于以下几种形式:
    2)单个帐号多次发布包含垃圾广告的内容;
    3)多个广告帐号互相配合发布、传播包含垃圾广告的内容;
    4)多次发布包含欺骗性外链的内容,如未注明的淘宝客链接、跳转网站等,诱骗用户点击链接
    5)发布大量包含推广链接、产品、品牌等内容获取搜索引擎中的不正当曝光;
    6)购买或出售帐号之间虚假地互动,发布干扰网站秩序的推广内容及相关交易。
    7)发布包含欺骗性的恶意营销内容,如通过伪造经历、冒充他人等方式进行恶意营销;
    8)使用特殊符号、图片等方式规避垃圾广告内容审核的广告内容。


4. 色情低俗信息,主要表现为:
    1)包含自己或他人性经验的细节描述或露骨的感受描述;
    2)涉及色情段子、两性笑话的低俗内容;
    3)配图、头图中包含庸俗或挑逗性图片的内容;
    4)带有性暗示、性挑逗等易使人产生性联想;
    5)展现血腥、惊悚、残忍等致人身心不适;
    6)炒作绯闻、丑闻、劣迹等;
    7)宣扬低俗、庸俗、媚俗内容。


5. 不实信息,主要表现为:
    1)可能存在事实性错误或者造谣等内容;
    2)存在事实夸大、伪造虚假经历等误导他人的内容;
    3)伪造身份、冒充他人,通过头像、用户名等个人信息暗示自己具有特定身份,或与特定机构或个人存在关联。


6. 传播封建迷信,主要表现为:
    1)找人算命、测字、占卜、解梦、化解厄运、使用迷信方式治病;
    2)求推荐算命看相大师;
    3)针对具体风水等问题进行求助或咨询;
    4)问自己或他人的八字、六爻、星盘、手相、面相、五行缺失,包括通过占卜方法问婚姻、前程、运势,东西宠物丢了能不能找回、取名改名等;


7. 文章标题党,主要表现为:
    1)以各种夸张、猎奇、不合常理的表现手法等行为来诱导用户;
    2)内容与标题之间存在严重不实或者原意扭曲;
    3)使用夸张标题,内容与标题严重不符的。


8.「饭圈」乱象行为,主要表现为:
    1)诱导未成年人应援集资、高额消费、投票打榜
    2)粉丝互撕谩骂、拉踩引战、造谣攻击、人肉搜索、侵犯隐私
    3)鼓动「饭圈」粉丝攀比炫富、奢靡享乐等行为
    4)以号召粉丝、雇用网络水军、「养号」形式刷量控评等行为
    5)通过「蹭热点」、制造话题等形式干扰舆论,影响传播秩序


9. 其他危害行为或内容,主要表现为:
    1)可能引发未成年人模仿不安全行为和违反社会公德行为、诱导未成年人不良嗜好影响未成年人身心健康的;
    2)不当评述自然灾害、重大事故等灾难的;
    3)美化、粉饰侵略战争行为的;
    4)法律、行政法规禁止,或可能对网络生态造成不良影响的其他内容。


二、违规处罚
本网站通过主动发现和接受用户举报两种方式收集违规行为信息。所有有意的降低内容质量、伤害平台氛围及欺凌未成年人或危害未成年人身心健康的行为都是不能容忍的。
当一个用户发布违规内容时,本网站将依据相关用户违规情节严重程度,对帐号进行禁言 1 天、7 天、15 天直至永久禁言或封停账号的处罚。当涉及欺凌未成年人、危害未成年人身心健康、通过作弊手段注册、使用帐号,或者滥用多个帐号发布违规内容时,本网站将加重处罚。


三、申诉
随着平台管理经验的不断丰富,本网站出于维护本网站氛围和秩序的目的,将不断完善本公约。
如果本网站用户对本网站基于本公约规定做出的处理有异议,可以通过「建议反馈」功能向本网站进行反馈。
(规则的最终解释权归属本网站所有)

我知道了
恭喜你~答对了
+5羽毛
下一次认真读哦
成功推荐给其他人
+ 10羽毛
评论成功且进入审核!审核通过后,您将获得10羽毛的奖励。分享本文章给好友阅读最高再得15羽毛~
(羽毛可至 "羽毛精选" 兑换礼品)
好友微信扫一扫
复制链接