hl-api-changelog/17_续签H5全字段全附件回显-init已返完整数据待前端渲染-司机H5.md 位于 257b72ff5956aa4d07898e27219589e8101c136c

API Changelog Bot 36ba58c0bb docs(changelog): 续签PII口径拍板上线 phone/licenseNo明文 idCard脱敏 (PR #3945 )

第4节 待定→已拍板:phone/licenseNo 续签返明文供司机核对,idCard/emergencyPhone 仍脱敏;
已部署测试服 init 实测确认。前端原样渲染 prefill 即可。

2026-06-17 19:27:29 +08:00

5.5 KiB

原始文件 Blame 文件历史

【前端待办·司机H5】续签 init 已返完整回显数据（车辆块+全附件+全字段），H5 续签页需渲染+预填

服务：hl-fleet-service（车务）关联 PR：#3920（续签司机侧全字段全附件）+ #3921（续签车辆侧常驻车回显，Closes #3919），均已合并 dev-v3 + 部署测试服双实例类型：前端待办（后端零改动，本条补此前漏发的契约周知）端点：GET /app/h5/driver-onboard/init?token=（renew 模式）

⚠️ 关键说明

续签 H5 第 2 步当前只显示了「驾照有效期 / 手机 / 常驻车牌」3 项的灰字提示，车辆字段块、各类附件上传区都没出来，输入框也没预填当前值。

排查结论：不是后端缺数据，是前端未渲染。最新后端 init 的 data.prefill 已返回续签全套回显数据（已在测试服 api.test.1814.love:9443 真实验证，蒙A-H7777 实测）。前端需要：① 确保本地后端已拉最新 dev-v3（否则 init 不返这些字段）；② 渲染车辆块 + 附件回显/上传；③ 把当前值预填进输入框。

1. init.data.prefill 完整字段（renew 模式）

1.1 司机字段

字段	含义	可改	备注
name / idCard / gender / nation	姓名/身份证/性别/民族	只读	供核对，续签不可改；idCard 脱敏
phone	手机号	可改	脱敏（135***5019）；不改直接提交，后端识别含 `` 跳过更新
drivingYears	驾龄	可改
licenseNo / licenseType / licenseExpire / licenseDaysLeft	驾照号/类型/有效期/剩余天数	可改	licenseNo 脱敏
emergencyName / emergencyPhone / emergencyRelation	紧急联系人	可改	emergencyPhone 脱敏
preferredCategory / preferredModel	常开车型偏好	可改
vehicleSource / vehicleNotes	车辆来源/备注	可改

1.2 司机附件 URL（8 类，回显 + 可加传更新）

idCardUrls / portraitUrls / driverLicenseUrls / healthCertUrls / trainingCertUrls / awardUrls / qualificationUrls / driverOtherUrls（均为 string[]）

1.3 currentVehicle 车辆块（司机有常驻车则非 null）

字段	含义
plate	车牌
vehicleModelId / modelName / seats	车型库车型 ID / 名称 / 座位
fleet	车队
vin	车架号
regDate / insureDue / inspectDue	注册日期 / 保险到期 / 年检到期
regCertUsage / regCertNo / regCertOwner	使用性质 / 行驶证号 / 所有人
regCertFrontUrls / regCertBackUrls / exteriorUrls / interiorUrls / insuranceUrls / inspectionUrls / operationLicenseUrls / otherUrls	车辆 8 类附件 URL（`string[]`，回显 + 可加传）

2. 真实响应示例（测试服实测，URL 已略）

{ "code":200, "data":{ "mode":"renew", "tokenState":"fresh",
  "prefill":{
    "name":"阿拉坦", "idCard":"152***********0195", "gender":"1", "nation":"鄂温克族",
    "phone":"135****5019", "drivingYears":6,
    "licenseNo":"152***********3000", "licenseType":"B1", "licenseExpire":"2034-04-15", "licenseDaysLeft":2859,
    "emergencyName":"联系人03", "emergencyPhone":"139****9003", "emergencyRelation":"朋友",
    "preferredModel":"别克GL8", "vehicleSource":"own",
    "idCardUrls":["..."], "portraitUrls":["..."], "driverLicenseUrls":["..."], "healthCertUrls":["..."],
    "trainingCertUrls":["..."], "awardUrls":["..."], "qualificationUrls":["..."], "driverOtherUrls":["..."],
    "currentVehicle":{
      "plate":"蒙A-H7777", "vehicleModelId":"2064998010110029826", "modelName":"丰田汉兰达", "seats":7, "fleet":"coopA",
      "vin":null, "regDate":"2020-09-05", "insureDue":"2026-09-20", "inspectDue":"2026-09-04",
      "regCertUsage":"", "regCertNo":"", "regCertOwner":"",
      "regCertFrontUrls":["..."], "regCertBackUrls":["..."], "exteriorUrls":["..."], "interiorUrls":["..."],
      "insuranceUrls":["..."], "inspectionUrls":["..."], "operationLicenseUrls":["..."], "otherUrls":["..."]
    }
  } } }

3. 前端待办（mmg）

确保本地/联调后端为最新 dev-v3——init 才会返 currentVehicle + 各 *Urls + 完整 driver 字段（旧后端只返 name/phone/license 少数字段）。
渲染车辆块：currentVehicle 非 null 时，把车型/座位/VIN/注册日期/保险到期/年检/使用性质/行驶证号/所有人渲染为可编辑表单（提交走 submit/renew 的 vehicleChanged + vehicle）。
渲染附件回显 + 上传：driver 8 类 + vehicle 8 类，按类目显示现有 URL 缩略图 + 提供「加传/替换」入口（提交时把各类目最终 URL 列表回传，后端按类目覆盖式合并）。
输入框预填当前值：phone/驾照有效期/常驻车牌等不再只做灰字「当前 xxx」提示，按需预填进输入框（脱敏值原样回传后端会跳过更新，安全）。

4. PII 回显口径（已拍板 + 已上线测试服，PR #3945）

phone / licenseNo 续签返明文（司机经单次绑本人 token 看自己资料，需核对系统现存完整号码）；idCard（最敏感）/ emergencyPhone（第三方号码）仍脱敏。

前端原样渲染 prefill 值即可（明文/脱敏对前端透明，无需区分处理）；脱敏值（含 *）原样回传后端会跳过更新。
已部署测试服 + init 实测确认：phone=13520135019(明文) / licenseNo=152801198803003000(明文) / idCard=152***0195(脱敏) / emergencyPhone=139****9003(脱敏)。
admin 司机列表/详情仍全脱敏，本口径仅 driver 续签自助路径。

5.5 KiB 原始文件 Blame 文件历史 Unescape Escape