前端调整V4预订事项用户化展示
This commit is contained in:
andy
@@ -271,6 +271,66 @@ V4 当前不做 OPERA / PMS 执行，但仍需要保留同订单处理顺序，
|
||||
- Rooming List 卡第一版没有可编辑业务字段；页面展示为轻量事项确认卡，用户点击“确认卡片”仅表示已人工处理当前 Rooming List 事项，不代表名单已解析、Excel 已生成或 PMS 已导入。
|
||||
- Room Information 卡下一阶段采用业务展示模型，不再只依赖通用 `fields[]` 扁平渲染；具体规则见“Room Information 卡展示模型”。
|
||||
|
||||
### 9.1.1 V4 任务详情页用户化展示边界
|
||||
|
||||
2026-07-21 已确认：`/reservation/order-tasks/{orderTaskId}` 默认面向普通酒店员工，不面向开发 / 测试。该页面的产品定位是“订单事项办理页”，不是“V4 任务卡模型调试页”。底层仍保持 Order Task / Task Card / SourceMessage 领域模型不变，但前端默认展示必须把模型语言翻译成业务语言。
|
||||
|
||||
展示口径：
|
||||
|
||||
- 页面主标题不直接使用“V4”“后端任务卡模型”“Task Card 模型”等技术描述，建议使用“处理预订事项”“订单事项处理”等业务文案。
|
||||
- `Reservation Task Card` 在普通页面上显示为“事项”“待确认事项”或具体业务名称，不直接称为“卡片模型”。
|
||||
- `SOURCE_MESSAGE_DISPLAY` 面向用户显示为“来源邮件”，固定在业务事项之后，默认折叠正文；正文仍只通过 SourceMessage conversation 权限链路读取。
|
||||
- Basic Information 显示为“预订基础信息”，Room Information 显示为“房型与日期”或“房型信息”，Payment 显示为“付款凭证”，Trace 显示为“跟进事项”，Rooming List 显示为“房表事项”。
|
||||
- 技术 ID、`order_task_id`、`card_id`、`source_event_index`、`order_ref`、`version`、`route_code`、JSON Pointer、`write_target`、payload 字段名、adapter 诊断和内部状态码默认不得出现在主摘要或业务事项区域；确需排查时只能放在折叠区或受控调试模式。
|
||||
- 普通用户可见状态应使用业务文案映射，例如 `PENDING_CONFIRM` 显示为“待确认”，`REVIEW_REQUIRED` 显示为“需要复核”，`CONFIRMED` 显示为“已确认”，`RESOLVED` 显示为“复核已完成”，`OPEN` / `COMPLETED` 显示为“待处理” / “已完成”。
|
||||
- 顶部摘要优先回答“这封邮件识别出了什么事项、当前还有什么要处理、下一步该点哪里”，而不是优先展示卡片数量和数据库 ID；已完成事项可以折叠为摘要，待处理或需复核事项应突出。
|
||||
- 每张可处理事项卡的主动作按钮放在该事项卡右侧，和该卡状态同区域展示；`PENDING_CONFIRM` 和 `REVIEW_REQUIRED` 的用户可见主按钮均为“确认卡片”，但前端内部仍按卡片状态分别调用普通确认或复核解阻接口。已确认事项不显示主动作按钮，只显示“已确认”或“复核已完成”等状态。移动端可降级为卡片底部右对齐，但仍属于当前事项卡，不做页面底部统一确认按钮。
|
||||
|
||||
安全边界：
|
||||
|
||||
- 技术折叠区或调试模式也不得展示邮件正文、HTML、附件 URL、AI 原始 payload、raw evidence、PMS 原始响应、Secret、Token 或跨酒店数据。
|
||||
- 如果后端接口为了路由、并发和提交必须返回 ID、`version`、`fields[]`、`write_target` 等稳定技术字段，前端可以用于内部逻辑，但默认用户页面不得把这些字段原样作为主文案。
|
||||
- 本节只约束展示和信息层级，不改变 V4 入站、确认、复核、审计、权限、酒店隔离或 SourceMessage 读取链路。
|
||||
|
||||
### 9.1.2 V4 工作台 / 任务列表用户化展示边界
|
||||
|
||||
`/reservation/tasks` 默认面向普通酒店员工，产品定位是“待处理预订事项列表”或“预订事项工作台”，不是 V4 模型列表。该页面可以继续使用 `GET /api/reservation/workbench-items` 和 `GET /api/reservation/order-tasks` 的稳定 code 做查询、路由和筛选，但普通用户可见文案不得直接暴露内部 item type、card status 或 route 语汇。
|
||||
|
||||
默认展示口径：
|
||||
|
||||
- 列表标题建议使用“待处理预订事项”“预订事项”或“工作台”，不直接使用“V4 工作台”“Order Task 列表”“任务卡列表”等技术描述。
|
||||
- 默认视图优先展示需要用户处理的事项，例如待确认、需要复核、待确认已读的来源通知；已完成事项保留筛选入口，但不应淹没默认工作队列。
|
||||
- `ORDER_TASK` 面向用户显示为“预订事项”，`SOURCE_NOTIFICATION` 面向用户显示为“来源通知”或“需查看邮件”，不直接展示内部 `item_type` code。
|
||||
- 任务类型面向用户显示为业务名称，例如新预订、修改预订、取消预订、付款凭证、跟进事项、房表事项；不要默认展示 `NEW_BOOKING`、`TRACE_RESERVATION_NOTES`、`ROOMING_LIST`、`PAYMENT` 等技术 code。
|
||||
- 筛选项第一版面向普通用户建议为“全部”“待我处理 / 待处理”“需要复核”“已完成”“来源通知”。技术筛选如 `item_type`、`order_task_status`、`card_status`、`route_code`、`system_process_category` 可放入高级筛选或受控调试模式，不作为默认筛选文案。
|
||||
- 列表行主动作保持业务化，例如“继续处理”“查看详情”“确认已读”；不把 V4 入口、旧任务 fallback 或 SourceMessage 模型差异暴露给普通用户。
|
||||
- 空态文案使用业务语言，例如“暂无需要处理的预订事项”，不要显示“暂无 ORDER_TASK”或“暂无 V4 card_status 匹配结果”。
|
||||
|
||||
安全边界：
|
||||
|
||||
- 列表默认不展示邮件正文、附件 URL、AI 原始 payload、adapter 诊断、raw evidence、JSON Pointer、数据库 ID 或 route 诊断；必要的技术信息只能用于内部逻辑、高级筛选或受控调试模式。
|
||||
- 高级筛选或调试模式不得突破酒店隔离、权限、SourceMessage 原文读取权限和敏感数据脱敏规则。
|
||||
|
||||
### 9.1.3 V4 订单详情页用户化展示边界
|
||||
|
||||
`/reservation/orders/{orderId}` 默认面向普通酒店员工，产品定位是“订单总览页”，不是 V4 时间线或任务卡调试页。该页面只展示订单当前确认快照、下一步处理入口、关联来源邮件和处理记录摘要，不在订单详情页直接确认、复核或编辑任务卡；具体办理动作仍进入 `/reservation/order-tasks/{orderTaskId}`。
|
||||
|
||||
展示口径：
|
||||
|
||||
- 页面标题优先显示订单业务名、Group Code、Confirmation Number 或用户可理解的订单名称，不把数据库 `order_id`、V4 字段名或内部 ID 作为第一视觉层级。
|
||||
- `order_overview` 面向用户显示为“当前确认快照”或“订单信息总览”，不显示为 `order_overview` 或 V4 payload。
|
||||
- `next_v4_action` 面向用户显示为“下一步处理”，例如“下一步：确认房型与日期”“下一步：复核付款凭证”；不直接展示 `action_type`、`action_status`、`card_id` 等内部 code。
|
||||
- `related_source_messages[]` 面向用户显示为“关联来源邮件”，不直接展示 SourceMessage 模型名或内部 SourceMessage ID；需要正文时仍通过 SourceMessage conversation 权限链路读取。
|
||||
- `v4_order_tasks[]` 面向用户显示为“处理记录”或“来源邮件处理记录”，不显示为“V4 时间线”。`cards[]` 面向用户显示为事项状态摘要，不显示为“卡片安全摘要”。
|
||||
- 订单详情页可以显示业务状态摘要，例如预订基础信息、房型与日期、付款凭证、跟进事项、房表事项的状态；但不在该页展示可编辑表单、确认按钮或复核提交入口。
|
||||
- 技术 ID、`order_task_id`、`card_id`、`source_message_id`、`version`、`route_code`、payload 字段名和内部状态码默认不得出现在订单详情主信息层级；确需排查时只能放入折叠区或受控调试模式。
|
||||
|
||||
安全边界：
|
||||
|
||||
- 订单详情 `order_overview` 只展示已确认 V4 卡片派生的订单事实，不把未确认 AI 建议或 display payload 当成订单事实。
|
||||
- 订单详情不得直接返回或展示邮件正文、HTML、附件 URL、AI 原始 payload、raw evidence、PMS 原始响应、Secret、Token 或跨酒店数据。
|
||||
- 本节只约束展示和信息层级，不改变订单详情接口作为订单总览页的定位，也不改变任务卡确认、复核、审计或 SourceMessage 读取链路。
|
||||
|
||||
### 9.2 同一本地订单下多个订单任务
|
||||
|
||||
如果多个 SourceMessage 或多个回调包绑定到同一本地订单：
|
||||
|
||||
Reference in New Issue
Block a user