文件
hl-api-changelog/changelogs-v2
API Changelog Bot fc6f223419
changelog-filename-gate / validate (push) Successful in 2s
docs(changelog): #7324 房务团期看板与整团按日订房计划 CRUD(H1-H6 + release-all)
七个新端点的前端交接件,重点写清四处「后端行为对、前端按直觉写会踩坑」的地方:

1. H1 列表 total 可能是 -1,语义是「未统计」——传 planStatus 且扫描页(500)被填满时
   走内存过滤降级路径。全仓其它分页都保证 total >= 0,直接拿它算总页数会出负页码。
2. H5 只传 version 的空提交:PENDING 行返 200 且只把 version +1(updateById 默认
   NOT_NULL 策略,null 不进 SET 子句,不清空任何业务字段),CONFIRMED 行抛 808692。
3. release-all 会返回「200 但什么都没释放」——整团都是过去的已确认行时,
   releasedPlanIds 为空、retainedPastPlanIds 非空、warnings=[PAST_STAY_RETAINED],
   与「团里根本没订房」的 808619 幂等出口是两条不同分支。
4. H4 响应恒带两个空数组 warnings / removedManualAllocIds(与 H5 共用 RespVO)。

另记两条与工单口径不一致、以源码为准的事实:
- 错误码实际新增 17 个(工单写 12 个),已按 HouseGroupBatchErrorCode 逐个列出。
- 部署顺序:hl-resource-service 必须先于 hl-order-service-v3,反序会让 order-v3 拿到
  roomCategory=null,fail-closed 房型守卫把每次 H4/H5 提交拒成 808691。

Refs #7324
2026-09-10 18:50:32 +08:00
..