2026.04.12 · 设计 · 约 7 分钟
五种状态,怎么变成一张能追责的工单
做寝修宝之前,我以为报修系统的核心是那张提交表单。跟宿管聊完才发现不是—— 核心是「这张单子现在归谁、下一步谁能动」。表单只是一次输入,状态才是骨架。 这篇讲我怎么把一堆口头规矩收敛成五个状态、四条规则,以及为什么判断必须写在服务端。
单子是怎么丢的
我宿舍水龙头漏了两周。问宿管,她说「报了呀,可能在排队」;问维修师傅,他说「没看到这个单子」。 两句话都不假,但单子在中间消失了。第二天我蹲了半天值班室,记下四件事:
- 报修走微信群,消息几小时就被刷走,宿管靠翻聊天记录找
- 宿管拿纸质本子登记,字迹和楼号经常对不上
- 维修师傅一天来抄一次单子,当天报的基本修不上
- 学生唯一能做的就是再问一遍
对应四个问题:信息不完整、责任不清晰、进度不透明、数据难统计。 前两个靠结构化表单能解决,后两个只能靠状态流转。
状态不是功能清单,是责任清单
一开始我想做成「谁都能改状态」,宿管立刻否了。她需要知道这单是不是经她派的, 师傅需要知道这单是不是派给自己的。所以每个状态真正回答的问题是: 现在轮到谁。
学生提交
│
▼
[ 0 待处理 ] ── 学生取消(仅此状态)──▶ [ 4 已取消 ] · 终态
│
│ 维修工接单 / 宿管指派
▼
[ 1 处理中 ]
│
│ 填写处理备注并完工
▼
[ 2 已完成 ]
│
│ 学生评分 + 文字评价
▼
[ 3 已评价 ] · 终态
旁路:催单不改变状态,只在 0 / 1 阶段累加 urge_count
状态用 TINYINT 存 0–4,不用字符串。省空间只是次要的,
主要是判断「是不是管理类角色」时可以直接写 role >= 1,不用维护一张枚举表。
四条规则
1. 正向流转,每一步换一个人
0→1 由维修工接单或宿管指派触发;1→2 必须填了处理备注才能完工; 2→3 只能由提交者本人评价。每一步都对应一个具体的人,不是「管理员随便改」。
2. 取消只有一条路
只有「待处理」能取消。师傅一旦接单、投入了工时,就不允许学生单方面终止。 这条不是我拍脑袋定的,是宿管提的:以前纸质本子上有学生上午报、中午自己修好了, 师傅白跑一趟。规则不是技术限制,是业务流程的翻译。
3. 终态冻结,但数据不删
已评价(3)和已取消(4)不再接受任何变更。为什么不用删除来做「结束」?
因为后面要算平均接单时长、返修率,都得靠这些记录。
所以终态只是冻结,对终态工单发任何变更请求,统一返回 400。
4. 催单是旁路,不是状态
这是我最初设计错的地方——我本来想加一个「已催单」状态。 后来发现不对:状态描述的是「这单走到哪一步」,催单描述的是「急不急」, 两件事不在一个维度上。硬塞进状态机的话,一个「处理中、且被催了三次」的单子该怎么表示?
所以催单只做一件事:urge_count += 1,不改状态。
它可以在待处理和处理中反复执行,师傅在列表里看到次数就知道轻重。
一个字段能表达的东西,不要再加一个状态。
最关键的一行判断
前端会按角色隐藏按钮,这只解决好不好用。真正拦人的地方在服务端—— 隐藏按钮拦不住任何人打开控制台直接构造请求。
# 维修工接单:状态 0 -> 1,记录处理人与接单时间 @order_bp.route('/start/<int:order_id>', methods=['POST']) def start_order(order_id): order = db.session.get(RepairOrder, order_id) if order is None: return jsonify(code=404, msg='工单不存在', data=None) # 关键:不信任前端传来的状态,只认库里的 status if order.status != 0: return jsonify(code=400, msg='该工单已被接单或已取消', data=None) payload = request.get_json(silent=True) or {} order.status = 1 order.handler_name = payload.get('handler_name') or '维修师傅' order.start_time = datetime.now() db.session.commit() return jsonify(code=200, msg='已接单', data=order.to_dict())
这段代码里没有任何一行信任客户端传来的 status。
前端说「这单还是待处理」不算数,从数据库读出来的才算。
对一张已完成的工单再调一次,返回的是 400,而不是把状态改回 1。
状态机不是画给答辩看的那张图,它是「谁能做什么」的唯一真相来源。 图会过时,代码里那行判断不会。
状态机的边界,是用例固定住的
25 条用例覆盖账号、报修、管理、统计、送水五个域。正常流程大多一次就过, 真正容易漏的是异常分支:空字段提交、超长描述、重复提交、 以学生身份请求别人的工单详情、对已完成工单重复接单。
这几条的价值不在「证明它能用」,而在「证明它不能乱用」。 接口写完之后我自己手动点,永远只会走正常路径; 只有把「不该成功的情况」也写成用例,状态机的边界才算真的固定下来。
学到了什么
以前我以为状态机是「文档里画一下」的东西。做完才明白,
它的价值在于把模糊的口头规则逼成可执行的判断——
「师傅接单后学生不能取消」这种话,写在需求里没人会反对;
写成 if order.status != 0: return 400 之后,它才真的会发生。