Skip to content

About

设备报修工单的字段设计、七态状态机与演示数据,低代码落地参考

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

设备报修工单系统 —— 字段设计与演示数据

一套可以直接落地的「设备报修 / 维修工单」数据结构: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 必须存在。没有它们,一线会把这两类登记成"已完成",返修率和故障率从此都不准。

22 个工单字段

字段 类型 必填 说明
报修单号 自动编号 是 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,再导工单。

工单里的「设备编号」是关联字段,顺序错了会退化成纯文本,后面"点开设备看历史故障"就永远演不出来——而这是客户唯一会觉得"这个系统比微信报修强"的地方。

在低代码平台上落地

以简道云 / 宜搭为例,建表顺序:

  1. 位置 → 人员 → 设备(三个基础表,先建)
  2. 工单(主表)+ 工单流转日志(子表或独立表)
  3. 备件 → 工单备件明细

平台侧的四个必配项:

  • 设备编号设唯一校验(不是"建议唯一",是强校验)
  • 位置、故障分类用下拉,不用文本
  • 受理/派工/完工时间用按钮触发写入,字段只读
  • 状态用流程引擎推进,不要给用户一个可自由编辑的下拉

目录

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],...]

License

MIT

About

设备报修工单的字段设计、七态状态机与演示数据,低代码落地参考

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages