补齐订单列表V4继续处理入口

This commit is contained in:
andy
2026-07-20 01:54:38 +07:00
parent d1955f5097
commit 4b05cabd13
11 changed files with 459 additions and 17 deletions

View File

@@ -279,7 +279,7 @@ GET /api/reservation/orders/{orderId}
GET /api/reservation/orders
```
当前状态:后端已完成第一版。默认查询全部订单状态;`open_task_count` 排除 `COMPLETED``FAILED``next_processable_task_id` 按同订单队列可处理状态实时计算。
当前状态:后端已完成第一版。默认查询全部订单状态;`open_task_count` 排除 `COMPLETED``FAILED``next_processable_task_id`旧 V2/V3 同订单队列可处理状态实时计算。M002 V4 CP14 已补齐 V4 继续处理入口字段,前端有 `next_v4_order_task_id` 时应优先进入 V4 订单任务详情。
默认排序:按后端维护的订单最近业务活动时间倒序返回,保证最近有业务活动的订单排在前面。后端当前使用 `workflow_reservation_order.latest_activity_at` 作为排序字段,并在订单创建、任务创建、草稿保存、最终确认、人工复核解阻、任务状态变更等写路径维护;前端不要再基于任务时间或更新时间自行重排。
@@ -311,6 +311,11 @@ GET /api/reservation/orders
"display_name": "GRP-001",
"open_task_count": 2,
"next_processable_task_id": "10002",
"next_v4_order_task_id": "30001",
"next_v4_action_card_id": "31002",
"next_v4_action_type": "REVIEW",
"next_v4_action_status": "REVIEW_REQUIRED",
"v4_open_order_task_count": 1,
"updated_at": "2026-07-08T03:10:00Z"
}
],
@@ -322,6 +327,18 @@ GET /api/reservation/orders
}
```
V4 继续处理字段说明:
| 字段 | 说明 |
| --- | --- |
| `next_v4_order_task_id` | 当前订单下第一条仍需用户处理的 V4 订单任务 ID为空表示没有 V4 待处理订单任务。 |
| `next_v4_action_card_id` | `next_v4_order_task_id` 下第一张仍需确认或复核的卡片 ID。 |
| `next_v4_action_type` | `CONFIRM` / `REVIEW` / `NONE``CONFIRM` 调卡片确认接口,`REVIEW` 调复核解阻接口。 |
| `next_v4_action_status` | `PENDING_CONFIRM` / `REVIEW_REQUIRED``NONE` 时为空。 |
| `v4_open_order_task_count` | 当前订单下未完成 V4 订单任务数,`COMPLETED` 不计入。 |
前端“继续处理”入口建议优先级:优先使用 `next_v4_order_task_id` 跳转 V4 订单任务详情;没有 V4 待处理时再使用旧 `next_processable_task_id` 跳旧任务详情。S10/S99 来源通知不创建订单,不进入订单列表字段统计。
## 6. 前端联调演示数据 seed 接口
建议路径: