From 567004c69839c1b9d9a21dbd49088953edd40c28 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sat, 18 Apr 2026 21:26:13 +0800 Subject: [PATCH] =?UTF-8?q?=E7=8F=AD=E6=9C=9F=E4=BF=9D=E5=AD=98=20?= =?UTF-8?q?=E6=9C=80=E5=A4=A7=E4=BA=BA=E6=95=B0=20=E6=94=B9=E4=B8=BA?= =?UTF-8?q?=E9=9D=9E=E5=BF=85=E5=A1=AB=EF=BC=88=E5=8F=8D=E8=BD=AC=E4=B8=8A?= =?UTF-8?q?=E4=B8=80=E7=89=88=EF=BC=8CPR=20#865=20#862=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...t-v2_schedule-max-participants-optional.md | 61 +++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 changelogs/2026-04/2026-04-18_product-v2_schedule-max-participants-optional.md diff --git a/changelogs/2026-04/2026-04-18_product-v2_schedule-max-participants-optional.md b/changelogs/2026-04/2026-04-18_product-v2_schedule-max-participants-optional.md new file mode 100644 index 0000000..56ea902 --- /dev/null +++ b/changelogs/2026-04/2026-04-18_product-v2_schedule-max-participants-optional.md @@ -0,0 +1,61 @@ +# 班期保存 - 最大参与人数 改为非必填（反转 2026-04-18 上一版 changelog） + +**日期**: 2026-04-18 +**PR**: #865 → 合并到 dev，已部署测试环境 +**Issue**: #862 +**影响端**: 管理后台 Web (hl-ui-admin) +**影响接口**: +- `POST /admin/product/item/{id}/schedule` (Step4 创建班期) +- `PUT /admin/product/item/{id}/schedule` (Step4 修改班期) +- `POST /admin/product/item/{id}/schedule/batch-create` (Step4 班期批量创建) + +## ⚠️ 反转上一版 +本 changelog 反转 `2026-04-18_product-v2_schedule-max-participants-required.md`（PR #861）。产品侧确认：**班期定价页的"最大人数"按用户交互本意就是非必填**（不填=不限）。上一版把 `@NotNull` 补强的方向是错的，本次撤回。 + +## 行为变化 + +| 字段 | 前端是否必填 | 不传时后端行为 | 说明 | +|---|---|---|---| +| `maxParticipants`（最大人数）| **否** | 兜底写 DB 为 `0`（0=不限） | 报名/库存校验对 `0=不限` 不再恒拒 | +| `maxRooms`（最大房间数）| **否，前端不传** | 后端自动取 `product_basic.default_room_count`（每天最少房间数，行程 Step2 自动算好）；无 default 则 0=不限 | 行为无变化，本次明确文档化 | +| `productStockLimit`（库存上限）| **否** | 写 DB `NULL`（不限） | 行为无变化，本次明确文档化 | + +三者前端表单均**不要标红星**，不要做 required 校验。 + +## 请求体示例（最小体） + +```json +POST /admin/product/item/{id}/schedule +{ + "departureDate": "2027-06-01", + "adultPrice": 2999.00, + "childPrice": 1999.00 +} +``` + +上面请求合法返回 200，DB 存 `max_participants=0 / max_rooms= / product_stock_limit=NULL`。 + +## 下游接口（/internal/batch-info）联动 + +`InternalProductService.getBatchInfo` 回传字段 `remainingSlots`： +- 当班期 `maxParticipants <= 0`（不限）：`remainingSlots = Integer.MAX_VALUE`（2147483647） +- 否则：`remainingSlots = maxParticipants - enrolledCount` + +下游（订单服务）若展示"剩余名额"，建议判断 `>= Integer.MAX_VALUE` 时显示"不限"而非具体数字。 + +## DB DDL（已在测试环境应用） + +```sql +ALTER TABLE group_tour_batch + MODIFY COLUMN max_participants INT(11) NOT NULL DEFAULT 0 + COMMENT '最大参与人数(0=不限)'; +``` + +## 不影响 + +- 字段名、字段类型不变 +- `ScheduleRespVO` / `MpScheduleRespVO` 返回结构不变 +- 其他字段校验规则不变 +- 订单名额扣减逻辑：`maxParticipants > 0` 时仍按原逻辑控卡 + +🤖 Generated with [Claude Code](https://claude.com/claude-code)