docs: 通知管理后台按总人数展示房务调整

这个提交包含在:
API Changelog Bot 2026-07-20 16:40:12 +08:00
父节点 fe6b35d235
当前提交 2608ed2bfa

查看文件

@ -0,0 +1,45 @@
# 房务调整提醒按总人数展示(修改接口)
## 目标前端
- **端类型管理后台Web**
- **目标仓库:`mmg/hl-ui`**
- **仓库地址:`https://git.1814.love:8443/mmg/hl-ui.git`**
- **联调/验收环境:`http://192.168.100.160:9527`**
- **小程序:无需处理**
## 背景
订单调整删除一名出行人后,房务端“订单调整提醒”曾显示人员类型变化,例如“儿童人数 2 → 1”。房务只需要核对订单总人数,因此后端统一调整为“总人数 4 → 3”。
## 接口语义变更
涉及调整记录及房务详情中复用的 `changeItems`
```json
{
"type": "HEADCOUNT",
"label": "总人数",
"before": "4",
"after": "3"
}
```
- 总人数发生变化时,只返回一条 `HEADCOUNT``label` 固定为 `总人数`
- 不再按成人、儿童、小童、婴儿分别返回多条 `HEADCOUNT`
- 人员类型变化但总人数不变时,不返回 `HEADCOUNT`
- 出行人明细及 `addedTravelerIds` 契约不变。
## 管理后台处理要求
1. 房务“订单调整提醒”直接展示 `label + before → after`,不得自行按人员类型重新计算。
2. 不要依赖旧的“成人人数/儿童人数/小童人数/婴儿人数”标签。
3. 历史调整记录仍可能保留旧标签,前端需要兼容只读展示;新记录按“总人数”展示。
## 验收
- 订单出行人由 4 人删除 1 人后,房务提醒显示“总人数 4 → 3”。
- 页面不显示“儿童人数 2 → 1”等人员类型变化。
- 总人数不变时不出现人数调整提醒。
后端关联:`wx/HL#5090`、PR `wx/HL#5091`