画系统框图,先确定“这张图要解释哪一层系统”,再画组成模块和模块之间的关系。方框不是越多越完整,箭头也不是连上就算说明白:读者应该能从图中看出系统负责什么、与哪些外部对象交互,以及信息从哪里来、到哪里去。
下面按“图形选择、组件绘制、连接、文字、布局、检查”六个步骤,结合一个冷库温度监测的设计例子说明。你可以用 Boardmix 框架图工具整理模块,在同一画布上与开发、业务和运维人员核对边界。

1. 系统框图和流程图的区别
系统框图回答“系统由什么组成、各部分如何关联”;流程图回答“事情按什么顺序发生、遇到条件如何分支”。两者可以配合使用,但不能因为都用了方框和箭头,就认为表达的是同一件事。
| 比较项 | 系统框图 | 流程图 |
|---|---|---|
| 主要对象 | 模块、设备、服务、外部系统及其关系 | 动作、判断、起点和终点 |
| 方框如何命名 | “采集模块”“告警服务”等职责名称 | “采集温度”“发送通知”等动作 |
| 箭头说明什么 | 数据、信号、调用或依赖;需要图例或标签 | 步骤的执行方向及分支条件 |
| 适合讨论 | 模块划分、系统边界、接口和部署责任 | 超温后谁收到通知、何时复核和结束处理 |
例如,温度传感器、数据接入、规则判断、告警通知和监控页面,可以组成一张监测系统框图;“检测到超温→发送通知→值班人员复核→确认恢复”的处理过程,则适合另画流程图。把两种关系硬塞进一张图,容易让箭头同时承担“先后”和“调用”两种意思。
系统框图常用矩形表示模块,用分组框表示系统边界或层次。是否从左向右布局取决于阅读方向和关系,不能据此断定模块左侧一定是输入、右侧一定是输出。对于架构分层图,也可以从上到下组织界面、业务服务和基础设施。

