diff --git a/changelogs-v2/2026-06/13_3785_车务排查批量修复11项-新增与修改接口-管理后台与司机H5.md b/changelogs-v2/2026-06/13_3785_车务排查批量修复11项-新增与修改接口-管理后台与司机H5.md new file mode 100644 index 0000000..83eae87 --- /dev/null +++ b/changelogs-v2/2026-06/13_3785_车务排查批量修复11项-新增与修改接口-管理后台与司机H5.md @@ -0,0 +1,22 @@ +# 【新增+修改接口·管理后台+司机H5】车务排查批量修复 11 项——待审详情端点/H5 车型下拉源/列表字段 Label 补齐/续签赛季 bug 修复 + +> 服务:hl-fleet-service(8087/8187) | 分支:dev-v3 | PR:#3785 | 工单:#3784 | 已部署测试服并 12 项 E2E 实测通过(2026-06-13) +> 背景:wx 指派排查「按逻辑应该有的小功能没有」(如输入框该用下拉搜索框),audit workflow 36 agents 五维度扫描+逐条对抗验证,确认 15 项中 11 项契约有据立即修。 + +## ⚠️ 关键说明(前端动作) + +1. 🆕 **待审核单条详情** `GET /admin/fleet/drivers/pending/{id}`:审核抽屉数据源(证件原图 URL/驾照明细/紧急联系人/自带车块/驳回原因,PII 脱敏),不存在返 600402。**审核页"查看详情"抽屉可以接了**。 +2. 🆕 **H5 init 下发 `vehicleTypeOptions`**(仅 mode=new):`[{typeKey,typeName,icon,models:[{modelName,seats}]}]`——H5 新招「常开车型」步骤的**唯一合法数据源,禁前端写死大类**;renew 模式不返。 +3. **待审核列表新增出参**:`drivingYears/licenseClass/licenseNo(脱敏)/licenseExpire`(卡片直显初判)+ `modeLabel/reviewStatusLabel`(新招·续签/待审核·已通过·已驳回,不用再硬编码映射)。 +4. **司机列表新增出参**:`insuranceTypeLabel`(全年保险/按行程投保/无保险)+ `insuranceAnnualEnd`(年保到期日,仅 annual 行有值);**详情 insurance 块新增** `typeLabel/annualSourceLabel`(手工录入/保游网出单)。 +5. **司机列表新增入参** `onlyResidentUnbound=true`:仅返回未被任何车设为常驻的司机——**车辆表单选常驻司机的下拉数据源**(避免选了已占用司机保存才报 605022)。 +6. **车辆新增/编辑 fleet/ownerType 行为变更**:后端经字典归一校验——中文标签(如「公司所有」「自有」)也能传、自动归一为字典值落库;非法值返 **100001**(原任意字符串直落库)。 +7. **司机编辑新增入参** `blacklistReason`(可选≤256):仅本次把 season 转入 blacklist 时消费并自动落拉黑时间,**拉黑弹窗可以加原因输入框了**;详情/列表 blacklistReason 出参不再恒 null。 +8. **vehicleSource 行为变更**:仅接受 own/company,其余值 400(admin 编辑+H5 提交两处)。 +9. **续签赛季 bug 修复(行为变更)**:司机 H5 续签勾「今年休息」(continueSeason=false)后审核通过,season 现在正确落 **archived**(原 bug 无条件落 active);勾继续合作仍落 active+追加在册年。 + +## 实测(测试服 12 项) + +详情端点 200+600402 / init 车型选项无 basePrice / 列表新字段 Label 全出 / onlyResidentUnbound 排除准确 / 中文标签归一+脏值 100001 / vehicleSource 脏值 400 / 拉黑原因落库回显 / 续签 false→archived 真链路(H5 提交→审核通过)。 + +注:另有 2 项排查发现待 wx 拍板(紧急联系人「关系」字典种子口径 / 司机标签聚合清单端点),拍板后另行通知。