Files
th-hotel-simple/docs/import/20260718/0718给黄哥/02-业务字段与卡片规则矩阵.md

19 KiB
Raw Blame History

预订任务信息系统业务字段与卡片规则矩阵

版本日期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 为 TENProposal 为 INQRooming List 或 Payment 确认后为 DEF 是,系统有初始规则 确认前可在 TEN / DEF / INQ 中受控改选 不要求 Agent 输出Fit 不显示
Block ID 仅 GroupPMS New 成功后 PMS 返回 当前无 API 时不存在 只读 在房间信息卡和执行结果/订单信息区域显示;当前不得模拟
Confirmation Number 仅 FitPMS New 成功后 PMS 返回 当前无 API 时不存在 只读 在房间信息卡和执行结果/订单信息区域显示;已有 Fit 后续业务靠它定位

2. 房型行

每行固定为:RoomType → 房量 → Adult每间

字段 业务来源或派生规则 是否必需 确认前权限 校验与特殊规则
RoomType 目标预订中的房型,匹配系统已有房型目录 只能从已有房型中改选 缺失或无法匹配时需人工复核
房量 目标预订中该房型的间数 可修改正整数 缺失、为 0 或无法确定时需人工复核
Adult每间 系统按 RoomType 的固定入住人数映射产生 是,系统派生 普通房间信息卡中只读 表示每间成人数,不是该行总人数;不存在无映射房型

房型行补充规则:

  • 允许多个房型行;
  • Rate Code 不属于房型行,不按 Rate Code 拆行;
  • 同一 RoomType 只有 Adult 不同时才允许拆成多行,例如 TWN × 4Adult 2TWN × 1Adult 3

四、房间信息卡——New / Update / Cancel

类型 订单定位 页面主要内容 确认前权限 当前无 PMS API 的确认结果
New Booking Group 用 Group Code 建单Fit 用真实姓名,暂无姓名时用 Booking Code 临时作为 Name 展示完整目标预订 按公共字段权限纠错 保存完整目标参数;卡片完成并锁定;显示“信息系统已确认,未调用 PMS”不显示创建成功不生成 PMS 编号
Update Booking Group 用 Group Code / Block NameFit 用 Confirmation Number 展示修改后的完整订单,并突出变化字段的“原参数 → 修改后参数” 修改后参数按字段权限纠错Rate Code 不可修改 保存最终修改并更新信息系统本地订单最新数据;完成并锁定;不伪造 PMS 回执
Cancel Booking Group 用 Group Code / Block NameFit 用 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 × 1Adult 3

4. Trace 确认结果

当前无 PMS API 时:

  • 保存卡内全部最终事项和确认时间;
  • 卡片变为已完成并锁定;
  • 显示“信息系统已确认,未调用 PMS”
  • 不宣称 Department 已同步、Trace 已写入 PMS 或加床已生效;
  • 不改写房间信息卡或订单房间汇总。

七、任务详情内嵌 Rooming List 卡

1. 出现与任务关系

项目 规则
适用订单 仅 GroupFit 不会出现
出现条件 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 更新为 DEFPayment 卡完成并锁定
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 调试不属于本次开发业务交接包。