2.9 KiB
2.9 KiB
【新增+修改接口·管理后台+司机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 项契约有据立即修。
⚠️ 关键说明(前端动作)
- 🆕 待审核单条详情
GET /admin/fleet/drivers/pending/{id}:审核抽屉数据源(证件原图 URL/驾照明细/紧急联系人/自带车块/驳回原因,PII 脱敏),不存在返 600402。审核页"查看详情"抽屉可以接了。 - 🆕 H5 init 下发
vehicleTypeOptions(仅 mode=new):[{typeKey,typeName,icon,models:[{modelName,seats}]}]——H5 新招「常开车型」步骤的唯一合法数据源,禁前端写死大类;renew 模式不返。 - 待审核列表新增出参:
drivingYears/licenseClass/licenseNo(脱敏)/licenseExpire(卡片直显初判)+modeLabel/reviewStatusLabel(新招·续签/待审核·已通过·已驳回,不用再硬编码映射)。 - 司机列表新增出参:
insuranceTypeLabel(全年保险/按行程投保/无保险)+insuranceAnnualEnd(年保到期日,仅 annual 行有值);详情 insurance 块新增typeLabel/annualSourceLabel(手工录入/保游网出单)。 - 司机列表新增入参
onlyResidentUnbound=true:仅返回未被任何车设为常驻的司机——车辆表单选常驻司机的下拉数据源(避免选了已占用司机保存才报 605022)。 - 车辆新增/编辑 fleet/ownerType 行为变更:后端经字典归一校验——中文标签(如「公司所有」「自有」)也能传、自动归一为字典值落库;非法值返 100001(原任意字符串直落库)。
- 司机编辑新增入参
blacklistReason(可选≤256):仅本次把 season 转入 blacklist 时消费并自动落拉黑时间,拉黑弹窗可以加原因输入框了;详情/列表 blacklistReason 出参不再恒 null。 - vehicleSource 行为变更:仅接受 own/company,其余值 400(admin 编辑+H5 提交两处)。
- 续签赛季 bug 修复(行为变更):司机 H5 续签勾「今年休息」(continueSeason=false)后审核通过,season 现在正确落 archived(原 bug 无条件落 active);勾继续合作仍落 active+追加在册年。
实测(测试服 12 项)
详情端点 200+600402 / init 车型选项无 basePrice / 列表新字段 Label 全出 / onlyResidentUnbound 排除准确 / 中文标签归一+脏值 100001 / vehicleSource 脏值 400 / 拉黑原因落库回显 / 续签 false→archived 真链路(H5 提交→审核通过)。
注:另有 2 项排查发现待 wx 拍板(紧急联系人「关系」字典种子口径 / 司机标签聚合清单端点),拍板后另行通知。