docs(changelog-v2): 站内信聊天 P1 加前端暂不接入横幅(仅后端就绪,前端暂缓动工) (#4020)

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 解析；发件人姓名后端快照写入，直接展示。