Files
th-hotel-simple/docs/import/20260718/0718给黄哥/04-前端视觉参考/00-视觉参考说明.md

47 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 前端视觉参考说明
本文件夹保存 2026-07-18 当前前端页面截图,用于帮助开发理解页面布局、卡片层级、字段组织和视觉样式。
## 使用原则
- 截图只作为视觉参考,不是业务规则权威来源;
- 若截图中的字段、状态、按钮或旧文案与 `01-预订任务信息系统业务需求说明书` 冲突,以主说明书为准;
- 截图可能包含演示 fixture不代表真实 Agent 输出、真实订单或 PMS 执行结果;
- 根级 Invoice 和根级 Rooming List 不属于本次预订任务业务说明范围,不纳入本文件夹。
## 截图与用途
| 文件 | 主要参考内容 |
|---|---|
| `01-任务列表-当前视觉.png` | 整体导航、任务概览、列表层级、状态标签与行操作 |
| `02-NewBooking-任务详情-当前视觉.png` | Group New Booking 的详情页结构、Basic Information、房间信息和邮件展示 |
| `03-Update与Trace-任务详情-当前视觉.png` | Update 的 Before → After 强调方式、普通 Trace 的卡片层级 |
| `04-Payment-任务详情-当前视觉.png` | Payment 凭证图片预览、人工复核提示与邮件证据布局 |
| `05-纯通知-任务详情-当前视觉.png` | 只显示邮件展示卡的纯通知页面 |
| `06-CancelBooking-任务详情-当前视觉.png` | 整单取消提示及当前订单只读展示方式 |
| `07-加床Trace-任务详情-当前视觉.png` | 加床 Trace 与普通 Trace 同卡共存,以及 RoomType、数量、Adult、Department 的组合展示 |
## 已知差异,开发必须按主文档修正
当前前端是在业务规则最终收口前制作的原型,因此截图中仍有历史内容:
- 所有可执行任务卡的最终按钮文案统一为“确认”,不使用“执行任务”“已查看”或“确认修改”;
- 不提供“保存草稿”;离开页面后未确认修改无需保留;
- 人工复核补正后直接点击同一个“确认”,不存在先确认修改、再执行的两步流程;
- 每张任务卡独立确认和锁定,不能用一个页面底部动作代替所有卡片的独立操作;
- 确认后永久锁定,不支持旧卡再次编辑、再次执行或重试;
- Voucher 已并入 Payment不存在独立 Voucher 卡;
- Payment 当前只需展示对应来源凭证,不需要截图原型中遗留的其他付款专属字段;
- 纯通知卡的按钮也统一为“确认”,并且没有人工终止;
- 根级 Rooming List 页面与本轮任务详情内嵌 Rooming List 无关,不能作为后者的实现依据。
## Rooming List 视觉缺口
当前任务详情原型尚未完整实现最新的内嵌 Rooming List 标准表格,因此本文件夹不放一张容易误导开发的旧版 Rooming List 截图,也不使用根级 `/rooming-list` 页面替代。
当前版本应直接按主说明书和字段矩阵实现Rooming List 卡展示 12 个必填业务字段的标准表格示意;原始附件只在邮件展示卡查看;当前不要求真实转换、复杂编辑或 Excel 流程。
## 状态页面说明
本次没有为“已完成、已终止、异常阻断”逐一制造截图。它们的业务规则与操作权限应直接按主说明书和验收清单实现,不能从现有 fixture 的历史状态倒推。