跳到正文
Boardmix博思白板 logo boardmix 白板
产品
AI工具
企业服务

画系统框图,先确定“这张图要解释哪一层系统”,再画组成模块和模块之间的关系。方框不是越多越完整,箭头也不是连上就算说明白:读者应该能从图中看出系统负责什么、与哪些外部对象交互,以及信息从哪里来、到哪里去。

下面按“图形选择、组件绘制、连接、文字、布局、检查”六个步骤,结合一个冷库温度监测的设计例子说明。你可以用 Boardmix 框架图工具整理模块,在同一画布上与开发、业务和运维人员核对边界。

冷库温度监测系统的采集、规则、通知与展示组成

1. 系统框图和流程图的区别

系统框图回答“系统由什么组成、各部分如何关联”;流程图回答“事情按什么顺序发生、遇到条件如何分支”。两者可以配合使用,但不能因为都用了方框和箭头,就认为表达的是同一件事。

比较项系统框图流程图
主要对象模块、设备、服务、外部系统及其关系动作、判断、起点和终点
方框如何命名“采集模块”“告警服务”等职责名称“采集温度”“发送通知”等动作
箭头说明什么数据、信号、调用或依赖;需要图例或标签步骤的执行方向及分支条件
适合讨论模块划分、系统边界、接口和部署责任超温后谁收到通知、何时复核和结束处理

例如,温度传感器、数据接入、规则判断、告警通知和监控页面,可以组成一张监测系统框图;“检测到超温→发送通知→值班人员复核→确认恢复”的处理过程,则适合另画流程图。把两种关系硬塞进一张图,容易让箭头同时承担“先后”和“调用”两种意思。

系统框图常用矩形表示模块,用分组框表示系统边界或层次。是否从左向右布局取决于阅读方向和关系,不能据此断定模块左侧一定是输入、右侧一定是输出。对于架构分层图,也可以从上到下组织界面、业务服务和基础设施。

Boardmix 画布中的分层系统架构图,按外部应用、前台应用、中台服务和基础设施分组
分层架构适合先讨论各层职责;需要解释具体交互时,还应补充关系标签。

查看分层系统架构模板时,先判断自己的系统是否需要这些层。小系统可以省去不适用的部分,无需为了贴合模板而添加没有实际职责的模块。

2. 系统框图怎么画

打开 Boardmix 工作区,新建白板或选择适合的模板。开始摆放图形前,用一句话写明范围。例如:“本图说明一个冷库内温度数据从采集到告警展示的系统组成,不包含制冷设备自动控制和库存管理。”这一句决定后面哪些模块放在框内,哪些作为外部依赖。

(1)选择图形工具:先约定图形的意思

用普通矩形画职责模块,用带标题的外层框表示本次讨论的系统。外部短信平台、传感器等对象可以放在边界外,并用不同底色区分。数据库是否使用专门符号不是关键,关键是图例一致:如果圆柱体代表数据存储,就不要又拿它表示业务服务。

这一步只需约定少量符号。例如,实线箭头表示数据传递,虚线表示配置关系;如果并不需要两种关系,就只用一种线型。图例越多,维护成本越高。

(2)绘制组件:每个方框只承担清楚的一类职责

先列模块,再放到画布上。冷库温度监测可以先分为以下几个部分;这是用于讨论的设计拆分,不代表每个模块都必须独立部署为一个服务。

模块或对象负责的事情需要讲清的边界
温度采集设备(外部)发送设备编号、时间和温度读数本图不展开硬件电路设计
数据接入接收数据,识别设备,处理不完整记录不负责决定温度是否超限
规则判断按设备对应规则判断异常规则参数来自哪里、由谁维护
告警通知把异常事件发送至通知渠道通知失败需要有可检查的状态
数据存储保存读数、规则和告警记录哪些模块读写哪些数据
监控页面展示读数、设备状态和告警记录展示状态不等于已经处理故障

同一层尽量保持相近粒度。不要把“整个业务平台”“登录按钮”和“数据库服务器”并列成三个模块。若需要解释某个模块内部细节,可在旁边单独展开子图,并保留与总图一致的名称。

