SpringBoot家政派单系统实践:订单流转、签到验收与评价闭环
一、方案概述与业务痛点
家政上门服务和普通线上商品订单差异明显,整个流程依赖线下履约动作,包含用户下单、平台派单、技师上门签到、服务验收、用户评价等环节。早期直接使用大量if-else判断订单状态,代码耦合严重,容易出现非法状态跳转;签到缺少地理位置校验,存在虚假打卡;评价入口不受订单状态约束,未完成订单也可以提交评价,无法形成可信的服务闭环。
本文基于SpringBoot搭建轻量派单系统,采用事件驱动的状态机管控订单流转,落地LBS签到校验、完工验收、评价联动整套能力,打通履约全流程。
二、订单状态流转模型设计
订单状态流转以事件驱动,不允许直接修改状态字段。订单核心状态:待支付、待派单、技师已接单、技师出发、上门签到、服务进行中、待用户验收、待评价、已完结、已取消、售后中。
正向链路:下单支付成功→待派单→派单推送→技师接单→技师出发→上门签到→服务执行→提交完工→用户验收→开放评价入口→评价完成,订单完结。
异常分支:待支付超时自动取消、技师拒单重回派单池、验收不通过转入售后工单、评价后产生售后申诉。
每一次状态变更,同步写入订单流水表,记录订单号、操作事件、前后状态、操作人、时间戳,用于问题追溯。
三、签到与验收模块实现
签到环节是履约真实性的核心控制点,使用Redis GEO计算经纬度距离,设置允许的误差半径,技师上报位置与服务地址超出阈值时,拦截签到请求。完工提交时,强制上传服务凭证图片,图片存入对象存储,和订单ID关联保存。验收分为自动验收和手动验收,超时未操作自动确认完工,同时开放评价入口。
下面是签到距离校验的Java代码示例:
@Service
public class SignCheckService {
@Autowired
private RedisTemplate<String, Object> redisTemplate;
/**
* LBS签到距离校验
* @param orderLng 订单地址经度
* @param orderLat 订单地址纬度
* @param techLng 技师上报经度
* @param techLat 技师上报纬度
* @param radius 允许半径,单位米
* @return true校验通过
*/
public boolean checkSignDistance(Double orderLng, Double orderLat, Double techLng, Double techLat, long radius) {
GeoOperations<String, Object> geoOps = redisTemplate.opsForGeo();
String key = "geo:order:";
geoOps.add(key, new Point(orderLng, orderLat), "address");
Distance distance = geoOps.distance(key, "address", new Point(techLng, techLat), Metrics.METERS);
// 清理临时geo数据
redisTemplate.delete(key);
if(distance == null){
return false;
}
return distance.getValue() <= radius;
}
}
签到校验通过后,才允许技师进入服务中状态,提交完工申请。
四、评价闭环模块设计
评价不能独立于订单存在,只有订单流转到【待评价】状态,用户端才展示评价入口。评价信息包含星级、文字描述、图片凭证,评价数据会回写到技师档案,更新技师平均分与评价总数,作为后续派单权重因子。
差评支持平台后台回复,评价提交后订单状态变更为已完结;如果评价后用户发起售后,单独生成售后工单,售后流程独立流转,不修改原有评价记录。
评价表增加唯一订单索引,限制一单只能评价一次,防止重复刷评。
五、并发控制与消息通知优化
订单状态更新使用数据库行锁,防止多端同时操作引发状态错乱;派单匹配结果做短期缓存,减少重复计算。订单节点变更使用MQ异步推送订阅消息,通知用户和技师,避免同步通知拖慢主流程。WebSocket用于技师端实时接收订单推送,降低轮询带来的服务器压力。
定时任务监听超时事件,包含待支付超时取消、待派单超时告警、验收超时自动确认。
六、上线问题与优化方向
上线后发现两个典型问题:一是地理位置受GPS信号影响,部分老旧小区定位漂移,后续增加人工复核入口,运营可以后台放行签到;二是评价权重直接参与派单,短期差评会严重影响技师接单,后续增加平滑算法,使用近30天滚动评分,降低单次差评的影响。
监控侧增加异常告警,包含签到校验失败、订单长时间无人接单、差评数量突增等事件,及时通知运营介入。
总结
基于SpringBoot实现家政派单系统,核心是把订单流转、线下签到、验收、评价串联成完整闭环。状态机统一管控订单状态,解决了状态跳转混乱的问题;LBS签到校验保证上门履约真实可信;评价和订单状态强绑定,评价数据反哺派单策略,形成正向循环。
这套方案不需要引入重型框架,中小同城家政平台可以低成本落地,模块之间职责隔离,后续扩展加价项、次卡套餐、多门店模式时,只需要在原有状态机上增加事件分支,改动范围可控。同时流水日志、评价记录、签到凭证留存,也是处理客诉、纠纷的重要数据依据。