作者:京东科技 倪新明

规划目的的传达是架构可视化关注的重要维度,在技能计划评定过程中不可避免的会出现各式各样的架构图或规划图,这些图形化表述在规划目的传达效果层面表现纷歧,本文从图形化的视角为软件架构图的评定关注点供给了参阅。

注:关于架构及架构可视化参阅文章 《 探寻软件架构的实质,究竟什么是架构?》 《 软件架构可视化及C4模型:架构规划不仅仅是UML》

1 原则

明晰的主题:架构图要表达的目的明晰,比方是容器图、组件图仍是布置图

一致的笼统层级:保持一致的笼统层级,不该超越2个以上的层次改变

粒度适宜的规模:不该企图在一张图表达“一切的东西”,每张架构图聚集于本身责任鸿沟的规模

明晰的图例说明:对架构图色彩、形状等有明晰的图例,以方便阅览导航

图形色彩不宜太多:过多色彩添加认知本钱,建议不超越 4 种

图形元素不宜太多:过多图形元素添加认知本钱

明晰的连线联系描绘

2 评定查看单

好像上线查看单和开发查看单,针对于软件架构图的评定制定一套查看单同样具有价值。不论架构规划者,仍是参与规划评定的开发人员,对于方式各异的 “架构图” 是供给通用的参阅关注点,以便干系人更多、更深化、更高效、更有针对性的获取架构图的更多信息。

2.1 通用查看项

架构图是否具有标题?

是否可以了解架构图的类型是什么?

是否可以了解架构图的规模是什么?

架构图是否有图例

2.2 元素

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

是否可以了解架构图中每个元素的类型? (比方,笼统等级,软件体系?容器?组件?等等)

是否可以了解架构图中的每个元素是做什么的?简要描绘信息?

是否可以了解与该元素相关的技能选型(适合标明技能选型的元素)

是否可以了解架构图中运用的一切缩写/简称的意义?

是否可以了解架构图中元素运用的一切色彩的意义

是否可以了解架构图中元素运用的一切形状的意义

是否可以了解架构图中元素运用的一切图标的意义?

是否可以了解架构图中元素运用的一切边框样式的意义? (比方,实线 vs 虚线)

是否可以了解架构图中运用的一切元素大小的意义? (比方, 小框 vs 大框 )

2.3 相相关系

架构图中的每条线是否有描绘联系意义的信息?

是否可以了解架构图中的每个相相关系****(适合标明技能选型的场景)的技能选型是什么? (比方,进程间的交互的协议)

是否可以了解架构图中的相相关系的简称或缩写

是否可以了解架构图中的连线色彩的意义?

是否可以了解架构图中的连线箭头的意义?

是否可以了解架构图中的连线样式的意义? (比方,实线 vs 虚线)

3 结语

本文描绘了软件架构图的一些评定关注点,其实不只是评定的视角,对于任何一个图形化的软件体系架构或规划表诉,怎么可以快速的了解其要表达的目的至关重要,对于规划者而言怎么快速传递架构规划信息并于干系人达成一致也至关重要。