From f23f62a5c49cb273f751cf14c63366b120f91068 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 15 Jun 2026 11:02:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E5=8F=B8=E6=9C=BA=E5=BD=95?= =?UTF-8?q?=E5=85=A5=E7=94=9F=E6=88=90=E9=93=BE=E6=8E=A5=E9=9C=80=E5=8A=A0?= =?UTF-8?q?=E6=89=8B=E6=9C=BA=E5=8F=B7(=E5=BF=85=E5=A1=AB)+=E5=A7=93?= =?UTF-8?q?=E5=90=8D(=E9=80=89=E5=A1=AB)=E8=BE=93=E5=85=A5=E6=A1=86,?= =?UTF-8?q?=E6=96=B0=E6=8B=9B=E6=89=8B=E6=9C=BA=E5=8F=B7=E5=B7=B2=E5=8F=98?= =?UTF-8?q?=E5=BF=85=E5=A1=AB(=E7=A0=B4=E5=9D=8F=E6=80=A7),=E5=90=8E?= =?UTF-8?q?=E7=AB=AFPR#3815=E5=B7=B2=E5=90=88=E5=B9=B6=E9=83=A8=E7=BD=B2?= =?UTF-8?q?=E6=B5=8B=E8=AF=95=E6=9C=8D=E5=9B=9B=E8=B7=AF=E5=AE=9E=E6=B5=8B?= =?UTF-8?q?=E9=80=9A=E8=BF=87=20[=E5=89=8D=E7=AB=AF=E5=BF=85=E6=94=B9P0]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 (1M context) --- ...机号必填姓名选填输入框-后端已合并部署实测-管理后台.md | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 changelogs-v2/2026-06/15_3814_司机录入生成链接需加手机号必填姓名选填输入框-后端已合并部署实测-管理后台.md diff --git a/changelogs-v2/2026-06/15_3814_司机录入生成链接需加手机号必填姓名选填输入框-后端已合并部署实测-管理后台.md b/changelogs-v2/2026-06/15_3814_司机录入生成链接需加手机号必填姓名选填输入框-后端已合并部署实测-管理后台.md new file mode 100644 index 0000000..a1c39b0 --- /dev/null +++ b/changelogs-v2/2026-06/15_3814_司机录入生成链接需加手机号必填姓名选填输入框-后端已合并部署实测-管理后台.md @@ -0,0 +1,53 @@ +# 【🔴前端必改·管理后台】司机自助录入「生成专属链接」需加「手机号(必填)+姓名(选填)」输入框 —— 后端已合并部署测试服并四路实测通过（PR #3815 / 工单 #3814） + +> 端：hl-ui（车务管理 → 司机自助录入；保险订单/司机档案投保区同源生成入口）| 服务：hl-fleet-service `H5TokenAdminController` §4.1 | PR #3815 已合并 dev-v3 + 部署测试服 | 实测 2026-06-15 +> ⚠️ **破坏性改动**：新招生成 token **手机号已变必填**。前端当前若仍不带手机号调生成接口 → 返 **100001**，新招生成会用不了，**请尽快加输入框**。 + +## ⚠️ 关键说明 + +司机自助录入「已发放链接」列表姓名/手机长期为「-」、「发短信」无号可发。后端已补：生成 token 时落库联系人，列表显示、「发短信」可直达。**前端需在生成入口加录入框并带参**。设计（wx 2026-06-15 拍）：**手动发短信 / 手机号必填、姓名选填 / 新招录入、续签自动取档案**。 + +## 1. 前端要做（两个 tab） + +**新招(new)**：生成区加输入框 +- 「手机号」**必填**（11 位，建议前端先做 `^1\d{10}$` 校验） +- 「姓名」选填 +- 点「生成专属链接」时把 `phone` + `name` 一起传（见下端点）。 + +**续签(renew)**：**不要让车管重录** +- 选中司机后，姓名/手机由后端从所绑档案自动取，前端**无需传 phone/name**（传了也被后端忽略）。 +- 如要展示，可只读/置灰显示该司机档案的姓名+脱敏手机（来源：司机列表项已有 name/phone）。 + +## 2. 端点契约（已部署实测） + +`POST /admin/fleet/h5/token`（生成 token，base `/admin/fleet/h5`，网关 `/admin/fleet/**` 已覆盖） + +| 字段 | 说明 | +|---|---| +| `mode` | `new`/`renew`（必填）| +| `phone` | 🆕 司机手机号。**新招必填(11位)**；续签可不传(取所绑档案) | +| `name` | 🆕 司机姓名。选填(新招录入)；续签忽略(取所绑档案) | +| `targetDriverId` | 续签必填(老档案 id，字符串透传防精度丢失) | +| `expireDays` | 选填(new=7/renew=14) | + +错误码：**100001** 新招缺手机号「新招生成必须录入手机号」 / **400** 手机号格式不正确 / 600205 续签司机不存在。 + +返回不变：`pendingId/token/url/shortUrl/expireAt/qrCodeUrl`。 + +## 3. 配套（已就绪，前端零额外改动） + +- 「已发放链接」列表（`GET /admin/fleet/h5/tokens`）的 `name`/`phone`(脱敏) 现在会有值，直接显示即可。 +- 「发短信」（`POST /admin/fleet/h5/tokens/{pendingId}/resend`）端点未变；因生成时已落手机号，现在能直接发到该号、短信问候语带姓名。 + +## 实测（测试服网关 9443） + +``` +新招 {"mode":"new","phone":"13812340001","name":"测试新招ABC"} → 200；列表 name=测试新招ABC phone=138****0001 +新招 {"mode":"new"}（缺手机号） → 100001「新招生成必须录入手机号」 +新招 {"mode":"new","phone":"123"}（格式错） → 400「手机号格式不正确」 +续签 {"mode":"renew","targetDriverId":"<司机id>"} → 200；列表显示该司机档案 name/phone（巴特尔 135****5020） +``` + +## 验收 + +新招：填手机号(必填)+姓名(选填) → 生成 → 「已发放链接」显示姓名/手机 → 点「发短信」发到该号。续签：选司机 → 生成 → 自动显示档案姓名/手机，无需重录。