docs(changelog-v2): 司机软删联动作废续签token + 前端需补档案缺失分支 (#3867/PR#3868)

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
+```