2.2 KiB
2.2 KiB
【后端·需前端配合】司机软删联动作废其未消费续签 token + 续签「核对档案」需补「查不到档案」分支（PR #3868 / 工单 #3867）
端：后端行为修复 + 前端需配合（H5 续签核对档案步）| 服务：hl-fleet-service | PR #3868 已合并 dev-v3 + 部署实测 | 2026-06-16
⚠️ 关键说明
修复「续签时查不到上赛季档案，却仍能进入下一步」。根因：续签 token 的目标司机被软删后，H5 init 的 getRenewPrefill 返 null（prefill 为空），但 token 仍 tokenValid=true、无任何「档案缺失」信号。
后端已做（行为变更）
司机被软删时（DriverService.delete），h5 域新增监听器联动作废该司机所有未消费的续签 token（mode=renew 且非 approved 非 voided）。作废后：
- H5
init对该 token 返回tokenState=voided - H5 提交/校验（
validateToken）抛LINK_VOIDED（码 600304）
即：目标司机档案没了，续签链接自动失效。
前端需配合（mmg）
- 现有失效处理已可兜底：续签 token 被作废后 init 返
tokenState=voided，前端现有的失效链接处理会直接拦住「下一步」——这部分无需新增代码，只要确认续签流程也走 tokenState 失效判断即可。 - 建议补「未查询到档案」友好分支（可选增强）：续签「核对档案」步当前写死「档案已由系统从上赛季自动同步」。建议增加判断——当 init 返回的续签预填
prefill为空/缺失时，不显示「已同步」，改提示「未查询到您的档案，请联系车管重新生成链接」并禁用「下一步」，比通用「链接失效」更友好。
注：原型
page_pending_h5.jsx续签「核对档案」步目前只有「已同步」单一状态，请一并在原型与真实 H5 补「档案缺失」分支。
验证（测试服 2026-06-16）
fleet 双实例 8087/8187 全新重启，Started 干净无 APPLICATION FAILED
27 单测全绿（作废/空操作/幂等/WrapperX 条件/监听器吞异常）；CR CLEAN
域解耦：h5 监听器只操作 fleet_driver_pending，不碰 driver Mapper