实践篇(三):如何有效评审软件架构图?

京东云开发者
• 阅读 412

作者:京东科技 倪新明

设计意图的传达是架构可视化关注的重要维度,在技术方案评审过程中不可避免的会出现各种各样的架构图或设计图,这些图形化表述在设计意图传达效果层面表现不一,本文从图形化的视角为软件架构图的评审关注点提供了参考。

注:关于架构及架构可视化参考文章 《 探寻软件架构的本质,到底什么是架构?》 《 软件架构可视化及C4模型:架构设计不仅仅是UML》

1 原则

明确的主题:架构图要表达的意图明确,比如是容器图、组件图还是部署图

一致的抽象层级:保持一致的抽象层级,不应超过2个以上的层次变化

粒度合适的范围:不应试图在一张图表达“所有的东西”,每张架构图聚焦于自身职责边界的范围

清晰的图例说明:对架构图颜色、形状等有明确的图例,以方便阅读导航

图形颜色不宜太多:过多颜色增加认知成本,建议不超过 4 种

图形元素不宜太多:过多图形元素增加认知成本

明确的连线关系描述

2 评审检查单

如同上线检查单和开发检查单,针对于软件架构图的评审制定一套检查单同样具有价值。不论架构设计者,还是参与设计评审的开发人员,对于形式各异的 “架构图” 是提供通用的参考关注点,以便干系人更多、更深入、更高效、更有针对性的获取架构图的更多信息。

2.1 通用检查项

架构图是否具有标题?

是否能够理解架构图的类型是什么?

是否能够理解架构图的范围是什么?

架构图是否有图例

2.2 元素

架构图中每一个元素是否有名字

是否能够理解架构图中每个元素的类型? (比如,抽象级别,软件系统?容器?组件?等等)

是否能够理解架构图中的每个元素是做什么的?简要描述信息?

是否能够理解与该元素相关的技术选型(适合标明技术选型的元素)

是否能够理解架构图中使用的所有缩写/简称的含义?

是否能够理解架构图中元素使用的所有颜色的含义

是否能够理解架构图中元素使用的所有形状的含义

是否能够理解架构图中元素使用的所有图标的含义?

是否能够理解架构图中元素使用的所有边框样式的含义? (比如,实线 vs 虚线)

是否能够理解架构图中使用的所有元素大小的含义? (比如, 小框 vs 大框 )

2.3 关联关系

架构图中的每条线是否有描述关系含义的信息?

是否能够理解架构图中的每个关联关系**适合标明技术选型的场景技术选型**是什么? (比如,进程间的交互的协议)

是否能够理解架构图中的关联关系的简称或缩写

是否能够理解架构图中的连线颜色的含义?

是否能够理解架构图中的连线箭头的含义?

是否能够理解架构图中的连线样式的含义? (比如,实线 vs 虚线)

3 结语

本文描述了软件架构图的一些评审关注点,其实不只是评审的视角,对于任何一个图形化的软件系统架构或设计表诉,如何能够快速的了解其要表达的意图至关重要,对于设计者而言如何快速传递架构设计信息并于干系人达成一致也至关重要。

点赞
收藏
评论区
推荐文章
blmius blmius
3年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
Wesley13 Wesley13
3年前
PPDB:今晚老齐直播
【今晚老齐直播】今晚(本周三晚)20:0021:00小白开始“用”飞桨(https://www.oschina.net/action/visit/ad?id1185)由PPDE(飞桨(https://www.oschina.net/action/visit/ad?id1185)开发者专家计划)成员老齐,为深度学习小白指点迷津。
Wesley13 Wesley13
3年前
VBox 启动虚拟机失败
在Vbox(5.0.8版本)启动Ubuntu的虚拟机时,遇到错误信息:NtCreateFile(\\Device\\VBoxDrvStub)failed:0xc000000034STATUS\_OBJECT\_NAME\_NOT\_FOUND(0retries) (rc101)Makesurethekern
Wesley13 Wesley13
3年前
FLV文件格式
1.        FLV文件对齐方式FLV文件以大端对齐方式存放多字节整型。如存放数字无符号16位的数字300(0x012C),那么在FLV文件中存放的顺序是:|0x01|0x2C|。如果是无符号32位数字300(0x0000012C),那么在FLV文件中的存放顺序是:|0x00|0x00|0x00|0x01|0x2C。2.  
Wesley13 Wesley13
3年前
mysql设置时区
mysql设置时区mysql\_query("SETtime\_zone'8:00'")ordie('时区设置失败,请联系管理员!');中国在东8区所以加8方法二:selectcount(user\_id)asdevice,CONVERT\_TZ(FROM\_UNIXTIME(reg\_time),'08:00','0
Wesley13 Wesley13
3年前
PHP创建多级树型结构
<!lang:php<?php$areaarray(array('id'1,'pid'0,'name''中国'),array('id'5,'pid'0,'name''美国'),array('id'2,'pid'1,'name''吉林'),array('id'4,'pid'2,'n
Easter79 Easter79
3年前
SpringBoot整合Redis乱码原因及解决方案
问题描述:springboot使用springdataredis存储数据时乱码rediskey/value出现\\xAC\\xED\\x00\\x05t\\x00\\x05问题分析:查看RedisTemplate类!(https://oscimg.oschina.net/oscnet/0a85565fa
Stella981 Stella981
3年前
Jenkins 插件开发之旅:两天内从 idea 到发布(上篇)
本文首发于:Jenkins中文社区(https://www.oschina.net/action/GoToLink?urlhttp%3A%2F%2Fjenkinszh.cn)!huashan(https://oscimg.oschina.net/oscnet/f499d5b4f76f20cf0bce2a00af236d10265.jpg)
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_