一套可以直接落地的「设备报修 / 维修工单」数据结构:7 张表、22 个工单字段、状态机、SLA 规则,附带一个可复现的演示数据生成器。
用于低代码平台(简道云 / 宜搭 / 明道云 / 氚云)搭建同类应用时,作为字段口径的参考;也可以直接作为 MySQL 库结构落地。
node gen-data.js # 生成 data/devices.csv 与 data/tickets.csv设备报修是低代码里最常被接的一类需求:报修、派工、维修、验收,四个动作。很多人在平台上 3 小时就拖出一个能演示的版本,然后客户用两周就弃用了。
弃用的原因几乎都在这四处:
① 用"订单汇总"的思路算库存/工时 —— 工单状态是可回退的(返修、误报、驳回重开),汇总口径一旦定错,报表永远对不上。正确做法是状态机 + 流转日志,报表只读日志,不读当前状态。
② 让用户手填时间 —— 受理时间、派工时间如果允许手填,SLA 从第一天起就是假的。这些字段必须由动作触发写入,界面上只读。
③ 设备编号允许改 —— 设备编号是所有关联的锚点(工单、备件、保养计划都挂在它上面)。客户一旦"整理台账"时把它改掉,历史工单全部断链,而这种破坏在界面上看不出来。
④ 状态值不够用 —— 只有"待处理/处理中/已完成"三个状态,一线就会把"设备本来就没坏"(误报)和"客户自己修了不用来"(不修)都登记成"已完成"。三个月后这张表的数据就废了。
┌──────────── 驳回重开 ────────────┐
▼ │
报修 ──▶ 待受理 ──受理──▶ 待派工 ──派工──▶ 处理中 ──完工──▶ 待验收 ──▶ 已完工
│ │ │ │
└──误报──────────┴────────────────┴──────▶ 误报 / 不修
七个状态,一个都不能少:
| 状态 | 含义 | 谁能改 |
|---|---|---|
pending_accept 待受理 |
已提交,无人认领 | 系统按班组自动分配 |
pending_dispatch 待派工 |
已确认是故障,等派活 | 受理人 |
processing 处理中 |
维修工已到场 | 维修工 |
pending_check 待验收 |
修完等确认 | 维修工 |
done 已完工 |
验收通过 | 验收人 |
false_alarm 误报 |
现场核查未见故障 | 维修工 + 审核 |
rejected 不修 |
判定不修(设备报废/成本过高) | 主管 |
false_alarm 和 rejected 必须存在。没有它们,一线会把这两类登记成"已完成",返修率和故障率从此都不准。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 报修单号 | 自动编号 | 是 | BX- + 年份 + 三位流水 |
| 报修时间 | 时间 | 是 | 提交时写入,不可手填 |
| 报修来源 | 下拉 | 是 | 扫码 / 电话 / 微信 / 巡检 |
| 设备编号 | 关联设备 | 是 | 关联字段,不是文本 |
| 设备名称 | 引用 | — | 随设备编号自动带出,只读 |
| 故障分类 | 下拉 | 是 | 电气 / 机械 / 液压气动 / 温度 / 异响 / 控制 / 其他 |
| 紧急度 | 下拉 | 是 | 低 / 一般 / 高(决定 SLA) |
| 故障描述 | 多行文本 | 是 | 限 500 字 |
| 报修人 | 关联人员 | 是 | 当前登录人默认带出 |
| 受理时间 | 时间 | — | 点「受理」时自动化写入 |
| 受理人 | 关联人员 | — | 同上 |
| 派工时间 | 时间 | — | 点「派工」时写入 |
| 维修工 | 关联人员 | — | 派工时选择 |
| 预计完工 | 时间 | — | 按 SLA 自动算,不手填 |
| 实际完工 | 时间 | — | 点「完工」时写入 |
| 处理结果 | 多行文本 | — | 完工必填 |
| 状态 | 下拉 | 是 | 由动作推进,不提供直接编辑 |
| 更换备件 | 子表 | — | 一行一个备件,不写进文本 |
| 备件金额 | 公式 | — | 子表汇总,DECIMAL 不用 FLOAT |
| 验收人 | 关联人员 | — | 仅待验收状态可填 |
| 满意度评分 | 数字 1–5 | — | 仅已完工可填 |
| 是否返修 | 布尔 | 是 | 默认否,由"同设备 7 天内二次报修"自动置是 |
完整 DDL(含索引、外键、两个报表视图)见 schema.sql。
gen-data.js 用固定随机种子生成,每次结果一致,可以直接复现:
- 8 台设备,跨 4 个位置(一号车间 / 二号车间 / 仓库 / 配电房)
- 50 张工单,覆盖 2026-09-29 ~ 2026-10-28 整 30 天
分布是刻意排的,因为"每台设备都差不多、状态均匀分布"的假数据,做出来的报表没有任何说服力:
| 维度 | 分布 | 为什么这么排 |
|---|---|---|
| 状态 | 已完工 42 / 待验收 3 / 处理中 2 / 待派工 2 / 误报 1 | 稀疏状态才能演示「待派工池」和「超时预警」 |
| 设备故障数 | 注塑机 A 13 次,空压机 1 号 12 次,其余 1–6 次 | 故意不平均,故障排行才有冲击力 |
| 紧急度 | 仅 18% 为「高」 | 一半是紧急,一眼看出是编的 |
| 返修 | 8% | 全是五星好评会立刻暴露数据是假的 |
必须先建设备台账、先导 devices.csv,再导工单。
工单里的「设备编号」是关联字段,顺序错了会退化成纯文本,后面"点开设备看历史故障"就永远演不出来——而这是客户唯一会觉得"这个系统比微信报修强"的地方。
以简道云 / 宜搭为例,建表顺序:
- 位置 → 人员 → 设备(三个基础表,先建)
- 工单(主表)+ 工单流转日志(子表或独立表)
- 备件 → 工单备件明细
平台侧的四个必配项:
- 设备编号设唯一校验(不是"建议唯一",是强校验)
- 位置、故障分类用下拉,不用文本
- 受理/派工/完工时间用按钮触发写入,字段只读
- 状态用流程引擎推进,不要给用户一个可自由编辑的下拉
schema.sql MySQL DDL,7 张表 + 2 个报表视图
gen-data.js 演示数据生成器(固定种子,可复现)
data/devices.csv 8 台设备
data/tickets.csv 50 张工单,22 列
生成后自带一致性统计,可直接核对:
工单 50 状态分布 {"已完工":42,"待验收":3,"处理中":2,"误报":1,"待派工":2}
设备故障排行 [["注塑机 A",13],["空压机 1 号",12],["包装机",6],...]
MIT