4.5 KiB
4.5 KiB
schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base, generated
| schema | ticket | title | consumer | author | change_type | backend_status | gateway_status | frontend_status | frontend_owner | frontend_ref | target_release | verified_at | status_note | updated_at | base | generated |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hl-changelog/v2 | 5797 | 车务聊天定制师端气泡永远「已送达」修复——车务读过即显示「已读」，并新增定制师端点对点 READ 信令 | admin | wx(GIT) | 修复 | deployed | not_required | not_required | mmg | 2026-08-10 | 接口契约零变化，前端无需改动即生效（readByPeer 字段在车务会话首次真正有值）。附带新增：车务团队读后向定制师推点对点 im-chat-read 信令，SSE 角标实时化接线时可顺带消费实现气泡实时翻「已读」。测试服 16:00 后已用真实 API + Redis 信令抓包验证通过。 | 2026-08-10 | dev-v3 | 2026-08-10T16:20:00+08:00 |
车务/聊天: 定制师端气泡永远「已送达」修复——车务读过即显示「已读」
服务: hl-user-service PR: #5799 Issue: #5797 日期: 2026-08-10 影响范围: 管理后台车务订单聊天（FLEET:{orderId} 会话）定制师端气泡已读态；聊天 READ 信令
一、背景
定制师在订单详情聊天框给车务发消息后，无论车务/超管是否已打开聊天窗读过，定制师端气泡永远显示「已送达」、刷新也不变「已读」。服务端团队共享已读水位其实一直在正常推进（#5792 修复后车务侧红点清零正常），坏的只是定制师端「读出来」这半边——#4689 车务聊天上线起即存在。
二、根因（后端，接口契约无关）
车务团队占位 adminId=0 与房务「抢单前无人接单」占位 0 撞值：定制师成员行的对端恒为 0（=车务团队），后端解析对端已读水位时把 0 一律当房务占位短路返 null → readByPeer 恒 false。
三、变更（均后端内部，接口路径/请求/响应结构零变化）
| # | 变化 |
|---|---|
| 1 | 对端=车务团队时改读 admin_id=0 团队行共享水位 → 任一车务/获准超管读过，定制师端 readByPeer 即为 true（open / open-fleet / 消息分页单一漏斗全覆盖）；房务抢单前占位行为不变 |
| 2 | 新增：车务团队读且水位实际推进时，向当前定制师推一条点对点 im-chat-read 信令（payload：adminId=定制师、readerAdminId、lastReadMessageId、conversationKey；此前定制师收不到任何 READ——团队清零信令只按 VEHICLE_MANAGER 角色广播） |
| 3 | 读侧对齐发送侧「定制师身份优先」：定制师本人持超管角色打开自己会话时，推进自己行而非团队水位（否则自读会把自己气泡刷成「已读」） |
四、对前端的影响
- 无需改动即生效：刷新/重开聊天框后，
readByPeer在车务会话首次真正有值，气泡按现有渲染逻辑显示「已读」。 - 给 SSE 角标实时化接线的顺带增强（见关联 changelog）：定制师端现在会收到点对点
im-chat-read信令，接入 chatSignalBus 后可把「自己发的、id<=lastReadMessageId」的气泡实时翻成「已读」，不必等刷新。信令结构与既有 #4289 点对点 READ 完全一致，无新字段。
五、验证证据（2026-08-10 测试服）
| 验证点 | 实测 |
|---|---|
| 定制师视角发消息、车务未读 | readByPeer=false（不误报） |
| 车务读后定制师拉线程 | readByPeer=true（此前恒 false） |
| 真实车务团队读（open-fleet） | 团队行水位 673→714、unread 1→0 |
| READ 信令 Redis 抓包 | 两条：团队广播（targetRole=VEHICLE_MANAGER）+ 点对点（adminId=定制师），水位正确 |
| 定制师本人（超管）自读 | 团队行水位不动（不再自己读自己） |
- 单测：新增 11 例，chat 相关 219+33 全绿。
- 现场顺带修复：订单 26-9313 定制师端三条「已送达」消息，部署后刷新即显示「已读」。
关联 / 联系人
链接
- Issue: #5797
- PR: #5799
- Merge commit: 31ffa7459
- 相关 changelog:
changelogs-v2/2026-08/10_frontend_车务看板聊天角标实时化与已读联动-前端优化-管理后台.md（SSE 接线时消费本单新增的点对点 READ 信令） - 前置修复: #5792（车务读→团队红点清零半边）