From 3c939270319ed71f9f7e60b90c3ba0c1af271d96 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 19 Jun 2026 11:16:39 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E7=AB=99=E5=86=85?= =?UTF-8?q?=E4=BF=A1=E8=81=8A=E5=A4=A9=20P2=20SSE=20=E5=AE=9E=E6=97=B6?= =?UTF-8?q?=E5=A5=91=E7=BA=A6(im-chat=20=E4=BA=8B=E4=BB=B6)=E5=B0=B1?= =?UTF-8?q?=E7=BB=AA=20(#4032)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...天P1-1对1会话6个管理端接口-新增接口-管理后台.md | 25 +++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) diff --git a/changelogs-v2/2026-06/19_4020_站内信升级聊天P1-1对1会话6个管理端接口-新增接口-管理后台.md b/changelogs-v2/2026-06/19_4020_站内信升级聊天P1-1对1会话6个管理端接口-新增接口-管理后台.md index 2c5d6a2..5f60967 100644 --- a/changelogs-v2/2026-06/19_4020_站内信升级聊天P1-1对1会话6个管理端接口-新增接口-管理后台.md +++ b/changelogs-v2/2026-06/19_4020_站内信升级聊天P1-1对1会话6个管理端接口-新增接口-管理后台.md @@ -175,11 +175,32 @@ POST /admin/message/chat/HOUSE:70123:1001:2046065465288949761/read | 阶段 | 内容 | 状态 | |------|------|------| -| **P1（本次）** | 6 个 admin 端点（open / 列表 / 线程 / 发消息 / 已读 / 聊天未读） | ✅ 已上测试服 | -| P2 | SSE 实时（角标实时刷 + 打开会话 live append + URGENT 强提示）+ 敏感词词库完善 | ⏳ 待开发 | +| **P1** | 6 个 admin 端点（open / 列表 / 线程 / 发消息 / 已读 / 聊天未读） | ✅ 已上测试服 | +| **P2** | SSE 实时推送（CHAT 走新增 `im-chat` 事件，含 URGENT priority）+ 敏感词 DFA（Hutool） | ✅ 已上测试服（后端就绪，前端接入时用，见下「SSE 实时契约」） | | P3 | 房务（order-v3）接入：配房页开会话 + 订单列表「未读红点」透传 | ⏳ 待开发 | | P4 | 车务（fleet）接入 | ⏳ 待开发 | +### SSE 实时契约（P2 后端已就绪，前端接入时用） + +复用现有 SSE 长连接 `GET /ws/admin-msg/stream`（EventSource，网关注入鉴权），**不新增连接**。一条连接上按 event 名分发： + +- **`message` 事件（现有系统通知，行为不变）**：前端原有监听**不用动**。 +- **`im-chat` 事件（P2 新增，聊天专用）**：对端在线时实时收到，payload： + +```json +{ + "type": "CHAT", + "adminId": "收件方adminId", + "unreadCount": 9, // 合并未读(聊天+通知)，直接刷顶部角标 + "conversationKey": "HOUSE:70123:101:205", + "senderName": "房务·小呼", + "preview": "标间超预算了…", + "priority": "URGENT" // URGENT 时前端做强提示(弹窗/声音) +} +``` + +前端用法：监听 `im-chat` → `unreadCount` 刷顶部角标；`conversationKey` 命中当前打开的会话则 live append 新气泡；`priority=URGENT` 强提示。**P2 是后端能力，前端接入仍待排期通知。** + --- ## 8. 注意事项