docs(changelog): 通知前端 — 产品详情移除 defaultRoomCount / 班期编辑状态随库存自动联动(均测试服验证)

这个提交包含在:
API Changelog Bot 2026-05-30 11:16:02 +08:00
父节点 b2dc6ad474
当前提交 995980d360
共有 2 个文件被更改,包括 58 次插入0 次删除

查看文件

@ -0,0 +1,28 @@
# 【管理后台】产品详情响应移除 defaultRoomCount(默认房间数)字段
> **类型**: 后端响应移除字段(死字段清理)
> **服务**: hl-product-service-v2
> **日期**: 2026-05-30
> **影响范围**: 管理后台 `GET /admin/product/item/{id}` 及内部产品详情 DTO
> **归属**: 后端已改(PR #3278 → dev,已同步 dev-v3)
> **状态**: 已部署测试服并验证通过(响应不再含该字段)
> **关联工单**: #3266 收尾
---
## 一、变更
产品详情响应不再返回 `defaultRoomCount`(默认房间数)。
- 该字段原是"行程住宿各天最小房间数"的聚合值,唯一用途是小蒙马班期创建时自动填充 maxRooms。
- #3258 已把班期 maxRooms 与行程**彻底脱钩**,该字段从此**无任何消费者**,本次随死字段清理移除。
- 与早先《小蒙马行程「住宿安排」房间数选择器移除》一脉相承(行程房间数对小蒙马已无作用)。
## 二、前端处理
- 若前端有读取 `productDetail.defaultRoomCount` 的地方(通常在行程住宿/班期相关展示),**移除该读取**;小蒙马班期房间数请改用班期自身的「最大房间数」maxRooms。
- DB 列 `product_basic.default_room_count` 暂保留为无映射废弃列(不影响,后续统一清理),仅响应不再透出。
## 三、测试服实测
`GET /admin/product/item/{id}` 返回体 `data` 中已无 `defaultRoomCount` 键(code=200)。

查看文件

@ -0,0 +1,30 @@
# 【管理后台】小蒙马班期编辑后状态随库存自动联动(满→FULL/恢复→ENROLLING)
> **类型**: 后端行为增强(状态联动)
> **服务**: hl-product-service-v2
> **日期**: 2026-05-30
> **影响范围**: 管理后台班期保存 `POST/PUT /admin/product/item/{id}/schedule`
> **归属**: 后端已改(PR #3277 → dev,已同步 dev-v3)
> **状态**: 已部署测试服并验证通过
> **关联工单**: #3266
---
## 一、变更(前端通常无需改动,仅告知)
编辑班期后,后端会按最新库存**自动联动持久 batchStatus**:
- 把「最大房间数」调小 / 「线下占位」调大,导致库存(可报名)≤0 → 状态自动变 `FULL`(已满额)。
- 反向把库存恢复到 >0 → 状态自动变回 `ENROLLING`(报名中)。
- 取消态(CANCELLING/CANCELLED)不受此联动影响。
这补齐了此前"只在新建班期时拦截库存0"的缺口,使后台列表的持久状态始终与实时库存一致。
## 二、前端
- 前端继续按 `batchStatus` 渲染即可(只对 `ENROLLING` 放开报名),**无需新增逻辑**。
- 编辑保存后刷新列表即可看到状态随库存联动后的最新值。
## 三、测试服实测
班期 maxRooms=5 → ENROLLING;编辑为 maxRooms=2+线下占位=2(库存=0)→ 自动 FULL;再编辑线下占位=0(库存=2)→ 自动回 ENROLLING。