diff --git a/changelogs-v2/2026-09/10_7328_团期房务整团会话GROUP_HOUSE-新增接口-管理后台.md b/changelogs-v2/2026-09/10_7328_团期房务整团会话GROUP_HOUSE-新增接口-管理后台.md index 016ca916..1e647185 100644 --- a/changelogs-v2/2026-09/10_7328_团期房务整团会话GROUP_HOUSE-新增接口-管理后台.md +++ b/changelogs-v2/2026-09/10_7328_团期房务整团会话GROUP_HOUSE-新增接口-管理后台.md @@ -7,12 +7,12 @@ author: "wx(GIT)" change_type: "新增接口" backend_status: "deployed" gateway_status: "not_required" -frontend_status: "pending" +frontend_status: "verified" frontend_owner: "mmg" -frontend_ref: "" +frontend_ref: "0f2f5b1a" target_release: "" -verified_at: "2026-09-10" -status_note: "2026-09-10 squash 0f62fb072(PR #7490)已合并 dev-v3 并部署测试服:hl-user-service 与 hl-order-service-v3 均已滚到当前 tip 0f62fb072,两实例均 LISTEN、Nacos healthy=true enabled=true。三个端点均实测打通:open-group-house 未认领态不对称行为已验证——管理员侧 200,fwzz_pure01/shuxin/fwzz_lead01/test_admin 等非当前认领人角色全部 281002;真实 conversation_key=GROUP_HOUSE:2097500233511362561(按团期聚合主键建键);GET /v3/admin/order/group-batch/{groupBatchId} 响应确认带 houseChatUnreadCount。测试数据已清理(admin_message / admin_conversation_member 均 COUNT=0)。⚠️ 与工单转述核对,本次发现并订正三处(第①②处 2026-09-10 首次发布时已订正,第③④处为部署后复核新增):① ChatConversationRespVO(会话列表项)本次新增的是 groupBatchId/groupBatchNo/groupBatchName 三个字段,并没有 departDate(departDate 只在 ChatOrderCardVO/打开会话响应的团期卡上,会话列表接口读不到);② 281016(缺 groupBatchId)在标准 HTTP 请求路径下不可达,ChatOpenGroupHouseReqVO.groupBatchId 有 @NotNull,@Valid 会先在参数绑定阶段返回 400,281016 只是 ChatManager 内部方法的防御性兜底(源码注释原话如此);③ open-group-house 响应对「团未认领」的 peerAdminId 不是 null 而是占位常量 0(ChatManager.buildFullResp 直接回显 DB 成员行原值,不做归一化),只有会话列表接口(ConversationMemberService.fillGroupBatchSummaries)才会归一化成 null,且列表还受 last_message_at IS NOT NULL 过滤,没发过消息的会话根本不出现在列表里,2026-09-10 实测发现原口径「两处均为 null」有误,已在「关键变化」第 2 条订正;④ 网关对未路由的 /internal/** 路径(本单两个 internal 端点均未配 Path 路由)返回的是 HTTP 200 + 业务体 {"code":404,"message":"接口不存在: ..."}(GlobalErrorWebExceptionHandler 路由未命中分支),不是 403——JwtAuthFilter.isInternalPath() 的 403 分支存在但轮不到执行(请求在路由层已被拒),原口径「网关对 /internal/** 一律 403」不准确,已在「七、不影响范围」订正。此外发现一处工单未提及但同一 squash 里的关联变更:既有团期详情接口 GET /v3/admin/order/group-batch/{groupBatchId}(A2)顺带新增只读字段 houseChatUnreadCount,纯新增不影响既有契约,一并写在「关键变化」供前端知悉。" +verified_at: "2026-09-11" +status_note: "2026-09-10 squash 0f62fb072(PR #7490)已合并 dev-v3 并部署测试服:hl-user-service 与 hl-order-service-v3 均已滚到当前 tip 0f62fb072,两实例均 LISTEN、Nacos healthy=true enabled=true。三个端点均实测打通:open-group-house 未认领态不对称行为已验证——管理员侧 200,fwzz_pure01/shuxin/fwzz_lead01/test_admin 等非当前认领人角色全部 281002;真实 conversation_key=GROUP_HOUSE:2097500233511362561(按团期聚合主键建键);GET /v3/admin/order/group-batch/{groupBatchId} 响应确认带 houseChatUnreadCount。测试数据已清理(admin_message / admin_conversation_member 均 COUNT=0)。⚠️ 与工单转述核对,本次发现并订正三处(第①②处 2026-09-10 首次发布时已订正,第③④处为部署后复核新增):① ChatConversationRespVO(会话列表项)本次新增的是 groupBatchId/groupBatchNo/groupBatchName 三个字段,并没有 departDate(departDate 只在 ChatOrderCardVO/打开会话响应的团期卡上,会话列表接口读不到);② 281016(缺 groupBatchId)在标准 HTTP 请求路径下不可达,ChatOpenGroupHouseReqVO.groupBatchId 有 @NotNull,@Valid 会先在参数绑定阶段返回 400,281016 只是 ChatManager 内部方法的防御性兜底(源码注释原话如此);③ open-group-house 响应对「团未认领」的 peerAdminId 不是 null 而是占位常量 0(ChatManager.buildFullResp 直接回显 DB 成员行原值,不做归一化),只有会话列表接口(ConversationMemberService.fillGroupBatchSummaries)才会归一化成 null,且列表还受 last_message_at IS NOT NULL 过滤,没发过消息的会话根本不出现在列表里,2026-09-10 实测发现原口径「两处均为 null」有误,已在「关键变化」第 2 条订正;④ 网关对未路由的 /internal/** 路径(本单两个 internal 端点均未配 Path 路由)返回的是 HTTP 200 + 业务体 {"code":404,"message":"接口不存在: ..."}(GlobalErrorWebExceptionHandler 路由未命中分支),不是 403——JwtAuthFilter.isInternalPath() 的 403 分支存在但轮不到执行(请求在路由层已被拒),原口径「网关对 /internal/** 一律 403」不准确,已在「七、不影响范围」订正。此外发现一处工单未提及但同一 squash 里的关联变更:既有团期详情接口 GET /v3/admin/order/group-batch/{groupBatchId}(A2)顺带新增只读字段 houseChatUnreadCount,纯新增不影响既有契约,一并写在「关键变化」供前端知悉。 前端已交付(commit 0f2f5b1a):chat.js 加 openGroupHouseChat(键 GROUP_HOUSE:{groupBatchId} 团期聚合主键 String 透传,前端不自拼)+KEY_RE 扩展;ChatDrawer 支持 GROUP_HOUSE(open 分流/会话卡团期文本/未认领 peerAdminId=0 显「团期管理员」不占在线点),281002 复用固定文案不透原文、281017 拦截器透 message;入口①房务看板「联系团期管理员」②团期详情「联系房务」+houseChatUnreadCount 角标(标读/信令重拉,TEAM 口径不重算);两 internal 端点前端不接。" updated_at: "2026-09-10" base: "dev-v3" ---