前端调整V4预订事项用户化展示

This commit is contained in:
andy
2026-07-21 20:54:24 +07:00
parent 350bb3310b
commit c521eb6dc0
20 changed files with 703 additions and 657 deletions

View File

@@ -154,6 +154,7 @@ th-TH
- 避免引入大型 Admin Template。
- 页面应优先表达业务主线,而不是堆叠技术字段。
- Debug 页面可以显示技术 ID但业务页面应优先展示可理解的业务状态和来源摘要。
- V4 工作台 / 任务列表、订单详情页和任务详情页默认面向普通酒店员工,应呈现为“待处理预订事项列表”“订单总览页”和“订单事项办理页”;`V4``ORDER_TASK``SOURCE_NOTIFICATION`、Task Card 模型、JSON Pointer、payload、version、route、数据库 ID 等技术信息不得出现在默认主信息层级,只能放在高级筛选、折叠区或受控调试模式。
- 预检、人工复核、任务确认要清楚区分:
- 外部 Provider 建议
- 人工确认值
@@ -345,13 +346,16 @@ pnpm test -- SomeSpecName.spec.ts
中文说明:
- 任务列表是独立菜单,服务于“按任务处理”的工作方式,不是订单列表的复制。
- 列表数据来自 `GET /api/reservation/tasks`;该接口已存在第一版,前端应直接接真实接口,不展示 fixture 假数据
- 本低保真结构图主要记录 V2/V3 旧任务列表结构V4 默认工作台 `/reservation/tasks` 应按 `M002-v4-order-task-card-domain-model-cp2.md` 的用户化契约使用 `GET /api/reservation/workbench-items` `GET /api/reservation/order-tasks`,展示“待处理预订事项 / 预订事项”,不直出 `ORDER_TASK``SOURCE_NOTIFICATION``card_status` 等技术筛选文案
- V2/V3 历史列表数据来自 `GET /api/reservation/tasks`;该接口已存在第一版,前端应直接接真实接口,不展示 fixture 假数据。
- 每行任务至少展示 `task_id`、关联订单、任务卡名称、任务类型 / 子类型、任务状态、队列顺序、是否可处理、只读原因和来源邮件摘要。
- 每行操作保留“查看任务”“查看订单”“查看邮件会话”三个入口;邮件会话入口按该任务的 `source_message_id``external_conversation_id` 打开。
- 如果来源邮件会话字段暂未接入,邮件会话入口置灰或展示“接口待补”,不使用假会话数据。
### 18.3 订单详情与任务卡低保真结构图
本节低保真结构图保留 V2/V3 旧任务流的页面骨架。V4 订单详情页默认是普通酒店员工使用的“订单总览页”,只展示订单当前确认快照、下一步处理、关联来源邮件和处理记录摘要;不在订单详情页直接渲染当前任务卡、保存草稿、确认任务或 OPERA 模拟操作。V4 订单详情、任务详情和工作台的当前展示契约以 `M002-v4-order-task-card-domain-model-cp2.md` 和前后端协作文档为准。
```text
┌────────────────────────────────────────────────────────────────────────────┐
│ 订单详情 GRP-001 / TMP-20260707-0001 ACTIVE / TEMPORARY │
@@ -384,7 +388,7 @@ pnpm test -- SomeSpecName.spec.ts
中文说明:
- 订单详情页必须沿用“订单归档容器 + 同订单任务队列 + 当前任务卡 + OPERA 模拟操作 + 审计时间线”的既有结构,不另起一套订单详情布局
- V2/V3 旧订单详情页沿用“订单归档容器 + 同订单任务队列 + 当前任务卡 + OPERA 模拟操作 + 审计时间线”的既有结构V4 订单详情页不沿用该“当前任务卡 + OPERA 模拟操作”主布局,而是作为订单总览页,通过下一步入口跳转到 V4 任务详情页办理
- 后续任务如果被前置任务阻塞,应在任务队列和任务卡操作区同时体现只读状态。
- 任务卡字段必须按后端字段矩阵分组渲染,不直接把 AI 原始 JSON 展示成自由表单。
- 邮件入口按任务粒度展示:每个任务可能来自不同 `source_message_id`,也可能落在不同 `external_conversation_id`。点击“邮件会话”只打开该任务来源消息所在的完整邮件会话,不代表订单下所有来源消息的合集。