架构图

什么是系统架构图？

系统架构图展示一个软件系统由哪些组件构成，以及它们如何连接：服务、数据库、消息队列、第三方 API，按层级或信任边界分组。Simon Brown 提出的 C4 模型把它分为系统上下文、容器、组件、代码四个缩放层级。

读图时先看边界和分组，再沿连线看请求和数据从哪里来、到哪里去。

什么时候用架构图

• 技术方案评审时，让评审人在十分钟内理解系统的主要部件和依赖。
• 做安全评估，标出哪些连接跨越了信任边界、需要鉴权和加密。
• 如果要说明服务具体部署在哪些主机、区域和端口上，应该画部署图。

怎样画好一张架构图

1. 一张图只停留在一个抽象层级，不要把容器和类混在一起。
2. 每条连线都写明协议或用途，例如「HTTPS / REST」「异步事件」。
3. 加上图例和标题，说明图的范围和更新日期。
4. 外部系统和第三方服务用不同的颜色或虚线框，与自研组件区分开。