3.1 KiB
3.1 KiB
配房流程简化 — 取消房务供应侧驳回(改单向·走聊天)+ 最终确认回执改不必填 — 行为变更 — 管理后台
变更类型:🔧 行为变更(取消房务驳回端点 + 最终确认放开回执强制) 端类型:管理后台(房务管家 → 配房面板 / 最终确认) 日期:2026-06-19 服务:hl-order-service-v3(house 模块) PR:wx/HL#4054 (Closes #4052)、wx/HL#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 UP(boot 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)配房先不做;本次仅散客/私人订制房务流程。