实践篇(三):如何有效评审软件架构图?
作者:京东科技 倪新明 设计意图的传达是架构可视化关注的重要维度,在技术方案评审过程中不可避免的会出现各种各样的架构图或设计图,这些图形化表述在设计意图传达效果层面表现不一,本文从图形化的视角为软件架构图的评审关注点提供了参考。 注:关于架构及架构可视化参考文章 《 探寻软件架构的本质,到底什么是架构?》 《 软件架构可视化及C4模型:架构设计不仅仅是UML》 1 原则 •明确的主题:架构图要表达的意图明确,比如是容器图、组件图还是部署图 •一致的抽象层级:保持一致的抽象层级,不应超过2个以上的层次变化 •粒度合适的范围:不应试图在一张图表达“所有的东西”,每张架构图聚焦于自身职责边界的范围 •清晰的图例说明:对架构图颜色、形状等有明确的图例,以方便阅读导航 •图形颜色不宜太多:过多颜色增加认知成本,建议不超过 4 种 •图形元素不宜太多:过多图形元素增加认知成本 •明确的连线关系描述 2 评审检查单 如同上线检查单和开发检查单,针对于软件架构图的评审制定一套检查单同样具有价值。不论架构设计者,还是参与设计评审的开发人员,对于形式各异的 “架构图” 是提供通用的参考关注点,以便干系人更...
