【前端待办·司机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 已略) ```json { "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) 1. **确保本地/联调后端为最新 dev-v3**——init 才会返 `currentVehicle` + 各 `*Urls` + 完整 driver 字段(旧后端只返 name/phone/license 少数字段)。 2. **渲染车辆块**:currentVehicle 非 null 时,把车型/座位/VIN/注册日期/保险到期/年检/使用性质/行驶证号/所有人渲染为可编辑表单(提交走 `submit/renew` 的 `vehicleChanged + vehicle`)。 3. **渲染附件回显 + 上传**:driver 8 类 + vehicle 8 类,按类目显示现有 URL 缩略图 + 提供「加传/替换」入口(提交时把各类目最终 URL 列表回传,后端按类目覆盖式合并)。 4. **输入框预填当前值**: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 续签自助路径。