4.9 KiB
4.9 KiB
schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base, generated
| schema | ticket | title | consumer | author | change_type | backend_status | gateway_status | frontend_status | frontend_owner | frontend_ref | target_release | verified_at | status_note | updated_at | base | generated |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hl-changelog/v2 | 5596 | 派单预校验增加驾照/年检/车辆保险到期强提醒(不拦截,车务人工判断) | admin | wx(GIT) | 修改接口 | deployed | verified | verified | hl-ui | hl-admin@572d25e64b5d5ed2cb325dcbb377978c425d4f1e | 2026-08-07 协调台实测:派车选车页对司机显示「无保险」「全年保险不覆盖本行程」「常驻司机已拉黑」等预校验警告(驾照/年检/保险提醒生效),标 verified。 | 2026-08-07 | dev-v3 | 2026-08-06T18:30:00+08:00 |
派单预校验增加驾照/年检/车辆保险到期强提醒(不拦截)
后端完成:PR #5617 已合并 dev-v3 并部署 TEST,网关验证通过。
关联 / 联系人
链接
联系人
- 后端负责人: @wx
背景
协调台实测:司机王信驾照 2022-02-05 已过期 4 年,但派单 precheck 无驾照到期校验——仅提示档期冲突/跨常驻,过期司机仍可正常派单(安全合规隐患)。
口径(wx 定):驾照/证件到期不拦截,强提醒即可——车务人工判断是否派单。
变更接口
POST /admin/fleet/assignments/precheck(修改响应)
warnings 数组新增 3 个非阻断强提醒类型(只进 warnings、不影响 conflict 阻断判定):
| type | 触发条件 | 文案示例 |
|---|---|---|
license_expired |
司机驾照到期日早于本单服务结束日 | 司机驾照已于 2022-02-05 过期(本单服务期间证件失效),请人工确认是否派单 |
veh_inspect_expired |
车辆年检(行驶证)到期日早于本单服务结束日 | 车辆年检已于 2025-01-01 过期(本单服务期间证件失效),请人工确认是否派单 |
veh_insure_expired |
车辆保险到期日早于本单服务结束日 | 车辆保险已于 2025-06-01 过期(本单服务期间无保险保障),请人工确认是否派单 |
判定基准取服务结束日(行程期间任一天证件失效都提醒),无结束日回退开始日;证件到期日为空不提示。
POST /admin/fleet/assignments/candidates(修改响应)
drivers.records[](司机候选)新增字段:
| 字段 | 类型 | 说明 |
|---|---|---|
licenseExpire |
string(date) | 驾照到期日;未填为空 |
licenseExpired |
boolean | 驾照是否已过期(相对请求服务日期;候选页醒目提示用) |
licenseExpiredMessage |
string | 醒目提示文案,如「司机驾照已于 2022-02-05 过期,请人工确认」;未过期为空 |
行为变化
- 过期司机派单不再无感放行:precheck 对驾照/年检/保险过期的车、司机给出强提醒 warning,弹窗醒目展示「驾照已过期」,但不拦截——车务人工判断是否派单
- 候选页醒目提示:司机候选列表直接透出
licenseExpired标记与文案,前端可标红「驾照已过期」 - 不改变既有阻断逻辑:证件到期不影响
conflict/conflicts,档期冲突、资源不可用、跨常驻等既有判定不变 - 写接口(create/change)不新增拦截,与口径一致(人说的算)
前端/调用方动作
- 派单弹窗(precheck):warnings 出现
license_expired/veh_inspect_expired/veh_insure_expired时醒目展示(红色警示样式),确认后仍可正常提交派单 - 候选页:司机候选
licenseExpired=true时展示「驾照已过期」醒目标签(可用licenseExpiredMessage直接展示),不限制选择
验证证据
- 定向测试 572 项全绿:AssignmentServiceTest 378(新增 2 例:过期证件强提醒不阻断 conflict=false、证件未过期无提示)、AssignmentCandidateServiceTest 47(新增 2 例:候选驾照过期标记与文案、有效驾照不标记)、DriverServiceTest 147
- fleet 全量 verify 3203 项,仅 ReleaseEMixedBinaryHarnessTest 2 个 Windows 进程时序用例 flaky 失败(单独重跑 23/23 全绿、干净基线同样全绿、失败用例每次不同=并行负载竞争,与本次改动无关);MySQL 8.0.33 集成 12/12 单独复跑全绿;spotless 通过
- 网关验证(TEST,18:10 部署后):① precheck 过期司机王信+有效车 → HTTP 200、conflict=false(不阻断)、warnings 含
license_expired「司机驾照已于 2022-02-05 过期(本单服务期间证件失效),请人工确认是否派单」;② 对照有效驾照司机 → 无任何证件到期提醒;③ 候选接口王信licenseExpired=true、licenseExpiredMessage「司机驾照已于 2022-02-05 过期,请人工确认」;共 10/10 通过