docs(changelog): 车务看板列表红点已落地去待定(PR #4698/#4695)——BoardOrderRecordVO +orderId +unreadMessageCount
原 02_4689 §订单列表红点 标注「待定(端点待确认)」,现确认=派单看板 /admin/fleet/board/orders, 照房务 grab-pool 服务端注入 unreadMessageCount + 数字 orderId(前端开会话/红点用),已合并部署实测。
这个提交包含在:
父节点
0e32011617
当前提交
cde332a840
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
> 模块:管理后台 · 车管控制台 · 订单聊天
|
> 模块:管理后台 · 车管控制台 · 订单聊天
|
||||||
> 类型:**后端新增(已合并 dev-v3 + 部署测试服 + API 实测)** + 前端接入
|
> 类型:**后端新增(已合并 dev-v3 + 部署测试服 + API 实测)** + 前端接入
|
||||||
> 日期:2026-07-01 · 关联 PR #4690 / 工单 #4689
|
> 日期:2026-07-01 · 关联 PR #4690(聊天本体)+ #4698(看板列表红点+数字 orderId) / 工单 #4689 + #4695
|
||||||
> 说明:车务聊天是**房务订单聊天的团队化镜像**——会话键 `FLEET:{orderId}`,与房务 `HOUSE:{orderId}` 同构,大部分聊天接口**复用**。
|
> 说明:车务聊天是**房务订单聊天的团队化镜像**——会话键 `FLEET:{orderId}`,与房务 `HOUSE:{orderId}` 同构,大部分聊天接口**复用**。
|
||||||
|
|
||||||
## 模型
|
## 模型
|
||||||
@ -30,12 +30,17 @@ body:`{"orderId": 2071784830965620737}`(必填;可选 `peer`)
|
|||||||
- 车务回复:`senderRole=FLEET`。
|
- 车务回复:`senderRole=FLEET`。
|
||||||
- **定制师广播:`senderRole=null`**(团队会话无单一收件人的历史设计)。前端在 FLEET 会话内**按「非 FLEET 即定制师」渲染徽章**(有 `senderName` 可显示姓名)。
|
- **定制师广播:`senderRole=null`**(团队会话无单一收件人的历史设计)。前端在 FLEET 会话内**按「非 FLEET 即定制师」渲染徽章**(有 `senderName` 可显示姓名)。
|
||||||
|
|
||||||
## 【订单列表红点——需后端订单列表接口配合(待定)】
|
## 【订单列表红点——已落地(PR #4698 / 工单 #4695)】
|
||||||
车务侧「订单列表行内红点」的数据源是 `biz-unread-batch`(bizModule=FLEET,团队共享未读),但它是**服务间 internal 接口(Feign 直连、不经网关,前端不能直接调)**。
|
车管控制台订单列表 = **派单看板列表** `GET /admin/fleet/board/orders`(原型「联系定制师+红点」按钮挂在从该列表打开的派车弹窗,按 order.id 取未读)。已照房务 `grab-pool` 既定模式在该端点**服务端注入**,前端直接读每行字段,无需自己调 internal 接口:
|
||||||
- 需要**车管控制台订单列表所走的那个后端列表接口**像房务 `grab-pool` 一样,内部调 `biz-unread-batch(bizModule=FLEET)` 把每单未读塞进列表项(字段如 `unreadMessageCount`)。
|
|
||||||
- ⚠️ **待确认**:车管控制台的订单列表走哪个后端接口(order-v3 用车需求列表 / fleet-service 派单列表)?确定后由后端补这段 FLEET 未读透传(小改)。本次 PR 只交付了聊天本体 + 未读机制,列表透传是下一步。
|
### 派单看板列表行 `BoardOrderRecordVO` 新增 2 字段
|
||||||
|
- **`orderId`**(String·数字雪花):该单数字订单 id。⚠️ 原有 `id` 是**展示号**(如 `HL20260627115248778`),**不能**当会话键;前端开车务会话 `open-fleet`(会话键 `FLEET:{orderId}`)、行内红点都用这个 `orderId`。
|
||||||
|
- **`unreadMessageCount`**(Integer):本单**车务团队共享**未读数(定制师发未读→全体车务该行亮红点;任一车务读→全体清零;车务之间回复不计)。默认 0;user-service 不可达时软降级为 0,不影响列表。
|
||||||
|
|
||||||
|
前端车管控制台订单列表/派车弹窗直接:行 `unreadMessageCount>0` 显红点(`>9` 显 `9+`)、点「联系定制师」用行 `orderId` 调 `open-fleet`。矩阵/其它订单视图如需同款红点,拿到 `orderId` 后走同一 `open-fleet`/未读机制即可(看板列表是主入口,已透出)。
|
||||||
|
|
||||||
## 已验证
|
## 已验证
|
||||||
- open-fleet 实测:200 + 订单卡(HL20260630103610215·吕思远·游牧的森林-短途版)+ 会话三行(车务→定制师 / 定制师→团队 / admin_id=0 团队共享水位行)。
|
- open-fleet 实测:200 + 订单卡(HL20260630103610215·吕思远·游牧的森林-短途版)+ 会话三行(车务→定制师 / 定制师→团队 / admin_id=0 团队共享水位行)。
|
||||||
- 车务发消息→定制师收到(unread+1);车务读→团队共享水位推进(任一车务读全体清零)。
|
- 车务发消息→定制师收到(unread+1);车务读→团队共享水位推进(任一车务读全体清零)。
|
||||||
- 单测 user-service 3099 绿(房务基线零回归)。
|
- 单测 user-service 3099 绿(房务基线零回归)。
|
||||||
|
- **看板列表红点(PR #4698)实测**:`/admin/fleet/board/orders` 74 单每行含 `orderId`(真数字雪花)+ `unreadMessageCount`;定制师向某单广播一条→重查该行 `unreadMessageCount=1`(团队未读联动看板);user-service 软降级路径不阻断列表。fleet-service 全量 1307 测试绿、ArchTest 11/11。
|
||||||
|
|||||||
正在加载...
x
在新工单中引用
屏蔽一个用户