From bdb6ac7e925a6ce5e6c9b7e55c3b5d344b3e8a50 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 23 Jul 2026 10:22:16 +0800
Subject: [PATCH] docs: hand off fleet personal unread badge #5180

---
 ...¯¦æƒ…è�”系车务独立未读红点-修改接å�£-管ç�†å�Žå�°.md | 93 +++++++++++++++++++
 1 file changed, 93 insertions(+)
 create mode 100644 changelogs-v2/2026-07/23_5180_订�详情�系车务独立未读红点-修改接�-管���.md

diff --git a/changelogs-v2/2026-07/23_5180_订�详情�系车务独立未读红点-修改接�-管���.md b/changelogs-v2/2026-07/23_5180_订�详情�系车务独立未读红点-修改接�-管���.md
new file mode 100644
index 0000000..51010af
--- /dev/null
+++ b/changelogs-v2/2026-07/23_5180_订�详情�系车务独立未读红点-修改接�-管���.md
@@ -0,0 +1,93 @@
+# 订�详情「�系车务�独立未读红点
+
+> 日期：2026-07-23  
+> 工�：HL #5180  
+> 影�范围：管���订�详情 → 行程安排 → 用车安排；�天 SSE 实时状�  
+> 状�：�端待处�
+
+## 1. 问题与�径
+
+车务通过 `FLEET:{orderId}` 会�给定制师��消��，顶部全局铃铛能显示未读，但当�订�「�系车务�按钮没有订�维度红点。房务按钮已有�款能力，本次车务必须�用相�的角标样��实时刷新和已读清零交互。
+
+房务与车务未读是两个独立业务会�，�止继续共用一个字段：
+
+- `unreadMessageCount`：当�登录定制师在本订� `HOUSE:{orderId}` 会�的未读数，�供「�系房务�使用。
+- `fleetUnreadMessageCount`：当�登录定制师在本订� `FLEET:{orderId}` 会�的未读数，�供「�系车务�使用。
+- 顶部铃铛全局未读�能说明“存在未读�，�能作为当�订�按钮是�亮红点的判断��。
+
+## 2. 接��更
+
+```http
+GET /v3/admin/order/{id}/itinerary
+```
+
+�应新增：
+
+```json
+{
+  "unreadMessageCount": 0,
+  "fleetUnreadMessageCount": 2,
+  "canContactFleet": true,
+  "contactFleetDisabledReason": null
+}
+```
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `unreadMessageCount` | Integer | HOUSE 订�会�未读；既有字段，语义�� |
+| `fleetUnreadMessageCount` | Integer | FLEET 订�会�未读；新增字段；无会��未登录或软�赖�级时为 `0` |
+
+两个字段必须分别消费，�能用 `fleetUnreadMessageCount || unreadMessageCount` 一类兜底混用，�则房务消�会错误点亮车务按钮。
+
+�端内部�数�时增加�选 `unreadScope`：
+
+- FLEET �传或传 `TEAM`：��车务看�既有团队共享未读�径。
+- FLEET 传 `PERSONAL`：按指定 `adminId` 返回车务�给该定制师的个人未读；订�详情的 `fleetUnreadMessageCount` 使用此�径。
+- HOUSE：�按�员行个人未读统计，行为��。
+
+该字段属于 order-v3 → user-service 内部契约，管���无需直接传递。
+
+## 3. �端实现�求
+
+### 3.1 按钮角标
+
+`VehicleArrangeCard.vue` 的「�系车务�按钮按 `RoomArrangeCard.vue` 原样�用 `NBadge`：
+
+- `fleetUnreadMessageCount > 0` 时显示红色数字角标。
+- `max=99`，`0` 自动��。
+- 按钮�用时���留未读�示，�能因为 `canContactFleet=false` �默�掉既有会�未读；是��许�新开会�继续�守�端门控。
+- 样���移�尺寸与「�系房务���一致，�新增�一套红点 CSS。
+
+`v3Adapter.js` 需把行程接�的 `fleetUnreadMessageCount` 映射为独立本地字段（建议 `itineraryFleetUnreadCount`），��覆盖现有 `itineraryUnreadCount`。
+
+### 3.2 SSE 实时刷新
+
+订�详情现有 `lastChatSignal` 监��匹� `HOUSE:{orderId}`。需��时支�：
+
+```text
+HOUSE:{orderId} -> 刷新�系房务角标
+FLEET:{orderId} -> 刷新�系车务角标
+```
+
+收到当�订�的 `FLEET:{orderId}` `im-chat` / `im-chat-read` 信令�，轻��拉行程接�并��并 `fleetUnreadMessageCount`；�能整页闪骨架�，也�能把其他订�的全局未读数套到当�订�。
+
+### 3.3 已读清零与竞�
+
+- 打开「�系车务�并收到�天抽屉 `read` 事件�，立�把当�订�车务角标本地清零。
+- 房务已读�清 HOUSE 字段，车务已读�清 FLEET 字段，互�影�。
+- �用房务现有 `chatReadEpoch`（或等价版本�）防竞�：已读期间较早�出的刷新请求返回时，�得把旧未读数�新覆盖�红点。
+- 切�订�时按新 `orderId` �算，�能沿用上一个订�角标。
+
+## 4. 验收场景
+
+- [ ] 当�订�无未读时，「�系车务��显示角标。
+- [ ] 车务给本�定制师�� 1 �消��，�刷新页�，顶部铃铛和本�「�系车务�都立�显示红点/数字 `1`。
+- [ ] 当�订�无车务未读�其他订�有车务未读时，顶部铃铛�亮，但当�订�「�系车务��亮。
+- [ ] 当�订��有房务未读时，�点亮「�系房务�，�得点亮「�系车务�。
+- [ ] 打开本�车务会�并读完�，「�系车务�角标立�消失，顶部铃铛与站内信列表�步收敛。
+- [ ] 已读�作与 SSE 刷新并�时，旧请求�会让已清零红点�现。
+- [ ] 角标样��最大数字和按钮布局与房务模�一致。
+
+## 5. 兼容性
+
+新增�应字段为加性�更。未接入新字段的旧�端行为��；�端接入��使用既有 `POST /admin/message/chat/open-fleet` 打开会�，`orderId` 必须使用数字雪花字符串，�能使用 `HL...` 展示�。