36ba58c0bb
第4节 待定→已拍板:phone/licenseNo 续签返明文供司机核对,idCard/emergencyPhone 仍脱敏; 已部署测试服 init 实测确认。前端原样渲染 prefill 即可。
77 行
5.5 KiB
Markdown
77 行
5.5 KiB
Markdown
【前端待办·司机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 续签自助路径。
|