结构图是什么
要回答合格的架构图应该是什么样子的，这样一个问题。我们首先应该知道架构图是什么。
“架构图”中的“图”，我们好理解，一种图形化的方式，来表达/展示架构。
“架构图”是什么的问题则转化为“架构”是什么？架构的定义有很多。下面是其中一个。
Architecture is about the important stuff. Whatever that is.
--- Ralph Johnson
这样的定义似乎过于宽泛，但也让我们看到架构中所关注的是软件系统中重要的元素。那么架构图就是软件系统中重要元素间关系的抽象表达。其他一些架构图的概念也印证了这一点。
系统架构图，是为了抽象地表示软件系统的整体轮廓和各个组件之间的相互关系和约束边界，以及软件系统的物理部署和软件系统的演进方向的整体视图。
合格架构图需要具备什么
这样的定义，已经说明了架构的是什么，它的作用也不言而喻：便于干系人理解系统架构，减少分歧，统一认识。
为了探究什么是合格的架构图，让我们看一下，市面上常见的架构图。
看过之后，我大致了解了系统架构，但又有一些疑问？
* 直线和虚线各代表什么？红线和绿线的区别是进出方向不同，为什么其他线没有颜色？
* Logic使用了Hibernate连接数据库，数据库使用了MySQL，他们的关系是通过位置来表达的。那Monitoring Service在Database下面，是表达了什么？
* 架构图中的方框表示组件，圆柱形表示中间件，Monitoring Service是一个服务为什么用白板的形状表示？
* 这张架构图，给开发看还能理解。如果给客户或者测试看，他们能否理解？或者是否需要了解系统的每个细枝末节？
一张架构图能够让人产生这么多疑问，没有起到统一认识和减少分歧作用，那它无疑不是一张合格的架构图。但通过这张图，也让我们发现一张合格的架构图，起码需要避免以上问题。
它至少需要具备：
统一的结构外观，需要在形状，边框，大小，颜色，线条等方面保持一致
简明的表达元素间关系，需要使用线条表示各个元素之间的关系，必要时在线条进行解释说明
多维度展示，应对不同的角色，在不同维度展示架构
认识到合格架构图的标准，那团队就可以把标准固化，形成规范保持下去，产出合格的架构图。
C4 Model
但我们知道项目是不断演进的，人员和文档也需要不断的更迭，长久下来这样的规则是否能够坚守下去？考虑到时间的推移和人的不可靠性，我们需要一个工具，来帮助团队固化标准，保证架构图的一致性和可追溯性。
C4 model（https://c4model.com/）正是这样的一个工具。
其中4个C中分别代表System Context diagram，Container Diagram，Component Diagram和Code Diagram。4个图的抽象粒度依次减小，从系统在整个IT环境中的位置到某个组件代码层级细节依次展示，适用于不同角色，不同维度理解系统。
Level 1: System Context diagram
System Context diagram，在最大的维度解释系统在整个IT系统里所处的位置，把系统置于图中间，周围是用户，以及其与其交互的第三方系统。在这个粒度上，需要关注的是用户以及第三方系统的交互；无需关注细节，具体的细节可以通过缩放查看其它粒度的图。它的作用是表达：系统的用户是谁，与哪些第三方系统交互，交互的方式是什么。
Level 2: Container diagram
Container diagram，在更细的粒度上解释系统。进一步剖析，展示内部结构，更适用于技术人员使用。其中一个容器，可以是一个后端服务，一个手机App/小程序，或者一个单页应用。它的作用是展示出系统技术选型，以及容器间和容器与其他的系统的具体交互。
Level 3: Component diagram
Component diagram，展示一个容器的具体组成和它们之间的联系。用来解释一个容器内部，组件的数量，构成方式，应用的技术和职责，以及组件间的交互。
Level 4: Code diagram
Code diagram展示一个组件的实现细节，通常使用UML类图表示，且自动生成。
C4 model也提供了其他类型的图，如System Landscape diagram，Deployment diagram等，可通过https://c4model.com/了解。
VS Code 中也提供了插件（https://github.com/qjebbs/vscode-plantuml）帮助绘制C4 model。以代码的形式动态生成C4 model，也可以通过git支持版本管理。如此一来，团队的架构图就保证了：一致性，可维护性，自解释性。
在这里https://github.com/RicardoNiepel/C4-PlantUML，你也可以获得C4 model的参考代码。
参考资料
https://www.infoq.cn/article/crafting-architectural-diagrams
