From 3da69918dbe46653321bf04482473679680356c4 Mon Sep 17 00:00:00 2001
From: wx <wx@1814.love>
Date: Thu, 28 May 2026 16:27:10 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E6=88=BF=E5=8A=A1?=
 =?UTF-8?q?=E7=AE=A1=E5=AE=B6=E5=AE=8C=E5=A4=87=E6=80=A7=20=E2=80=94=20?=
 =?UTF-8?q?=E6=97=A5=E5=8E=864=E7=8A=B6=E6=80=81+=E6=8A=A2=E5=8D=95product?=
 =?UTF-8?q?Type+=E5=BE=85=E5=8A=9E=E7=94=9F=E4=BA=A7=E8=80=85=E5=85=A8?=
 =?UTF-8?q?=E9=BD=90(=E5=90=AB=E5=8F=96=E6=B6=88=E2=86=92=E9=80=80?=
 =?UTF-8?q?=E8=AE=A2)=20(#3179/#3188=20PR3180/3200/3202)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...Š¢å�•productType+待办生产者全é½�_PR3180-3200-3202.md | 64 +++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 changelogs-v2/2026-05/28_HOUSE完备性_日历4状�+抢�productType+待办生产者全�_PR3180-3200-3202.md

diff --git a/changelogs-v2/2026-05/28_HOUSE完备性_日历4状�+抢�productType+待办生产者全�_PR3180-3200-3202.md b/changelogs-v2/2026-05/28_HOUSE完备性_日历4状�+抢�productType+待办生产者全�_PR3180-3200-3202.md
new file mode 100644
index 0000000..3269781
--- /dev/null
+++ b/changelogs-v2/2026-05/28_HOUSE完备性_日历4状�+抢�productType+待办生产者全�_PR3180-3200-3202.md
@@ -0,0 +1,64 @@
+# 二期 v3 房务管家：日历 4 状�点 + 抢�池 productType + 待办生产者全�（��消→退订）
+
+> **�务**: hl-order-service-v3
+> **PR**: #3180�#3200�#3202(hotfix)
+> **Issue**: #3179�#3188
+> **日期**: 2026-05-28
+> **影�**: 🟡 房务管家「日历视图 / 抢�池 / 待办 Tab�数�更完整；接�路径与字段结构**��**，仅字段从�空/� 0 �为真实值�待办 Tab 新增几类会真正产生的待办
+
+---
+
+## 总览（�端 mmg 必读）
+
+继上一批房务接�真实化�，本批补�房务管家剩余的完备性缺�。**接�路径�字段结构���**，�端��此把对应 UI 由"空�/� 0"切到真实渲染。
+
+---
+
+## 1. 日历视图 4 状�点真实化（§2.6）— PR #3180
+
+`GET /admin/house/calendar?month=YYYY-MM&scope=mine|all`
+
+此��天 / 汇总�有"进行中(inProgress)"有真实计数，"待�房(pending) / 询房中(inquiry) / 异常(exception)"�为 0。现已全部按真实状���：
+
+- **待�房 pending**：未被房务抢�的需求（按订�出�日�格）
+- **询房中 inquiry**：有 PENDING 询房的订�
+- **异常 exception**：有 OPEN 异常类待办（�酒店 / 退订 / 询房超时等）的订�
+- **进行中 inProgress**：已�房且�在以上桶
+
+`summary.{inProgress,pending,inquiry,exception}` 与�天 `statusDots[]`（� label/count/color）�返真实值。优先级：异常 > 询房中 > 待�房 > 进行中。
+
+## 2. 抢�池 productType 接通（§1.1）— PR #3180
+
+`GET /v3/admin/order/grab-pool/hotel-requirements`
+
+- 列表项 `productType`（CORE/GROUP/CUSTOM）�`productNo` 此�� null，现�产��务真实返回（如 `productType=CORE`�`productNo=C260520001`）。
+- `productType` 作为**查询筛选项现已生效**（按产�类型过滤抢�池）。
+- 上游产��务查�到 / �级时该字段如实 null，�报错。
+
+## 3. 待办 Tab 生产者全�（§4.1 / §3.4）— PR #3180 + #3200
+
+`GET /v3/admin/order/todos` —— 此�部分待办类型�有"消费/RESOLVE"没有"生产者"，对应 Tab 永远空。现补�，7 类待办�会真正产生：
+
+| 待办类型 | 何时产生（新增/原有） |
+|---|---|
+| `SWAP_HOTEL` �酒店 | **新增**：酒店回填**拒�**时自动产（#3180）；�酒店完��自动 RESOLVE |
+| `INVENTORY_CHECK_OVERDUE` 核房超期 | **新增**：�日巡检 Job 扫到酒店快照过期自动产（#3180）；核房�自动 RESOLVE |
+| `REFUND` 退订 | **新增**：订�**确认��消**（房务已�房�酒店）时自动产，归属原接�房务（#3200）；详�下 |
+| `INQUIRY_TIMEOUT` 询房超时 / `INQUIRY_ESCALATED` 询房加急 / `RETURN_TO_HK` 退回房务 | 原有，�� |
+
+> 注：`UNDELIVERED` 为历��留类型（其"询房 4h 无回�"语义已由 `INQUIRY_TIMEOUT` 承接），���独产生。
+
+## 4. 订��消 → 退订待办 + 待办清�（§1.3 / §4）— PR #3200（hotfix #3202）
+
+订��消�房务侧的�动此�未生效（监�链路缺陷），现已接通：
+
+- 订��消时，该订�房务侧"�房�置工作"类 OPEN 待办（�酒店/询房超时/核房超期等）**自动 RESOLVE**（�消�这些已无�义）。
+- 若�消时**房务已�房�酒店**，自动产一� `REFUND` 待办，归属原接�房务（无归属则广播），�示其处�酒店退订/释放。`reason` �订��消原因。
+- 业务规则确认：�蒙马(GROUP)库存在**下�时**扣��其他产�无库存 —— �房环节�涉�库存扣�/��。
+
+---
+
+## 验�
+以上全部已�并 dev-v3 + 测试��实例部署，并�真机验�：日历 4 状�点真实计数�抢�池 productType 真实返回�酒店拒�产�酒店待办�订��消产退订待办（�消订� → SWAP_HOTEL 待办 RESOLVED + REFUND 待办 OPEN 归属原房务）。无接�路径/字段结构�更。
+
+如需任一接�完整�应样例或字段疑问，回我��。