From a66f2acd86ba556ab30e5c6ce326669e0813158a Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 19 Jun 2026 15:43:28 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E9=85=8D=E6=88=BF=E6=B5=81?= =?UTF-8?q?=E7=A8=8B=E7=AE=80=E5=8C=96=20#4052+#4055(=E5=8F=96=E6=B6=88?= =?UTF-8?q?=E6=88=BF=E5=8A=A1=E9=A9=B3=E5=9B=9E=E6=94=B9=E5=8D=95=E5=90=91?= =?UTF-8?q?=E8=B5=B0=E8=81=8A=E5=A4=A9=20+=20=E6=9C=80=E7=BB=88=E7=A1=AE?= =?UTF-8?q?=E8=AE=A4=E5=9B=9E=E6=89=A7=E6=94=B9=E4=B8=8D=E5=BF=85=E5=A1=AB?= =?UTF-8?q?)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...改单向走聊天+最终确认回执改不必填-行为变更-管理后台.md | 58 +++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 changelogs-v2/2026-06/19_4052_4055_配房流程简化-取消房务驳回改单向走聊天+最终确认回执改不必填-行为变更-管理后台.md diff --git a/changelogs-v2/2026-06/19_4052_4055_配房流程简化-取消房务驳回改单向走聊天+最终确认回执改不必填-行为变更-管理后台.md b/changelogs-v2/2026-06/19_4052_4055_配房流程简化-取消房务驳回改单向走聊天+最终确认回执改不必填-行为变更-管理后台.md new file mode 100644 index 0000000..e8f162d --- /dev/null +++ b/changelogs-v2/2026-06/19_4052_4055_配房流程简化-取消房务驳回改单向走聊天+最终确认回执改不必填-行为变更-管理后台.md @@ -0,0 +1,58 @@ +# 配房流程简化 — 取消房务供应侧驳回(改单向·走聊天)+ 最终确认回执改不必填 — 行为变更 — 管理后台 + +> 变更类型：🔧 行为变更（取消房务驳回端点 + 最终确认放开回执强制） +> 端类型：管理后台（房务管家 → 配房面板 / 最终确认） +> 日期：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)配房先不做；本次仅散客/私人订制房务流程。