From 268ca6e1168fde519d966f5763cc695c6f4e4553 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sun, 28 Jun 2026 13:14:22 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E6=88=BF=E5=8A=A1=E5=BE=85?= =?UTF-8?q?=E5=8A=9E=E5=88=97=E8=A1=A8=E5=8A=A0=20orderTodoCount=20?= =?UTF-8?q?=E6=9C=AC=E5=8D=95=E5=BE=85=E5=8A=9E=E6=80=BB=E6=95=B0(#4542=20?= =?UTF-8?q?=E5=89=8D=E7=AB=AF=E5=AF=B9=E6=8E=A5)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 (1M context) --- ...本单待办总数orderTodoCount_前端对接-管理后台.md | 35 +++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 changelogs-v2/2026-06/41_4542_房务待办列表加本单待办总数orderTodoCount_前端对接-管理后台.md diff --git a/changelogs-v2/2026-06/41_4542_房务待办列表加本单待办总数orderTodoCount_前端对接-管理后台.md b/changelogs-v2/2026-06/41_4542_房务待办列表加本单待办总数orderTodoCount_前端对接-管理后台.md new file mode 100644 index 0000000..68f80f9 --- /dev/null +++ b/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`。 + +字段为新增，前端按需取用，旧逻辑不受影响。