From fe28a296e9c95ceff16d8db0875a92530c57267e Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 2 Jul 2026 11:00:47 +0800
Subject: [PATCH] =?UTF-8?q?changelog:=20=E8=AE=A2=E5=8D=95=E8=AF=A6?=
 =?UTF-8?q?=E6=83=85=E8=81=94=E7=B3=BB=E6=88=BF=E5=8A=A1=E6=8C=89=E9=92=AE?=
 =?UTF-8?q?=E8=A1=A5=E6=9C=AA=E8=AF=BB=E7=BA=A2=E7=82=B9=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...…è�”系房务按钮未读红点缺失-å‰�端修å¤�-管ç�†å�Žå�°.md | 86 +++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 changelogs-v2/2026-07/10_订�详情�系房务按钮未读红点缺失-�端修�-管���.md

diff --git a/changelogs-v2/2026-07/10_订�详情�系房务按钮未读红点缺失-�端修�-管���.md b/changelogs-v2/2026-07/10_订�详情�系房务按钮未读红点缺失-�端修�-管���.md
new file mode 100644
index 0000000..bf41776
--- /dev/null
+++ b/changelogs-v2/2026-07/10_订�详情�系房务按钮未读红点缺失-�端修�-管���.md
@@ -0,0 +1,86 @@
+# 订�详情「�系房务�按钮未读红点缺失
+
+> 模�：管��� · 订�详情 `/order-v2/detail/{orderId}` · 行程安排 · �宿安排
+> 类型：**�端修�（�用既有站内信/会�未读数�）**
+> 日期：2026-07-02
+> 背景：顶部站内信铃铛已有未读红点，站内信列表也能看到当�订�会�未读，但订�详情�宿安排�片里的「�系房务�按钮没有红点�示，导致用户在订�详情内看�到该订�会�待处�状�。
+
+## 问题现象
+
+测试订�示例：
+
+- 订�：`HL20260702100458640`
+- 页�：`/order-v2/detail/2072501756742242305`
+- 顶部铃铛：显示未读红点 `1`
+- 站内信列表：存在未读订�会� `�订�会�】HL20260702100458640 测多旅客五`
+- 订�详情：�宿安排�片「�系房务�按钮未显示红点
+
+## ��端 · 管���】需改动
+
+### 1. 「�系房务�按钮展示订�维度未读红点
+
+在订�详情页�宿安排�片中，��当�订�存在未读房务/订�会�消�，「�系房务�按钮必须展示未读红点或未读数�。
+
+建议规则：
+
+```ts
+const showHouseChatUnread =
+  currentOrderUnreadCount > 0
+```
+
+展示形�：
+
+- `currentOrderUnreadCount === 1`：显示红点或数字 `1`
+- `currentOrderUnreadCount > 1`：显示数�，超过上��显示 `99+`
+- `currentOrderUnreadCount === 0`：��红点
+
+### 2. 未读数���径
+
+�用现有站内信/会�未读能力，�需�新增�端接�。
+
+�端需�按**订�维度**映射未读，���看顶部全局未读数：
+
+- 顶部铃铛红点是全局未读，�能说明“有未读�，�能说明当�订�按钮是�应亮。
+- 订�详情按钮需�按当� `orderId` / `orderNo` / 会�业务 key 匹�对应会�未读数。
+- 如果已有会�列表�未读统计或站内信列表中包� `orderId`�`orderNo`�`bizId`�`conversationId` 等字段，优先使用这些字段�精确映射。
+- 如果当�接�没有�稳定映射到订�的字段，�端需��馈缺字段，�能�默�展示红点。
+
+### 3. 点击�的状��步
+
+用户点击「�系房务�进入会�并读完消��，需��步刷新：
+
+- 当�订�「�系房务�按钮红点
+- 顶部站内信铃铛红点/数�
+- 站内信列表该会�未读状�
+
+建议在以下时机刷新：
+
+- 订�详情页进入时
+- 打开/关闭�天窗��
+- 站内信 SSE / 轮询 / unread-count 更新�
+- 手动点击“全部已读��
+
+### 4. 适用范围
+
+本次明确�求修�：
+
+- �宿安排�片：`�系房务`
+
+如果「�系车务�「�系�务�使用�一套�天按钮组件，也应�用相�未读红点逻辑，���修房务按钮造��类问题残留。
+
+## 验收标准
+
+| 场景 | 期望 |
+|------|------|
+| 当�订�有 1 �未读订�会� | 顶部铃铛显示红点，订�详情「�系房务�按钮也显示红点/数字 `1` |
+| 当�订�无未读，但其他订�有未读 | 顶部铃铛�显示红点，当�订�「�系房务�按钮�显示红点 |
+| 点击「�系房务�并读完消� | 当�按钮红点消失，顶部铃铛和站内信列表�步更新 |
+| 切�订�详情 | 红点按新订��新计算，�沿用上一个订�状� |
+
+## 涉�页�/能力
+
+| 页�/能力 | 说明 |
+|-----------|------|
+| `/order-v2/detail/{orderId}` | 订�详情�宿安排�片「�系房务�按钮 |
+| `/notification/my-messages` | 站内信列表已有订�会�未读状� |
+| 顶部铃铛 unread-count | 全局未读�示，需�与订�维度按钮状��动刷新 |