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

3.1 KiB

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

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