补齐订单详情V4总览接口

This commit is contained in:
andy
2026-07-20 14:38:09 +07:00
parent b50e004b06
commit 8f893991dd
14 changed files with 659 additions and 40 deletions

View File

@@ -598,7 +598,16 @@ GET /api/reservation/orders/{orderId}
权限RESERVATION_ORDER_READ
```
用于订单详情页展示 V4 订单任务时间线,同时保留旧 `tasks[]`新增字段为 `v4_order_tasks[]``include_tasks=false``tasks[]``v4_order_tasks[]` 都返回空数组
用于订单详情页展示 V4 订单总览和 V4 订单任务时间线,同时保留旧 `tasks[]`M002 V4 CP15.1 已补齐 `order_overview``next_v4_action``related_source_messages[]` `v4_order_tasks[].cards[]``include_tasks=false``tasks[]``v4_order_tasks[]` `related_source_messages[]` 都返回空数组,`order_overview` 为空快照,`next_v4_action.action_type=NONE`
`order_overview` 只从已确认 V4 卡片派生:
- Basic Information 已确认后,返回 `account_code``account_name``market_code``source_code`
- Room Information 已确认后,返回 `arrival_date``departure_date``rate_code``room_items[]`
- Trace / Rooming List / Payment 返回对应最新卡片状态,方便订单详情展示待处理事项;
- 未确认 AI 建议不得进入 `order_overview`,避免把未处理内容展示成订单事实。
`next_v4_action` 使用和订单列表一致的下一步处理口径Basic Information 优先;业务卡中 `REVIEW_REQUIRED` 优先于 `PENDING_CONFIRM`;无待处理卡时 `action_type=NONE`。订单详情页应使用该字段跳转 V4 订单任务详情页,不在订单详情页直接确认或复核。
`v4_order_tasks[]` 每项返回:
@@ -606,6 +615,7 @@ GET /api/reservation/orders/{orderId}
- `order_ref`
- `order_task_status`
- `card_counts`
- `cards[]`
- `source_message_summary`
- `source_received_at`
- `created_at`
@@ -617,6 +627,7 @@ GET /api/reservation/orders/{orderId}
- 排序沿用 V4 Repository 的同订单顺序:`source_received_at``source_message_id``order_context_index``created_at`、数字 ID 正序。
- `source_message_summary` 只返回安全摘要不返回邮件正文、HTML、附件 URL 或 AI 原始 payload原文仍走 SourceMessage 会话接口。
- `latest_activity_at` 为 V4 订单任务自身 `updated_at` 与其下卡片 `updated_at` 的最大值。
- `cards[]` 只返回卡片安全摘要,不返回业务字段 payload订单详情页如需处理字段必须跳转 V4 订单任务详情接口。
- 接口权限仍使用 `RESERVATION_ORDER_READ`并按订单实际所属酒店校验访问权V4 任务读取时继续以该订单酒店过滤,避免跨酒店脏数据泄露。
### 12.6 订单列表 V4 继续处理入口
@@ -802,6 +813,7 @@ AI 原始 payload、邮件正文、附件 URL 和技术 trace 不应直接进入
| M002-V4-CP13 | 目录管理后台 V1 | Account / Market / Source 管理,临时 Room Type / Rate Code 管理,目录维护权限和管理审计 |
| M002-V4-CP14 | 订单列表 V4 继续处理入口 | 已完成:`GET /api/reservation/orders` 返回 V4 下一步订单任务、卡片、动作类型、动作状态和 open 数,前端可优先跳 V4 订单任务详情 |
| M002-V4-CP15 | V4 业务审计查询 | 已完成:`GET /api/reservation/order-tasks/{orderTaskId}/audits``GET /api/reservation/source-notifications/{notificationId}/audits` 返回卡片确认、复核解阻和来源通知 ack 的脱敏审计流水 |
| M002-V4-CP15.1 | 订单详情 V4 化后端补齐 | 已完成:`GET /api/reservation/orders/{orderId}` 返回 `order_overview``next_v4_action``related_source_messages[]``v4_order_tasks[].cards[]`,支撑订单总览页 |
| M002-V4-CP16 | PMS / OPERA / OHIP 目录同步 | 同步 Adapter、同步 run、最后成功快照、失败重试和同步状态管理入口 |
## 17. 已确认设计决策