用 ArkTS 写一个报修派单系统:工单状态机、派单与现场核销
用 ArkTS 写一个报修派单系统:工单状态机、派单与现场核销
为什么选报修派单
数独考的是本地状态,待办清单考的是本地与云端同步,员工签到考的是时间地点怎么变成一条可信记录,云相册考的是大文件怎么上云。报修派单考的是另一块——一条工单在多个人手里流转时,状态怎么不乱。
报修这件事本身很日常:住户发现水管漏了,拍张照、写两句、提交;物业接单,派给维修师傅;师傅上门修好,住户确认,工单才算结案。流程看着简单,但状态一多就容易出问题:同一张单被两个人同时接了、修完了没人确认、退回之后不知道该找谁。写这个 App,核心就是把流转规则先定死,再写界面。
我这次的参考是鸿蒙开发实践中心里的报修派单系统案例,11 月 4 日已经给它的代码仓点过 Star。案例本身带代码仓,跟着它的结构走一遍,比从零凭空写要稳:先看它怎么分层,再自己动手写一遍核心逻辑。
工单只有一张状态表,不要到处散落
报修派单的第一件事,是给工单定一张唯一的状态表:待派单、已派单、处理中、待确认、已完成、已退回。所有状态变化只能走这张表,不允许界面上随手改一个字段就跳状态。
这个取舍和前面几篇是一脉相承的。状态只留一份,放在 ViewModel 或者组件的 @State 里,界面用 ForEach 把工单数组画出来。增删改只改数组,界面刷新交给框架。状态转移写成一个单独的函数,入参是当前状态和要做的动作,出参是下一个状态或者拒绝——非法转移直接拒绝并给提示,不要静默地跳过去。比如“待派单”的单不能直接点“已完成”,必须先派单、再处理、再确认。
新手容易把“当前在看哪张单”“筛选了哪个状态”写进工单数据里,结果一切换筛选、一切换页面就全乱了——浏览位置和筛选条件是界面的属性,不是工单的属性,工单只负责存自己的状态和时间。
派单:先抢单还是先指派,要先定规则
派单有两种常见做法:管理员指派给指定师傅,或者师傅在列表里抢单。两种做法各有各的坑,指派要防管理员把单派给已经满负荷的人,抢单要防两个人同时抢到同一张单。
我的做法是把派单也当成一次状态转移来处理:只有“待派单”的单能被派,派单成功的那一刻,状态立刻变成“已派单”,并写上接单人、派单时间和派单人。抢单时先查状态再改状态,改之前状态已经变了的,后到的那次直接拒绝、提示“已被接单”。不要先在界面上把单标记成“我的”,再慢慢去改后台——界面先改、后台后改,中间那段时间就是两个人同时抢到的窗口。
派单还要留一个退回口子。师傅到了现场发现修不了——缺配件、问题不在自己负责的范围——要能把单退回“待派单”,并写清楚退回原因。退回不是删除,退回记录要留着,管理员下次派单才能避开同样的坑。没有退回原因的退回,等于把问题推回给下一个人。
现场核销:照片、时间与确认,三者缺一不可
师傅修完,工单不能自己说了算。要结案,需要三样东西对上:维修前后的照片、处理时间、住户的确认。照片证明确实去了现场、确实动了手;时间证明处理没有拖太久;住户确认证明问题真的解决了。
照片上传沿用云相册那篇的做法:先传缩略图和元数据,让工单立刻出现维修记录,再在后台慢慢传原图;只在 Wi-Fi 下自动传原图,移动网络下只传缩略图。维修照片是证据,不要等到有空再补拍,补拍的照片证明不了当时修了什么。
确认也要本地先行:住户点“确认完成”,界面立刻变、本地立刻落盘,不要等网络回来再确认。本地存的每一条记录,最好带一个“最后修改时间”和一个“是否已同步”的标记。这两个字段界面上看不见,却是后面同步的全部依据。没有它们,同步时根本分不清哪张单已经确认过了。
还有一个容易踩的坑:不要用工单标题或者住户姓名当唯一键。同一栋楼可能有两户同时报“水管漏水”,标题一撞就互相覆盖。用“提交时间 + 提交人标识”拼一个唯一键,或者直接用服务端返回的 ID,重复提交直接返回已有记录,不要重复落盘。
两个实操坑
其一,时间要用同一口径。手机系统时间可以被用户手动改,拿本地时间当报修时间,改一下手机时间,工单的排序和超时统计就全乱了。报修时间以服务端返回的时间为准,本地只负责记录“这条记录是什么时候提交的”。超时统计不要在界面上现算,单独算一个派生结果给界面用,原数组只负责存数据。
其二,列表不要一次全量拉。工单攒到几百张,一次拉全量元数据,首屏要等很久。第一次同步拉全量元数据,之后只拉增量;照片和附件永远按需拉。同步的单位是“自上次同步以来变了什么”,不是“全部重新来一遍”。筛选和搜索也一样,先在本地已同步的数据里筛,筛不到再去服务端查,不要每次换个筛选条件就全量请求一次。
收尾
报修派单系统的核心就三件事:一个“待派单到已完成”的状态机、一个“先查状态再改状态”的派单口径、一个“照片 + 时间 + 住户确认”的核销口径。把这三件事写对,剩下的统计、评价、催单都只是数据的呈现。
- 点赞
- 收藏
- 关注作者
评论(0)