接入前端真实接口并标记邮件HTML清洗
This commit is contained in:
andy
@@ -177,6 +177,7 @@ th-TH
|
||||
VITE_API_BASE_URL=http://localhost:8080
|
||||
VITE_APP_ENV=local
|
||||
VITE_DEFAULT_LOCALE=zh-CN
|
||||
VITE_RESERVATION_HOTEL_ID=HOTEL-TEST
|
||||
VITE_ENABLE_MOCKS=false
|
||||
```
|
||||
|
||||
@@ -190,6 +191,7 @@ VITE_API_PROXY_TARGET=http://127.0.0.1:8081
|
||||
|
||||
- 公开配置可以放 `VITE_*`。
|
||||
- Secret 一律不进入 `VITE_*`。
|
||||
- `VITE_RESERVATION_HOTEL_ID` 是当前前端 Reservation 页面默认酒店上下文，用于订单列表、任务列表和订单详情查询；它不是 Secret，但需要随本地 / test / prod 环境显式配置，避免页面查到错误酒店数据。
|
||||
- 生产需要运行时配置时，应由部署系统生成公开配置文件，例如 `/app-config.json`。
|
||||
- 需要秘密的外部调用一律经后端代理或适配器。
|
||||
|
||||
@@ -280,3 +282,207 @@ pnpm test -- SomeSpecName.spec.ts
|
||||
- [ ] 是否运行了 `pnpm typecheck` 或说明了无法运行原因？
|
||||
- [ ] 是否运行了 `pnpm test` 或说明了无法运行原因？
|
||||
- [ ] 是否运行了 `pnpm build` 或说明了无法运行原因？
|
||||
|
||||
## 18. Reservation 前端低保真结构图与流程图
|
||||
|
||||
本节只记录当前 Reservation 前端第一版信息架构草图，用于对齐页面结构和业务主线。具体 checkpoint 设计、接口契约和实施计划应放入单独需求或设计文档，不在本规范中展开。
|
||||
|
||||
### 18.1 订单工作台低保真结构图
|
||||
|
||||
```text
|
||||
┌────────────────────────────────────────────────────────────────────────────┐
|
||||
│ Hotel OMS 中文 / EN / ไทย 主题 / 用户 │
|
||||
├───────────────┬────────────────────────────────────────────────────────────┤
|
||||
│ │ 订单工作台 │
|
||||
│ 订单管理 │ │
|
||||
│ 任务队列 │ ┌──────────────────────────────────────────────────────┐ │
|
||||
│ 消息来源 │ │ 筛选区 │ │
|
||||
│ 系统状态 │ │ 日期范围 | 业务号 | 订单状态 | 任务状态 | 任务卡类型 │ │
|
||||
│ │ └──────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ │ ┌──────────────────────────────────────────────────────┐ │
|
||||
│ │ │ 订单 / 任务列表 │ │
|
||||
│ │ │ 业务号 订单状态 当前任务 任务状态 操作 │ │
|
||||
│ │ │ GRP-001 ACTIVE New Booking 待确认 查看 │ │
|
||||
│ │ │ TMP-002 TEMP Fallback 人工复核 查看 │ │
|
||||
│ │ │ CNF-003 ACTIVE Cancel READY 执行 │ │
|
||||
│ │ └──────────────────────────────────────────────────────┘ │
|
||||
└───────────────┴────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
中文说明：
|
||||
|
||||
- 左侧导航只保留已确认的 Reservation 相关入口，不提前暴露未确认部门流程。
|
||||
- 工作台首屏服务于“找到需要处理的订单或任务”，不是普通订单 CRUD 首页。
|
||||
- 列表行应同时表达订单状态、当前任务、任务状态和下一步动作。
|
||||
|
||||
### 18.2 任务列表低保真结构图
|
||||
|
||||
```text
|
||||
┌────────────────────────────────────────────────────────────────────────────┐
|
||||
│ Hotel OMS 中文 / EN / ไทย 主题 / 用户 │
|
||||
├───────────────┬────────────────────────────────────────────────────────────┤
|
||||
│ │ 任务列表 │
|
||||
│ 订单列表 │ │
|
||||
│ 任务列表 │ ┌──────────────────────────────────────────────────────┐ │
|
||||
│ 消息来源 │ │ 筛选区 │ │
|
||||
│ 系统状态 │ │ 日期范围 | 订单号/业务号 | 任务类型 | 任务状态 | 可处理 │ │
|
||||
│ │ │ 来源邮件关键词 | 是否参与队列 │ │
|
||||
│ │ └──────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ │ ┌──────────────────────────────────────────────────────┐ │
|
||||
│ │ │ 任务数据 │ │
|
||||
│ │ │ 任务号 订单号 任务卡 状态 来源邮件 │ │
|
||||
│ │ │ #10001 GRP-001 New Booking 待确认 Booking Req │ │
|
||||
│ │ │ #10002 GRP-001 Update 阻塞中 Booking Upd │ │
|
||||
│ │ │ #10003 TMP-002 Fallback 人工复核 Unknown Msg │ │
|
||||
│ │ │ │ │
|
||||
│ │ │ 队列 | 可处理 | 邮件会话 | 查看任务 | 查看订单 │ │
|
||||
│ │ └──────────────────────────────────────────────────────┘ │
|
||||
└───────────────┴────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
中文说明：
|
||||
|
||||
- 任务列表是独立菜单，服务于“按任务处理”的工作方式，不是订单列表的复制。
|
||||
- 列表数据来自 `GET /api/reservation/tasks`；该接口已存在第一版，前端应直接接真实接口，不展示 fixture 假数据。
|
||||
- 每行任务至少展示 `task_id`、关联订单、任务卡名称、任务类型 / 子类型、任务状态、队列顺序、是否可处理、只读原因和来源邮件摘要。
|
||||
- 每行操作保留“查看任务”“查看订单”“查看邮件会话”三个入口；邮件会话入口按该任务的 `source_message_id` 或 `external_conversation_id` 打开。
|
||||
- 如果来源邮件会话字段暂未接入，邮件会话入口置灰或展示“接口待补”，不使用假会话数据。
|
||||
|
||||
### 18.3 订单详情与任务卡低保真结构图
|
||||
|
||||
```text
|
||||
┌────────────────────────────────────────────────────────────────────────────┐
|
||||
│ 订单详情 GRP-001 / TMP-20260707-0001 ACTIVE / TEMPORARY │
|
||||
│ 主来源消息 #190... 业务号来源 AI_CANDIDATE 最近更新 2026-07-08 │
|
||||
├────────────────────────────────────────────────────────────────────────────┤
|
||||
│ 订单摘要 │
|
||||
│ Group Code / Confirmation No. / 临时单号 / 订单状态 / 主来源消息 / 创建时间 │
|
||||
├───────────────────────────────┬────────────────────────────────────────────┤
|
||||
│ 同订单任务队列 │ 当前任务卡 │
|
||||
│ │ │
|
||||
│ ① New Booking 待确认 邮件会话│ New Booking 卡 │
|
||||
│ ② Update 阻塞中 邮件会话│ ┌ 证据区 ───────────────────────────────┐ │
|
||||
│ ③ Trace Notes 未开始 邮件会话│ │ 生成原因 / 来源消息摘要 / 附件 / 邮件会话│ │
|
||||
│ │ └──────────────────────────────────────┘ │
|
||||
│ │ ┌ 基础信息 ─────────────────────────────┐ │
|
||||
│ │ │ Group Code / Confirmation No. / 类型 │ │
|
||||
│ │ └──────────────────────────────────────┘ │
|
||||
│ │ ┌ 入住与房型 ───────────────────────────┐ │
|
||||
│ │ │ 入住日期 / 离店日期 / 房量 / 房型 / Rate│ │
|
||||
│ │ └──────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ │ [保存草稿] [确认任务] │
|
||||
├───────────────────────────────┴────────────────────────────────────────────┤
|
||||
│ OPERA 模拟操作 │
|
||||
│ ① 预检查 PENDING / SUCCEEDED / FAILED ② 写入 PENDING / SUCCEEDED / FAILED │
|
||||
│ │
|
||||
│ 审计时间线：AI 创建 → 保存草稿 → 人工确认 → OPERA 预检查 → OPERA 写入 │
|
||||
└────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
中文说明：
|
||||
|
||||
- 订单详情页必须沿用“订单归档容器 + 同订单任务队列 + 当前任务卡 + OPERA 模拟操作 + 审计时间线”的既有结构，不另起一套订单详情布局。
|
||||
- 后续任务如果被前置任务阻塞，应在任务队列和任务卡操作区同时体现只读状态。
|
||||
- 任务卡字段必须按后端字段矩阵分组渲染，不直接把 AI 原始 JSON 展示成自由表单。
|
||||
- 邮件入口按任务粒度展示：每个任务可能来自不同 `source_message_id`，也可能落在不同 `external_conversation_id`。点击“邮件会话”只打开该任务来源消息所在的完整邮件会话，不代表订单下所有来源消息的合集。
|
||||
- 当前任务卡证据区展示来源消息摘要、附件摘要和“查看邮件会话”入口；完整邮件正文、HTML 和附件详情进入单独邮件会话详情页查看，避免订单详情页被长邮件撑开。
|
||||
- OPERA 模拟和审计是任务确认后的执行轨迹，不应和 AI 原始建议混在同一区域。
|
||||
|
||||
### 18.4 任务详情低保真结构图
|
||||
|
||||
```text
|
||||
┌────────────────────────────────────────────────────────────────────────────┐
|
||||
│ 任务详情 #10002 Update Booking / RATE_CHANGE PENDING_CONFIRM │
|
||||
│ 关联订单 GRP-001 [查看订单] 来源邮件 Booking Update [查看邮件会话] │
|
||||
├────────────────────────────────────────────────────────────────────────────┤
|
||||
│ 处理状态 │
|
||||
│ 可处理 / 阻塞原因 / 队列顺序 / 前置任务状态 / 只读说明 │
|
||||
├────────────────────────────────────────────────────────────────────────────┤
|
||||
│ 证据区 │
|
||||
│ 生成原因 / 来源消息摘要 / 附件摘要 / 完整邮件会话入口 │
|
||||
├────────────────────────────────────────────────────────────────────────────┤
|
||||
│ 任务卡字段 │
|
||||
│ 基础信息：Group Code / Confirmation No. / 业务动作 │
|
||||
│ 变更内容：before_after / rate_code / fix_charge_items │
|
||||
│ 人工复核：visible_reason / required fields / validation │
|
||||
├────────────────────────────────────────────────────────────────────────────┤
|
||||
│ 操作区 │
|
||||
│ [保存草稿] [确认任务] │
|
||||
├────────────────────────────────────────────────────────────────────────────┤
|
||||
│ OPERA 模拟操作 │
|
||||
│ 预检查 / 写入 / 重试状态 / 最近错误 │
|
||||
├────────────────────────────────────────────────────────────────────────────┤
|
||||
│ 审计流水 │
|
||||
│ AI 创建 → 草稿保存 → 人工确认 → OPERA 预检查 → OPERA 写入 │
|
||||
└────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
中文说明：
|
||||
|
||||
- 任务详情页聚焦单个任务卡的查看、编辑、确认和执行轨迹，不承载同订单全局队列；同订单全局队列仍回到订单详情页查看。
|
||||
- 任务详情读取来自 `GET /api/reservation/tasks/{taskId}`，草稿保存、确认任务、OPERA 模拟和审计流水使用后端已存在的任务工作流接口。
|
||||
- 证据区只展示来源消息摘要和附件摘要；完整邮件正文、HTML、历史邮件和回复进入邮件会话详情页。
|
||||
- 字段区按后端 `fields[]` 的 `display_area` 和字段规则分组渲染，不把 AI 原始 JSON 直接展示为自由表单。
|
||||
- 如果任务不可处理，操作区应保持只读，并展示 `availability` 或 `readonly_reason_code` 给出的原因。
|
||||
|
||||
### 18.5 邮件会话详情低保真结构图
|
||||
|
||||
```text
|
||||
┌────────────────────────────────────────────────────────────────────────────┐
|
||||
│ 邮件会话详情 Re: Booking Update 返回订单 / 返回任务 │
|
||||
│ Conversation thread-20260708-001 共 6 封 最近收到 2026-07-08 11:28 │
|
||||
├────────────────────────────────────────────────────────────────────────────┤
|
||||
│ 会话摘要 │
|
||||
│ 酒店 / 渠道 EMAIL / 发件人汇总 / 主题 / 关联订单 GRP-001 / 关联任务 3 个 │
|
||||
├────────────────────────────────────────────────────────────────────────────┤
|
||||
│ 邮件时间线 │
|
||||
│ │
|
||||
│ ┌ 2026-07-06 09:10 guest@example.com Booking Request ────────────────┐ │
|
||||
│ │ 邮件全文正文或已清洗 HTML │ │
|
||||
│ │ 附件：rooming-list.xlsx / voucher.pdf │ │
|
||||
│ │ 关联：New Booking #10001 │ │
|
||||
│ └──────────────────────────────────────────────────────────────────────┘ │
|
||||
│ ┌ 2026-07-07 14:22 hotel@example.com Re: Booking Request ────────────┐ │
|
||||
│ │ 邮件全文正文或已清洗 HTML │ │
|
||||
│ │ 附件：无 │ │
|
||||
│ │ 关联：无 │ │
|
||||
│ └──────────────────────────────────────────────────────────────────────┘ │
|
||||
│ ┌ 2026-07-08 11:28 guest@example.com Re: Booking Update ─────────────┐ │
|
||||
│ │ 邮件全文正文或已清洗 HTML │ │
|
||||
│ │ 附件：change-request.pdf │ │
|
||||
│ │ 关联：Update Booking #10002 │ │
|
||||
│ └──────────────────────────────────────────────────────────────────────┘ │
|
||||
└────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
中文说明：
|
||||
|
||||
- 邮件会话详情页展示同一个 `external_conversation_id` 下的全部邮件，包括历史邮件、当前邮件和后续回复。
|
||||
- 页面入口可以来自订单详情任务队列、当前任务卡证据区或任务详情页，但落地页统一为“邮件会话详情”，不是单封邮件详情。
|
||||
- 每封邮件应展示完整正文或清洗后的 HTML、附件列表、内联图片信息、发送 / 接收时间、发件人摘要、主题和关联订单 / 任务。
|
||||
- 前端不在本页展示假数据；后端接口未接入时显示“接口待接入 / 暂无邮件会话数据”。
|
||||
- 邮件全文属于用户在邮箱中本来可见的信息，前端页面不做业务层面的截断隐藏；但仍必须通过本项目后端接口读取，不在前端保存外部系统 Secret 或访问 key。
|
||||
|
||||
### 18.6 Reservation 任务主流程图
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
A["SourceMessage Inbox<br/>来源消息"] --> B["AI 过渡层<br/>保存 AI 原始 JSON"]
|
||||
B --> C["订单<br/>业务号或临时单号"]
|
||||
B --> D["任务队列<br/>按 execution_order 排序"]
|
||||
D --> E["任务卡详情<br/>字段矩阵驱动渲染"]
|
||||
E --> F["保存草稿<br/>draft_payload"]
|
||||
E --> G["最终确认<br/>confirmed_payload"]
|
||||
G --> H["OPERA 模拟操作<br/>预检查 / 写入"]
|
||||
H --> I["审计时间线<br/>确认、执行、重试记录"]
|
||||
```
|
||||
|
||||
中文说明：
|
||||
|
||||
- `SourceMessage Inbox` 是来源事实层，不表达订单、任务或业务结论。
|
||||
- AI 输出只作为原始建议和证据保存，不能直接改变最终业务状态。
|
||||
- 用户确认后的 `confirmed_payload` 才能作为 OPERA 模拟操作输入。
|
||||
- 审计时间线用于串联人工确认、OPERA 执行和重试记录，便于后续追溯。
|
||||
|
||||
Reference in New Issue
Block a user