docs: add dated fleet chat frontend handoff
changelog-filename-gate / validate (push) Has been cancelled

这个提交包含在:
API Changelog Bot
2026-07-23 09:32:15 +08:00
父节点 3e710dee3c
当前提交 3847d19b20
共修改 3 个文件,包含 517 行新增和 6 行删除
@@ -45,9 +45,3 @@ body:`{"orderId": 2071784830965620737}`(必填;可选 `peer`)
- 单测 user-service 3099 绿(房务基线零回归)。
- **看板列表红点(PR #4698)实测**:`/admin/fleet/board/orders` 74 单每行含 `orderId`(真数字雪花)+ `unreadMessageCount`;定制师向某单广播一条→重查该行 `unreadMessageCount=1`(团队未读联动看板);user-service 软降级路径不阻断列表。fleet-service 全量 1307 测试绿、ArchTest 11/11。
## 【前端待办·2026-07-23 截图反馈】
- 派单看板订单卡必须接入 `unreadMessageCount`:大于 0 显示消息红点,超过 9 显示 `9+`;不能只显示订单状态。
- 派单看板订单卡增加「联系定制师」按钮,使用该行 `orderId` 调用 `POST /admin/message/chat/open-fleet`,不要使用展示号 `id`。
- 订单详情弹窗增加「联系定制师」按钮,复用房务聊天抽屉和同一 `open-fleet` 接口;打开会话后按接口语义自动标记已读。
- 右上角消息提醒沿用 `/admin/message/unread-count` 初始拉取 + SSE 刷新,和房务保持一致。
@@ -0,0 +1,10 @@
# 车务订单聊天前端入口与未读提醒
## 前端交接(截图反馈)
- 派单看板订单卡接入 `unreadMessageCount`:大于 0 显示消息红点,超过 9 显示 `9+`。
- 派单看板订单卡增加「联系定制师」按钮,使用该行 `orderId` 调用 `POST /admin/message/chat/open-fleet`,不要使用展示号 `id`。
- 订单详情弹窗增加「联系定制师」按钮,复用房务聊天抽屉和同一 `open-fleet` 接口;打开会话后自动标记已读。
- 右上角消息提醒沿用 `/admin/message/unread-count` 初始拉取 + SSE 刷新,和房务保持一致。
详细接口契约见同目录 `02_4689_车务订单聊天_定制师车务团队_新接口_管理后台.md`。