docs(changelog): #7322 菜单种子已落地（PR #7467），补部署两条注意事项
changelog-filename-gate / validate (push) Successful in 3s
changelog-filename-gate / validate (push) Successful in 3s
sys_menu 两行抢单池入口已由 V20260910_001 补上。 部署须知：#7322 部署清单本次起必须带 hl-user-service； 菜单树按 roleId 缓存 Redis（TTL 3600s），部署后需 DEL cache:menu:tree:role:*。 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
这个提交包含在：
API Changelog Bot
@@ -12,7 +12,7 @@ frontend_owner: "mmg"
|
|||||||
frontend_ref: ""
|
frontend_ref: ""
|
||||||
target_release: ""
|
target_release: ""
|
||||||
verified_at: ""
|
verified_at: ""
|
||||||
status_note: "本篇覆盖 PR #7436（合并提交 ab4118a01）。2026-09-10 已部署测试服（HEAD 6d41d6148，已验 ab4118a01 为其祖先），Flyway V20260910_301 执行成功，order_group_batch 三列 house_claimer_id/house_claimer_name/house_claimed_at 已落库。32 条验收项中 28 条已取证，含用 5 个真实登录账号过网关实测的归属与接管链路。⚠️ 尚缺一项交付：后台菜单（sys_menu）的两行抢单池入口尚未随 迁移落库，已另行补 Flyway；在那之前新端点只能直接调用、后台菜单里点不到。"
|
status_note: "本篇覆盖 PR #7436（合并提交 ab4118a01）。2026-09-10 已部署测试服（HEAD 6d41d6148，已验 ab4118a01 为其祖先），Flyway V20260910_301 执行成功，order_group_batch 三列 house_claimer_id/house_claimer_name/house_claimed_at 已落库。32 条验收项中 28 条已取证，含用 5 个真实登录账号过网关实测的归属与接管链路。后台菜单（sys_menu）的两行抢单池入口已由 PR #7467（squash 7f791a250，hl-user-service 的 V20260910_001）补上。⚠️ 部署两条：① #7322 的部署清单原本不含 hl-user-service，本次起必须带上；② 菜单树按 roleId 缓在 Redis（cache:menu:tree:role:{roleId}，TTL 3600s），Flyway 直连 DB 不触发失效，部署后需 DEL cache:menu:tree:role:* 否则最长要等一小时。"
|
||||||
updated_at: "2026-09-10"
|
updated_at: "2026-09-10"
|
||||||
base: "dev-v3"
|
base: "dev-v3"
|
||||||
---
|
---
|
||||||
@@ -39,7 +39,7 @@ base: "dev-v3"
|
|||||||
6. **`GET /v3/admin/order/group-batch/{groupBatchId}`（团期详情）追加 3 个只读字段**：`houseClaimerId` / `houseClaimerName` / `houseClaimedAt`（均可空，未认领为 `null`），供团期管理员侧展示「负责房务」。
|
6. **`GET /v3/admin/order/group-batch/{groupBatchId}`（团期详情）追加 3 个只读字段**：`houseClaimerId` / `houseClaimerName` / `houseClaimedAt`（均可空，未认领为 `null`），供团期管理员侧展示「负责房务」。
|
||||||
7. **团级指针是团单房务归属的唯一真源，认领/接管不回写任何户级字段**（不动 `claimer_id`/`status`/`house_status`/`room_control_status`，不 fire 户级状态机，不绑会话，不广播 SSE）——认领后户级 `room_control_status` 仍会显示「待配房」直到后续订房工单（`#7325`）把它置 `DONE`，这是有意为之，不是缺陷。
|
7. **团级指针是团单房务归属的唯一真源，认领/接管不回写任何户级字段**（不动 `claimer_id`/`status`/`house_status`/`room_control_status`，不 fire 户级状态机，不绑会话，不广播 SSE）——认领后户级 `room_control_status` 仍会显示「待配房」直到后续订房工单（`#7325`）把它置 `DONE`，这是有意为之，不是缺陷。
|
||||||
8. **无 SSE 广播**：团期池/我的团页面需前端手动或定时刷新，不会像普通抢单池那样实时推送变更。
|
8. **无 SSE 广播**：团期池/我的团页面需前端手动或定时刷新，不会像普通抢单池那样实时推送变更。
|
||||||
9. **不新增权限码**，5 个新端点走既有的「房务角色门」（`HouseWriteGuard`，写口）与新增的读口角色门（`ROOM_MANAGER`/`house_keeper_lead`/`SUPER_ADMIN`，否则 808090），hl-user-service **零 Flyway**（菜单种子是否需要待确认，见「口径与定案 #11」，如需要会是独立的 user-service Flyway，不影响本篇端点契约）。
|
9. **不新增权限码**，5 个新端点走既有的「房务角色门」（`HouseWriteGuard`，写口）与新增的读口角色门（`ROOM_MANAGER`/`house_keeper_lead`/`SUPER_ADMIN`，否则 808090），菜单种子（`sys_menu`）**确实需要**，已由独立的 hl-user-service Flyway `V20260910_001__add_house_grab_pool_menus.sql`（PR #7467）落地，**不影响本篇端点契约**。
|
||||||
10. **数据库变更**：`order_group_batch` 新增 3 列 + 1 索引（`V20260910_301__order_group_batch_add_house_claimer.sql`），无新表。
|
10. **数据库变更**：`order_group_batch` 新增 3 列 + 1 索引（`V20260910_301__order_group_batch_add_house_claimer.sql`），无新表。
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -942,7 +942,7 @@ Authorization: Bearer <团期管理员 token>
|
|||||||
- 团期看板权限地基 #6902、团期需求确认/打回 #7210：本单角色门不复用这两处的平台权限码体系，走既有的 `HouseWriteGuard` 房务角色门。
|
- 团期看板权限地基 #6902、团期需求确认/打回 #7210：本单角色门不复用这两处的平台权限码体系，走既有的 `HouseWriteGuard` 房务角色门。
|
||||||
- 团期房务批次后续工单：`#7323`（订房地基/扣减来源分支）、`#7324`（房务团期看板/订房计划 CRUD，读本单 `GroupBatchDetailRespVO` 新三字段、提供 `countActivePlans` 供本单 808660 使用）、`#7325`/`#7326`（按日确认与自动分房、分房微调）、`#7327`（双源巡检契约）、`#7328`（房务↔团期管理员会话，参与人取本单 `house_claimer_id`）。
|
- 团期房务批次后续工单：`#7323`（订房地基/扣减来源分支）、`#7324`（房务团期看板/订房计划 CRUD，读本单 `GroupBatchDetailRespVO` 新三字段、提供 `countActivePlans` 供本单 808660 使用）、`#7325`/`#7326`（按日确认与自动分房、分房微调）、`#7327`（双源巡检契约）、`#7328`（房务↔团期管理员会话，参与人取本单 `house_claimer_id`）。
|
||||||
- 旧拟议契约 `docs/group/团期模块接口文档-v2.0.html` GB-ADM-016（`POST /v3/admin/order/group-batch/{groupBatchId}/hotel-requirements/claim`，逐户批量薄编排）**已被本单替代**，不采用该旧契约。
|
- 旧拟议契约 `docs/group/团期模块接口文档-v2.0.html` GB-ADM-016（`POST /v3/admin/order/group-batch/{groupBatchId}/hotel-requirements/claim`，逐户批量薄编排）**已被本单替代**，不采用该旧契约。
|
||||||
- **待确认（口径与定案 #11）**：房务管家菜单是否需要 `sys_menu` 种子行（hl-user-service Flyway），需连测试库核实后由管理者补充，不影响本篇端点契约本身。
|
- **已确认（口径与定案 #11）**：房务管家菜单**确由 `sys_menu` 驱动**（该目录 `menu_id=2064956343462092801` 下已有 4 个既有子菜单：订单列表 / 日历视图 / 待处理 / 月度对账），故需种子行；已由 **PR #7467** 落地：「抢单池·普通」`/housekeeper/grab-pool`、「抢单池·团期」`/housekeeper/grab-pool-group`，`sort_order` 5/6 接在既有四项之后，授 `ROOM_MANAGER`/`house_keeper_lead`/`SUPER_ADMIN`（**不授 ADMIN**：团期读口有角色门，ADMIN 调必得 808090）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -956,4 +956,4 @@ Authorization: Bearer <团期管理员 token>
|
|||||||
### 联系人
|
### 联系人
|
||||||
|
|
||||||
- **后端负责人**: wx
|
- **后端负责人**: wx
|
||||||
- **待确认对象（前端 hl-ui）**: mmg——房务管家需新增「抢单池·团期」「我的团」两个页面（含团级接管的超管专属入口）；普通抢单池「产品类型」筛选下拉建议隐藏 `GROUP` 选项；团期详情页展示「负责房务」三字段；无 SSE，页面需手动或定时刷新；`sys_menu` 菜单种子的 `path`/`component` 命名请回复后由管理者补 Flyway
|
- **待确认对象（前端 hl-ui）**: mmg——房务管家需新增「抢单池·团期」「我的团」两个页面（含团级接管的超管专属入口）；普通抢单池「产品类型」筛选下拉建议隐藏 `GROUP` 选项；团期详情页展示「负责房务」三字段；无 SSE，页面需手动或定时刷新；⚠️ **菜单路由请确认**——两个页面是「抢单池·普通」与「抢单池·团期」，**「我的团」是团期页内的一个 Tab、不是独立页面**（本行先前写成两个页面与工单两处口径不符，2026-09-10 订正）。迁移已先行落地（`/housekeeper/grab-pool` 与 `/housekeeper/grab-pool-group`，按同目录既有四行的风格）——理由：hl-ui 找不到组件会回落「开发中」页、不白屏不报错，**有一个落到「开发中」的菜单项，好过没有菜单项**。若实际路由不同，回一句我补一个迁移覆写（`menu_id` 不变、无副作用）；`sort_order` 想调也一并说。
|
||||||
|
|||||||
在新工单中引用
屏蔽一个用户