From ccb71ead90f6eb2b7b197e2bde7ff1bfdf8f745a Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 24 Jun 2026 14:20:16 +0800
Subject: [PATCH] =?UTF-8?q?@=20docs(changelog-v2):=20=E9=87=8A=E6=94=BE?=
 =?UTF-8?q?=E5=9B=9E=E6=B1=A0=E5=86=BB=E7=BB=93=E6=97=A7=E6=88=BF=E5=8A=A1?=
 =?UTF-8?q?=E4=BC=9A=E8=AF=9D+=E6=B6=88=E6=81=AF=E8=BD=AC=E7=95=99?=
 =?UTF-8?q?=E8=A8=80=E6=B1=A0=E7=9C=9F=E7=94=9F=E6=95=88=20(#4330=20#4332)?=
 =?UTF-8?q?=20@?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ... å†»ç»“旧房务会è¯�+消æ�¯è½¬ç•™è¨€æ± çœŸç”Ÿæ•ˆ_管ç�†å�Žå�°.md | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 changelogs-v2/2026-06/24_4330_4332_释放回池冻结旧房务会�+消�转留言池真生效_管���.md

diff --git a/changelogs-v2/2026-06/24_4330_4332_释放回池冻结旧房务会�+消�转留言池真生效_管���.md b/changelogs-v2/2026-06/24_4330_4332_释放回池冻结旧房务会�+消�转留言池真生效_管���.md
new file mode 100644
index 0000000..09fab75
--- /dev/null
+++ b/changelogs-v2/2026-06/24_4330_4332_释放回池冻结旧房务会�+消�转留言池真生效_管���.md
@@ -0,0 +1,37 @@
+# 房务释放回池：冻结旧房务会� + 旧房务消�整段转「留言池�(链路修通真生效)
+
+> �更类型：🔧 修�（�端，�端按下方「留言�展示���）
+> 端类型：管���（房务管家·订�详情�天 / 定制师侧「待接�房务�会�）
+> 日期：2026-06-24 ｜ 工�：#4329 #4331 ｜ PR：#4330 #4332 ｜ �务：hl-user-service（�实例已部署 health UP，**测试� DB+API ground-truth 实测全通过**）
+
+---
+
+## 背景
+房务订��天=方案A（一�一会� `HOUSE:{orderId}`，房务轮�）。此�「释放回抢�池��两个 bug：
+1. 定制师还能跟**旧房务**继续�（旧房务会�没冻结）；
+2. 上次�天内容没转�「留言�（下个房务抢�看�到对�连续性）。
+
+根因有两层：
+- **#4331(根因)**：释放事件� Feign 调 user 绑定时传 `houseAdminId=null`，但 user 端入� VO 该字段有 `@NotNull` → `@Valid` 直接 400 打回 → 释放绑定逻辑**从未真正执行**（软�赖被 fallback �默�掉，主�程照常�功，潜�数周）。去掉该 `@NotNull` �链路�通。
+- **#4330(逻辑)**：释放绑定逻辑本身补全——归档旧房务�员行 + 旧房务�下消�整段转留言池。
+
+## �端行为�化（�端一般无需改）
+释放回抢�池�：
+- **旧房务**：会��员行 `status→ARCHIVED`，脱离该会�——其会�列表��显示本会��且**�能��消�**（�消�返业务�「无�访问该会��）。
+- **该会�全部�天消�**（�旧房务已读的）整段改判回「留言池�（无房务接收�）。
+- **定制师**：其「�系房务�回退「待接�房务��（peer ��），�续�的消�进留言池。
+- **下个房务抢�**：留言池消�整段转�给新房务（计入未读 + 转为正常�天）。
+- �一房务**�新抢回**该�：归档行自动�活（`status→ACTIVE`），�天��。
+
+## �端「留言��展示��（�点）
+释放回池�，定制师打开会�标题显示「待接�房务�，**该会�历�消�整体呈现为「留言��**——这是预期效果（无房务接�期间的消�都是留言，等下个房务抢�转为实时�天）：
+- 定制师侧：会���打开��继续�（进留言池），消�标「留言�属正常，**�是 bug**。
+- 房务侧（未抢�）：订�详情显示「抢���与定制师实时沟通���（�端已去掉旧「内部留言�入�，符�「�留�天��求）。
+- 旧房务侧：释放�该会�从其会�列表消失（已归档），符�预期。
+
+## 验�说明（如实·ground-truth）
+✅ 测试� DB + API 实测全通过：
+- 释放�旧房务(admin)�员行 `status=ARCHIVED`�其会�列表无此会�；
+- 旧房务释放��消�被拒（「无�访问该会��）；
+- 该�留言池消��全（定制师留言 admin_id=0 就绪，下个房务抢��转�）；
+- �房务�抢→�员行�活 `ACTIVE`��天��。