hl-api-changelog/changelogs-v2/2026-06/19_4052_4055_配房流程简化-取消房务驳回改单向走聊天+最终确认回执改不必填-行为变更-管理后台.md

3.1 KiB

配房流程简化 — 取消房务供应侧驳回(改单向·走聊天)+ 最终确认回执改不必填 — 行为变更 — 管理后台

变更类型:🔧 行为变更(取消房务驳回端点 + 最终确认放开回执强制) 端类型:管理后台(房务管家 → 配房面板 / 最终确认) 日期2026-06-19 服务hl-order-service-v3house 模块) PRwx/HL#4054 Closes #4052wx/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 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)配房先不做;本次仅散客/私人订制房务流程。