333 lines
19 KiB
Markdown
333 lines
19 KiB
Markdown
# 预订任务信息系统业务字段与卡片规则矩阵
|
||
|
||
> 版本日期：2026-07-18
|
||
> 用途：帮助产品、设计、开发和测试快速核对每张任务卡需要什么业务数据、如何展示、哪些内容可编辑，以及确认后的业务结果。
|
||
> 本文不规定数据库表、接口结构或代码实现。若与其他材料冲突，以 `01-预订任务信息系统业务需求说明书.md` 为准。
|
||
|
||
## 一、任务与卡片总览
|
||
|
||
### 1. 普通预订任务
|
||
|
||
固定展示顺序：
|
||
|
||
`Basic Information → 房间信息 → Trace → Rooming List → Payment → 邮件展示`
|
||
|
||
| 卡片 | 出现条件 | 是否独立确认 | 普通状态 | 确认后 | 是否可触发终止 |
|
||
|---|---|---|---|---|---|
|
||
| Basic Information | 普通预订任务固定出现 | 是 | 待确认 / 待确认 + 需人工复核 / 已完成 / 已终止 | 保存最终选择并锁定 | 是，未完成时可触发整笔订单任务终止 |
|
||
| 房间信息 | 普通预订任务固定出现 | 是 | 同上 | 按 New / Update / Cancel 规则完成并锁定 | 是 |
|
||
| Trace | Agent 给出 Trace 业务时出现 | 是 | 同上 | 保存全部 Trace 最终参数并锁定 | 是 |
|
||
| Rooming List | Agent 给出 Group Rooming List 业务时出现 | 是 | 同上 | 当前完成展示确认并锁定 | 是 |
|
||
| Payment | Agent 给出 Payment 业务时出现 | 是 | 同上 | 完成凭证确认及当前本地处理并锁定 | 是 |
|
||
| 邮件展示 | 普通预订任务固定出现 | 否，只作来源证据 | 不参与订单任务进度 | 无单独确认动作 | 否 |
|
||
|
||
### 2. 纯通知任务
|
||
|
||
| 项目 | 规则 |
|
||
|---|---|
|
||
| 页面内容 | 只显示邮件展示卡，不显示任何预订业务卡 |
|
||
| 完成方式 | 用户点击邮件展示卡中的“确认”后完成；仅打开页面不自动完成 |
|
||
| 人工复核 | 不存在 |
|
||
| 人工终止 | 不存在 |
|
||
| 订单修改 | 不查询或修改预订订单 |
|
||
| PMS | 不调用 PMS |
|
||
|
||
### 3. 通用确认规则
|
||
|
||
| 规则项 | 业务规则 |
|
||
|---|---|
|
||
| 确认单位 | 每张任务卡独立确认；不存在订单任务级全局确认 |
|
||
| 卡片互不阻塞 | 单张卡的问题不阻塞同订单任务中的其他合法卡片 |
|
||
| 草稿 | 不自动保存，不提供保存草稿；离开页面后未确认修改无需保留 |
|
||
| 长期记录 | 保留 Agent 原始值和用户最终确认值，不保留每次中间编辑历史 |
|
||
| 确认次数 | 每张卡只能确认一次 |
|
||
| 确认后 | 永久锁定，不能再次编辑、确认或重新执行 |
|
||
| 错误纠正 | 不重开旧任务；后续变更必须由新的程序输入经 Agent 生成新任务 |
|
||
|
||
## 二、Basic Information 卡
|
||
|
||
字段顺序固定为：`Account → Market → Source`。
|
||
|
||
| 字段 | 业务含义与来源 | 是否必需 | 展示与编辑 | 缺失或无效时 | 当前无 PMS API 的确认结果 |
|
||
|---|---|---|---|---|---|
|
||
| Account | 由邮件发件人等业务信息确定，并匹配信息系统已有 Account 目录 | 是 | 受控选择；用户可从已有值改选；不可自由输入；没有 Manual | 卡片显示需人工复核，用户从已有目录补选 | 保存最终选择 |
|
||
| Market | 与 Account 存在系统预设关系，由系统自动带出 | 是 | 受控选择；用户可从已有值改选；不可自由输入 | 同上 | 保存最终选择 |
|
||
| Source | 与 Account 存在系统预设关系，由系统自动带出 | 是 | 受控选择；用户可从已有值改选；不可自由输入 | 同上 | 保存最终选择 |
|
||
|
||
补充规则：如果目录本身缺少可选值，应进入主数据维护，不允许在任务卡临时造出系统不存在的值。
|
||
|
||
## 三、房间信息卡——公共字段
|
||
|
||
### 1. 订单对象与订单级字段
|
||
|
||
| 字段 | 适用范围 | 业务来源或派生规则 | 是否必需 | 确认前权限 | 校验与特殊规则 |
|
||
|---|---|---|---|---|---|
|
||
| 预订类型标签 | Group / Fit | 业务事件确定 | 是 | 不可改 | Group 与 Fit 使用不同定位和对象名称 |
|
||
| Block Name | Group | 等于邮件中的 Group Code，是团号，不是住客姓名 | 是 | 创建前可纠错；确认后锁定 | 已有 Group 订单后续仍以 Group Code / Block Name 定位，不优先用 Block ID |
|
||
| Name | Fit | 优先真实住客姓名；暂无真实姓名时可临时使用 Booking Code | 是 | 创建前可纠错；确认后锁定 | 后续真实姓名通过 Update 修改；已有订单后续定位使用 Confirmation Number，不使用 Name |
|
||
| 入住日期 | Group / Fit | 目标预订信息 | 是 | 可改 | 缺失时需人工复核 |
|
||
| 离店日期 | Group / Fit | 目标预订信息 | 是 | 可改 | 缺失时需人工复核；必须晚于入住日期 |
|
||
| Nights | Group / Fit | 系统按入住、离店日期自动计算 | 是，系统派生 | 只读 | 不要求 Agent 提供，不能由用户覆盖 |
|
||
| Rate Code | Group / Fit | 从业务邮件取得并匹配系统已有 Rate Code | 是 | New 创建前可从已有值改选；Update 不允许修改 | 订单级字段，只显示一次；无默认值；不能自由输入 |
|
||
| Breakfast | Group / Fit | Group 固定包含；Fit 由 Rate Code 规则派生 | 是，系统派生 | 只读 | 需要变更时应修改合法 Rate Code，而不是直接改 Breakfast |
|
||
| Group Booking Status | 仅 Group | 普通 New 为 TEN；Proposal 为 INQ；Rooming List 或 Payment 确认后为 DEF | 是，系统有初始规则 | 确认前可在 TEN / DEF / INQ 中受控改选 | 不要求 Agent 输出；Fit 不显示 |
|
||
| Block ID | 仅 Group，PMS New 成功后 | PMS 返回 | 当前无 API 时不存在 | 只读 | 在房间信息卡和执行结果/订单信息区域显示；当前不得模拟 |
|
||
| Confirmation Number | 仅 Fit，PMS New 成功后 | PMS 返回 | 当前无 API 时不存在 | 只读 | 在房间信息卡和执行结果/订单信息区域显示；已有 Fit 后续业务靠它定位 |
|
||
|
||
### 2. 房型行
|
||
|
||
每行固定为：`RoomType → 房量 → Adult（每间）`。
|
||
|
||
| 字段 | 业务来源或派生规则 | 是否必需 | 确认前权限 | 校验与特殊规则 |
|
||
|---|---|---|---|---|
|
||
| RoomType | 目标预订中的房型，匹配系统已有房型目录 | 是 | 只能从已有房型中改选 | 缺失或无法匹配时需人工复核 |
|
||
| 房量 | 目标预订中该房型的间数 | 是 | 可修改正整数 | 缺失、为 0 或无法确定时需人工复核 |
|
||
| Adult（每间） | 系统按 RoomType 的固定入住人数映射产生 | 是，系统派生 | 普通房间信息卡中只读 | 表示每间成人数，不是该行总人数；不存在无映射房型 |
|
||
|
||
房型行补充规则：
|
||
|
||
- 允许多个房型行；
|
||
- Rate Code 不属于房型行，不按 Rate Code 拆行；
|
||
- 同一 RoomType 只有 Adult 不同时才允许拆成多行，例如 `TWN × 4｜Adult 2` 与 `TWN × 1｜Adult 3`。
|
||
|
||
## 四、房间信息卡——New / Update / Cancel
|
||
|
||
| 类型 | 订单定位 | 页面主要内容 | 确认前权限 | 当前无 PMS API 的确认结果 |
|
||
|---|---|---|---|---|
|
||
| New Booking | Group 用 Group Code 建单；Fit 用真实姓名，暂无姓名时用 Booking Code 临时作为 Name | 展示完整目标预订 | 按公共字段权限纠错 | 保存完整目标参数；卡片完成并锁定；显示“信息系统已确认，未调用 PMS”；不显示创建成功，不生成 PMS 编号 |
|
||
| Update Booking | Group 用 Group Code / Block Name；Fit 用 Confirmation Number | 展示修改后的完整订单，并突出变化字段的“原参数 → 修改后参数” | 修改后参数按字段权限纠错；Rate Code 不可修改 | 保存最终修改并更新信息系统本地订单最新数据；完成并锁定；不伪造 PMS 回执 |
|
||
| Cancel Booking | Group 用 Group Code / Block Name；Fit 用 Confirmation Number | 只读展示完整当前订单，并表达“将取消整笔订单” | 当前订单参数不可改；只能确认或终止任务 | 保留订单历史并把本地订单标记为已取消；完成并锁定；不删除订单、不清除 PMS 标识、不伪造 PMS 已取消 |
|
||
|
||
### Update 变化展示
|
||
|
||
| 变化类型 | 页面突出方式 |
|
||
|---|---|
|
||
| 日期变化 | 显示原入住/离店日期 → 修改后日期，并显示系统重算后的 Nights |
|
||
| Name 变化 | 显示原 Name → 修改后 Name |
|
||
| 房型或房量变化 | 分别显示修改前完整房型清单和修改后完整房型清单 |
|
||
| Rate Code | 不属于 Update 可修改内容，不展示为可变字段 |
|
||
|
||
系统无需追踪“某一原房型行变成哪一新行”；只需准确展示完整 Before 清单和完整 After 清单。
|
||
|
||
## 五、已有订单的定位门槛
|
||
|
||
适用于 Update、Cancel、Trace、Rooming List 和 Payment。
|
||
|
||
| 场景 | 页面行为 | 可编辑范围 | 确认按钮 |
|
||
|---|---|---|---|
|
||
| 唯一匹配 1 笔订单 | 回显卡片所需订单数据 | 按卡片字段权限 | 满足卡片校验后可用 |
|
||
| 匹配 0 笔 | 完整卡片仍显示，但未取得订单数据的部分禁用 | 只允许修改 Group Code / Confirmation Number | 禁用 |
|
||
| 匹配多笔 | 同上，系统不能自行选择 | 只允许修改定位字段 | 禁用 |
|
||
| 定位后唯一匹配 | 重新回显订单和卡片参数 | 恢复正常字段权限 | 满足校验后可用 |
|
||
|
||
统一提示：`未唯一匹配到订单，请核对 Group Code / Confirmation Number`。
|
||
|
||
当前无 PMS API 时查信息系统本地订单；未来有 PMS API 时改为查询 PMS。系统查单失败不会擅自给卡片添加“需人工复核”标记。
|
||
|
||
## 六、Trace 卡
|
||
|
||
### 1. 卡片级规则
|
||
|
||
| 项目 | 规则 |
|
||
|---|---|
|
||
| 出现范围 | New Booking、Update Booking 可出现；Cancel Booking 不出现 |
|
||
| 数量 | 同一订单只显示一张 Trace 卡，卡内可有多条事项 |
|
||
| 关联范围 | 关联整笔订单 |
|
||
| 与 Rooming List 的关系 | 没有前后置或依赖关系 |
|
||
| 确认单位 | 整张 Trace 卡一次确认，提交卡内全部事项 |
|
||
|
||
### 2. 普通备注事项
|
||
|
||
| 字段 | 业务规则 | 是否必需 | 确认前权限 | 缺失处理 |
|
||
|---|---|---|---|---|
|
||
| 事项内容 | 对邮件要求的业务事项进行提炼 | 是 | 可修改 | 没有事项内容就不应创建该 Trace item |
|
||
| Department | 负责接收该事项的系统预设部门或组合部门 | 是 | 受控选择，可改选 | Agent 应提供；异常缺失时系统兜底 FO+HSK |
|
||
|
||
### 3. 加床事项
|
||
|
||
| 字段 | 业务规则 | 是否必需 | 确认前权限 | 校验与展示 |
|
||
|---|---|---|---|---|
|
||
| 事项内容 | 系统固定生成 `SET EXTRA BED` | 是 | 可见；业务文案固定 | 可与蜜月布置等普通事项并存 |
|
||
| 目标 RoomType | 当前订单中需要加床的房型 | 是 | 只能从当前订单已有房型中改选 | 缺失或不属于当前订单说明关联或解析错误，需要核对整笔订单 |
|
||
| 加床房间数量 | 该房型中需要加床的间数 | 是 | 可修改正整数 | 邮件只写单数“加床”且未给数量时，默认为 1 |
|
||
| 加床后 Adult（每间） | 系统初始按该房型当前 Adult +1 计算 | 是 | 可修改 | 表示加床后每间成人数，不表示加床房间数 |
|
||
| Department | 负责部门或组合部门 | 是 | 受控选择，可改选 | 异常缺失时系统兜底 FO+HSK |
|
||
|
||
页面应相邻回显加床目标，例如：`TWN × 1｜Adult 3`。
|
||
|
||
### 4. Trace 确认结果
|
||
|
||
当前无 PMS API 时：
|
||
|
||
- 保存卡内全部最终事项和确认时间；
|
||
- 卡片变为已完成并锁定；
|
||
- 显示“信息系统已确认，未调用 PMS”；
|
||
- 不宣称 Department 已同步、Trace 已写入 PMS 或加床已生效；
|
||
- 不改写房间信息卡或订单房间汇总。
|
||
|
||
## 七、任务详情内嵌 Rooming List 卡
|
||
|
||
### 1. 出现与任务关系
|
||
|
||
| 项目 | 规则 |
|
||
|---|---|
|
||
| 适用订单 | 仅 Group；Fit 不会出现 |
|
||
| 出现条件 | Agent 给出 Rooming List 业务 |
|
||
| 同邮件多订单 | 按目标订单拆成多笔订单任务 |
|
||
| 同订单新版名单 | 新邮件形成新任务，关联同一 Group；旧任务、旧邮件和旧结果保留 |
|
||
| 定位 | Group Code / Block Name，不优先用 Block ID |
|
||
| 原始附件 | 只在邮件展示卡查看，不在 Rooming List 卡重复展示 |
|
||
|
||
### 2. 当前标准表格字段
|
||
|
||
当前仅展示以下必填业务列；Line 若出现，只是辅助序号。
|
||
|
||
| 顺序 | 字段 | 当前页面要求 |
|
||
|---:|---|---|
|
||
| 1 | Name | 显示为标准表格列 |
|
||
| 2 | First Name | 显示为标准表格列 |
|
||
| 3 | Arrival | 显示为标准表格列 |
|
||
| 4 | Departure | 显示为标准表格列 |
|
||
| 5 | Room Type | 显示为标准表格列 |
|
||
| 6 | Rate Code | 显示为标准表格列 |
|
||
| 7 | Number of Rooms | 显示为标准表格列 |
|
||
| 8 | Adults | 显示为标准表格列 |
|
||
| 9 | Children | 显示为标准表格列 |
|
||
| 10 | Payment Type | 显示为标准表格列 |
|
||
| 11 | Accompanying Guests | 显示为标准表格列 |
|
||
| 12 | Nationality | 显示为标准表格列 |
|
||
|
||
### 3. 当前范围与确认结果
|
||
|
||
| 项目 | 当前要求 |
|
||
|---|---|
|
||
| 表格内容 | 可使用演示数据，不要求证明已准确转换原附件 |
|
||
| 真实解析 | 暂不要求真实逐位住客解析、同住分组或复杂校验 |
|
||
| 交互 | 暂不要求复杂编辑、分页或固定列 |
|
||
| Excel | 不生成、不下载、不要求用户手工导入 PMS |
|
||
| 确认 | 用户点击确认后卡片完成并锁定 |
|
||
| Group 状态 | 按业务规则把本地 Group Booking Status 处理为 DEF |
|
||
| PMS 语义 | 只表示信息系统确认，未调用 PMS |
|
||
|
||
未来拿到 PMS API 后，重新确认真实住客结构、必填校验和执行参数，直接调用 API，不经过 Excel。
|
||
|
||
## 八、Payment 卡
|
||
|
||
| 项目 | 业务规则 |
|
||
|---|---|
|
||
| 适用事件 | 仅属于 Update Booking |
|
||
| 适用订单 | Group、Fit 均可 |
|
||
| 同邮件多订单 | 按订单拆任务 |
|
||
| 同订单多凭证 | 一张 Payment 卡展示全部凭证，不按附件拆卡 |
|
||
| 凭证顺序 | 没有业务顺序 |
|
||
| Voucher | 已并入 Payment，不存在独立 Voucher 卡 |
|
||
| 页面所需数据 | Payment 事件、目标订单、一份或多份对应来源附件 |
|
||
| 当前不需要 | 金额、付款日期、付款人、交易号、银行账号、QR、备注、付款状态、Department |
|
||
| 业务含义 | 展示凭证不等于酒店已确认到账 |
|
||
|
||
### Payment 确认结果
|
||
|
||
| 订单类型 | 当前无 PMS API 的结果 |
|
||
|---|---|
|
||
| Group | 用户查看凭证并确认；本地 Group Booking Status 更新为 DEF；Payment 卡完成并锁定 |
|
||
| Fit | 用户查看凭证并确认；Payment 卡直接完成并锁定，不新增其他订单字段 |
|
||
|
||
两种情况都不得显示 `Payment Confirmed`，不得代表到账确认或 PMS 成功；当前不设计重试按钮或 PMS 回执。
|
||
|
||
## 九、邮件展示卡
|
||
|
||
| 字段或功能 | 是否固定显示 | 权限与规则 |
|
||
|---|---|---|
|
||
| 邮件主题 | 是 | 只读；监听值缺失时可为 null |
|
||
| 发件人 | 是 | 只读；使用邮件监听得到的发件人值 |
|
||
| 发送时间 | 是 | 只读 |
|
||
| 邮件原文 | 是 | 只读；只展开触发当前任务的这一封邮件 |
|
||
| 当前邮件附件 | 是 | 可预览或下载；不可新增、删除或替换 |
|
||
| 查看完整邮件 | 是 | 打开对应完整邮件会话，不在卡内直接铺开整个历史线程 |
|
||
|
||
附件至少需要满足以下业务展示条件：
|
||
|
||
| 附件信息 | 要求 |
|
||
|---|---|
|
||
| 稳定标识 | 必需，用于区分并关联附件 |
|
||
| 文件名 | 必需 |
|
||
| 内容类型 | 必需，用于决定预览方式 |
|
||
| 可访问地址 | 必需，由邮件监听或文件存储提供 |
|
||
| 文件大小 | 可选 |
|
||
|
||
Payment 只引用邮件展示卡对应的来源附件，不需要再复制一份附件内容。
|
||
|
||
## 十、人工复核、校验与卡型错误
|
||
|
||
| 情况 | 页面状态 | 用户处理 | 是否影响其他卡 |
|
||
|---|---|---|---|
|
||
| 具体业务已确定，但该卡数据需核对或补正 | 待确认 + 需人工复核 | 按原字段权限补正后直接点击同一个“确认” | 不影响其他合法卡 |
|
||
| 必填校验未通过 | 保持待确认状态并显示字段问题 | 修正合法字段 | 不影响其他合法卡 |
|
||
| 已有订单未唯一匹配 | 待确认；非定位字段全部禁用 | 先补正 Group Code / Confirmation Number | 不影响其他合法卡 |
|
||
| Agent 漏识别、误识别或生成错误卡型 | 信息系统不新增、删除或切换卡型 | 用户从任一未完成预订业务卡触发终止 | 终止作用于整笔订单任务 |
|
||
| 无法确定具体任务类型 | 纯通知 | 查看邮件并确认 | 不生成业务卡或人工复核卡 |
|
||
| Agent 输出结构无法解析 | 技术异常 | 由开发处理 | 不创建酒店用户可见任务 |
|
||
|
||
## 十一、终止与异常阻断
|
||
|
||
| 对象或场景 | 结果 |
|
||
|---|---|
|
||
| 触发入口 | 任一尚未完成、未被阻断的预订业务卡上的“终止任务” |
|
||
| 已完成卡 | 保持已完成，保留真实参数、确认时间和结果 |
|
||
| 未完成卡 | 全部变为已终止并锁定 |
|
||
| 订单任务 | 整体变为已终止 |
|
||
| PMS | 不调用，不回滚已完成卡 |
|
||
| 异常标记 | 关联订单标记为异常订单 |
|
||
| 后续新任务 | 仍可查看内容，但状态为异常阻断；无确认入口，不允许调用 PMS |
|
||
| 终止记录 | 固定原因“人工终止” + 终止时间 |
|
||
| 终止人 | 当前无账户架构，不记录、不显示、不造占位值 |
|
||
| 纯通知 | 不提供终止入口 |
|
||
|
||
## 十二、状态汇总
|
||
|
||
### 1. 单卡状态
|
||
|
||
| 状态 | 含义 |
|
||
|---|---|
|
||
| 待确认 | 卡片已生成，等待用户检查和确认 |
|
||
| 待确认 + 需人工复核 | Agent 明确要求用户核对或补正该卡；仍是待确认卡 |
|
||
| 已完成 | 卡片已完成信息系统当前阶段要求的处理并永久锁定 |
|
||
| 已终止 | 订单任务被人工终止时，该卡尚未完成 |
|
||
|
||
### 2. 订单任务汇总状态
|
||
|
||
| 条件 | 汇总状态 |
|
||
|---|---|
|
||
| 所有可执行卡均未完成 | 待处理 |
|
||
| 至少一张完成且仍有卡未完成 | 处理中 |
|
||
| 所有可执行卡均完成 | 已完成 |
|
||
| 任一卡触发订单级终止 | 已终止 |
|
||
| 异常订单出现后续新任务 | 异常阻断 |
|
||
|
||
订单任务不显示“已完成 2/5”等计数；单卡的“需人工复核”不形成订单级额外提示；普通预订中的邮件证据卡不参与进度汇总。
|
||
|
||
## 十三、当前无 PMS API 的统一结果口径
|
||
|
||
| 业务卡 | 信息系统当前可以做什么 | 当前不能宣称什么 |
|
||
|---|---|---|
|
||
| Basic Information | 保存最终 Account、Market、Source | PMS 已接收 |
|
||
| New Booking | 保存完整目标订单参数 | 创建成功、已有 Block ID / Confirmation Number |
|
||
| Update Booking | 保存最终 After，并更新本地订单最新数据 | PMS 已更新 |
|
||
| Cancel Booking | 保留历史并把本地订单标记为已取消 | PMS 已取消 |
|
||
| Trace | 保存最终事项 | 部门已同步、PMS 已写入、加床已生效 |
|
||
| Rooming List | 完成标准表格展示确认；Group 本地状态处理为 DEF | 名单已准确转换或已导入 PMS |
|
||
| Payment | 展示凭证并完成当前本地处理；Group 本地状态处理为 DEF | 已到账、Payment Confirmed、PMS 成功 |
|
||
| 纯通知 | 记录用户已确认查看和处理 | 任何订单或 PMS 动作已执行 |
|
||
|
||
统一原则：页面中的“已完成”只表示该任务卡已经完成信息系统当前阶段要求的确认和本地处理，不等于 PMS 成功。
|
||
|
||
## 十四、明确排除与后置事项
|
||
|
||
- 根级 Invoice 不在本轮 Agent 预订任务范围；
|
||
- 根级 `/rooming-list` 文件工作区不在本轮 Agent 预订任务范围；
|
||
- 不存在独立 Voucher、S99、Fallback、Need Manual Review 或统一“条件业务卡片”；
|
||
- 当前不设计数据库、接口、技术模块、代码结构或 PMS 重试机制；
|
||
- 真实 PMS API 参数、执行回执和失败处理拿到 API 后再确认；
|
||
- Rooming List 的真实转换和住客数据结构拿到 API 后再确认；
|
||
- Agent 最终 JSON Schema、训练案例和 Skill 调试不属于本次开发业务交接包。
|