(3)连接组件:箭头上写传递的内容

先画主关系:采集设备→数据接入,标注“温度读数”;数据接入→规则判断,标注“已识别设备的有效记录”;规则判断→告警通知,标注“超限事件”;告警通知→外部通知渠道,标注“通知请求”。监控页面从哪里读取状态,也应画清楚。

连线前问自己:两端是否真的存在直接交互?如果监控页面通过查询服务读取数据,就不要为了省一个框,画成浏览器直接连接数据库。双向箭头也不应默认使用;请求与响应信息不同且对讨论重要时,可以分别标明。

(4)添加文本说明:补充连接无法表达的约束

给图加标题、边界说明和简短图例。对容易误解的模块补一句职责,例如“规则判断只产生告警事件,不直接控制制冷设备”。接口协议、数据更新频率、异常数据处理等尚未确定的内容,可列在画布旁的待确认清单中,安排负责人确认后再更新图。

系统框图需要说明结构,并不承担全部接口文档的工作。字段、错误码和权限规则可以放在配套说明中,用模块名称或编号与图建立对应关系。

(5)调整布局:按阅读顺序减少交叉

可以从左到右排列采集、处理、通知,把共享存储放在下方,把外部服务放在系统边界外。用对齐和等间距排列减少视觉噪声;模块颜色主要用于区分类别,不必每个模块使用一种颜色。

如果一根连线跨越多个区域,先检查模块分组是否合理,再考虑折线绕行。不要让连线穿过模块文字,也不要把箭头终点放在边框外一段距离处,造成关系悬空。

(6)检查错误:从输入、职责和故障三个角度走读

  • 沿一条数据走一遍:一条温度读数从哪里进入,经过哪些模块,最后在哪里展示或保存?缺失路径要补全。
  • 逐框核对职责:是否有两个模块负责同一判断,或有一项关键工作没有模块承担?检查名称与实际职责是否一致。
  • 检查重要失败情形:设备断连、数据不完整、通知失败时,由哪个模块发现并记录?框图不必展开所有故障步骤,但应能指出责任所在。

请相关人员按同一条输入共同走读,比单纯问“这张图对不对”更容易发现问题。完成后可分享白板供团队核对;需要交付静态文件时,在当前导出面板确认可用格式,并检查文字和箭头是否清晰。

Boardmix 中的简单 Web 系统架构,前端接口与后端控制、服务和数据层建立连接
Web 架构图展示了另一种分层方式;它的模块名称和关系应按实际系统调整。

打开简单 Web 系统架构模板,可以练习核对“界面请求经过哪些层、在哪一层访问数据”。模板中的连接不是对所有 Web 系统都适用的固定方案。

3. 系统框图模板怎么选和使用

选择模板看的是结构是否适合,而不只是行业名称相近。下面几种模板分别强调业务分层、知识处理、跨主体协同与技术架构。打开社区模板后,先确认内容、使用入口和适用条件,再替换为自己的模块与关系。

营销系统:适合梳理数据接入与业务能力

营销系统设计框图,区分数据接入、接口网关、业务服务、数据处理与存储

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

知识图谱系统:适合表达处理层次

知识图谱系统技术框图,按知识获取、图谱化、知识计算和应用分层

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

冷链系统:适合先画清跨主体边界

冷链供应链系统框图,连接监控中心、仓储、运输、企业及监管和查询主体

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

分层技术架构:适合区分业务与运行支撑

分层系统架构模板,区分展示、网关、业务、数据、运行支撑及运行环境

分层系统架构模板可以帮助区分业务模块和支撑组件。图中的数据库、容器或服务器只是模板内容,应以实际技术选择为准;没有确认使用的组件,不应作为已部署事实写进交付图。

最终交付前,让第一次看到图的人回答三个问题:系统边界在哪里、各模块各自负责什么、主要信息怎样流动。回答不出来,就继续调整模块命名和连线标签。打开 Boardmix 绘制系统框图,先把一个清楚的小范围画对,再按需要展开细节。

把想法整理成图,让讨论有据可依

用 Boardmix 梳理思路、绘制图表,与团队共同完善。

打开 Boardmix 白板 浏览模板