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 96d0b0c..2c5d6a2 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 @@ -9,9 +9,15 @@ --- -## ⚠️ 关键说明(前端务必先读) +## 🛑 前端暂不需要接入(2026-06-19 更新,最高优先级) -1. **本期 P1 没有实时推送(SSE)**。聊天靠「发消息 + 拉线程 + 轮询未读」的请求/响应模式工作;实时角标冒泡(顶部铃铛实时 +1、打开的会话 live append 新气泡)是 **P2** 再上。P1 阶段前端可用**轮询**(如进入会话时拉线程、定时拉 `unread-total`)先把界面跑起来。 +**本次仅「后端 P1」就绪,前端聊天 UI 集成暂缓——收到本文先不用动工。** 本文档是后端接口的**提前留档/参考**,**不是开工通知**;待产品排期、正式通知前端接入时再据此对接。下方接口说明仅供后端联调与未来参考。 + +--- + +## ⚠️ 关键说明(前端正式接入时再读) + +1. **本期 P1 没有实时推送(SSE)**。聊天靠「发消息 + 拉线程 + 轮询未读」的请求/响应模式工作;实时角标冒泡(顶部铃铛实时 +1、打开的会话 live append 新气泡)是 **P2** 再上。前端正式接入时可用**轮询**(如进入会话时拉线程、定时拉 `unread-total`)先把界面跑起来。 2. **能力归属 user-service,复用现有站内信**。聊天行和系统通知行同表(`admin_message`),顶部**合并未读角标**(聊天+通知合计)继续走现有 `GET /admin/message/unread-count`,本次**不变**;本期新增的 `GET /admin/message/chat/unread-total` 只给「聊天 Tab」单独展示聊天未读数。 3. **一个订单 × 一对人 = 一个对话框**(不是整单一个群)。会话靠 `conversationKey` 唯一定位,订单 ID 已编入键;订单详情页「围绕这个订单的全部对话」= 调会话列表接口按 `bizModule=HOUSE&bizId=订单ID` 过滤。 4. **前端不传 adminId / 姓名**。当前操作人由网关注入的 token 解析;发件人姓名后端快照写入,直接展示。