234527639f
43 #4573 配房询房即扣库存+单日确认requirementId+弹窗全态回显currentSelections(前端必改) 44 #4574 日历团数按团期折叠修复+某天下钻详情新端点 45 #4575 待办按订单聚合一行多类型标签+类型字典化(前端必改) 46 #4578 定制师联系房务未读角标unreadMessageCount+站内信标题团号·联系人 47 #4576 转单操作日志显示接收人真名+转单理由(知悉)
31 行
2.1 KiB
Markdown
31 行
2.1 KiB
Markdown
# 定制师侧「联系房务」未读角标 unreadMessageCount + 订单类型站内信标题改「团号·联系人」（前端对接）
|
||
|
||
> 模块：订单详情/行程安排（定制师侧）· 站内信收件箱（管理后台）
|
||
> 类型：出参新增字段 + 标题渲染变更（PR #4590/#4593（修boot）/#4589 已合 dev-v3 + 测试服实测）
|
||
> 关联工单：#4578 / #4577
|
||
> 日期：2026-06-28
|
||
|
||
## 1. 【出参新增·对接】定制师侧「联系房务」未读消息角标
|
||
|
||
房务反馈「订单详情 / 行程安排页的『联系房务』按钮，有未读消息时要显示未读数角标」。
|
||
|
||
- 定制师侧订单详情 `GET /admin/order/orders/{id}` 与 行程安排 `GET /admin/order/orders/{id}/itinerary` **新增出参 `unreadMessageCount`**（Integer）。
|
||
- = 当前登录定制师在该订单 HOUSE 会话中的未读消息数；无未读返 0。
|
||
- 软依赖：消息服务临时不可达时降级返 0，不阻断订单详情主流程。
|
||
- **前端对接**：在「联系房务」按钮上按 `unreadMessageCount > 0` 显示未读角标（数字）。
|
||
|
||
（房务侧订单详情/我的接单列表此前已有 `unreadMessageCount` / `tabCounts.unreadMessageCount`，本次补的是**定制师侧**两个接口。）
|
||
|
||
## 2. 【标题变更·知悉】订单类型站内信标题改「团号 · 联系人」
|
||
|
||
房务反馈「订单类型的站内信标题太长，要换成团号+联系人短的」。
|
||
|
||
- 站内信收件箱 `GET /admin/message/list` 中「订单消息」(kind=CHAT 聊天) 的展示标题由 `【聊天】发件人（角色）` 改为 **`订单号 · 客户姓名`**（如 `HL20260628142754274 · 赵建国`）。
|
||
- 取不到订单摘要（非 HOUSE 会话 / 消息服务降级）时回退原 `【聊天】发件人` 兜底。
|
||
- 「核房记录已更新」等普通消息(NOTIFY) 标题不变。
|
||
- 前端无需改，标题自动变短。
|
||
|
||
## 测试服实测
|
||
- 定制师订单详情/行程安排返 `unreadMessageCount`（无未读=0；底层 admin_conversation_member.unread_count 增量打通）。
|
||
- 站内信订单消息标题 = 「HL… · 赵建国」/「HL… · 周明远」；普通消息标题不变。
|