From 532afb1c973ddd000806507ac9255ce6660cdf8a Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 7 Jul 2026 16:58:00 +0800
Subject: [PATCH] docs(house): update ledger export and lead handoff

---
 ...¡µé�¢ç®€åŒ–为已é…�房酒店汇总表-å‰�端待处ç�†-管ç�†å�Žå�°.md | 33 ++++++++++
 ...Š¡ç»„é•¿æ�ƒé™�列表è�”系房务å‰�端待处ç�†-管ç�†å�Žå�°.md | 60 +++++++++++++++++++
 2 files changed, 93 insertions(+)
 create mode 100644 changelogs-v2/2026-07/41_房务组长��列表�系房务�端待处�-管���.md

diff --git a/changelogs-v2/2026-07/40_房务月度对账页�简化为已�房酒店汇总表-�端待处�-管���.md b/changelogs-v2/2026-07/40_房务月度对账页�简化为已�房酒店汇总表-�端待处�-管���.md
index 88ca986..6b22b16 100644
--- a/changelogs-v2/2026-07/40_房务月度对账页�简化为已�房酒店汇总表-�端待处�-管���.md
+++ b/changelogs-v2/2026-07/40_房务月度对账页�简化为已�房酒店汇总表-�端待处�-管���.md
@@ -46,9 +46,42 @@
 - 间夜：该月�房完毕订�中，�到该酒店的间夜�计。
 - �计：对上方表格订�数�间夜数求和。
 
+## 接�对接
+
+页�数�：
+
+```http
+GET /v3/admin/house/reconciliation/monthly?month=2026-07
+```
+
+�端�按 `data.hotels[]` 渲染酒店汇总表：
+
+| 字段 | 用途 |
+| --- | --- |
+| `hotelName` | 酒店�称 |
+| `orderCount` | 订� |
+| `roomNights` | 间夜 |
+
+`overview`�金�类字段目��端为兼容旧页��返回，当�页����渲染统计�片�现结金��环比等内容。
+
+导出 Excel：
+
+```http
+GET /v3/admin/house/reconciliation/monthly/export?month=2026-07&format=xlsx
+```
+
+生� PDF：
+
+```http
+GET /v3/admin/house/reconciliation/monthly/export?month=2026-07&format=pdf
+```
+
+两个导出接�都返回附件�，�端按 blob 下载��。文件内容和页���径，�包�“酒店�称 / 订� / 间夜 / �计�汇总表。
+
 ## 验收�径
 
 - 房务管�员进入 `/housekeeper/ledger`，页���出现顶部统计�片和空�大框。
 - 有数�时直接显示酒店汇总表。
 - 无数�时�在表格区域�轻�空�，��展示现结类统计。
 - 页�语义���写“现结账��，统一按“月度对账 / �房完毕订�酒店汇总��解。
+- 点击「导出 Excel�下载 xlsx，点击「生� PDF�下载 pdf，内容与页�酒店汇总表一致。
diff --git a/changelogs-v2/2026-07/41_房务组长��列表�系房务�端待处�-管���.md b/changelogs-v2/2026-07/41_房务组长��列表�系房务�端待处�-管���.md
new file mode 100644
index 0000000..7006506
--- /dev/null
+++ b/changelogs-v2/2026-07/41_房务组长��列表�系房务�端待处�-管���.md
@@ -0,0 +1,60 @@
+# 41_房务组长��列表�系房务�端待处�-管���
+
+## 背景
+
+房务管�员角色当�能打开「全部�待办 Tab，且�以看到其他房务待办，属于越�展示。
+
+房务组长进入订�列表时，应看到所有已被房务抢走��抢�池状�的订�，�应�看到已完�订�。
+
+�外，列表里「�系房务�打开会�时标题显示“对端�，需�改�具体负责房务。
+
+## 待办 Tab ��
+
+页�路径：
+
+- `/housekeeper/todos`
+
+�端规则：
+
+1. 普通房务管�员�展示「我的未完��Tab。
+2. 「全部�/「�事在处��Tab 仅房务组长�超级管�员展示。
+3. 普通房务管�员请求待办接��传 `scope=mine`。
+4. `scope=all` / `scope=others` 仅房务组长�超级管�员使用。
+
+�端已加兜底��：普通房务管�员请求 `scope=all` 或 `scope=others` 会返回业务错误 `582204`。
+
+## 房务组长订�列表
+
+页�路径：
+
+- `/housekeeper/orders`
+
+房务组长「全部房务�列表��强制传 `status=confirmed` / `DONE` 一类完��过滤。
+
+应直接查询房务订�列表的组长视角，展示所有已抢�/已归属房务��抢�池状�的订�，包括：
+
+- �房中
+- 待最终确认
+- 已完�
+- 异常/待处�
+
+列表行里的负责房务展示：
+
+- 使用接�返回的 `claimerName`。
+- �端已优先返回房务�业微信昵称。
+- 没绑定�业微信时，�端回退用户�。
+
+## �系房务
+
+房务组长列表点击「�系房务�时：
+
+1. 使用当�订�行的 `claimerId` 作为�天对端管�员 ID。
+2. 会�抽屉标题展示当�订�行的 `claimerName`。
+3. ��展示“对端�这�兜底文案，除�接�确实没有返回任何�字。
+
+## 验收�径
+
+- 普通房务管�员看�到「全部�/「�事在处��Tab，也�能通过�端请求看到其他房务待办。
+- 房务组长能看到所有已归属房务的订�，��已完�。
+- 房务组长列表展示具体负责房务�。
+- 点击「�系房务��，�天标题显示具体房务，�显示“对端�。