调整Rooming List付款方式选项

This commit is contained in:
andy
2026-07-22 17:31:55 +07:00
parent 7e2cd8969f
commit 0de960372b
14 changed files with 74 additions and 25 deletions

View File

@@ -33,7 +33,7 @@ CP2 目标调整:
- 后端从来源 Excel 的 `旅游日期` 列解析入住日期和离店日期,不再要求前端手填 `arrival` / `departure`
- 后端按分房结果计算目标 `Adults`,不再要求前端手填 `adults`
- 目标默认值区域只保留 `Payment Type``Nationality` 两个字段。
- `Payment Type` 前端默认为 `CA`,后端也按 `CA` 作为当前唯一允许值校验。
- `Payment Type` 前端默认为 `BTQR`,当前可选择 `BTQR``CA`,后端按同一枚举校验。
- `Nationality` 前端只允许选择 `KR``CHN`,后端按同一枚举校验。
第一阶段不做:
@@ -169,7 +169,7 @@ people_per_room = 3
| `Number of Rooms` | 第一版每行固定为 `1`,后续如目标模板变化再调整 |
| `Adults` | CP2 由后端按当前房间实际人数派生 |
| `Children` | CP2 固定为 `0` |
| `Payment Type` | 前端选择;当前默认和唯一允许值为 `CA` |
| `Payment Type` | 前端选择;当前默认值为 `BTQR`,允许 `BTQR``CA` |
| `VIP` | CP2 固定为空,后续如有稳定默认值再单独确认 |
| `Accompanying Guests` | 同房其他旅客姓名,英文逗号分隔 |
| `Nationality` | 前端选择;当前只允许 `KR``CHN` |
@@ -202,7 +202,7 @@ Content-Type: multipart/form-data
| `hotel_id` | string | 否 | 酒店 ID不传时按当前登录用户默认酒店或单酒店上下文解析 |
| `people_per_room` | integer | 是 | 每间房人数,必须大于 0 |
| `room_type` | string | 是 | 目标 Excel 的 `Room Type` |
| `payment_type` | string | 否 | CP2 目标 Excel 的 `Payment Type`;为空时后端按 `CA` 处理;当前只允许 `CA` |
| `payment_type` | string | 否 | CP2 目标 Excel 的 `Payment Type`;为空时后端按 `BTQR` 处理;当前只允许 `BTQR``CA` |
| `nationality` | string | 是 | CP2 目标 Excel 的 `Nationality`;当前只允许 `KR``CHN` |
CP2 不再接收以下前端业务字段作为生成依据:
@@ -244,7 +244,7 @@ Content-Disposition: attachment; filename="rooming-list-<timestamp>.xlsx"
- multipart 必填字段缺失,返回 `ROOMING_LIST_VALIDATION_FAILED`
- `people_per_room` 数字格式错误,返回 `ROOMING_LIST_VALIDATION_FAILED`
- `payment_type``CA`,返回 `ROOMING_LIST_VALIDATION_FAILED`
- `payment_type``BTQR` / `CA`,返回 `ROOMING_LIST_VALIDATION_FAILED`
- `nationality``KR` / `CHN`,返回 `ROOMING_LIST_VALIDATION_FAILED`
- 来源文件缺失、非 `.xls` / `.xlsx`、无法读取、缺少 `护照全名` 表头或缺少 / 无法解析 `旅游日期` 表头,返回 `ROOMING_LIST_SOURCE_FILE_INVALID`
- 同一来源文件出现多个不同旅游日期区间CP2 返回受控错误,不生成 Excel。
@@ -309,7 +309,7 @@ RESERVATION_ROOMING_LIST_GENERATE
- 填写每间房人数。
- 填写目标 `Room Type`
- 目标默认值区域只保留 `Payment Type``Nationality`
- `Payment Type` 使用下拉或固定选择,默认 `CA`,当前不开放其他值
- `Payment Type` 使用下拉选择,默认 `BTQR`,当前可选择 `BTQR``CA`
- `Nationality` 使用下拉,只允许 `KR``CHN`
- 展示解析预览:总人数、预计房间数、前几行分房结果。
- 点击生成后下载 `.xlsx`
@@ -336,7 +336,7 @@ RESERVATION_ROOMING_LIST_GENERATE
- 尾房人数不足时仍生成一行。
- `Adults` 按每个房间实际人数派生,尾房人数不足时不使用满房人数。
- `Children` 默认为 `0`
- `payment_type` 为空时按 `CA` 处理,非 `CA` 返回受控错误。
- `payment_type` 为空时按 `BTQR` 处理,非 `BTQR` / `CA` 返回受控错误。
- `nationality=KR` / `CHN` 成功,其他值返回受控错误。
- 来源文件中多个不同旅游日期区间返回受控错误。
- 缺少 `旅游日期` 表头或旅游日期格式无法解析时返回受控错误。