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

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

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