查看分层系统架构模板时,先判断自己的系统是否需要这些层。小系统可以省去不适用的部分,无需为了贴合模板而添加没有实际职责的模块。
2. 系统框图怎么画
打开 Boardmix 工作区,新建白板或选择适合的模板。开始摆放图形前,用一句话写明范围。例如:“本图说明一个冷库内温度数据从采集到告警展示的系统组成,不包含制冷设备自动控制和库存管理。”这一句决定后面哪些模块放在框内,哪些作为外部依赖。
(1)选择图形工具:先约定图形的意思
用普通矩形画职责模块,用带标题的外层框表示本次讨论的系统。外部短信平台、传感器等对象可以放在边界外,并用不同底色区分。数据库是否使用专门符号不是关键,关键是图例一致:如果圆柱体代表数据存储,就不要又拿它表示业务服务。
这一步只需约定少量符号。例如,实线箭头表示数据传递,虚线表示配置关系;如果并不需要两种关系,就只用一种线型。图例越多,维护成本越高。
(2)绘制组件:每个方框只承担清楚的一类职责
先列模块,再放到画布上。冷库温度监测可以先分为以下几个部分;这是用于讨论的设计拆分,不代表每个模块都必须独立部署为一个服务。
| 模块或对象 | 负责的事情 | 需要讲清的边界 |
|---|---|---|
| 温度采集设备(外部) | 发送设备编号、时间和温度读数 | 本图不展开硬件电路设计 |
| 数据接入 | 接收数据,识别设备,处理不完整记录 | 不负责决定温度是否超限 |
| 规则判断 | 按设备对应规则判断异常 | 规则参数来自哪里、由谁维护 |
| 告警通知 | 把异常事件发送至通知渠道 | 通知失败需要有可检查的状态 |
| 数据存储 | 保存读数、规则和告警记录 | 哪些模块读写哪些数据 |
| 监控页面 | 展示读数、设备状态和告警记录 | 展示状态不等于已经处理故障 |
同一层尽量保持相近粒度。不要把“整个业务平台”“登录按钮”和“数据库服务器”并列成三个模块。若需要解释某个模块内部细节,可在旁边单独展开子图,并保留与总图一致的名称。
(3)连接组件:箭头上写传递的内容
先画主关系:采集设备→数据接入,标注“温度读数”;数据接入→规则判断,标注“已识别设备的有效记录”;规则判断→告警通知,标注“超限事件”;告警通知→外部通知渠道,标注“通知请求”。监控页面从哪里读取状态,也应画清楚。
连线前问自己:两端是否真的存在直接交互?如果监控页面通过查询服务读取数据,就不要为了省一个框,画成浏览器直接连接数据库。双向箭头也不应默认使用;请求与响应信息不同且对讨论重要时,可以分别标明。
(4)添加文本说明:补充连接无法表达的约束
给图加标题、边界说明和简短图例。对容易误解的模块补一句职责,例如“规则判断只产生告警事件,不直接控制制冷设备”。接口协议、数据更新频率、异常数据处理等尚未确定的内容,可列在画布旁的待确认清单中,安排负责人确认后再更新图。
系统框图需要说明结构,并不承担全部接口文档的工作。字段、错误码和权限规则可以放在配套说明中,用模块名称或编号与图建立对应关系。
(5)调整布局:按阅读顺序减少交叉
可以从左到右排列采集、处理、通知,把共享存储放在下方,把外部服务放在系统边界外。用对齐和等间距排列减少视觉噪声;模块颜色主要用于区分类别,不必每个模块使用一种颜色。
如果一根连线跨越多个区域,先检查模块分组是否合理,再考虑折线绕行。不要让连线穿过模块文字,也不要把箭头终点放在边框外一段距离处,造成关系悬空。
(6)检查错误:从输入、职责和故障三个角度走读
- 沿一条数据走一遍:一条温度读数从哪里进入,经过哪些模块,最后在哪里展示或保存?缺失路径要补全。
- 逐框核对职责:是否有两个模块负责同一判断,或有一项关键工作没有模块承担?检查名称与实际职责是否一致。
- 检查重要失败情形:设备断连、数据不完整、通知失败时,由哪个模块发现并记录?框图不必展开所有故障步骤,但应能指出责任所在。
请相关人员按同一条输入共同走读,比单纯问“这张图对不对”更容易发现问题。完成后可分享白板供团队核对;需要交付静态文件时,在当前导出面板确认可用格式,并检查文字和箭头是否清晰。

打开简单 Web 系统架构模板,可以练习核对“界面请求经过哪些层、在哪一层访问数据”。模板中的连接不是对所有 Web 系统都适用的固定方案。
3. 系统框图模板怎么选和使用
选择模板看的是结构是否适合,而不只是行业名称相近。下面几种模板分别强调业务分层、知识处理、跨主体协同与技术架构。打开社区模板后,先确认内容、使用入口和适用条件,再替换为自己的模块与关系。
营销系统:适合梳理数据接入与业务能力

营销系统设计框图可用来讨论外部系统与内部能力的分工。修改时要区分“数据从哪里来”和“哪些业务使用这些数据”,不要只把产品名称填满各层。
知识图谱系统:适合表达处理层次

知识图谱系统技术框图展示了从知识获取到应用的层次。讨论实际项目时,应删去未采用的能力,并明确每一层的输入与输出,避免把能力清单误当成已经实现的系统。
冷链系统:适合先画清跨主体边界

冷链供应链系统框图覆盖的范围比前文的单个冷库温度监测更大。可以先借它确定企业、监管和消费者等外部主体,再单独展开自己负责的监控模块,避免在一张图里混用全行业平台与设备内部的细节。
分层技术架构:适合区分业务与运行支撑

分层系统架构模板可以帮助区分业务模块和支撑组件。图中的数据库、容器或服务器只是模板内容,应以实际技术选择为准;没有确认使用的组件,不应作为已部署事实写进交付图。
最终交付前,让第一次看到图的人回答三个问题:系统边界在哪里、各模块各自负责什么、主要信息怎样流动。回答不出来,就继续调整模块命名和连线标签。打开 Boardmix 绘制系统框图,先把一个清楚的小范围画对,再按需要展开细节。