diff --git a/changelogs-v2/2026-06/16_3867_续签司机软删联动作废token-前端需配合.md b/changelogs-v2/2026-06/16_3867_续签司机软删联动作废token-前端需配合.md new file mode 100644 index 0000000..e65b1d6 --- /dev/null +++ b/changelogs-v2/2026-06/16_3867_续签司机软删联动作废token-前端需配合.md @@ -0,0 +1,31 @@ +# 【后端·需前端配合】司机软删联动作废其未消费续签 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) + +1. **现有失效处理已可兜底**:续签 token 被作废后 init 返 `tokenState=voided`,前端**现有的失效链接处理**会直接拦住「下一步」——这部分**无需新增代码**,只要确认续签流程也走 tokenState 失效判断即可。 +2. **建议补「未查询到档案」友好分支**(可选增强):续签「核对档案」步当前写死「档案已由系统从上赛季自动同步」。建议增加判断——当 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 +```