docs(changelog): 房务待办列表加 orderTodoCount 本单待办总数(#4542 前端对接)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

changelogs-v2/2026-06/41_4542_房务待办列表加本单待办总数orderTodoCount_前端对接-管理后台.md

@@ -0,0 +1,35 @@
+# 房务待办列表项新增「本单待办总数」orderTodoCount（前端对接）
+
+> 模块：房务管家 · 待办列表（管理后台）
+> 类型：后端新增出参字段（PR #4542 已合 dev-v3 + 测试服实测生效）
+> 日期：2026-06-28
+
+## 背景
+
+一个订单可能同时挂多个待办（例：「酒店12h未回复」HOTEL_REPLY_TIMEOUT + 「需求变更重配」REQUIREMENT_ADJUSTED 或 「未读消息」UNREAD_CHAT），都是同一个订单的事。房务在处理某条待办时，应能一眼看到「这个订单一共还有几个待办」，避免只处理点开的那条、漏掉同订单的其他待办。
+
+## 新增字段
+
+`GET /v3/admin/order/todos` 返回的每个待办项（`list[]`，含派生项）新增：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `orderTodoCount` | Integer | **本单待办总数**：该待办所属订单在当前 scope 下的全部 OPEN 待办数（含持久化 + 派生①待配房/④未读消息），跨分页准确 |
+
+## 前端用法
+
+在待办列表每行展示「本单共 N 个待办」标记（N = `orderTodoCount`）。
+
+- **同一订单的多个待办，每行的 `orderTodoCount` 一致**（例：某单的「酒店12h未回复」行与「未读消息」行都显示 `orderTodoCount=2`）。
+- 单个待办的订单 `orderTodoCount=1`。
+- 该数字**跨分页稳定**（不会因为该单的多条待办分散在不同页而少算）——前端无需自己按订单分组统计。
+- 计数口径与当前 scope（`我的`=mine / `同事`=others / `全部`=all）一致，与列表实际可见的该单待办行数吻合；**不随 todoType/urgency 等 Tab 筛选收窄**（含当前 Tab 外的待办才能防漏处理）。
+
+## 测试服实测
+
+- 字段全量存在（每行均含 Integer `orderTodoCount`，0 缺失）。
+- 一单 2 待办（`PENDING_ARRANGE`派生 + `HOTEL_REPLY_TIMEOUT`持久化）→ 两行 `orderTodoCount` 均 = **2**。
+- 一单 4 待办（3 持久化 + 1 派生）→ 四行均 = **4**。
+- 单待办订单 → `orderTodoCount=1`。
+
+字段为新增，前端按需取用，旧逻辑不受影响。