From 84286cc92509fe550d801c7c71d5ac3f5f9831a0 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 11 Aug 2026 18:22:26 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E6=B4=BE=E5=8D=95=E5=BC=B9?=
 =?UTF-8?q?=E7=AA=97=E9=9C=80=E6=B1=82=E4=BF=A1=E6=81=AF=E4=B8=A4=E5=A4=84?=
 =?UTF-8?q?=E5=90=84=E7=BC=BA=E4=B8=80=E5=8D=8A=E2=80=94=E2=80=94=E5=90=8E?=
 =?UTF-8?q?=E7=AB=AF=E5=AD=97=E6=AE=B5=E5=B7=B2=E5=B0=B1=E7=BB=AA=E8=BD=AC?=
 =?UTF-8?q?=E5=89=8D=E7=AB=AF=EF=BC=88=E5=8E=9F=20#5848=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¼¹çª—需求信æ�¯ä¸¤å¤„å�„缺一å�Š-å‰�端缺陷-管ç�†å�Žå�°.md | 150 ++++++++++++++++++
 1 file changed, 150 insertions(+)
 create mode 100644 changelogs-v2/2026-08/11_frontend_派�弹窗需求信�两处�缺一�-�端缺陷-管���.md

diff --git a/changelogs-v2/2026-08/11_frontend_派�弹窗需求信�两处�缺一�-�端缺陷-管���.md b/changelogs-v2/2026-08/11_frontend_派�弹窗需求信�两处�缺一�-�端缺陷-管���.md
new file mode 100644
index 0000000..6a061cb
--- /dev/null
+++ b/changelogs-v2/2026-08/11_frontend_派�弹窗需求信�两处�缺一�-�端缺陷-管���.md
@@ -0,0 +1,150 @@
+---
+schema: "hl-changelog/v2"
+ticket: "frontend"
+title: "派�弹窗需求信�展示补全：Step1 缺结构化车型语��Step2 缺特殊诉求与文字备注（�端字段已全部就绪）"
+consumer: "admin"
+change_type: "�端缺陷"
+author: "wx(GIT)"
+backend_status: "not_required"
+gateway_status: "not_required"
+frontend_status: "pending"
+frontend_owner: "mmg"
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "原 #5848 �端工��调研判定为纯�端渲染缺�，已关�转本�。三�信�（结构化车型语� / 通用特殊诉求 / 文字备注）�端在 GET /admin/fleet/board/orders/{orderId} �一份�应里全部已返回，测试� 26-3698 实测有值，无需任何�端改动。"
+updated_at: "2026-08-11"
+base: "dev-v3"
+---
+
+# 派�弹窗需求信�展示补全（原 #5848 → 转�端）
+
+> **页�**：车务管� → 派�看� → 订�派车弹窗
+> **�端**：**零改动**。三�信�早已在�一份详情�应里返回，�是�端两处�渲染了一�。
+
+---
+
+## 一�现状：两处�缺一�
+
+| �置 | 现在显示 | 缺什么 |
+|------|---------|--------|
+| **Step1「订�详情�→ 定制师/用车备注**区� | �有文字备注（例：`用车备注 ��墨6人suv*2`） | **缺结构化车型语�** |
+| **Step2「排车�→ 底部「当�需求�**区� | �有结构化语�（例：`当�需求：SUV7座×1 + 商务车7座×1`） | **缺通用特殊诉求 + 文字备注** |
+
+wx 的�求：**两处都��时展示「结构化车型语� + 通用特殊诉求 + 文字备注�三�完整信�**。车管在 Step2 排车时最需�看到「�儿童座椅�「�中文�机�这类诉求，现在�能看到车型数�。
+
+---
+
+## 二�数���：一个接��一份�应�三个字段
+
+**两处��**——Step1 和 Step2 用的是**�一个 order 对象**，�自�一次请求：
+
+```
+GET /admin/fleet/board/orders/{orderId}
+Authorization: Bearer <admin token>
+（无请求体）
+```
+
+�应 `data` 里三个字段：
+
+| 字段 | 类型 | 是��空 | 说明 |
+|------|------|---------|------|
+| `requirementFleetText` | `String` | **�为 null** | �端拼好的**结构化车型整�**，如 `SUV7座×1 + 商务车7座×1` |
+| `specialTags` | `List<String>` | **�为数组**（无诉求时 `[]`） | 通用特殊诉求，**值本身就是中文标签** |
+| `requirementRemark` | `String` | **�为 null** | 文字备注 / 其他诉求 |
+
+> `requirements` 是 `requirementRemark` 的**兼容别�**（�值），新代�请用 `requirementRemark`。
+
+### 测试环境实测（2026-08-11，26-3698）
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "requirementFleetText": "SUV7座×1 + 商务车7座×1",
+    "specialTags": ["�高速油费"],
+    "requirementRemark": "和法国飞行速度",
+    "requirements": "和法国飞行速度",
+    "plannerNote": null
+  }
+}
+```
+
+---
+
+## 三�三个字段的使用�径（��）
+
+### 1. `requirementFleetText` —— **原样渲染，�止自行拼装**
+
+整�由�端统一拼好，格�是 #5817 定的「车队组�写法�：**座�内� + 加�连接**。
+
+```
+SUV7座×1 + 商务车7座×1
+```
+
+规则（�端已实现，�端�需��刻）：
+- 缺座�时�略座�：`SUV×2 + 商务车7座×1`
+- 车型未知时回退原始值
+- 需求为空或 `fleet` 为空 → 返回 **`null`**（整��渲染）
+
+⚠� **�止**用 `vehicleSlots[].requiredVehicleTypeLabel` 或 `requiredVehicles` 自己��拼这��——那些是**派�行的历�快照**，需求�版�是**陈旧值**（会显示��版�的旧车型）。�有 `requirementFleetText` 是当�生效需求的��值。
+
+### 2. `specialTags` —— **直接渲染，��查字典翻译**
+
+数组里的值**本身就是中文标签**（�端字典 `vehicle_special_demand` 的 `dict_value` 与 `dict_label` 有���一致），直接当 tag 渲染��：
+
+```
+["儿童安全座椅", "大行�空间", "中文�机", "��机(5年以上)", "�高速油费", "�音车型", "有WiFi"]
+```
+
+�为数组，`length === 0` 时�渲染该�。
+
+### 3. `requirementRemark` —— 自由文本
+
+�能为 `null`，判 falsy 时�渲染。
+
+---
+
+## 四��端��的两件事
+
+### 1. Step1「定制师/用车备注�区� —— 补车型语�
+
+在现有的 `plannerNote` / `requirementRemark` / `specialTags` 之外，增渲染 `order.requirementFleetText`（原样输出）。`null` 时�显示该行。
+
+### 2. Step2 底部「当�需求�区� —— 补诉求与备注
+
+在现有的 `requirementFleetText` 之�，补上：
+- `order.specialTags` → tag 列表（空数组�渲染）
+- `order.requirementRemark` → 文本（null �渲染）
+
+---
+
+## 五�版本一致性（验收项，�端已��）
+
+「两处展示的三�信��自�一版当�生效需求，�串版本�这一�**�端天然满足**：
+
+三个字段全部出自**�一个当�生效需求对象**（`is_active=1` 且 version 最大的那一版），一次�数�一起下�。�端��都从这份�应�值，就��能串版本。
+
+�之，如果�端从 `vehicleSlots` 或 `requiredVehicles` 自己��，就会踩到派�行的陈旧快照——�上文第三节的警告。
+
+---
+
+## 六�空�汇总
+
+| 场景 | �端返回 |
+|------|---------|
+| 无生效需求 / 需求��达 | `requirementFleetText: null`�`specialTags: []`�`requirementRemark: null` |
+| `fleet` 为空数组或解�失败 | `requirementFleetText: null` |
+| 无特殊诉求 | `specialTags: []`（**�是 null**） |
+| 无备注 | `requirementRemark: null`（�转空串） |
+
+整�判空规则：整� `null` → �渲染该行；tags `length === 0` → �渲染；备注 falsy → �渲染。**��出现空白区�或字�� `null`。**
+
+---
+
+## 七�关�
+
+- 原�端工� #5848（已关�，判定为纯�端渲染缺�）
+- 车型语�格�定义：#5817 / `11_5810b_需求车型语�改车队组�写法-修改接�-管���.md`
+- 陈旧快照�的�因：#5871（�版�派�行 `required_vehicle_type` �刷新）