From 4b866a0371d9ae424e657d04b4849eecc630390b Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 23 Jun 2026 17:56:09 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E6=88=BF=E5=8A=A1?=
 =?UTF-8?q?=E5=BC=82=E5=B8=B8=E6=A0=87=E8=AE=B0=E5=AE=8C=E6=88=90+?=
 =?UTF-8?q?=E5=B7=B2=E7=A1=AE=E8=AE=A4=E6=94=B9=E5=B7=B2=E5=AE=8C=E6=88=90?=
 =?UTF-8?q?+=E9=87=8A=E6=94=BE/=E8=BD=AC=E5=8D=95=E4=BF=AE=E5=A4=8D=20(#43?=
 =?UTF-8?q?12=20#4318=20#4319)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...‡è®°å®Œæˆ�+已确认改已完æˆ�+释放转å�•ä¿®å¤�_管ç�†å�Žå�°.md | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 changelogs-v2/2026-06/23_4312_4318_4319_房务异常标记完�+已确认改已完�+释放转�修�_管���.md

diff --git a/changelogs-v2/2026-06/23_4312_4318_4319_房务异常标记完�+已确认改已完�+释放转�修�_管���.md b/changelogs-v2/2026-06/23_4312_4318_4319_房务异常标记完�+已确认改已完�+释放转�修�_管���.md
new file mode 100644
index 0000000..fcc78a4
--- /dev/null
+++ b/changelogs-v2/2026-06/23_4312_4318_4319_房务异常标记完�+已确认改已完�+释放转�修�_管���.md
@@ -0,0 +1,49 @@
+# 房务�房：异常�加「标记完��终� + 「已确认�文案统一改「已完�� + 释放/转�弹窗 body 必填 400 修�
+
+> �更类型：✅ 新增接� + 🔧 修�（已部署测试�；契约层已 round-trip 实测，数��赖行为�下「验�说明�）
+> 端类型：管���（房务管家·订�详情/异常桶/转�·释放弹窗）
+> 日期：2026-06-23 ｜ 工�：#4307 #4315 #4317 ｜ PR：#4312 #4318 #4319 ｜ �务：hl-order-service-v3 / hl-user-service
+> 关�：承接 #4301（房务状�机修�）的 P1 设计项；本批多为房务侧体验修�。
+
+---
+
+## 一�需��端动手的
+
+### 1. 异常�加「标记完��按钮（新增端点）✅契约已实测
+房务 6 �里「异常�原本没有「处置完��出�（�消�/放弃�永�异常）。现新增统一终�出�。
+
+- **端点**：`POST /v3/admin/order/hotel-requirements/{requirementId}/close`
+- **body**：�空。�选 `{"reason":"异常已处置"}`（reason 选填，≤200 字）。
+- **�功**：`house_status` → `CONFIRMED`（label =「已完��）。
+- **�置**：仅 `house_status == EXCEPTION` �调；�异常�返 **808022「当�房务状��异常,��标记完��**；需求�存在返 808002。
+- **�端**：异常桶/订�详情，当 `houseStatus==EXCEPTION` 时显示「标记完��按钮 → 调本端点 → �功�该�进「已完��。
+
+### 2. 房务终�文案：「已确认�→「已完��
+房务侧 `CONFIRMED` �的中文 label 由「已确认�统一改为「已完��（�房回传完� 与 异常处置完� 都�这个终�）。
+- �端 `houseStatusLabel` / 进度� step5 等已返「已完��。
+- **�端**：若有**硬编�**「已确认�字样（房务终�徽章/进度�/筛选 Tab）需�步改「已完��；若直接用�端返回的 label 则无需改。
+
+---
+
+## 二��端已修� / 行为�化（�端一般无需改，知会）
+
+### 3. 释放/转�确认弹窗 body 必填 400 — 已修� ✅实测
+之�「确认释放�「确认转��弹窗�带 body 时�端报 `400 Required request body is missing`。
+- 现 `release` / `close` 端点 body 改�选；`release/close/transfer` 的 `reason` 改�选（reason 留空�端兜底）。
+- `transfer` 的 `toUserId` �必填；超管指派 reason≥10 字校验�留。
+- **�端无需改**：原��传 body 的调用现在�� 400。
+
+### 4. 转�候选去�微强制过滤（纯�端）
+「转�/指派�候选「选择目标房务�原�返回**已绑�微**的房务，导致未绑�微账��显示�下拉「无数��。现改为按**房务角色**（house_keeper/house_lead，多角色感知）+ 活跃查，**�微�选**（未绑�微者�字回�用户�）。
+- **�端无需改**。
+- 注�：候选��求环境里有除自己外��房务角色�活跃的账�；若�空请确认环境已给测试账�分� house_keeper/house_lead 角色。
+
+### 5. 释放回池�会�消�转「留言�+ �抢转�（纯�端）
+房务释放回池�，原房务↔定制师的会�消�退回「留言池�（抢��留言�）；之�别的房务�抢�时，这些留言会转�给新房务（计入未读 + SSE）。
+- **�端无需改**：沿用现有「内部留言框�/未读展示，行为自然生效。
+
+---
+
+## 验�说明（如实）
+- ✅ **测试� round-trip 实测通过**：`release` / `close` 端点已上线�body �空（无 body 调用返业务�而� `Required request body is missing` 400）�`/close` 已路由（� 404）。
+- ⚠� **数��赖行为未在测试�演示**：测试�当�无房务订�/房务角色账�，故「候选有数��「异常�标记完�→已完��「释放�留言转��三项**完整业务�程**未在测试�跑通演示；�已被�端**�元测试覆盖**且已部署（hl-order-service-v3 �实例 8086/8186�hl-user-service �实例 8081/8181 health UP）。建议在有房务数�的环境二次确认完整�程。