docs(changelog): 配房流程简化 #4052+#4055(取消房务驳回改单向走聊天 + 最终确认回执改不必填)

这个提交包含在:
API Changelog Bot 2026-06-19 15:43:28 +08:00
父节点 52da3f6e7f
当前提交 a66f2acd86

查看文件

@ -0,0 +1,58 @@
# 配房流程简化 — 取消房务供应侧驳回(改单向·走聊天)+ 最终确认回执改不必填 — 行为变更 — 管理后台
> 变更类型:🔧 行为变更(取消房务驳回端点 + 最终确认放开回执强制)
> 端类型:管理后台(房务管家 → 配房面板 / 最终确认)
> 日期2026-06-19
> 服务hl-order-service-v3house 模块)
> PRhttps://git.1814.love:8443/wx/HL/pulls/4054 Closes #4052、https://git.1814.love:8443/wx/HL/pulls/4056 Closes #4055
---
## ⚠️ 关键说明给前端,2 处都要改)
### 1. 取消房务「驳回需求」功能(流程改单向)
配房流程改为**上游(定制师/团期管理员)→ 房务 单向**:房务不再有「驳回需求/打回退上游」功能,配不出时改用**站内聊天对话框INAPP-CHAT**与上游沟通。
- **房务管家配房面板请移除「驳回/打回」按钮**——后端端点 `POST /v3/admin/order/{id}/hotel-requirement/supplier-reject` **已删除**,再调会返 `404 接口不存在`
- 配房状态流从「待配房→配房中→**驳回**→配房中→回配成功」简化为 **「待配房→配房中→回配成功」**。
- 配不出/有疑问 → 走聊天与定制师沟通(聊天模块已上线)。
> 注:**团期管理员打回定制师**`/hotel-requirement/reject`,PENDING_REVIEW→REJECTED_TO_CONSULTANT是另一条流程,**保留不变**。
### 2. 最终确认回执改「不必填」
房务最终确认finalize**不再强制先上传回执**——撤销原 `808183`(最终确认前必须上传至少一张回执)闸口。
- 前端可**去掉「最终确认前必须先传回执」的拦截**,直接最终确认即可。
- **回执上传/查询端点保留**`POST/GET /admin/house/assignments/requirements/{id}/receipts`)——回执仍**可选**上传,只是不再强制。
- 其余最终确认闸口不变:需到「待最终确认」态(`808185`)、至少 1 间已配房、无在途询房。
已部署测试服双实例 health UPboot clean、9443 实测supplier-reject 返 404已删、finalize 端点正常808100 需求不存在=端点在、回执闸口已撤)。
---
## 房务两个「确认」语义(与实现一致,供前端对齐)
| 动作 | 含义 | 端点 |
|---|---|---|
| **确认**(提交配房方案 submit| 对酒店房型库存的**扣减**(全产品硬扣,#4029| `POST .../requirements/{id}/submit` |
| **最终确认**finalize| 对配房需求的**确认**,回写订单主表 `room_control_status=DONE`(配房完成)| `POST .../requirements/{id}/finalize` |
本次仅放开 finalize 的回执强制;扣库存(确认)逻辑不变。
---
## 错误码变化
| 错误码 | 状态 |
|---|---|
| 808183最终确认需先上传回执| ❌ **已删除**(回执改不必填)|
| 808185未进入待最终确认/ 808186当前状态不允许上传回执| ✅ 保留 |
---
## 备注
- 网关无需改(`/v3/admin/order/**``/admin/house/assignments/**` 路由已覆盖)。
- 团期(GROUP)配房先不做;本次仅散客/私人订制房务流程。