我是刘天成,一名后端开发工程师,平时主要写业务接口。公司要给设备科做一套巡检登记工具,我从后端视角记录一下这次用低代码方式搭建的过程,重点讲表结构设计,因为这是整套东西的地基。
一、需求背景与方案取舍
1.1 巡检业务的现状
我们厂区有三百多台设备,设备科每天安排人按线路巡检。原来的记录方式是纸质表格,巡检员打勾签字,月底由统计员录入汇总。问题很多:字迹潦草认不清、漏检没法追、数据滞后一个月才见光。
设备科提的核心诉求有三个。巡检点位电子化,到点扫码登记。异常项拍照上报,维修工单能自动流转。月底统计自动化,不再人工录入。诉求不复杂,但按传统开发方式排期,前后端加联调至少一个月。
1.2 为什么这次选了低代码
作为写代码的人,我对低代码一直有保留意见,总觉得灵活性不够。但这次评估后态度变了:巡检本质上是标准表单加简单流转,没有复杂算法,没有高并发,为这类需求写一套完整的后端服务性价比很低。
团队里的判断是:能沉淀成配置的东西就不要写死在代码里。巡检点位、检查项、异常类型,这些业务规则半年就会变一次,写进代码里每次都要发版。放在配置化的表结构里,设备科自己就能维护。
1.3 先画数据流再动手
动手前我把整条数据流画在白板上:巡检计划生成任务,任务下发到人,人扫码填结果,异常生成工单,工单闭环回流统计。五个环节对应五组数据实体,谁先谁后一目了然。
这一步比写任何代码都重要。低代码平台让人很容易上手拖表单,但表之间的关联关系如果不提前想清楚,做到一半返工是常态。我们初版设计就因为漏了班次维度返工过一次,后面细说。
二、表结构设计:整个项目的地基
2.1 实体梳理
拆下来一共六张核心表。设备台账是主数据;巡检点位定义检查项;巡检计划定义频次和人员;巡检任务按计划生成;巡检记录是每次填写的明细;维修工单承接异常流转。下面是简化的结构说明:
device_asset 设备台账
id, code, name, area, status, qr_token
inspect_point 巡检点位
id, asset_id -> device_asset, item_name,
check_type(enum: bool/range/text), upper_limit, lower_limit
inspect_plan 巡检计划
id, name, route_ids(json), freq(daily/weekly),
shift(morning/night), inspector_role
inspect_task 巡检任务(按计划+日期生成)
id, plan_id -> inspect_plan, task_date, shift,
status(pending/done/missed), done_at
inspect_record 巡检记录明细
id, task_id -> inspect_task, point_id -> inspect_point,
value_text, value_num, is_abnormal, photos(json), note
repair_order 维修工单
id, record_id -> inspect_record, severity,
handler, status(open/fixing/closed), closed_at
设计上有两个要点。点位表用 check_type 区分检查项类型,布尔型打勾、区间型填数值、文本型写描述,一张表管三类检查项,不用拆三张。记录表冗余了 is_abnormal 标记,统计异常率时直接聚合这一列,不用每次运行时再判断。
2.2 关联与反范式的小权衡
标准三范式的做法,巡检记录只存点位 ID,设备信息通过点位关联查出来。但巡检记录是全系统写入量很大的一张表,一天几百条,月度报表如果要联三层表查设备区域,聚合就慢了。
我做的取舍是在记录表里冗余 asset_code 和 area 两个字段。写入时多填两列,查询时省两层关联。台账数据基本不变,冗余的失真风险很小。这种反范式操作在低代码平台上尤其值得做,因为平台的聚合查询能力通常比裸 SQL 弱,少一层关联就少一分性能焦虑。
2.3 漏掉班次维度的返工
初版计划表没有班次字段,任务按天生成。上线试跑就被设备科打回来了:夜班巡检和白班巡检是两条线路、两拨人,按天生成任务等于把两件事混成一件,谁做了谁没做说不清。
返工动作不大但很伤。计划表加 shift 字段,任务生成逻辑从每天一条改成每班一条,历史数据补了一遍。这次返工让我更确信:表结构评审要把业务方拉进来,开发自己觉得维度够了不算数,夜班师傅一句话就能顶半天推演。
2.4 扫码与防作弊设计
每个点位生成一张二维码贴在现场,码里带 qr_token,与点位绑定。巡检员扫码后表单自动带出点位和检查项,理论上到点才能填。但纯扫码挡不住拍照远程扫,所以我们加了定位字段,提交时记录坐标,报表里筛出坐标明显偏离的记录人工复核。
没有做强制围栏拦截,是权衡后的决定。厂区有钢结构车间信号漂移大,硬拦截会误伤正常巡检。定位偏移只做标记不做阻断,既留了稽核线索,又不影响一线体验。防作弊做到够用就好,做绝了系统会被一线想办法绕过去。
三、流程与界面的配置要点
3.1 任务自动生成的实现
巡检任务不靠人手动建。用平台的定时触发能力,每天凌晨按生效计划批量生成当天的任务记录,白班夜班各一套。生成的任务挂在巡检员角色名下,打开小程序就能看到自己的待办。
漏检的判定也在这时候做:过了巡检时间窗还有未完成的任务,状态自动改成 missed,月底统计漏检率直接聚合任务表。把"漏检"变成一个显式状态而不是靠人翻记录,是这套设计里我自己比较满意的一点,后来团队内部复盘时也把它当成可复用的设计模式。
3.2 异常自动转工单
巡检记录保存时触发一个动作:is_abnormal 为真的记录自动创建维修工单,严重程度从检查项配置里带过来。工单指派给维修角色,处理完填处理结果,闭环时间自动算出来。
配置时有个细节容易漏:同一点位连续异常会天天生成新工单,维修还没跟上工单先堆成山。我们加了一条去重规则,同一点位存在未闭环工单时只追加记录不重复开单。这条规则是试运行一周后补上的,教训是流转逻辑一定要想"重复发生怎么办"。
3.3 移动端界面的克制
界面只做了三个页:我的任务、扫码填报、异常上报。检查项用大按钮和大输入框,巡检员很多戴手套操作,按钮小了点不准。填完一页自动跳下一个点位,减少手动切页。
配色和花活全部从简。设备科提过要加企业门户风格的首页,被我们劝住了,工具类应用打开就该直奔待办,装饰性页面只会增加加载时间和学习成本。
3.4 权限与角色的划分
权限拆成四个角色:巡检员只能看自己名下的任务和填报;维修工只看工单模块;设备科管理员能维护台账、点位和计划;统计员只读全部数据。台账维护和填报权限严格分开,避免巡检员顺手改了点位配置,把异常拖成正常。
角色设计有个原则:权限跟着岗位职责走,而不是跟人走。人员调动时只改角色归属,不用逐项改权限。试运行期间有一次人员借调,五分钟就完成了权限交接,这在自研系统里往往要改库表。
四、试运行与数据校验
4.1 双轨并行两周
上线前双轨跑了两周,纸质表和系统同时记录,事后对数。头一周对出了十一条差异,全是纸质漏记而系统有记录的情况,说明电子化反而把以前漏检的水分挤出来了。到了双轨后一周,差异归零,纸质流程停掉。
双轨那两周还观察到一个现象:巡检员对拍照上传的接受度比预想高,反而对在表单里打字描述很抵触。我们就把文本描述改成常用短语快选,不选也能提交。小改动很多,但每一个都是从一线反馈里长出来的,坐在会议室里设计不出来。
4.2 统计口径的校对
月底统计报表上线前,我拿人工录入的历史数据做了交叉校验。设备完好率、漏检率、工单闭环时长三个指标,系统口径和人工口径各算一遍,对不上的一处处解释。有一个差异来自时间窗定义:人工统计把夜班算进前一天,系统按自然日切,最后统一改成按班次日切。指标口径这种事,不校对一定埋雷。
五、复盘与一点后端视角的感想
整套东西从建表到上线用了九个工作日,其中表结构设计花掉三天。如果走传统开发,光搭框架写接口就不止这个数。后来统计能力上有新诉求,我们又把这套表结构原样搬进了搭贝继续迭代,导入导出配置文件即可,说明当初把业务规则尽量放进数据结构而不是页面逻辑的决定是对的。
写代码的人转型做低代码,最容易犯的错是把平台当IDE用,什么逻辑都想挂事件脚本。我的体会是反过来:能用表结构表达的就别用脚本,能用配置表达的就别写逻辑。数据模型稳住了,上面的流程和页面怎么改都不伤筋动骨。工具在变,建模能力永远是后端的基本功。