实现V4订单详情总览页
This commit is contained in:
andy
@@ -5,14 +5,15 @@
|
||||
| 最近更新 | 2026-07-20 |
|
||||
| 当前分支 | `feature/huangting` |
|
||||
| 当前阶段 | M002 V4 入站、多卡模型、持久化基线、入站写入、查询接口、卡片确认、复核解阻、目录校验、订单详情 V4 总览、DB 目录、Lookup API、前端 lookup 接入、目录管理后台 CP1 前后端、订单列表 V4 继续处理入口 / open count 收口和 V4 业务审计查询 |
|
||||
| 当前重点 | M002 V4 已完成订单列表 V4 继续处理入口字段和前端消费，`GET /api/reservation/orders` 可返回 V4 下一步订单任务、卡片、动作类型、动作状态、V4 open 数和统一展示字段 `open_work_item_count`；`GET /api/reservation/orders/{orderId}` 已补齐订单详情 `order_overview`、`next_v4_action`、`related_source_messages[]` 和 `v4_order_tasks[].cards[]`，支撑订单总览页；V4 订单任务和 S10/S99 来源通知已补齐业务审计查询接口；后续可做前端订单详情 V4 化、测试机联调、真实 PMS / OPERA / OHIP 同步或 SuperAgent 目录供给方案 |
|
||||
| 当前重点 | M002 V4 已完成订单列表 V4 继续处理入口字段和前端消费，`GET /api/reservation/orders` 可返回 V4 下一步订单任务、卡片、动作类型、动作状态、V4 open 数和统一展示字段 `open_work_item_count`；`GET /api/reservation/orders/{orderId}` 已补齐订单详情 `order_overview`、`next_v4_action`、`related_source_messages[]` 和 `v4_order_tasks[].cards[]`，前端订单详情页已改为 V4 订单总览页；V4 订单任务和 S10/S99 来源通知已补齐业务审计查询接口；2026-07-20 测试机 smoke 已完成主链路验证，但测试机订单详情响应疑似未部署到包含 CP15.1 的最新后端包，需要重新部署后复测订单详情 V4 总览；后续可做真实 PMS / OPERA / OHIP 同步或 SuperAgent 目录供给方案 |
|
||||
|
||||
## 1. 当前 Checkpoint
|
||||
|
||||
- 名称：`M002-V4-order-detail-overview-backend`
|
||||
- 状态：Done，订单详情接口已补齐 V4 订单总览数据：`GET /api/reservation/orders/{orderId}` 返回 `order_overview`、`next_v4_action`、`related_source_messages[]` 和 `v4_order_tasks[].cards[]`。`order_overview` 只从已确认 V4 卡片派生，未确认 AI 建议不作为订单事实；`next_v4_action` 复用订单列表下一步处理口径，前端仍跳 V4 订单任务详情处理。
|
||||
- 目标：支撑前端把订单详情页从旧任务处理页改成“订单总览 + 当前确认快照 + V4 任务时间线 + 下一步入口”。
|
||||
- 边界：本轮不改前端、不新增表、不改 V4 写操作、不接真实 OPERA / OHIP、不废弃旧 V2/V3 详情接口。
|
||||
- 名称：`M002-V4-order-detail-overview-frontend`
|
||||
- 状态：Done，前端订单详情页已改为“订单总览页”：展示 `order_overview` 当前确认快照、`next_v4_action` 下一步入口、`related_source_messages[]` 关联来源消息摘要，以及 `v4_order_tasks[].cards[]` V4 订单任务和任务卡安全摘要。点击下一步入口或 V4 时间线任务进入 `/reservation/order-tasks/{orderTaskId}`。
|
||||
- 目标：让订单详情页聚焦订单视角总览，不在该页直接确认、复核或编辑 V4 任务卡。
|
||||
- 边界：本轮不改后端、不改 V4 写操作、不展示 `ai_payload_json`、`display_payload_json`、`confirmed_payload_json`、邮件正文或附件 URL；旧 V2/V3 详情接口和独立任务详情页继续保留。
|
||||
- 联调备注：2026-07-20 测试机 V4 主链路 smoke 已完成登录 / 权限 / 酒店隔离、V4 工作台、V4 订单任务列表和详情、lookup、Basic Information 确认、业务卡确认、S10/S99 来源通知详情和 ack、V4 业务审计验证；当前测试机没有待复核 `REVIEW_REQUIRED` 卡，复核写操作未覆盖。测试机 `GET /api/reservation/orders/{orderId}` 仍返回旧响应形态，缺少 CP15.1 的 `order_overview`、`next_v4_action`、`related_source_messages[]` 和 `v4_order_tasks[].cards[]`，优先排查测试机是否部署了包含订单详情 V4 总览的最新包。
|
||||
|
||||
## 2. 当前优先级
|
||||
|
||||
@@ -35,12 +36,12 @@
|
||||
- 后续每完成一个 Feature 或 Checkpoint，需要更新本文件，避免项目状态继续沉淀在聊天记录里。
|
||||
- M010 Rooming List Excel 生成后端 CP1 和前端 V1 已实现：前端 `/reservation/rooming-lists/new` 上传来源名单和手工字段，后端同步生成 `.xlsx` 直接下载，第一版不落库、不上传 OSS。
|
||||
- M011 Booking Excel 附件预处理 CP1/CP2/CP3 已实现：后端可排除人员名单类 Excel，按最近 6 个月候选窗口选择实际存在的最新 3 个业务月，抽取 Booking Update / 附加费表高亮行业务 JSON；Debug EML 和 AgentBus dispatch 在各自 include 开关与总开关同时启用时，会在调用 SuperAgent 前追加 `attachment_extractions[]`。测试机 AgentBus 增强已开启；生产链路仍默认关闭，生产开启需单独确认。
|
||||
- M002 V4 CP1 当前已完成入站解析和现有任务链路过渡适配；M002 V4 CP2 已完成订单任务与多卡领域模型设计；M002 V4 CP3 已完成 V4 订单任务、多卡和 S10/S99 来源通知表结构与 Repository 基线；M002 V4 CP4 已完成入站写入新模型；M002 V4 CP5 已完成前端查询接口并补齐订单详情 `v4_order_tasks[]` 时间线；M002 V4 CP6 已完成普通卡片确认和 S10/S99 来源通知 ack；M002 V4 CP7 已完成 `REVIEW_REQUIRED` 卡复核解阻和复核场景订单归属确认；M002 V4 CP8 已完成目录校验、V4 卡片 `fields[]` 字段白名单、确认写入白名单收口和嵌套业务字段目录校验；M002 V4 CP11 已完成数据库目录、初始化种子、启动补种子、Account / Room Type / Rate Code lookup API，并把 V4 入站、确认、复核目录校验切换到当前酒店数据库目录；M002 V4 CP12 已完成前端 lookup 接入第一版和 V4 订单任务时间线消费；M002 V4 CP13 目录管理后台 CP1 已完成前后端列表、新增、启用 / 停用闭环；M002 V4 CP14 已完成订单列表 V4 继续处理入口字段和前端入口消费，`GET /api/reservation/orders` 返回 V4 下一步订单任务、卡片、动作类型、动作状态、V4 open 数和统一展示计数 `open_work_item_count`，前端按 V4 优先、旧任务回退跳转，并按 `open_work_item_count` 展示待处理数量；V4 业务审计查询已补齐订单任务审计和来源通知 ack 审计两个只读接口；订单详情已补齐 V4 `order_overview`、`next_v4_action`、`related_source_messages[]` 和 `v4_order_tasks[].cards[]`。真实 PMS 同步和 SuperAgent 目录机器接口仍未完成。
|
||||
- M002 V4 CP1 当前已完成入站解析和现有任务链路过渡适配；M002 V4 CP2 已完成订单任务与多卡领域模型设计；M002 V4 CP3 已完成 V4 订单任务、多卡和 S10/S99 来源通知表结构与 Repository 基线；M002 V4 CP4 已完成入站写入新模型；M002 V4 CP5 已完成前端查询接口并补齐订单详情 `v4_order_tasks[]` 时间线；M002 V4 CP6 已完成普通卡片确认和 S10/S99 来源通知 ack；M002 V4 CP7 已完成 `REVIEW_REQUIRED` 卡复核解阻和复核场景订单归属确认；M002 V4 CP8 已完成目录校验、V4 卡片 `fields[]` 字段白名单、确认写入白名单收口和嵌套业务字段目录校验；M002 V4 CP11 已完成数据库目录、初始化种子、启动补种子、Account / Room Type / Rate Code lookup API，并把 V4 入站、确认、复核目录校验切换到当前酒店数据库目录；M002 V4 CP12 已完成前端 lookup 接入第一版和 V4 订单任务时间线消费；M002 V4 CP13 目录管理后台 CP1 已完成前后端列表、新增、启用 / 停用闭环；M002 V4 CP14 已完成订单列表 V4 继续处理入口字段和前端入口消费，`GET /api/reservation/orders` 返回 V4 下一步订单任务、卡片、动作类型、动作状态、V4 open 数和统一展示计数 `open_work_item_count`，前端按 V4 优先、旧任务回退跳转，并按 `open_work_item_count` 展示待处理数量；V4 业务审计查询已补齐订单任务审计和来源通知 ack 审计两个只读接口；订单详情已补齐并完成前端接入 V4 `order_overview`、`next_v4_action`、`related_source_messages[]` 和 `v4_order_tasks[].cards[]`。真实 PMS 同步和 SuperAgent 目录机器接口仍未完成。
|
||||
- M002 V4 CP2 已确认：V4 工作台统一列表草案为 `/api/reservation/workbench-items`，业务订单任务接口新开 `/api/reservation/order-tasks/**`，S10/S99 来源通知详情草案为 `/api/reservation/source-notifications/{notificationId}`；S10/S99 使用来源通知模型，不再挂隐藏技术订单；`FIT + BOOKING_CODE` 不建 ACTIVE 唯一约束，匹配多条进人工复核；Basic Information 必须先确认；Account / Market / Source 当前通过数据库目录读取和派生；旧 V2/V3 任务详情和草稿确认接口后续可逐步废弃。
|
||||
|
||||
## 5. Next Steps
|
||||
|
||||
- 后续如继续做 M002 V4，可优先让前端改造订单详情 V4 总览页并进行测试机联调，或推进真实 PMS / OPERA / OHIP 目录同步和 `workflow_reservation_catalog_sync_run` checkpoint。
|
||||
- 后续如继续做 M002 V4，可优先进行测试机联调，或推进真实 PMS / OPERA / OHIP 目录同步和 `workflow_reservation_catalog_sync_run` checkpoint。
|
||||
- 后续新增重要功能时，优先在 `docs/project/requirements/` 或未来 `docs/specs/` 中形成 Spec，再实现代码。
|
||||
- M010 后续如需预览、历史记录、OSS 下载、订单 / 任务预填或客户字段目录化，再单独开前后端 checkpoint。
|
||||
- M011 CP4 暂不推进；当前停留在 CP3 边界，只增强 SuperAgent 输入，不直接落订单、任务或长期解析历史。后续如确实需要运营查询或长期追踪，再单独设计 Excel 解析批次 / 行级持久化表。
|
||||
|
||||
@@ -454,6 +454,43 @@ export default {
|
||||
taskQueue: 'Order task queue',
|
||||
v4TaskTimeline: 'V4 order task timeline',
|
||||
v4TaskTimelineEmpty: 'No V4 order tasks.',
|
||||
v4TaskTimelineHint: 'Shows safe order-task and card summaries only. Complete actions in the V4 task detail page.',
|
||||
v4OverviewTitle: 'Current V4 confirmed snapshot',
|
||||
v4OverviewSubtitle: 'Derived from confirmed cards only, not from unconfirmed AI suggestions.',
|
||||
v4OverviewEmpty: 'No confirmed V4 order snapshot yet.',
|
||||
accountCode: 'Account Code',
|
||||
accountName: 'Account Name',
|
||||
marketCode: 'Market Code',
|
||||
sourceCode: 'Source Code',
|
||||
departureDate: 'Departure date',
|
||||
rateCode: 'Rate Code',
|
||||
roomItems: 'Confirmed room items',
|
||||
latestConfirmedAt: 'Latest confirmed at',
|
||||
traceCardStatus: 'Trace card status',
|
||||
roomingListCardStatus: 'Rooming List card status',
|
||||
paymentCardStatus: 'Payment card status',
|
||||
nextV4ActionTitle: 'Next action',
|
||||
nextV4ActionSubtitle: 'The order overview only links to the task page; it does not confirm, review, or edit cards.',
|
||||
nextV4ActionType: 'Action type',
|
||||
nextV4ActionStatus: 'Action status',
|
||||
nextV4CardId: 'Card ID',
|
||||
openOrderTaskCount: 'Open V4 tasks',
|
||||
enterV4Task: 'Open task page',
|
||||
nextActionConfirm: 'Confirm card',
|
||||
nextActionReview: 'Manual review',
|
||||
nextActionNone: 'No pending action',
|
||||
nextV4ActionEmpty: 'No next V4 action.',
|
||||
relatedSourceMessages: 'Related source messages',
|
||||
relatedSourceMessagesHint: 'Shows headers and conversation summary only. Open the conversation page for full email content.',
|
||||
relatedSourceMessagesEmpty: 'No related source messages.',
|
||||
externalConversationId: 'External conversation ID',
|
||||
latestActivityAt: 'Latest activity',
|
||||
v4CardsEmpty: 'No card summaries.',
|
||||
cardId: 'Card ID',
|
||||
reviewStatus: 'Review status',
|
||||
confirmedBy: 'Confirmed by',
|
||||
confirmedAt: 'Confirmed at',
|
||||
sourceEventIndex: 'Source event {index}',
|
||||
sourceMessage: 'Source message',
|
||||
businessKeySource: 'Business key source',
|
||||
updatedAt: 'Last updated',
|
||||
@@ -822,6 +859,12 @@ export default {
|
||||
INFORMATIONAL_MESSAGE: 'Message notification (legacy)',
|
||||
SOURCE_MESSAGE_REVIEW_NOTIFICATION: 'Source message notification',
|
||||
SOURCE_MESSAGE_ONLY: 'Source message only',
|
||||
SOURCE_MESSAGE_DISPLAY: 'Source message display card',
|
||||
SOURCE_MESSAGE_NOTIFICATION: 'Source message notification card',
|
||||
BASIC_INFORMATION: 'Basic Information card',
|
||||
ROOM_INFORMATION: 'Room Information card',
|
||||
TRACE_RESERVATION_NOTES: 'Trace notes card',
|
||||
PAYMENT: 'Payment card',
|
||||
MANUAL_REVIEW: 'Manual review',
|
||||
FALLBACK_REVIEW: 'Manual review',
|
||||
},
|
||||
|
||||
@@ -454,6 +454,43 @@ export default {
|
||||
taskQueue: 'คิวงานของออเดอร์นี้',
|
||||
v4TaskTimeline: 'ไทม์ไลน์งานออเดอร์ V4',
|
||||
v4TaskTimelineEmpty: 'ยังไม่มีงานออเดอร์ V4',
|
||||
v4TaskTimelineHint: 'แสดงเฉพาะสรุปงานและการ์ดที่ปลอดภัย หากต้องดำเนินการให้เข้าไปที่หน้ารายละเอียดงาน V4',
|
||||
v4OverviewTitle: 'สแนปช็อต V4 ที่ยืนยันแล้ว',
|
||||
v4OverviewSubtitle: 'มาจากการ์ดที่ยืนยันแล้วเท่านั้น ไม่ใช้คำแนะนำ AI ที่ยังไม่ยืนยัน',
|
||||
v4OverviewEmpty: 'ยังไม่มีสแนปช็อตออเดอร์ V4 ที่ยืนยันแล้ว',
|
||||
accountCode: 'Account Code',
|
||||
accountName: 'Account Name',
|
||||
marketCode: 'Market Code',
|
||||
sourceCode: 'Source Code',
|
||||
departureDate: 'วันออก',
|
||||
rateCode: 'Rate Code',
|
||||
roomItems: 'ประเภทห้องและจำนวนที่ยืนยันแล้ว',
|
||||
latestConfirmedAt: 'เวลายืนยันล่าสุด',
|
||||
traceCardStatus: 'สถานะการ์ด Trace',
|
||||
roomingListCardStatus: 'สถานะการ์ด Rooming List',
|
||||
paymentCardStatus: 'สถานะการ์ด Payment',
|
||||
nextV4ActionTitle: 'ขั้นตอนถัดไป',
|
||||
nextV4ActionSubtitle: 'หน้าสรุปออเดอร์เป็นทางเข้าเท่านั้น ไม่ยืนยัน ตรวจสอบ หรือแก้ไขการ์ดในหน้านี้',
|
||||
nextV4ActionType: 'ประเภทการดำเนินการ',
|
||||
nextV4ActionStatus: 'สถานะการดำเนินการ',
|
||||
nextV4CardId: 'รหัสการ์ด',
|
||||
openOrderTaskCount: 'งาน V4 ที่ยังไม่เสร็จ',
|
||||
enterV4Task: 'ไปหน้าดำเนินการ',
|
||||
nextActionConfirm: 'ยืนยันการ์ด',
|
||||
nextActionReview: 'ตรวจสอบด้วยคน',
|
||||
nextActionNone: 'ไม่มีงานรอดำเนินการ',
|
||||
nextV4ActionEmpty: 'ยังไม่มีขั้นตอน V4 ถัดไป',
|
||||
relatedSourceMessages: 'ข้อความต้นทางที่เกี่ยวข้อง',
|
||||
relatedSourceMessagesHint: 'แสดงเฉพาะหัวอีเมลและสรุปเธรด หากต้องการอ่านทั้งหมดให้เปิดหน้าบทสนทนาอีเมล',
|
||||
relatedSourceMessagesEmpty: 'ยังไม่มีข้อความต้นทางที่เกี่ยวข้อง',
|
||||
externalConversationId: 'รหัสเธรดภายนอก',
|
||||
latestActivityAt: 'กิจกรรมล่าสุด',
|
||||
v4CardsEmpty: 'ยังไม่มีสรุปการ์ด',
|
||||
cardId: 'รหัสการ์ด',
|
||||
reviewStatus: 'สถานะตรวจสอบ',
|
||||
confirmedBy: 'ผู้ยืนยัน',
|
||||
confirmedAt: 'เวลายืนยัน',
|
||||
sourceEventIndex: 'เหตุการณ์ต้นทาง {index}',
|
||||
sourceMessage: 'ข้อความต้นทาง',
|
||||
businessKeySource: 'แหล่งที่มาของเลขธุรกิจ',
|
||||
updatedAt: 'อัปเดตล่าสุด',
|
||||
@@ -822,6 +859,12 @@ export default {
|
||||
INFORMATIONAL_MESSAGE: 'แจ้งเตือนข้อความ (เดิม)',
|
||||
SOURCE_MESSAGE_REVIEW_NOTIFICATION: 'แจ้งเตือนข้อความต้นทาง',
|
||||
SOURCE_MESSAGE_ONLY: 'ข้อความต้นทางแบบอ่านอย่างเดียว',
|
||||
SOURCE_MESSAGE_DISPLAY: 'การ์ดแสดงข้อความต้นทาง',
|
||||
SOURCE_MESSAGE_NOTIFICATION: 'การ์ดแจ้งเตือนข้อความต้นทาง',
|
||||
BASIC_INFORMATION: 'การ์ดข้อมูลพื้นฐาน',
|
||||
ROOM_INFORMATION: 'การ์ดข้อมูลห้อง',
|
||||
TRACE_RESERVATION_NOTES: 'การ์ดหมายเหตุติดตาม',
|
||||
PAYMENT: 'การ์ดการชำระเงิน',
|
||||
MANUAL_REVIEW: 'ตรวจสอบด้วยคน',
|
||||
FALLBACK_REVIEW: 'ตรวจสอบด้วยคน',
|
||||
},
|
||||
|
||||
@@ -454,6 +454,43 @@ export default {
|
||||
taskQueue: '同订单任务队列',
|
||||
v4TaskTimeline: 'V4 订单任务时间线',
|
||||
v4TaskTimelineEmpty: '暂无 V4 订单任务。',
|
||||
v4TaskTimelineHint: '只展示订单任务和任务卡安全摘要；处理动作请进入 V4 任务详情页完成。',
|
||||
v4OverviewTitle: 'V4 当前确认快照',
|
||||
v4OverviewSubtitle: '仅来自已确认任务卡，不使用未确认 AI 建议。',
|
||||
v4OverviewEmpty: '暂无已确认的 V4 订单快照。',
|
||||
accountCode: 'Account 代码',
|
||||
accountName: 'Account 名称',
|
||||
marketCode: 'Market 代码',
|
||||
sourceCode: 'Source 代码',
|
||||
departureDate: '离店日期',
|
||||
rateCode: 'Rate Code',
|
||||
roomItems: '已确认房型房量',
|
||||
latestConfirmedAt: '最近确认时间',
|
||||
traceCardStatus: 'Trace 卡片状态',
|
||||
roomingListCardStatus: 'Rooming List 卡片状态',
|
||||
paymentCardStatus: 'Payment 卡片状态',
|
||||
nextV4ActionTitle: '下一步处理',
|
||||
nextV4ActionSubtitle: '订单总览只提供入口，不直接确认、复核或编辑任务卡。',
|
||||
nextV4ActionType: '动作类型',
|
||||
nextV4ActionStatus: '动作状态',
|
||||
nextV4CardId: '任务卡编号',
|
||||
openOrderTaskCount: '未完成 V4 任务数',
|
||||
enterV4Task: '进入处理页',
|
||||
nextActionConfirm: '确认任务卡',
|
||||
nextActionReview: '人工复核',
|
||||
nextActionNone: '无待处理动作',
|
||||
nextV4ActionEmpty: '暂无下一步 V4 处理动作。',
|
||||
relatedSourceMessages: '关联来源消息',
|
||||
relatedSourceMessagesHint: '只展示邮件头和会话摘要；全文请进入邮件会话页查看。',
|
||||
relatedSourceMessagesEmpty: '暂无关联来源消息。',
|
||||
externalConversationId: '外部会话编号',
|
||||
latestActivityAt: '最近活动时间',
|
||||
v4CardsEmpty: '暂无任务卡摘要。',
|
||||
cardId: '任务卡编号',
|
||||
reviewStatus: '复核状态',
|
||||
confirmedBy: '确认人',
|
||||
confirmedAt: '确认时间',
|
||||
sourceEventIndex: '来源事件 {index}',
|
||||
sourceMessage: '来源消息',
|
||||
businessKeySource: '业务号来源',
|
||||
updatedAt: '最近更新',
|
||||
@@ -822,6 +859,12 @@ export default {
|
||||
INFORMATIONAL_MESSAGE: '消息通知（历史 Message Notification）',
|
||||
SOURCE_MESSAGE_REVIEW_NOTIFICATION: '来源消息通知',
|
||||
SOURCE_MESSAGE_ONLY: '来源消息只读',
|
||||
SOURCE_MESSAGE_DISPLAY: '来源消息展示卡',
|
||||
SOURCE_MESSAGE_NOTIFICATION: '来源消息通知卡',
|
||||
BASIC_INFORMATION: '基础信息卡',
|
||||
ROOM_INFORMATION: '房型信息卡',
|
||||
TRACE_RESERVATION_NOTES: '追踪备注卡',
|
||||
PAYMENT: '付款信息卡',
|
||||
MANUAL_REVIEW: '人工复核',
|
||||
FALLBACK_REVIEW: '人工复核',
|
||||
},
|
||||
|
||||
@@ -11,6 +11,7 @@ import ReservationSourceMessageConversationView from '@/views/reservation/Reserv
|
||||
import ReservationTaskListView from '@/views/reservation/ReservationTaskListView.vue'
|
||||
import { useAuthStore } from '@/stores/authStore'
|
||||
import type {
|
||||
ReservationOrderDetailResult,
|
||||
ReservationOrderListResult,
|
||||
ReservationV4OrderTaskListResult,
|
||||
ReservationV4WorkbenchListResult,
|
||||
@@ -221,7 +222,7 @@ function createV4OrderTaskListResult(
|
||||
}
|
||||
}
|
||||
|
||||
function createOrderDetailResult(displayName = 'GRP-001') {
|
||||
function createOrderDetailResult(displayName = 'GRP-001'): ReservationOrderDetailResult {
|
||||
return {
|
||||
order: {
|
||||
order_id: displayName === 'GRP-002' ? '20002' : '20001',
|
||||
@@ -286,6 +287,49 @@ function createOrderDetailResult(displayName = 'GRP-001') {
|
||||
review_required_count: 1,
|
||||
confirmed_count: 0,
|
||||
},
|
||||
cards: [
|
||||
{
|
||||
card_id: '9100',
|
||||
card_type: 'SOURCE_MESSAGE_DISPLAY',
|
||||
event_type: null,
|
||||
source_event_index: 0,
|
||||
card_sort_order: 0,
|
||||
card_status: 'READONLY',
|
||||
review_status: null,
|
||||
confirmed_by: null,
|
||||
confirmed_at: null,
|
||||
latest_activity_at: '2026-07-08T05:05:00Z',
|
||||
ai_payload_json: 'unsafe ai payload must stay hidden',
|
||||
display_payload_json: 'unsafe display payload must stay hidden',
|
||||
confirmed_payload_json: 'unsafe confirmed payload must stay hidden',
|
||||
text_body: 'unsafe mail body must stay hidden',
|
||||
attachment_url: 'https://oss.example.test/private.xlsx',
|
||||
},
|
||||
{
|
||||
card_id: '9101',
|
||||
card_type: 'BASIC_INFORMATION',
|
||||
event_type: 'NEW_BOOKING',
|
||||
source_event_index: 1,
|
||||
card_sort_order: 10,
|
||||
card_status: 'CONFIRMED',
|
||||
review_status: null,
|
||||
confirmed_by: 'frontend-query-admin',
|
||||
confirmed_at: '2026-07-08T11:10:00Z',
|
||||
latest_activity_at: '2026-07-08T11:10:00Z',
|
||||
},
|
||||
{
|
||||
card_id: '9104',
|
||||
card_type: 'PAYMENT',
|
||||
event_type: 'PAYMENT',
|
||||
source_event_index: 3,
|
||||
card_sort_order: 60,
|
||||
card_status: 'REVIEW_REQUIRED',
|
||||
review_status: 'PENDING',
|
||||
confirmed_by: null,
|
||||
confirmed_at: null,
|
||||
latest_activity_at: '2026-07-08T11:20:00Z',
|
||||
},
|
||||
],
|
||||
source_message_summary: {
|
||||
source_message_id: '30003',
|
||||
hotel_id: 'HOTEL-TEST',
|
||||
@@ -303,8 +347,54 @@ function createOrderDetailResult(displayName = 'GRP-001') {
|
||||
latest_activity_at: '2026-07-08T05:10:00Z',
|
||||
},
|
||||
],
|
||||
order_overview: {
|
||||
account_code: 'QBD_TRAVEL',
|
||||
account_name: 'Q.B.D. TRAVEL GROUP CO., LTD',
|
||||
market_code: 'LEISURE',
|
||||
source_code: 'TRAVEL_AGENT',
|
||||
arrival_date: '2026-07-26',
|
||||
departure_date: '2026-07-29',
|
||||
rate_code: 'BAR',
|
||||
room_items: [
|
||||
{
|
||||
room_type_code: 'RM1',
|
||||
room_count: 2,
|
||||
},
|
||||
{
|
||||
room_type_code: 'RM2',
|
||||
room_count: 1,
|
||||
},
|
||||
],
|
||||
trace_card_status: 'CONFIRMED',
|
||||
rooming_list_card_status: 'PENDING_CONFIRM',
|
||||
payment_card_status: 'REVIEW_REQUIRED',
|
||||
latest_confirmed_at: '2026-07-08T11:20:00Z',
|
||||
ai_payload_json: 'unsafe overview payload must stay hidden',
|
||||
},
|
||||
next_v4_action: {
|
||||
order_task_id: '9001',
|
||||
card_id: '9104',
|
||||
action_type: 'REVIEW',
|
||||
action_status: 'REVIEW_REQUIRED',
|
||||
open_order_task_count: 1,
|
||||
},
|
||||
related_source_messages: [
|
||||
{
|
||||
source_message_id: '30003',
|
||||
hotel_id: 'HOTEL-TEST',
|
||||
external_message_id: 'm-v4-1',
|
||||
external_conversation_id: 'thread-v4-1',
|
||||
subject: 'V4 Booking Package',
|
||||
sender_summary: 'v4@example.test',
|
||||
received_at: '2026-07-08T05:00:00Z',
|
||||
source_sent_at: null,
|
||||
conversation_message_count: 1,
|
||||
html_body: '<strong>unsafe related mail body</strong>',
|
||||
attachment_url: 'https://oss.example.test/related.xlsx',
|
||||
},
|
||||
],
|
||||
warnings: [],
|
||||
}
|
||||
} as unknown as ReservationOrderDetailResult
|
||||
}
|
||||
|
||||
function createSourceMessageConversationResult(
|
||||
@@ -480,28 +570,65 @@ describe('reservation P0 views', () => {
|
||||
vi.mocked(service.fetchSourceMessageConversation).mockReset()
|
||||
})
|
||||
|
||||
it('renders active order task source evidence without the stale pending copy', async () => {
|
||||
it('renders the V4 order overview, next action, related source messages and safe card timeline', async () => {
|
||||
vi.mocked(service.fetchReservationOrderDetail).mockResolvedValue(createOrderDetailResult())
|
||||
|
||||
const wrapper = await mountWithPlugins(ReservationOrderDetailView, '/reservation/orders/20001', {
|
||||
ReservationTaskDetailPanel: {
|
||||
template: '<section />',
|
||||
},
|
||||
})
|
||||
const wrapper = await mountWithPlugins(ReservationOrderDetailView, '/reservation/orders/20001')
|
||||
await vi.dynamicImportSettled()
|
||||
|
||||
expect(wrapper.text()).toContain('Booking Request')
|
||||
expect(wrapper.text()).toContain('guest@example.test')
|
||||
expect(wrapper.text()).toContain('2')
|
||||
expect(wrapper.text()).toContain('前序任务未完成')
|
||||
expect(wrapper.text()).toContain('V4 当前确认快照')
|
||||
expect(wrapper.text()).toContain('QBD_TRAVEL')
|
||||
expect(wrapper.text()).toContain('Q.B.D. TRAVEL GROUP CO., LTD')
|
||||
expect(wrapper.text()).toContain('2026-07-26')
|
||||
expect(wrapper.text()).toContain('2026-07-29')
|
||||
expect(wrapper.text()).toContain('RM1 × 2')
|
||||
expect(wrapper.text()).toContain('下一步处理')
|
||||
expect(wrapper.find('a[href="/reservation/order-tasks/9001"]').text()).toContain('进入处理页')
|
||||
expect(wrapper.find('.primary-link[href="/reservation/order-tasks/9001"]').exists()).toBe(true)
|
||||
expect(wrapper.text()).toContain('关联来源消息')
|
||||
expect(wrapper.text()).toContain('v4@example.test')
|
||||
expect(wrapper.text()).toContain('查看邮件会话')
|
||||
expect(wrapper.find('a[href="/reservation/source-messages/30003/conversation"]').exists()).toBe(true)
|
||||
expect(wrapper.text()).toContain(zhCN.order.v4TaskTimeline)
|
||||
expect(wrapper.text()).toContain('order-ref-1')
|
||||
expect(wrapper.text()).toContain('V4 Booking Package')
|
||||
expect(wrapper.text()).not.toContain('PREVIOUS_TASK_NOT_FINISHED')
|
||||
expect(wrapper.find('.v4-timeline-item__main[href="/reservation/order-tasks/9001"]').exists()).toBe(true)
|
||||
expect(wrapper.text()).toContain('基础信息卡')
|
||||
expect(wrapper.text()).toContain('frontend-query-admin')
|
||||
expect(wrapper.text()).toContain('待复核')
|
||||
expect(wrapper.text()).not.toContain('unsafe ai payload must stay hidden')
|
||||
expect(wrapper.text()).not.toContain('unsafe display payload must stay hidden')
|
||||
expect(wrapper.text()).not.toContain('unsafe confirmed payload must stay hidden')
|
||||
expect(wrapper.text()).not.toContain('unsafe mail body must stay hidden')
|
||||
expect(wrapper.text()).not.toContain('https://oss.example.test')
|
||||
expect(wrapper.findComponent({ name: 'ReservationTaskDetailPanel' }).exists()).toBe(false)
|
||||
expect(wrapper.text()).not.toContain('来源邮件摘要字段待后端补充')
|
||||
})
|
||||
|
||||
it('shows empty states when an order has no V4 overview, next action, source messages or task timeline', async () => {
|
||||
const result = createOrderDetailResult()
|
||||
result.order_overview = null
|
||||
result.next_v4_action = {
|
||||
order_task_id: null,
|
||||
card_id: null,
|
||||
action_type: 'NONE',
|
||||
action_status: null,
|
||||
open_order_task_count: 0,
|
||||
}
|
||||
result.related_source_messages = []
|
||||
result.v4_order_tasks = []
|
||||
vi.mocked(service.fetchReservationOrderDetail).mockResolvedValue(result)
|
||||
|
||||
const wrapper = await mountWithPlugins(ReservationOrderDetailView, '/reservation/orders/20001')
|
||||
await vi.dynamicImportSettled()
|
||||
|
||||
expect(wrapper.text()).toContain('暂无已确认的 V4 订单快照')
|
||||
expect(wrapper.text()).toContain('暂无下一步 V4 处理动作')
|
||||
expect(wrapper.text()).toContain('暂无关联来源消息')
|
||||
expect(wrapper.text()).toContain(zhCN.order.v4TaskTimelineEmpty)
|
||||
expect(wrapper.find('a[href^="/reservation/order-tasks/"]').exists()).toBe(false)
|
||||
})
|
||||
|
||||
it('renders order list items returned by the backend', async () => {
|
||||
vi.mocked(service.fetchReservationOrders).mockResolvedValue(createOrderListResult())
|
||||
|
||||
|
||||
@@ -246,6 +246,36 @@ export interface ReservationV4CardCounts {
|
||||
confirmed_count: number
|
||||
}
|
||||
|
||||
export interface ReservationOrderV4RoomSummary {
|
||||
room_type_code: string | null
|
||||
room_count: number | null
|
||||
}
|
||||
|
||||
export interface ReservationOrderV4OverviewResult {
|
||||
account_code: string | null
|
||||
account_name: string | null
|
||||
market_code: string | null
|
||||
source_code: string | null
|
||||
arrival_date: string | null
|
||||
departure_date: string | null
|
||||
rate_code: string | null
|
||||
room_items: ReservationOrderV4RoomSummary[]
|
||||
trace_card_status: ReservationV4CardStatus | string | null
|
||||
rooming_list_card_status: ReservationV4CardStatus | string | null
|
||||
payment_card_status: ReservationV4CardStatus | string | null
|
||||
latest_confirmed_at: string | null
|
||||
}
|
||||
|
||||
export type ReservationOrderV4NextActionType = 'CONFIRM' | 'REVIEW' | 'NONE' | string
|
||||
|
||||
export interface ReservationOrderV4NextActionResult {
|
||||
order_task_id: string | null
|
||||
card_id: string | null
|
||||
action_type: ReservationOrderV4NextActionType | null
|
||||
action_status: ReservationV4CardStatus | string | null
|
||||
open_order_task_count: number | null
|
||||
}
|
||||
|
||||
export interface ReservationV4ActionAvailability {
|
||||
blocked: boolean
|
||||
read_only: boolean
|
||||
@@ -453,6 +483,7 @@ export interface ReservationV4OrderTaskTimelineItem {
|
||||
order_ref: string | null
|
||||
order_task_status: ReservationV4OrderTaskStatus | string
|
||||
card_counts: ReservationV4CardCounts
|
||||
cards: ReservationOrderV4TaskCardTimelineItem[]
|
||||
source_message_summary: ReservationV4SourceMessageSummary | null
|
||||
source_received_at: string | null
|
||||
created_at: string | null
|
||||
@@ -460,8 +491,24 @@ export interface ReservationV4OrderTaskTimelineItem {
|
||||
latest_activity_at: string | null
|
||||
}
|
||||
|
||||
export interface ReservationOrderV4TaskCardTimelineItem {
|
||||
card_id: string
|
||||
card_type: ReservationV4CardType | string
|
||||
event_type: string | null
|
||||
source_event_index: number | null
|
||||
card_sort_order: number | null
|
||||
card_status: ReservationV4CardStatus | string
|
||||
review_status: string | null
|
||||
confirmed_by: string | null
|
||||
confirmed_at: string | null
|
||||
latest_activity_at: string | null
|
||||
}
|
||||
|
||||
export interface ReservationOrderDetailResult {
|
||||
order: ReservationOrderSummaryResult
|
||||
order_overview: ReservationOrderV4OverviewResult | null
|
||||
next_v4_action: ReservationOrderV4NextActionResult | null
|
||||
related_source_messages: ReservationV4SourceMessageSummary[]
|
||||
tasks: ReservationOrderTaskTimelineItem[]
|
||||
v4_order_tasks: ReservationV4OrderTaskTimelineItem[]
|
||||
warnings: string[]
|
||||
|
||||
@@ -51,110 +51,290 @@
|
||||
</dl>
|
||||
</section>
|
||||
|
||||
<div class="order-grid">
|
||||
<aside class="order-side">
|
||||
<section class="th-section side-section">
|
||||
<div class="overview-layout">
|
||||
<section class="th-section overview-section">
|
||||
<div class="th-section-header">
|
||||
<div>
|
||||
<h2 class="th-section-title">
|
||||
{{ t('order.taskQueue') }}
|
||||
{{ t('order.v4OverviewTitle') }}
|
||||
</h2>
|
||||
<p class="th-muted">
|
||||
{{ t('order.v4OverviewSubtitle') }}
|
||||
</p>
|
||||
</div>
|
||||
<div class="side-section__body">
|
||||
<ReservationTaskQueue
|
||||
:items="detail.tasks"
|
||||
:active-task-id="activeTaskId"
|
||||
@open-task="activeTaskId = $event"
|
||||
</div>
|
||||
|
||||
<template v-if="hasOrderOverview">
|
||||
<dl class="overview-facts">
|
||||
<div
|
||||
v-for="fact in overviewFacts"
|
||||
:key="fact.label"
|
||||
>
|
||||
<dt>{{ fact.label }}</dt>
|
||||
<dd>{{ fact.value }}</dd>
|
||||
</div>
|
||||
</dl>
|
||||
|
||||
<div class="room-summary">
|
||||
<span>{{ t('order.roomItems') }}</span>
|
||||
<div
|
||||
v-if="overviewRoomItems.length"
|
||||
class="room-summary__items"
|
||||
>
|
||||
<strong
|
||||
v-for="room in overviewRoomItems"
|
||||
:key="`${room.room_type_code ?? '-'}-${room.room_count ?? '-'}`"
|
||||
>
|
||||
{{ formatRoomSummary(room) }}
|
||||
</strong>
|
||||
</div>
|
||||
<strong v-else>-</strong>
|
||||
</div>
|
||||
|
||||
<div class="overview-statuses">
|
||||
<div
|
||||
v-for="statusItem in overviewStatuses"
|
||||
:key="statusItem.label"
|
||||
>
|
||||
<span>{{ statusItem.label }}</span>
|
||||
<ReservationStatusBadge
|
||||
v-if="statusItem.status"
|
||||
:status="statusItem.status"
|
||||
/>
|
||||
<strong v-else>-</strong>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
<p
|
||||
v-else
|
||||
class="empty-copy"
|
||||
>
|
||||
{{ t('order.v4OverviewEmpty') }}
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<section class="th-section side-section">
|
||||
<section class="th-section next-action-section">
|
||||
<div class="th-section-header">
|
||||
<div>
|
||||
<h2 class="th-section-title">
|
||||
{{ t('order.nextV4ActionTitle') }}
|
||||
</h2>
|
||||
<p class="th-muted">
|
||||
{{ t('order.nextV4ActionSubtitle') }}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<template v-if="hasNextV4Action && nextV4Action">
|
||||
<dl class="next-action-facts">
|
||||
<div>
|
||||
<dt>{{ t('order.nextV4ActionType') }}</dt>
|
||||
<dd>{{ formatNextActionType(nextV4Action.action_type) }}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.nextV4ActionStatus') }}</dt>
|
||||
<dd>
|
||||
<ReservationStatusBadge
|
||||
v-if="nextV4Action.action_status"
|
||||
:status="nextV4Action.action_status"
|
||||
/>
|
||||
<span v-else>-</span>
|
||||
</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.openOrderTaskCount') }}</dt>
|
||||
<dd>{{ nextV4Action.open_order_task_count ?? 0 }}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.nextV4CardId') }}</dt>
|
||||
<dd>{{ nextV4Action.card_id ?? '-' }}</dd>
|
||||
</div>
|
||||
</dl>
|
||||
<RouterLink
|
||||
class="primary-link"
|
||||
:to="`/reservation/order-tasks/${nextV4Action.order_task_id}`"
|
||||
>
|
||||
{{ t('order.enterV4Task') }}
|
||||
</RouterLink>
|
||||
</template>
|
||||
<p
|
||||
v-else
|
||||
class="empty-copy"
|
||||
>
|
||||
{{ t('order.nextV4ActionEmpty') }}
|
||||
</p>
|
||||
</section>
|
||||
</div>
|
||||
|
||||
<section class="th-section source-section">
|
||||
<div class="th-section-header">
|
||||
<div>
|
||||
<h2 class="th-section-title">
|
||||
{{ t('order.relatedSourceMessages') }}
|
||||
</h2>
|
||||
<p class="th-muted">
|
||||
{{ t('order.relatedSourceMessagesHint') }}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div
|
||||
v-if="relatedSourceMessages.length"
|
||||
class="source-list"
|
||||
>
|
||||
<article
|
||||
v-for="sourceMessage in relatedSourceMessages"
|
||||
:key="sourceMessage.source_message_id"
|
||||
class="source-item"
|
||||
>
|
||||
<div>
|
||||
<strong>{{ sourceMessage.subject ?? t('taskList.noSourceSubject') }}</strong>
|
||||
<span>{{ sourceMessage.sender_summary ?? '-' }}</span>
|
||||
</div>
|
||||
<dl>
|
||||
<div>
|
||||
<dt>{{ t('task.sourceReceivedAt') }}</dt>
|
||||
<dd>{{ formatReservationDateTime(sourceMessage.received_at) }}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.conversationMessageCount') }}</dt>
|
||||
<dd>{{ sourceMessage.conversation_message_count ?? '-' }}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.externalConversationId') }}</dt>
|
||||
<dd>{{ sourceMessage.external_conversation_id ?? '-' }}</dd>
|
||||
</div>
|
||||
</dl>
|
||||
<RouterLink
|
||||
class="source-link"
|
||||
:to="`/reservation/source-messages/${sourceMessage.source_message_id}/conversation`"
|
||||
>
|
||||
{{ t('task.viewConversation') }}
|
||||
</RouterLink>
|
||||
</article>
|
||||
</div>
|
||||
<p
|
||||
v-else
|
||||
class="empty-copy"
|
||||
>
|
||||
{{ t('order.relatedSourceMessagesEmpty') }}
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<section class="th-section v4-timeline-section">
|
||||
<div class="th-section-header">
|
||||
<div>
|
||||
<h2 class="th-section-title">
|
||||
{{ t('order.v4TaskTimeline') }}
|
||||
</h2>
|
||||
<p class="th-muted">
|
||||
{{ t('order.v4TaskTimelineHint') }}
|
||||
</p>
|
||||
</div>
|
||||
<div class="side-section__body">
|
||||
</div>
|
||||
|
||||
<p
|
||||
v-if="!v4OrderTasks.length"
|
||||
class="side-empty"
|
||||
class="empty-copy"
|
||||
>
|
||||
{{ t('order.v4TaskTimelineEmpty') }}
|
||||
</p>
|
||||
<template v-else>
|
||||
<RouterLink
|
||||
<div
|
||||
v-else
|
||||
class="v4-timeline-list"
|
||||
>
|
||||
<article
|
||||
v-for="item in v4OrderTasks"
|
||||
:key="item.order_task_id"
|
||||
class="v4-timeline-item"
|
||||
>
|
||||
<RouterLink
|
||||
class="v4-timeline-item__main"
|
||||
:to="`/reservation/order-tasks/${item.order_task_id}`"
|
||||
>
|
||||
<span>
|
||||
<strong>{{ v4OrderReference(item) }}</strong>
|
||||
<small>{{ item.source_message_summary?.subject ?? '-' }}</small>
|
||||
<small>{{ item.source_message_summary?.subject ?? t('taskList.noSourceSubject') }}</small>
|
||||
</span>
|
||||
<ReservationStatusBadge :status="item.order_task_status" />
|
||||
<small>
|
||||
{{ t('taskList.cardCountsTotal', { total: item.card_counts.total_count }) }}
|
||||
·
|
||||
{{ formatReservationDateTime(item.latest_activity_at ?? item.updated_at ?? item.created_at) }}
|
||||
</small>
|
||||
</RouterLink>
|
||||
</template>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="th-section source-gap">
|
||||
<h2>{{ t('task.evidence') }}</h2>
|
||||
<template v-if="activeTask">
|
||||
<dl>
|
||||
<dl class="timeline-meta">
|
||||
<div>
|
||||
<dt>{{ t('task.sourceSubject') }}</dt>
|
||||
<dd>{{ activeTask.source_subject ?? '-' }}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('task.sourceSender') }}</dt>
|
||||
<dd>{{ activeTask.source_sender_summary ?? '-' }}</dd>
|
||||
<dt>{{ t('taskList.cardCountsTotal', { total: item.card_counts.total_count }) }}</dt>
|
||||
<dd>
|
||||
{{ t('taskList.cardCountsPending', { count: item.card_counts.pending_confirm_count }) }}
|
||||
·
|
||||
{{ t('taskList.cardCountsReview', { count: item.card_counts.review_required_count }) }}
|
||||
·
|
||||
{{ t('taskList.cardCountsConfirmed', { count: item.card_counts.confirmed_count }) }}
|
||||
</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('task.sourceReceivedAt') }}</dt>
|
||||
<dd>{{ formatReservationDateTime(activeTask.source_received_at) }}</dd>
|
||||
<dd>{{ formatReservationDateTime(item.source_received_at) }}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.conversationMessageCount') }}</dt>
|
||||
<dd>{{ activeTask.conversation_message_count ?? '-' }}</dd>
|
||||
<dt>{{ t('order.latestActivityAt') }}</dt>
|
||||
<dd>{{ formatReservationDateTime(item.latest_activity_at ?? item.updated_at ?? item.created_at) }}</dd>
|
||||
</div>
|
||||
</dl>
|
||||
<RouterLink
|
||||
v-if="activeTask.source_message_id"
|
||||
class="source-link"
|
||||
:to="`/reservation/source-messages/${activeTask.source_message_id}/conversation`"
|
||||
>
|
||||
{{ t('task.viewConversation') }}
|
||||
</RouterLink>
|
||||
<span
|
||||
v-else
|
||||
class="source-link source-link--disabled"
|
||||
>
|
||||
{{ t('common.endpointMissing') }}
|
||||
</span>
|
||||
</template>
|
||||
<p v-else>
|
||||
{{ t('common.noData') }}
|
||||
</p>
|
||||
</section>
|
||||
</aside>
|
||||
|
||||
<ReservationTaskDetailPanel
|
||||
v-if="activeTaskId"
|
||||
:task-id="activeTaskId"
|
||||
/>
|
||||
<section
|
||||
v-else
|
||||
class="th-section order-state"
|
||||
<div
|
||||
v-if="item.cards.length"
|
||||
class="card-summary-list"
|
||||
>
|
||||
{{ t('common.noData') }}
|
||||
</section>
|
||||
<article
|
||||
v-for="card in item.cards"
|
||||
:key="card.card_id"
|
||||
class="card-summary"
|
||||
>
|
||||
<div class="card-summary__heading">
|
||||
<span>
|
||||
<strong>{{ cardTimelineTitle(card) }}</strong>
|
||||
<small>{{ card.event_type ?? '-' }}</small>
|
||||
</span>
|
||||
<ReservationStatusBadge :status="card.card_status" />
|
||||
</div>
|
||||
<dl>
|
||||
<div>
|
||||
<dt>{{ t('order.cardId') }}</dt>
|
||||
<dd>{{ card.card_id }}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.reviewStatus') }}</dt>
|
||||
<dd>
|
||||
<ReservationStatusBadge
|
||||
v-if="card.review_status"
|
||||
:status="card.review_status"
|
||||
/>
|
||||
<span v-else>-</span>
|
||||
</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.confirmedBy') }}</dt>
|
||||
<dd>{{ card.confirmed_by ?? '-' }}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.confirmedAt') }}</dt>
|
||||
<dd>{{ formatReservationDateTime(card.confirmed_at) }}</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt>{{ t('order.latestActivityAt') }}</dt>
|
||||
<dd>{{ formatReservationDateTime(card.latest_activity_at) }}</dd>
|
||||
</div>
|
||||
</dl>
|
||||
</article>
|
||||
</div>
|
||||
<p
|
||||
v-else
|
||||
class="empty-copy empty-copy--compact"
|
||||
>
|
||||
{{ t('order.v4CardsEmpty') }}
|
||||
</p>
|
||||
</article>
|
||||
</div>
|
||||
</section>
|
||||
</template>
|
||||
</div>
|
||||
</template>
|
||||
@@ -165,11 +345,16 @@ import { RouterLink, useRoute } from 'vue-router'
|
||||
import { useI18n } from 'vue-i18n'
|
||||
|
||||
import ReservationStatusBadge from '@/components/reservation/ReservationStatusBadge.vue'
|
||||
import ReservationTaskDetailPanel from '@/components/reservation/ReservationTaskDetailPanel.vue'
|
||||
import ReservationTaskQueue from '@/components/reservation/ReservationTaskQueue.vue'
|
||||
import { fetchReservationOrderDetail } from '@/services/reservationService'
|
||||
import { useAuthStore } from '@/stores/authStore'
|
||||
import type { ReservationOrderDetailResult, ReservationV4OrderTaskTimelineItem } from '@/types/reservation'
|
||||
import type {
|
||||
ReservationOrderDetailResult,
|
||||
ReservationOrderV4NextActionResult,
|
||||
ReservationOrderV4RoomSummary,
|
||||
ReservationOrderV4TaskCardTimelineItem,
|
||||
ReservationV4OrderTaskTimelineItem,
|
||||
} from '@/types/reservation'
|
||||
import { formatReservationTaskCard } from '@/utils/reservationDisplay'
|
||||
import { formatReservationDateTime } from '@/utils/reservationFormat'
|
||||
|
||||
const route = useRoute()
|
||||
@@ -178,11 +363,61 @@ const authStore = useAuthStore()
|
||||
const loading = ref(false)
|
||||
const errorMessage = ref('')
|
||||
const detail = ref<ReservationOrderDetailResult | null>(null)
|
||||
const activeTaskId = ref('')
|
||||
|
||||
const orderId = computed(() => String(route.params.orderId ?? ''))
|
||||
const activeTask = computed(() => detail.value?.tasks.find((task) => task.task_id === activeTaskId.value) ?? null)
|
||||
const orderOverview = computed(() => detail.value?.order_overview ?? null)
|
||||
const nextV4Action = computed(() => detail.value?.next_v4_action ?? null)
|
||||
const relatedSourceMessages = computed(() => detail.value?.related_source_messages ?? [])
|
||||
const v4OrderTasks = computed(() => detail.value?.v4_order_tasks ?? [])
|
||||
const overviewRoomItems = computed(() => orderOverview.value?.room_items ?? [])
|
||||
const hasNextV4Action = computed(() => {
|
||||
const action = nextV4Action.value
|
||||
return Boolean(action?.order_task_id && action.action_type && action.action_type !== 'NONE')
|
||||
})
|
||||
const hasOrderOverview = computed(() => {
|
||||
const overview = orderOverview.value
|
||||
if (!overview) {
|
||||
return false
|
||||
}
|
||||
return Boolean(
|
||||
overview.account_code ||
|
||||
overview.account_name ||
|
||||
overview.market_code ||
|
||||
overview.source_code ||
|
||||
overview.arrival_date ||
|
||||
overview.departure_date ||
|
||||
overview.rate_code ||
|
||||
overview.room_items.length ||
|
||||
overview.trace_card_status ||
|
||||
overview.rooming_list_card_status ||
|
||||
overview.payment_card_status ||
|
||||
overview.latest_confirmed_at,
|
||||
)
|
||||
})
|
||||
const overviewFacts = computed(() => {
|
||||
const overview = orderOverview.value
|
||||
if (!overview) {
|
||||
return []
|
||||
}
|
||||
return [
|
||||
{ label: t('order.accountCode'), value: displayValue(overview.account_code) },
|
||||
{ label: t('order.accountName'), value: displayValue(overview.account_name) },
|
||||
{ label: t('order.marketCode'), value: displayValue(overview.market_code) },
|
||||
{ label: t('order.sourceCode'), value: displayValue(overview.source_code) },
|
||||
{ label: t('order.arrivalDate'), value: displayValue(overview.arrival_date) },
|
||||
{ label: t('order.departureDate'), value: displayValue(overview.departure_date) },
|
||||
{ label: t('order.rateCode'), value: displayValue(overview.rate_code) },
|
||||
{ label: t('order.latestConfirmedAt'), value: formatReservationDateTime(overview.latest_confirmed_at) },
|
||||
]
|
||||
})
|
||||
const overviewStatuses = computed(() => {
|
||||
const overview = orderOverview.value
|
||||
return [
|
||||
{ label: t('order.traceCardStatus'), status: overview?.trace_card_status ?? null },
|
||||
{ label: t('order.roomingListCardStatus'), status: overview?.rooming_list_card_status ?? null },
|
||||
{ label: t('order.paymentCardStatus'), status: overview?.payment_card_status ?? null },
|
||||
]
|
||||
})
|
||||
|
||||
watch(
|
||||
orderId,
|
||||
@@ -206,21 +441,45 @@ async function loadOrder(nextOrderId: string): Promise<void> {
|
||||
loading.value = true
|
||||
errorMessage.value = ''
|
||||
try {
|
||||
const nextOrder = await fetchReservationOrderDetail(nextOrderId)
|
||||
detail.value = nextOrder
|
||||
activeTaskId.value = nextOrder.tasks[0]?.task_id ?? ''
|
||||
detail.value = await fetchReservationOrderDetail(nextOrderId)
|
||||
} catch (error) {
|
||||
detail.value = null
|
||||
activeTaskId.value = ''
|
||||
errorMessage.value = error instanceof Error ? error.message : String(error)
|
||||
} finally {
|
||||
loading.value = false
|
||||
}
|
||||
}
|
||||
|
||||
function displayValue(value: string | null | undefined): string {
|
||||
return value?.trim() || '-'
|
||||
}
|
||||
|
||||
function formatRoomSummary(room: ReservationOrderV4RoomSummary): string {
|
||||
return `${displayValue(room.room_type_code)} × ${room.room_count ?? '-'}`
|
||||
}
|
||||
|
||||
function formatNextActionType(actionType: ReservationOrderV4NextActionResult['action_type']): string {
|
||||
if (actionType === 'CONFIRM') {
|
||||
return t('order.nextActionConfirm')
|
||||
}
|
||||
if (actionType === 'REVIEW') {
|
||||
return t('order.nextActionReview')
|
||||
}
|
||||
if (actionType === 'NONE') {
|
||||
return t('order.nextActionNone')
|
||||
}
|
||||
return actionType ?? '-'
|
||||
}
|
||||
|
||||
function v4OrderReference(item: ReservationV4OrderTaskTimelineItem): string {
|
||||
return item.order_ref?.trim() || item.source_message_summary?.subject?.trim() || `#${item.order_task_id}`
|
||||
}
|
||||
|
||||
function cardTimelineTitle(card: ReservationOrderV4TaskCardTimelineItem): string {
|
||||
const title = formatReservationTaskCard(t, card.card_type, card.card_type)
|
||||
const index = card.source_event_index == null ? '' : ` · ${t('order.sourceEventIndex', { index: card.source_event_index })}`
|
||||
return `${title}${index}`
|
||||
}
|
||||
</script>
|
||||
|
||||
<style scoped>
|
||||
@@ -240,7 +499,11 @@ function v4OrderReference(item: ReservationV4OrderTaskTimelineItem): string {
|
||||
color: var(--th-color-danger);
|
||||
}
|
||||
|
||||
.order-summary {
|
||||
.order-summary,
|
||||
.overview-section,
|
||||
.next-action-section,
|
||||
.source-section,
|
||||
.v4-timeline-section {
|
||||
display: grid;
|
||||
gap: 18px;
|
||||
padding: 20px;
|
||||
@@ -255,7 +518,9 @@ function v4OrderReference(item: ReservationV4OrderTaskTimelineItem): string {
|
||||
|
||||
.order-summary p,
|
||||
.order-summary h1,
|
||||
.order-summary dl {
|
||||
.order-summary dl,
|
||||
.empty-copy,
|
||||
.th-muted {
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
@@ -271,19 +536,48 @@ function v4OrderReference(item: ReservationV4OrderTaskTimelineItem): string {
|
||||
font-size: 26px;
|
||||
}
|
||||
|
||||
.order-summary dl {
|
||||
.order-summary dl,
|
||||
.overview-facts,
|
||||
.next-action-facts,
|
||||
.source-item dl,
|
||||
.timeline-meta,
|
||||
.card-summary dl {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(6, minmax(0, 1fr));
|
||||
gap: 16px;
|
||||
}
|
||||
|
||||
.order-summary dt {
|
||||
.order-summary dl,
|
||||
.overview-facts {
|
||||
grid-template-columns: repeat(4, minmax(0, 1fr));
|
||||
}
|
||||
|
||||
.next-action-facts,
|
||||
.source-item dl,
|
||||
.timeline-meta {
|
||||
grid-template-columns: repeat(3, minmax(0, 1fr));
|
||||
}
|
||||
|
||||
.card-summary dl {
|
||||
grid-template-columns: repeat(5, minmax(0, 1fr));
|
||||
}
|
||||
|
||||
.order-summary dt,
|
||||
.overview-facts dt,
|
||||
.next-action-facts dt,
|
||||
.source-item dt,
|
||||
.timeline-meta dt,
|
||||
.card-summary dt {
|
||||
color: var(--th-color-slate-500);
|
||||
font-size: 12px;
|
||||
font-weight: 700;
|
||||
}
|
||||
|
||||
.order-summary dd {
|
||||
.order-summary dd,
|
||||
.overview-facts dd,
|
||||
.next-action-facts dd,
|
||||
.source-item dd,
|
||||
.timeline-meta dd,
|
||||
.card-summary dd {
|
||||
margin: 5px 0 0;
|
||||
color: var(--th-color-slate-900);
|
||||
font-size: 13px;
|
||||
@@ -291,111 +585,61 @@ function v4OrderReference(item: ReservationV4OrderTaskTimelineItem): string {
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
|
||||
.order-grid {
|
||||
.overview-layout {
|
||||
display: grid;
|
||||
grid-template-columns: minmax(260px, 340px) minmax(0, 1fr);
|
||||
grid-template-columns: minmax(0, 2fr) minmax(300px, 0.9fr);
|
||||
gap: 18px;
|
||||
align-items: start;
|
||||
}
|
||||
|
||||
.order-side,
|
||||
.side-section__body {
|
||||
display: grid;
|
||||
gap: 14px;
|
||||
}
|
||||
|
||||
.side-section {
|
||||
padding-bottom: 16px;
|
||||
}
|
||||
|
||||
.side-section__body {
|
||||
padding: 14px 16px 0;
|
||||
}
|
||||
|
||||
.source-gap {
|
||||
display: grid;
|
||||
gap: 8px;
|
||||
padding: 16px;
|
||||
}
|
||||
|
||||
.source-gap h2,
|
||||
.source-gap p,
|
||||
.source-gap dl {
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.source-gap h2 {
|
||||
color: var(--th-color-slate-900);
|
||||
font-size: 15px;
|
||||
}
|
||||
|
||||
.source-gap p {
|
||||
.th-muted,
|
||||
.empty-copy {
|
||||
color: var(--th-color-slate-500);
|
||||
font-size: 13px;
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
.side-empty {
|
||||
margin: 0;
|
||||
color: var(--th-color-slate-500);
|
||||
font-size: 13px;
|
||||
line-height: 1.6;
|
||||
.empty-copy--compact {
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.v4-timeline-item {
|
||||
.room-summary,
|
||||
.overview-statuses {
|
||||
display: grid;
|
||||
grid-template-columns: minmax(0, 1fr) auto;
|
||||
gap: 8px;
|
||||
border: 1px solid var(--th-color-slate-200);
|
||||
border-radius: var(--th-radius-sm);
|
||||
background: var(--th-color-white);
|
||||
color: inherit;
|
||||
padding: 10px;
|
||||
text-decoration: none;
|
||||
border-top: 1px solid var(--th-color-slate-100);
|
||||
padding-top: 14px;
|
||||
}
|
||||
|
||||
.v4-timeline-item > span {
|
||||
display: grid;
|
||||
gap: 3px;
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.v4-timeline-item strong {
|
||||
color: var(--th-color-slate-900);
|
||||
font-size: 13px;
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
|
||||
.v4-timeline-item small {
|
||||
.room-summary > span,
|
||||
.overview-statuses span {
|
||||
color: var(--th-color-slate-500);
|
||||
font-size: 12px;
|
||||
font-weight: 700;
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
|
||||
.v4-timeline-item > small {
|
||||
grid-column: 1 / -1;
|
||||
}
|
||||
|
||||
.source-gap dl {
|
||||
display: grid;
|
||||
gap: 10px;
|
||||
}
|
||||
|
||||
.source-gap dt {
|
||||
color: var(--th-color-slate-500);
|
||||
font-size: 12px;
|
||||
font-weight: 700;
|
||||
}
|
||||
|
||||
.source-gap dd {
|
||||
margin: 4px 0 0;
|
||||
color: var(--th-color-slate-900);
|
||||
font-size: 13px;
|
||||
font-weight: 800;
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
|
||||
.room-summary__items,
|
||||
.overview-statuses {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
.room-summary__items strong {
|
||||
border-radius: 999px;
|
||||
background: var(--th-color-slate-100);
|
||||
color: var(--th-color-slate-900);
|
||||
padding: 5px 10px;
|
||||
font-size: 13px;
|
||||
}
|
||||
|
||||
.overview-statuses div {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
.primary-link,
|
||||
.source-link {
|
||||
color: var(--th-color-blue-600);
|
||||
font-size: 13px;
|
||||
@@ -403,23 +647,119 @@ function v4OrderReference(item: ReservationV4OrderTaskTimelineItem): string {
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
.source-link--disabled {
|
||||
.primary-link {
|
||||
width: fit-content;
|
||||
border-radius: var(--th-radius-sm);
|
||||
background: var(--th-color-blue-600);
|
||||
color: var(--th-color-white);
|
||||
padding: 9px 12px;
|
||||
}
|
||||
|
||||
.source-list,
|
||||
.v4-timeline-list,
|
||||
.card-summary-list {
|
||||
display: grid;
|
||||
gap: 12px;
|
||||
}
|
||||
|
||||
.source-item,
|
||||
.v4-timeline-item,
|
||||
.card-summary {
|
||||
display: grid;
|
||||
gap: 12px;
|
||||
border: 1px solid var(--th-color-slate-200);
|
||||
border-radius: var(--th-radius-sm);
|
||||
background: var(--th-color-white);
|
||||
padding: 14px;
|
||||
}
|
||||
|
||||
.source-item > div,
|
||||
.v4-timeline-item__main,
|
||||
.card-summary__heading {
|
||||
display: flex;
|
||||
align-items: flex-start;
|
||||
justify-content: space-between;
|
||||
gap: 12px;
|
||||
}
|
||||
|
||||
.source-item > div {
|
||||
align-items: center;
|
||||
}
|
||||
|
||||
.source-item > div > strong,
|
||||
.source-item > div > span,
|
||||
.v4-timeline-item__main span,
|
||||
.card-summary__heading span {
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.source-item > div > strong,
|
||||
.v4-timeline-item__main strong,
|
||||
.card-summary__heading strong {
|
||||
color: var(--th-color-slate-900);
|
||||
font-size: 14px;
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
|
||||
.source-item > div > span,
|
||||
.v4-timeline-item__main small,
|
||||
.card-summary__heading small {
|
||||
color: var(--th-color-slate-500);
|
||||
font-size: 12px;
|
||||
font-weight: 700;
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
|
||||
.v4-timeline-item__main {
|
||||
align-items: center;
|
||||
color: inherit;
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
.v4-timeline-item__main span,
|
||||
.card-summary__heading span {
|
||||
display: grid;
|
||||
gap: 3px;
|
||||
}
|
||||
|
||||
.card-summary-list {
|
||||
border-top: 1px solid var(--th-color-slate-100);
|
||||
padding-top: 12px;
|
||||
}
|
||||
|
||||
.card-summary {
|
||||
background: var(--th-color-slate-50);
|
||||
}
|
||||
|
||||
@media (max-width: 1100px) {
|
||||
.order-summary dl {
|
||||
grid-template-columns: repeat(3, minmax(0, 1fr));
|
||||
.overview-layout {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
|
||||
.order-grid {
|
||||
grid-template-columns: 1fr;
|
||||
.order-summary dl,
|
||||
.overview-facts,
|
||||
.next-action-facts,
|
||||
.source-item dl,
|
||||
.timeline-meta,
|
||||
.card-summary dl {
|
||||
grid-template-columns: repeat(2, minmax(0, 1fr));
|
||||
}
|
||||
}
|
||||
|
||||
@media (max-width: 680px) {
|
||||
.order-summary dl {
|
||||
.order-summary dl,
|
||||
.overview-facts,
|
||||
.next-action-facts,
|
||||
.source-item dl,
|
||||
.timeline-meta,
|
||||
.card-summary dl {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
|
||||
.source-item > div,
|
||||
.v4-timeline-item__main,
|
||||
.card-summary__heading {
|
||||
display: grid;
|
||||
}
|
||||
}
|
||||
</style>
|
||||
|
||||
@@ -106,7 +106,7 @@
|
||||
| --- | --- | --- |
|
||||
| `GET /api/reservation/orders` | 补齐订单列表 V4 继续处理入口字段，并新增统一 open count 字段；前端展示已接入。 | `order_status` 不传时默认查询全部订单状态；`page_num` 从 1 开始；`page_size` 后端有最大值保护；`open_work_item_count` 是订单列表展示用统一待处理数量，开发阶段不考虑旧数据，第一版直接等于 `v4_open_order_task_count`；前端展示待处理数量时只读该字段，不自行计算旧任务数和 V4 数，也不使用旧 `open_task_count` 作为展示数量；旧 `open_task_count` 和 `next_processable_task_id` 继续保留用于 V2/V3 兼容与排查。V4 新增 `next_v4_order_task_id`、`next_v4_action_card_id`、`next_v4_action_type`、`next_v4_action_status`、`v4_open_order_task_count`；前端“继续处理”已按优先级实现：存在 `next_v4_order_task_id` 时跳 `/reservation/order-tasks/{next_v4_order_task_id}`，否则回退旧 `/reservation/tasks/{next_processable_task_id}`；两者都没有时展示无待处理状态。 |
|
||||
| `GET /api/reservation/tasks` | 补齐来源邮件会话摘要字段，并新增 `order_status` 查询参数。 | `order_status` 按任务所属订单状态过滤，支持 `TEMPORARY`、`ACTIVE`、`ENDED`、`LOGIC_DELETED`；列表仍然只返回安全摘要，不返回正文、HTML、附件 URL 或 AI 原始 payload；点击邮件入口时使用 `source_message_id` 调会话详情。 |
|
||||
| `GET /api/reservation/orders/{orderId}` | 补齐旧 `tasks[]` 来源邮件会话摘要字段，并新增 V4 总览和 `v4_order_tasks[]` 订单任务时间线。 | `include_tasks=false` 可只取轻量摘要，此时 `tasks[]`、`v4_order_tasks[]` 和 `related_source_messages[]` 都为空，`order_overview` 为空快照，`next_v4_action.action_type=NONE`；旧 `tasks[]` 顺序由后端按订单队列返回，V4 `v4_order_tasks[]` 按 `source_received_at`、`source_message_id`、`order_context_index`、`created_at`、数字 ID 正序返回；前端不要自行重排。`include_source_summary` 第一版不作为前端裁剪字段的强约束，前端暂不要依赖它减少返回字段。 |
|
||||
| `GET /api/reservation/orders/{orderId}` | 补齐旧 `tasks[]` 来源邮件会话摘要字段，并新增 V4 总览和 `v4_order_tasks[]` 订单任务时间线；前端订单详情总览页已接入。 | `include_tasks=false` 可只取轻量摘要，此时 `tasks[]`、`v4_order_tasks[]` 和 `related_source_messages[]` 都为空，`order_overview` 为空快照，`next_v4_action.action_type=NONE`；旧 `tasks[]` 顺序由后端按订单队列返回，V4 `v4_order_tasks[]` 按 `source_received_at`、`source_message_id`、`order_context_index`、`created_at`、数字 ID 正序返回；前端不要自行重排。订单详情页只展示 V4 确认快照、下一步入口、关联来源消息和任务卡安全摘要，不在该页确认、复核或编辑任务卡，也不展示 payload、邮件正文或附件 URL。`include_source_summary` 第一版不作为前端裁剪字段的强约束，前端暂不要依赖它减少返回字段。 |
|
||||
| `GET /api/reservation/tasks/{taskId}` | 补齐顶层来源邮件字段，并扩展 `fields[]` 元数据。 | 顶层来源字段用于打开邮件会话；`fields[]` 中的 `result_type`、`task_type`、`task_subtype`、`default_value_source` 用于前端字段分组、调试和白名单对齐。 |
|
||||
| `GET /api/source-messages/{sourceMessageId}/conversation` | 新增邮件会话详情接口，并补齐 `html_body_sanitized` / `html_render_mode`。 | 当前唯一推荐路径是这个接口；前端渲染邮件 HTML 时优先使用 `html_body_sanitized`；不要调用历史讨论过的 `/api/source-message-conversations/{externalConversationId}`。 |
|
||||
| `POST /api/system/debug/eml-superagent-runs` | 新增 Debug EML 上传到 SuperAgent 调试接口，并补齐独立 Debug 外部消息 ID、原始 Message-ID 保留、安全 HTML 字段和入口通知识别。 | 只用于调试页面；请求为 multipart/form-data；必须传 `X-TH-Hotel-Debug-Upload-Key`，但该 key 不能写进前端源码、构建产物、URL、localStorage 或错误上报；SuperAgent 返回旧 S000/S999 或新 S10/S99 入口通知时都不应被前端视为 JSON 解析失败。 |
|
||||
@@ -157,7 +157,7 @@ POST /api/auth/logout
|
||||
| `external_conversation_id` | 外部邮件会话 ID。 | 仅用于展示或调试，不作为当前会话详情接口路径参数。 |
|
||||
| `conversation_message_count` | 同一外部会话下的邮件数量。 | 用于提示用户打开的是整段会话，不是单封邮件。 |
|
||||
|
||||
订单详情已经补齐 V4 订单页总览字段：`order_overview`、`next_v4_action`、`related_source_messages[]` 和增强后的 `v4_order_tasks[].cards[]`。订单详情页应定位为订单视角总览，不要在订单详情页直接编辑、确认或复核任务卡；点击 `next_v4_action.order_task_id` 或时间线 `order_task_id` 后进入 `/reservation/order-tasks/{orderTaskId}` 对应的 V4 订单任务详情页处理。
|
||||
订单详情已经补齐并完成前端接入 V4 订单页总览字段：`order_overview`、`next_v4_action`、`related_source_messages[]` 和增强后的 `v4_order_tasks[].cards[]`。订单详情页定位为订单视角总览，不要在订单详情页直接编辑、确认或复核任务卡；点击 `next_v4_action.order_task_id` 或时间线 `order_task_id` 后进入 `/reservation/order-tasks/{orderTaskId}` 对应的 V4 订单任务详情页处理。
|
||||
|
||||
`order_overview` 只从已确认 V4 卡片派生：Basic Information 未确认时 Account / Market / Source 为空；Room Information 未确认时日期、Rate Code、房型房量为空。前端不要把未确认卡片 display payload 反推成订单事实。
|
||||
|
||||
@@ -165,7 +165,7 @@ POST /api/auth/logout
|
||||
|
||||
| 字段 | 说明 | 前端使用方式 |
|
||||
| --- | --- | --- |
|
||||
| `order_task_id` | V4 订单任务 ID，字符串。 | 点击 V4 时间线项时跳转 `/api/reservation/order-tasks/{orderTaskId}` 对应的前端详情页。 |
|
||||
| `order_task_id` | V4 订单任务 ID，字符串。 | 点击 V4 时间线项时跳转前端路由 `/reservation/order-tasks/{orderTaskId}`，该页面再调用 `GET /api/reservation/order-tasks/{orderTaskId}`。 |
|
||||
| `order_ref` | SuperAgent V4 回调包内订单引用。 | 用于区分同一邮件里的多个订单上下文，不等同 PMS 永久订单号。 |
|
||||
| `order_task_status` | V4 订单任务状态，当前为 `OPEN` / `COMPLETED`。 | 展示处理状态，不要用于替代卡片级 `availability`。 |
|
||||
| `card_counts` | V4 卡片数量摘要。 | 展示待确认、待复核和已确认规模。 |
|
||||
@@ -504,6 +504,7 @@ RESERVATION_ROOMING_LIST_GENERATE
|
||||
- 前端不展示 `ai_payload_json`、邮件完整正文、附件 URL、raw evidence 或 SuperAgent 原始 payload；来源邮件详情仍从邮件会话页面查看，卡片内仅展示后端普通接口返回的安全摘要、邮件片段和附件名称。
|
||||
- V4 来源消息卡读取 `attachments`、`uploaded_media`、`file_references` 时，只允许展示附件名称、类型和大小等安全摘要；如果后端 payload 中异常出现 `https://`、`oss://`、`s3://` 等直接 URL 字符串，前端必须替换为“未命名附件”或隐藏，不得把 URL 渲染到普通业务页面。
|
||||
- V4 主流程不调用旧 V2/V3 草稿、旧任务确认、旧同卡复核接口，也不展示 OPERA 模拟操作入口。
|
||||
- 2026-07-20 测试机 smoke 注意：订单详情页依赖 `GET /api/reservation/orders/{orderId}` 返回 `order_overview`、`next_v4_action`、`related_source_messages[]` 和 `v4_order_tasks[].cards[]`。如果测试机响应仍只有旧 `order`、`tasks[]`、基础 `v4_order_tasks[]` 和 `warnings`，应先确认测试机后端是否部署了包含 M002 V4 CP15.1 的最新包；前端不要为了该旧响应重新做兼容逻辑，避免把部署问题固化成页面分支。
|
||||
|
||||
## 6. 不给前端直接调用的接口
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
| --- | --- | --- | --- |
|
||||
| P0 | 订单列表接口 `GET /api/reservation/orders` | 订单列表页、首页工作台 | 已完成第一版 |
|
||||
| P0 | 任务列表接口 `GET /api/reservation/tasks` | 任务列表菜单、订单详情任务入口 | 已完成第一版，已补来源邮件会话字段和 `order_status` 筛选 |
|
||||
| P0 | 订单详情接口 `GET /api/reservation/orders/{orderId}` | 订单详情页 | 已完成第一版，已补旧 `tasks[]` 来源邮件会话字段和 V4 `v4_order_tasks[]` 时间线 |
|
||||
| P0 | 订单详情接口 `GET /api/reservation/orders/{orderId}` | 订单详情页 | 已完成第一版，已补旧 `tasks[]` 来源邮件会话字段和 V4 `order_overview` / `next_v4_action` / `related_source_messages[]` / `v4_order_tasks[].cards[]`，前端订单详情总览页已接入 |
|
||||
| P0 | 任务详情读取接口 `GET /api/reservation/tasks/{taskId}` | 任务详情页动态渲染 | 已完成第一版，已补来源邮件字段和 3.0 字段元数据 |
|
||||
| P0 | 任务详情操作接口 | 任务详情保存、确认、OPERA、审计 | 已完成；前端可直接接入 |
|
||||
| P0 | 邮件会话详情接口 `GET /api/source-messages/{sourceMessageId}/conversation` | 邮件会话详情页 | 已完成第一版 |
|
||||
@@ -30,7 +30,7 @@
|
||||
| 接口 / 能力 | 当前后端状态 | 前端是否可直接接入 | 仍需后端处理 |
|
||||
| --- | --- | --- | --- |
|
||||
| `GET /api/reservation/tasks` | 已完成第一版，已补来源邮件会话字段和所属订单状态筛选 | 可以 | `order_status` 按任务所属订单状态过滤；不传时保持当前全部任务列表行为。 |
|
||||
| `GET /api/reservation/orders/{orderId}` | 已完成第一版，已补旧 `tasks[]` 来源邮件会话字段、V4 总览和 V4 `v4_order_tasks[]` 时间线 | 可以 | 暂无；`include_tasks=false` 时旧 `tasks[]`、V4 `v4_order_tasks[]` 和 `related_source_messages[]` 都返回空数组，`order_overview` 为空快照，`next_v4_action.action_type=NONE`。 |
|
||||
| `GET /api/reservation/orders/{orderId}` | 已完成第一版，已补旧 `tasks[]` 来源邮件会话字段、V4 总览和 V4 `v4_order_tasks[]` 时间线，前端订单详情总览页已接入 | 可以 | 暂无；`include_tasks=false` 时旧 `tasks[]`、V4 `v4_order_tasks[]` 和 `related_source_messages[]` 都返回空数组，`order_overview` 为空快照，`next_v4_action.action_type=NONE`。 |
|
||||
| `GET /api/reservation/tasks/{taskId}` | 已完成第一版，已补任务顶层来源邮件字段和 `fields[]` 3.0 元数据 | 可以 | 当前 Controller 不接收 `hotel_id`；如后续多酒店隔离需要前端显式传酒店上下文，请后端补可选入参或确认按 taskId 全局唯一即可。 |
|
||||
| `PUT /api/reservation/tasks/{taskId}/draft` | 已完成 | 可以 | 当前 Controller 不接收 `hotel_id`；如写操作需要酒店上下文幂等 / 权限校验，请后端补可选入参或请求体字段。 |
|
||||
| `POST /api/reservation/tasks/{taskId}/confirm` | 已完成 | 可以 | 当前 Controller 不接收 `hotel_id`；如写操作需要酒店上下文幂等 / 权限校验，请后端补可选入参或请求体字段。 |
|
||||
@@ -165,9 +165,9 @@ GET /api/reservation/tasks
|
||||
GET /api/reservation/orders/{orderId}
|
||||
```
|
||||
|
||||
当前状态：后端已按 P0 最小诉求实现第一版，并在 M002 V4 CP15.1 补齐订单详情 V4 总览字段。接口返回订单摘要、V4 当前确认快照、V4 下一步处理入口、关联来源邮件摘要、旧 V2/V3 同订单任务时间线和 V4 订单任务时间线；`include_tasks=false` 时旧 `tasks[]`、V4 `v4_order_tasks[]` 和 `related_source_messages[]` 都返回空数组，`order_overview` 为空快照，`next_v4_action.action_type=NONE`。旧任务时间线已补齐每个任务的来源邮件会话摘要。
|
||||
当前状态：后端已按 P0 最小诉求实现第一版，并在 M002 V4 CP15.1 补齐订单详情 V4 总览字段；前端订单详情总览页已接入这些字段。接口返回订单摘要、V4 当前确认快照、V4 下一步处理入口、关联来源邮件摘要、旧 V2/V3 同订单任务时间线和 V4 订单任务时间线；`include_tasks=false` 时旧 `tasks[]`、V4 `v4_order_tasks[]` 和 `related_source_messages[]` 都返回空数组，`order_overview` 为空快照，`next_v4_action.action_type=NONE`。旧任务时间线已补齐每个任务的来源邮件会话摘要。
|
||||
|
||||
订单详情页后续应定位为“订单总览 + 当前确认快照 + V4 任务时间线 + 下一步入口”，不是 V4 任务卡处理页。同订单任务队列里的每个任务都需要自己的“查看邮件会话”入口，因为不同任务可能来自不同邮件或不同邮件会话。因此 `tasks[]` 中每个任务已补齐来源邮件会话字段。V4 新模型下，同一订单的多卡订单任务通过 `v4_order_tasks[]` 单独返回，前端点击后进入 V4 订单任务详情。
|
||||
订单详情页当前定位为“订单总览 + 当前确认快照 + V4 任务时间线 + 下一步入口”，不是 V4 任务卡处理页。同订单任务队列里的每个任务都需要自己的“查看邮件会话”入口，因为不同任务可能来自不同邮件或不同邮件会话。因此 `tasks[]` 中每个任务已补齐来源邮件会话字段。V4 新模型下，同一订单的多卡订单任务通过 `v4_order_tasks[]` 单独返回，前端点击后进入 V4 订单任务详情。
|
||||
|
||||
建议入参：
|
||||
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
| 日期 | 2026-07-19 |
|
||||
| 状态 | 测试机 V4 前后端联调冒烟清单 |
|
||||
| 适用范围 | 登录、酒店权限、V4 工作台、V4 订单任务详情、目录 lookup、卡片确认、复核解阻、S10/S99 ack、订单详情 V4 时间线 |
|
||||
| 不适用范围 | 真实 OPERA / OHIP、目录同步、旧 V2/V3 全量回归、前端视觉验收 |
|
||||
| 不适用范围 | 真实 OPERA / OHIP、目录同步、旧 V2/V3 全量回归、M011 CP4、前端视觉验收 |
|
||||
|
||||
## 1. 测试前置
|
||||
|
||||
@@ -256,15 +256,19 @@ ORDER BY updated_at DESC, id DESC;
|
||||
|
||||
| 项目 | 结果 | 备注 |
|
||||
| --- | --- | --- |
|
||||
| 登录与酒店权限 | 待测 | |
|
||||
| V4 工作台 | 待测 | |
|
||||
| V4 订单任务详情 | 待测 | |
|
||||
| Account Lookup | 待测 | |
|
||||
| Room Type Lookup | 待测 | |
|
||||
| Rate Code Lookup | 待测 | |
|
||||
| Basic Information 确认 | 待测 | |
|
||||
| 业务卡确认 | 待测 | |
|
||||
| REVIEW_REQUIRED 复核解阻 | 待测 | |
|
||||
| S10/S99 ack | 待测 | |
|
||||
| 订单详情 V4 时间线 | 待测 | |
|
||||
| 目录管理 CP1 | 待测 | |
|
||||
| 登录与酒店权限 | 通过 | 2026-07-20 smoke：`/api/auth/me` 返回 `HOTEL-TEST` 和 V4 权限；未带 Bearer 访问 V4 工作台返回 401；错误 `hotel_id` 访问工作台和订单详情返回 403。 |
|
||||
| V4 工作台 | 通过 | `GET /api/reservation/workbench-items` 返回 5 条，包含 `ORDER_TASK` 和 `SOURCE_NOTIFICATION`；列表未发现邮件正文、附件 URL、AI 原始 payload 字段。 |
|
||||
| V4 订单任务列表 | 通过 | `GET /api/reservation/order-tasks` 返回业务订单任务，不包含来源通知；`card_status=REVIEW_REQUIRED` 查询当前测试数据返回 0 条。 |
|
||||
| V4 订单任务详情 | 通过 | `GET /api/reservation/order-tasks/2079096313548677122` 返回 `source_message_card`、`basic_information_card`、`business_cards[]`、`fields[]` 和 `availability`；Basic 未确认前业务卡 `readonly_reason_code=PRIOR_CARD_NOT_CONFIRMED`。 |
|
||||
| Account Lookup | 通过 | `GET /api/reservation/lookups/accounts` 返回 3 条 ACTIVE Account。 |
|
||||
| Room Type Lookup | 通过 | `GET /api/reservation/lookups/room-types` 返回 8 条 ACTIVE Room Type。 |
|
||||
| Rate Code Lookup | 通过 | `GET /api/reservation/lookups/rate-codes` 返回 5 条 ACTIVE Rate Code，`stale=false`；有固定种子 warning，符合当前第一版目录状态。 |
|
||||
| Basic Information 确认 | 通过 | 使用 `version=0` 确认 Basic Information 成功，卡片进入 `CONFIRMED`，version 递增到 1，业务卡随后变为可确认。 |
|
||||
| 业务卡确认 | 通过 | 使用 `version=0` 确认 Room Information 成功，订单任务进入 `COMPLETED`，工作台显示 `display_status=COMPLETED`，订单列表 `open_work_item_count=0`、`v4_open_order_task_count=0`。 |
|
||||
| REVIEW_REQUIRED 复核解阻 | 未覆盖写操作 | 当前测试机没有 `REVIEW_REQUIRED` 待复核卡；已用历史完成记录 `2078906313578168322` 验证详情和 `V4_CARD_REVIEW_RESOLVE` 审计查询返回脱敏结果。下一轮需要准备一条待复核测试数据后再跑写操作。 |
|
||||
| S10/S99 来源通知详情 | 通过 | 工作台包含 S10 与 S99 来源通知；详情接口返回通知摘要和来源消息卡，不返回订单任务或业务卡。 |
|
||||
| S10/S99 ack | 通过 | 对已 ACK 的 S10 通知重复 ack 返回 200 且保持 `ACKED`，验证幂等；S10/S99 均未创建订单，也未进入订单列表。 |
|
||||
| V4 业务审计 | 通过 | 订单任务确认审计和来源通知 ack 审计接口返回 200；快照未发现 `ai_payload_json`、正文、HTML、附件 URL、token、secret 等敏感字段。 |
|
||||
| 订单详情 V4 总览 / 时间线 | 失败 | 测试机 `GET /api/reservation/orders/2079096313393487874` 返回 200，但响应仍只有 `order`、旧 `tasks[]`、基础 `v4_order_tasks[]` 和 `warnings`；缺少 CP15.1 要求的 `order_overview`、`next_v4_action`、`related_source_messages[]` 和 `v4_order_tasks[].cards[]`。本地最新后端已有测试覆盖，优先排查测试机是否部署了包含 CP15.1 的最新包。 |
|
||||
| M011 AgentBus Booking Excel 预处理观察 | 未覆盖 outbound payload | `GET /api/system/agentbus-probe` 显示测试机 AgentBus 已连接且已捕获 frame；当前普通 HTTP 接口不暴露发给 SuperAgent 的 outbound payload，无法仅通过本次 smoke 确认 `attachment_extractions[]` 是否追加。未推进 M011 CP4，未新增解析批次表或行级持久化。 |
|
||||
| 目录管理 CP1 | 未覆盖 | 本 checkpoint 聚焦 V4 主流程联调；目录管理后台另行 smoke。 |
|
||||
|
||||
Reference in New Issue
Block a user