From 56ee91cb6031d8ac3384e6b2242c940e924b5477 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 15 Jun 2026 10:34:45 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E5=82=AC=E5=8A=9EP0-?=
 =?UTF-8?q?=E4=BF=9D=E9=99=A9=E8=AE=A1=E5=88=92=E4=BD=BF=E7=94=A8=E5=88=86?=
 =?UTF-8?q?=E7=B1=BB(=E5=8F=B8=E6=9C=BA=E5=8F=AF=E7=94=A8)=E6=89=93?=
 =?UTF-8?q?=E6=A0=87UI=E4=BB=8D=E7=BC=BA,=E5=8F=B8=E6=9C=BA=E6=8A=95?=
 =?UTF-8?q?=E4=BF=9D=E6=95=B4=E6=9D=A1=E5=8D=A1=E7=82=B9,=E5=90=8E?=
 =?UTF-8?q?=E7=AB=AF=E7=AB=AF=E7=82=B9=E9=BD=90=E5=85=A8=E5=AE=9E=E6=B5=8B?=
 =?UTF-8?q?=E5=8F=AF=E7=94=A8=E5=8F=AA=E5=B7=AE=E5=89=8D=E7=AB=AF=E5=BC=80?=
 =?UTF-8?q?=E5=85=B3=20[=E5=89=8D=E7=AB=AF=E5=82=AC=E5=8A=9E]?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 ...»å�¸æœºå�¯ç”¨æ‰“æ ‡UIä»�缺-å�Žç«¯ç«¯ç‚¹é½�全实测å�¯ç”¨-管ç�†å�Žå�°.md | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 changelogs-v2/2026-06/15_催办_�险计划使用分类�机�用打标UI�缺-�端端点�全实测�用-管���.md

diff --git a/changelogs-v2/2026-06/15_催办_�险计划使用分类�机�用打标UI�缺-�端端点�全实测�用-管���.md b/changelogs-v2/2026-06/15_催办_�险计划使用分类�机�用打标UI�缺-�端端点�全实测�用-管���.md
new file mode 100644
index 0000000..80cdff6
--- /dev/null
+++ b/changelogs-v2/2026-06/15_催办_�险计划使用分类�机�用打标UI�缺-�端端点�全实测�用-管���.md
@@ -0,0 +1,52 @@
+# �🔴�端催办·管���】�险计划「使用分类（�机�用）�打标 UI �未� —— 这是「�机投��整�的�点，�端端点�全且已实测，�差�端这一个开关
+
+> 端：hl-ui（�险管� → �险产�）| �务：hl-order-service-v3 `AdminInsuranceController`（SRS §9.17.3）| **�端零改动（端点早已存在并实测�用）** | 测试�网关 9443 实测 2026-06-15
+> ⚠� 本�是**��催办**：�一缺�已在 `13_…` / `15_�机投��险计划下拉空…` 里作为"第 3 件事"�过，但至今未�实。wx 2026-06-15 �次确认「现在没有地方标记�险给�机用�，故�独拎出�� P0 催办。
+
+## ⚠� 关键说明：为什么是�点（一��）
+
+「�险订� / �机档案 → 投�下� → 人员类型=�机�的「�险计划�下拉，**�列被标为"�机�用（DRIVER/BOTH）"的计划**（安全侧，防把客人计划误投给�机）。而所有�游�步进�的计划**默认都是 CUSTOMER（客人用）**——**没有任何 UI 能把计划标��机�用 → �机下拉永远空 → �机投�功能��层�用�起�**。
+
+现在�机下拉里能看到「计划一 / 10万计划�，是�端排查时**临时手动标的 2 个测试样本**，�是��能控的。**正�上线�，这个打标 UI 必须�**，�则���加一个�机险计划都得找�端改库。
+
+## 1. �端�补什么（唯一缺�，精确到�置）
+
+在「**�险管� → �险产�**�里给**计划（plan）**加一个「使用分类�控件：
+
+- **�置**：�险产�列表 → 点�产�（眼�图标/详情）→ 该产�下的**计划列表**，�个计划一行加一个「使用分类�下拉或分段开关：**客人(CUSTOMER) / �机(DRIVER) / 通用(BOTH)**。
+- **粒度**：按**计划**标，�是按产�标（一个产�下��计划�分别给客人/�机）。
+- **默认**：未标的计划是 `CUSTOMER`，下拉显示"客人"。
+- 标� **�机** 或 **通用** �，该计划立�出现在「�机投��的�险计划下拉里。
+
+## 2. 调这两个现�端点（�端零改动）
+
+| 用途 | 方法 + 路径 | 入� / 出� |
+|---|---|---|
+| **打标（设使用分类）** | `PUT /v3/admin/insurance/plans/{planId}/usage-category` | body `{"usageCategory":"DRIVER"}`；白�� **CUSTOMER/DRIVER/BOTH**，�法值返 **540223**；返回 `Result<Void>` |
+| **回显（读当�分类）** | `GET /v3/admin/insurance/products/all` | �个产� `plans[].usageCategory` �当�分类（用于渲染控件选中�）；也�用 `GET /v3/admin/insurance/products/{productId}/plans` 按产��计划 |
+
+网关 `/v3/admin/**` 已覆盖路由，无需�端/网关任何改动。
+
+## 3. 关键注�（��踩�）
+
+- **�游"�步产�"�会覆盖本标注**：�端 `syncProducts` 是增�护�，��标过的 `usageCategory` 在下次�步�**�留**，�会被�置回 CUSTOMER。放心标。
+- **�机下拉�径**：�机投�下拉�列 `usageCategory ∈ {DRIVER, BOTH}`；客人端维�现状（全列��收紧）。
+- `planId` 是雪花 id，**当字符串�传**（别转 JS Number，�考今天�一�续签 targetDriverId 科学计数法踩�）。
+
+## curl 实测（测试�网关 9443，真 admin token）
+
+```bash
+# 打标：把�计划标��机�用
+curl -k -X PUT "https://api.test.1814.love:9443/v3/admin/insurance/plans/2054773833342451714/usage-category" \
+  -H "Authorization: Bearer <adminToken>" -H "Content-Type: application/json" \
+  -d '{"usageCategory":"DRIVER"}'
+# → {"code":200,"success":true}
+
+# 回显：读�计划当�分类
+curl -k "https://api.test.1814.love:9443/v3/admin/insurance/products/all" -H "Authorization: Bearer <adminToken>"
+# → data[].plans[].usageCategory ∈ CUSTOMER/DRIVER/BOTH
+```
+
+## 验收
+
+�险产� → �产�计划列表，把一个�外险计划「使用分类�改为「�机�→ 回到「投�下� → 人员类型=�机 → �险计划�下拉，该计划应出现。��全程无需找�端。