# 房务待办列表项新增「本单待办总数」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`。

字段为新增，前端按需取用，旧逻辑不受影响。
