补齐订单详情V4总览接口
This commit is contained in:
@@ -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. 已确认设计决策
|
||||
|
||||
Reference in New Issue
Block a user