huangting/th-hotel-simple
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
eda3e7087366a406667d1916b166473e8d3d05d3
th-hotel-simple/docs/import/20260710/任务卡前端字段变更与路由说明_3.0_to_current.md
andy 6e47158d9e 提交一次代码
2026-07-12 09:57:54 +08:00

32 KiB
Raw Blame History

任务卡前端字段变更与路由说明（开发共识版）

对比基线：任务卡前端展示字段表 3.0.xlsx
当前规则基线：2026-07-10 17:50（Asia/Shanghai）
业务共识基线：2026-07-10（房型/Rate Code、Parent split、Note/Trace、Rooming List/TA Recorder、人工复核）
booking-desk-event.skill SHA-256：b5f33e17c642fefc11b41934cdd657ff2df25ea50b544c7a44424c5d3d977192

文档定位：本文是信息系统 adapter/任务卡开发的确定性交接契约。如项目 reference 中仍存在旧的含混表述，本文中已标记为“已确认业务决策”的规则优先供开发实现，后续再回写上游 skill。

1. 开发先看结论

  1. 当前 Agent 没有为业务结果直接输出 result_type、task_type、task_subtype。普通业务的真实路由键是 message_events[].event_type；只有 S10/S99 原生输出 result_type=source_message_review_notification。
  2. 三元组应由信息系统 adapter 按每个 message_events[i] 派生，不能在邮件根对象只算一次。一封邮件可以同时生成多张候选卡。
  3. message_events[] 是候选事件，不是真实 TaskCard；信息系统仍需做 Case 匹配、Preflight、去重、锁和状态检查后再建卡。
  4. S10、S99 与 unhandled_current_intents[] 都是展示路径，不创建业务 TaskCard。
  5. 业务 Need Manual Review 与 S99 不是同一种复核：前者是 business_event_review，后者是 main_agent_entry_review。
  6. 房型或 Rate Code 无法唯一映射时，默认转业务人工复核；唯一例外是 Parent split 中某个 child 的房型原文仅为 SUITE，该 child 可保留为 New Booking 候选事件，但不得成为可执行任务。
  7. Parent split 固定产生 1 个 Parent Group Cancel Booking 候选 + N 个 Child Group New Booking 候选，不经过 Allotment Maintenance。
  8. 每个 Rooming List 目标必须派生一个与该 group/预订明确绑定的 TA Recorder。
  9. 修改已有结构化订单字段/备注走 Update；新增补充事实、要求或安排走 Trace；Note 不再开放新任务卡。
  10. 业务人工复核不按原业务类型细分卡型。进入 manual_review 后，卡内业务字段全量可编辑；原邮件、证据、系统 ID 和审计字段仍只读。

1.1 已确认业务决策

主题 最终规则 开发不得做的事
房型/Rate Code 歧义 默认 Need Manual Review 不得猜 PMS 房型或 Rate Code
Parent split + raw SUITE 只对该 child 保留 room_type_raw=SUITE，pms_room_type_code=null，requires_downstream_hard_validation=true 不得填 SU1/SU3/SU6；不得创建可执行任务或写 PMS
Parent split Parent 是 Group Block 取消；children 是 Group Block New Booking 不得路由到 Cancel Allotment 或 Allotment Maintenance
Rooming List 每个已确认目标必须同时产生 1 个 Rooming List + 1 个 TA Recorder 不得按邮件/workbook/sheet 只产生 1 个 TA Recorder
修改备注 vs 新增补充 修改已有结构化值走 Update；新增信息走 Trace 不得用 Note 承接普通补充信息
业务人工复核 统一人工复核卡，业务字段可编辑 不得依赖 intended_event_type 拆分复核卡

当前正式契约以以下文件组合为准：

  • prompts/main_agent_prompt.md
  • skills/booking-desk-event/SKILL.md
  • skills/booking-desk-event/references/00-output-contract.md
  • skills/booking-desk-event/references/01-current-history-boundary.md
  • skills/booking-desk-event/references/03-current-content-completeness.md
  • skills/booking-desk-event/references/02-event-routing-map.md
  • 各业务 reference

task_plan.md、findings.md、progress.md 是累积工作日志，不是接口契约。.skill 包也不包含 Main Agent prompt，部署时两者必须同步。

2. 信息系统标准三元组

下表是本次确认冻结的 adapter 输出。其中 normal_task、manual_review 延续 3.0 的信息系统语义；source_message_review_notification 来自当前上游；unhandled_current_intent 是为非任务展示新增的下游枚举。

result_type 是本文和 3.0 表使用的标准名。如信息系统实体内部字段名为 task_result，必须做同义归一：task_result := result_type；不得当成第四个独立路由字段。信息系统的人工复核判别组合固定为 task_type=Fallback + task_result=manual_review，task_subtype=business_event_review。

result_type task_type task_subtype 上游判别 信息系统具体去向 是否建业务卡
source_message_review_notification Message Notification S10 根 route_code=S10 源邮件查看通知组件 否
source_message_review_notification Message Notification S99 根 route_code=S99 源邮件查看通知组件 + 入口复核信息 否
normal_task New Booking new_fit_reservation event_type=New Booking 且 extracted_fields.booking_object_type=FIT Reservation New Booking 卡（FIT） 字段校验通过后为候选卡
normal_task New Booking new_group_block event_type=New Booking 且 extracted_fields.booking_object_type=Group Block New Booking 卡（Group Block） 字段校验通过后为候选卡
normal_task New Booking new_allotment_control_block event_type=New Booking 且 extracted_fields.booking_object_type=Allotment / Control Block New Booking 卡（Allotment / Control Block） 候选卡，Preflight 后
normal_task Update Booking update_booking_amendment event_type=Update Booking / Amendment Update Booking 卡；修改项另外展示 候选卡，Preflight 后
normal_task Cancel Booking cancel_fit_reservation event_type=Cancel Booking 且 extracted_fields.cancel_object_type=fit_reservation Cancel Booking 卡（FIT） 字段校验通过后为候选卡
normal_task Cancel Booking cancel_group_block event_type=Cancel Booking 且 extracted_fields.cancel_object_type=group_block Cancel Booking 卡（Group Block） 字段校验通过后为候选卡
normal_task Cancel Booking linked_parent_release_after_child_split event_type=Cancel Booking；cancel_object_type=group_block；relationship_type 同名 Cancel Booking 卡（Parent Group） 候选卡，必须下游硬校验
normal_task Cancel Allotment cancel_allotment_control_block event_type=Cancel Allotment Cancel Allotment 卡 候选卡，Preflight 后
normal_task Voucher Received lian_tai_credit_voucher event_type=Voucher Received Voucher Received 卡 候选卡，Preflight 后
normal_task Payment Evidence payment_evidence event_type=Payment Evidence Payment Evidence 卡 候选卡，Preflight 后
normal_task Rooming List rooming_list event_type=Rooming List Rooming List 卡 候选卡，Preflight 后
normal_task Amend Group Code amend_group_code event_type=AMEND GROUP CODE Amend Group Code 卡 候选卡，Preflight 后
normal_task Trace / Reservation Notes extra_bed event_type=Trace 且 extracted_fields.trace_subtype=extra_bed Trace 卡（Extra Bed） 候选卡，Preflight 后
normal_task Trace / Reservation Notes general_request event_type=Trace 且 extracted_fields.trace_subtype=general_request Trace 卡（General Request） 候选卡，Preflight 后
normal_task TA Recorder maintain_ta_recorder event_type=TA RECORDER；与同目标 Rooming List 关联 TA Recorder 卡（从对应 Rooming List 派生） 每目标必产生 1 张；Preflight 后
normal_task Invoice Generation invoice_generation event_type=Invoice Generation Invoice Generation 卡 候选卡；业务字段待冻结
normal_task Invoice Received invoice_received event_type=Invoice Received Invoice Received 卡 候选卡；业务字段待冻结
normal_task Payment Notice payment_notice event_type=Payment Notice Payment Notice 卡 候选卡；业务字段待冻结
normal_task Manual RateCode manual_rate_code event_type=Manual RateCode Manual RateCode 卡 候选卡；业务字段待冻结
manual_review Fallback business_event_review event_type=Need Manual Review 且 manual_review.review_record_type=business_event_review 统一业务人工复核卡；业务字段全量可编辑 是，但不得执行业务写入
unhandled_current_intent Unhandled Current Intent requires_business_approval_or_unsupported_task_card 每个 unhandled_current_intents[i] 邮件详情内未覆盖意图展示块 否

说明：

  • task_type 保留 3.0 已存在的信息系统卡名；上游 event_type 的大小写和空格必须按当前契约原值匹配。
  • New Booking 的 FIT/Group 对象枚举和普通 Cancel 的 extracted_fields.cancel_object_type 按本文第 5 节直接冻结；不能靠前端猜测。
  • Update 的多种修改可以同时存在，因此统一使用一个卡 subtype；不得再用单个 action token 决定卡型。
  • 人工复核统一使用 manual_review + Fallback + business_event_review。前端只需通过 result_type=manual_review（或内部别名 task_result=manual_review）切换到全量业务字段可编辑模式，不再需要 manual_review.intended_event_type。
  • Invoice、Payment Notice、Manual RateCode 已进入支持事件目录，但详细 payload 尚未完整冻结。首版只能使用通用事件头、目标、证据和人工复核字段。

2.1 Parent split 的确定性事件集

Parent split 不是 Allotment Maintenance，也不是一张复合卡。必须在同一封邮件的 message_events[] 中产生：

  1. 每个 child group 一个 New Booking：
    • booking_object_type=Group Block
    • adapter 三元组为 normal_task + New Booking + new_group_block
    • case_keys.group_code=<child_group_code>
  2. 一个 parent group Cancel Booking 候选：
    • cancel_object_type=group_block
    • adapter 三元组为 normal_task + Cancel Booking + linked_parent_release_after_child_split
    • case_keys.group_code=<parent_group_code>
    • child_group_codes[] 包含全部 children，related_source_event_indices[] 指向全部 child New Booking 事件
    • requires_downstream_hard_validation=true

Parent 取消事件只是候选。下游确认 parent group、全部 child 关系和 PMS 当前状态前，不得创建可执行取消任务，不得写入 PMS。

2.2 Parent split 的 generic SUITE 唯一例外

只有当一个 child 的唯一不确定项是房型原文 SUITE 时，该 child 才可继续输出 New Booking 候选事件：

{
  "extracted_fields": {
    "room_type_raw": "SUITE",
    "pms_room_type_code": null
  },
  "requires_downstream_hard_validation": true
}
  • 不得猜测或填写 SU1、SU3、SU6。
  • 下游确认具体 PMS 房型代码前，该 child 只是不可执行候选，不得写 PMS。
  • 校验失败时，只将该 child 转业务人工复核；不得阻塞或丢弃同邮件中其他已合格的 child 事件。
  • Rate Code 不唯一不在此例外内；仍必须转业务人工复核。

3. Adapter 路由顺序

1. 如果根 result_type == source_message_review_notification：
   - route_code 必须是 S10 或 S99；映射通知组件；不遍历业务卡。

2. 否则按业务根处理：
   - 校验五个根字段存在；
   - 遍历 message_events[]，每个 event 独立计算一组三元组；
   - 遍历 unhandled_current_intents[]，每个 item 生成一个展示块；
   - case_candidates[] 和 extraction_warnings[] 不参与任务卡路由。

3. 任意稳定判别字段缺失或出现未知 event_type：
   - 对该 event fail closed，记录接口契约错误并展示源邮件；
   - 不得按房量、关键词、附件名等在前端重新执行 AI 业务判断；
   - 不得为该无效 event 自动创建 TaskCard；根结构仍合法时，其他合法 sibling events 继续独立处理。

关键判别：

  • New Booking：必须读取 extracted_fields.booking_object_type。
  • Update：固定 subtype=update_booking_amendment；具体修改用 action 数组或 before_after[] 展示。
  • Cancel：先判断 parent split 的 relationship_type；命中时 cancel_object_type 必须是 group_block，再处理其他普通 cancel object。
  • Trace：只允许 extracted_fields.trace_subtype=extra_bed|general_request。
  • Need Manual Review：必须同时检查 manual_review.review_record_type=business_event_review。
  • S99 的 main_agent_entry_review 只展示在 S99 通知中，不能创建 Fallback 业务卡。
  • Unhandled Current Intent：text_raw 和 visible_message 都必须展示；前者是证据原文，后者是给用户的中文提示。

3.1 “契约错误”和“人工复核”不再混用

情况 系统处理 该项自动业务卡数
未知/禁用 event_type，或已声明某路由但必填判别字段缺失 记录 adapter_contract_error，保留并展示源邮件；该 event 不转业务复核 0
业务类型已识别，但房型/Rate Code/目标/证据存在业务歧义 生成统一 manual_review + Fallback + business_event_review 卡 1 张人工复核卡，0 张可执行卡
Parent split 的业务意图已确认，但 parent group 或 parent-child 绑定无法确认 该 parent 取消转统一业务人工复核；合法 child events 仍独立处理 parent 可执行卡 0；人工复核 1
event 声明 linked_parent_release_after_child_split，但 parent_group_code/child_group_codes/related_source_event_indices 等契约字段缺失 这是 payload 契约错误，不是业务歧义；记录错误并拒绝该 event 0

因此，开发文档中不再使用“0 卡/复核”这类二选一表述。契约错误和业务不确定必须按上表分开。

4. 3.0 之后已发生的字段变化

4.1 已新增，开发必须消费

字段/结构 变化 开发动作
source_message 所有合规结果新增源邮件身份 根级保存并用于原邮件跳转
source_message.source_message_id 升级为非空必填，不得猜测 缺失视为上游/基础设施错误
message_events[] 邮件级多事件数组 每个 item 独立路由；不能一封邮件只建一张卡
case_candidates[] 新根字段 保留；item schema 未冻结，暂不消费
extraction_warnings[] 新根字段/语义收窄 只显示解析/OCR/抽取告警，不建卡
unhandled_current_intents[] 新增第五个业务根字段 每项同时展示 visible_message 和 text_raw，永不建卡
message_events[].event_role 新增事件角色 审计展示；当前常见值 travel_agent_request
message_events[].current_or_history 新增证据边界 正常新事件必须为 current
message_events[].source_event_index 新增批次内关系索引 仅用于事件关联，不是 TaskCard ID
case_keys.reservation_number / block_code 通用目标 key 扩展为四键 与 group/confirmation 一起固定保留
file_references[] 通用文件引用 与 attachments[] 分开归一，缺失补 []
context_used 新增历史/系统证据审计对象 只做审计和硬校验，不做卡型推断
related_source_event_index 新增单来源关系 linked Trace 等场景使用
related_source_event_indices[] 新增多来源关系 parent release 关联多个 child 时使用
related_event_type 新增关联事件类型 关系展示
relationship_type 新增关系类型 linked_trace、linked_parent_release_after_child_split 或 derived_ta_recorder_from_rooming_list
requires_downstream_hard_validation 新增下游硬校验开关 为 true 时禁止自动执行
extracted_fields.room_type_raw 将房型原文与 normalized/PMS code 分开 始终保留原文；不再用单一 room_type 同时表示原文和标准值
extracted_fields.pms_room_type_code 从默认必填改为“唯一映射后才可填” 歧义时保持 null；Parent split raw SUITE 例外中禁止填猜测值
extracted_fields.nights 住期新增晚数 与 arrival/departure 一起显示/校验
extracted_fields.date_evidence 新增酒店/行程/动作/sheet 原始日期证据 复核区展示；action date 不是入住日期
extracted_fields.trace_items[] Trace 新增结构化明细 同一目标仍是一张 Trace，不按 item 拆卡
trace_items[].category/text_raw/service_date/service_period_raw/pax/notify_departments Trace 明细字段新增 按原顺序展示
extracted_fields.requires_rate_update Extra Bed 新增费率更新意图 只表示意图，不计算价格
parent release/cancel 一组字段 新增 parent/child、release reason、候选标记 固定映射 Parent Group Cancel Booking 特殊候选卡，使用硬校验
TA Recorder 派生关系 每个 Rooming List 目标必须派生 related_source_event_index=<Rooming List index>；related_event_type=Rooming List；relationship_type=derived_ta_recorder_from_rooming_list；两者 case_keys 必须一致
QBD/LianTai row evidence 新增 sheet/row/highlight/status/raw date/room/price 等证据 复核区展示；一个有效行一个事件
rate_code_result.manual_price_reason_code 手工价原因新增 手工价提示
rate_code_result.price_evidence[] 价格证据新增 审计/复核展示
Fix Charge item 扩展字段 新增 amount/currency/unit/quantity/total/raw/evidence/follow-up 保留但不自动调用 TBD 工具
additional_operations[] 新增后续操作意图 只显示 pending，不直接执行
S10/S99 notification 结构 新增 route/assessment/notification/user-decision 统一源邮件查看组件

4.2 已修改或迁移

3.0 字段/枚举 当前处理 开发动作
根级/卡级旧字段路径 业务字段现在位于 message_events[i] normalizer 加事件数组前缀
result_type/task_type/task_subtype 业务 Agent 不再原生输出 adapter 逐 event 派生
信息系统内部 task_result 如存在，仅是 result_type 的别名 normalizer 统一为 task_result := result_type
Update Booking 多个 action 作为 subtype 一个 Update 可多 action subtype 固定 update_booking_amendment，动作另存数组/明细
修改已有备注/结构化字段 Update Booking / Amendment 使用 update_actions[] 和 before_after[] 展示改前/改后
新增补充事实、要求、安排 Trace 使用 trace_items[]，不转 Note
cancel_allotment_control_block 属于 Cancel Booking 当前有独立 Cancel Allotment 迁移到新卡
bank_transfer_slip 属于 Voucher Received 当前银行/现金/交易凭证是 Payment Evidence 迁移到新卡
Rooming List 四个 subtype 当前是同一名单事件的证据同义词 统一 subtype=rooming_list，原文留 evidence
Rooming List → TA Recorder 从“可能派生”收口为“每目标必须派生” 每个 target 产生一对关联事件，保留同一目标键和 Rooming List 关系
Parent split 路由 旧文档使用 release/cancel 混合描述 固定 child Group New Booking + parent Group Cancel Booking；不进入 Cancel Allotment/Allotment Maintenance
房型/Rate Code 不唯一 旧文档写成“人工复核或 downstream validation” 默认人工复核；只保留 Parent split child raw SUITE 这一个硬校验例外
旧 extracted_fields.room_type 拆分为房型原文、normalized 值和 PMS code 原文迁移到 room_type_raw；PMS code 仅在唯一映射时填写
Trace / Reservation Notes 上游 task name 当前 event_type=Trace adapter 映回旧信息系统卡名
linked task Trace subtype 当前是 relationship_type=linked_trace subtype 仍必须是 extra_bed/general_request
parent_source_event_index 当前改用通用 related 字段 迁移到 related_source_event_index/indices
post_confirm_action 当前改为 post_confirmation_intent 字段改名；仍是 pending intent
Rate Code 固定下拉全集 当前 reference 仅为 Typical/已知规则 不得硬编码文档示例为封闭枚举；使用配置中心或可编辑文本
Fix Charge charge_type=additional_charge 当前为 fixed_charge 更新枚举
Fix Charge pricing_mode=unit_price 当前为 unit 更新枚举
业务人工复核只展示 reason/known fields 当前固定九字段结构 完整显示 missing/blocking/conflict/action/evidence/known fields；业务字段全量可编辑
S10 状态名 no_booking_action_detected 值兼容保留，但语义改为“未匹配支持事件” 必须展示原邮件并要求用户决定，不能自动关闭

4.3 废弃、禁止或暂不开放

旧值/组合 状态 替代
informational_message + Message Notification + thank_you/fyi/... 废弃业务卡路由 裸礼貌/裸 FYI → S10；具体预订信息 → Trace；输入不足 → S99
Fallback 的旧 routing subtype 废弃为路由主键 S10、S99 或业务 Need Manual Review 三分流
manual_review + 各业务 task_type + manual_review 废弃 统一 manual_review + Fallback + business_event_review；不再新增 intended event type
new_booking 废弃直接路由 必须归一成 FIT/Group/Allotment 三类之一
new_allotment 兼容 alias 归一为 new_allotment_control_block
update_trace_or_guest_request 废弃 独立 Trace
update_group_block_linkage 废弃模糊值 old→new code 用 Amend Group Code；parent split 用 child New + parent Cancel
Trace subtype=linked task 废弃 使用 relationship 字段
Trace subtype=任务卡展示编辑矩阵 3.0 数据污染 删除
No Action、S000、S999 非法 只允许 S10/S99
Note 禁用；仅作为旧契约历史文字 普通补充信息统一 Trace；不开放新卡
Allotment Maintenance 禁用；无独立 producer/schema/任务卡 修改已有 Allotment/Control Block 走 Update Booking / Amendment + update_allotment_control_block；Parent split 走 child New + parent Cancel
Fix Charge 独立任务 非法 只作为 New/Update 内嵌字段和后续意图

5. 开发可直接收口的技术契约（无需再等产品确认）

5.1 路由和标识字段

项目 必须实现的固定规则
New Booking 对象判别 强制 extracted_fields.booking_object_type，枚举固定为 FIT Reservation / Group Block / Allotment / Control Block
Cancel Booking 对象判别 强制 extracted_fields.cancel_object_type=fit_reservation|group_block；普通 Allotment 取消必须使用 Cancel Allotment；Parent split 的 parent 固定为 group_block
Update 修改项 冻结 extracted_fields.update_actions[]，允许多值；它只用于展示修改项，不用作卡 subtype
result_type/task_result 对外契约使用 result_type；信息系统内部若使用 task_result，只做同义别名归一
业务人工复核 固定 result_type/task_result=manual_review、task_type=Fallback、task_subtype=business_event_review，不增加 intended_event_type；业务字段全量可编辑，证据/审计/系统字段只读
事件关系 ID source_event_index/related_* 仅在本次 Agent 输出内建立关系，绝不是 TaskCard ID 或 PMS ID

5.2 字段归一

项目 必须实现的固定规则
attachments[] / file_references[] 两个字段分开保留；缺失时 normalizer 补 []，不得合并成一个字段
manual_review 普通事件缺失时补 null；Need Manual Review 必须包含完整九字段对象，不完整则契约错误
case_keys 固定保留 group_code/confirmation_number/reservation_number/block_code 四键，无值用 null，不得猜测
unhandled_current_intents[] 每项必须保留并展示 text_raw、visible_message、requires_user_decision=true；不建卡
source_message.source_message_id 非空必填；缺失时整个根结果按上游/基础设施错误拒绝，不得创建卡或 S10/S99 通知
case_candidates[] / extraction_warnings[] item schema 冻结前只保留/展示，不参与任务创建

5.3 执行安全

项目 必须实现的固定规则
requires_downstream_hard_validation=true 该 event 只能停留在候选/待确认状态；禁止变成可执行 TaskCard，禁止写 PMS
房型/Rate Code 歧义 默认转业务人工复核；不得由前端、adapter 或配置默认值猜测
Parent split raw SUITE 仅保留 raw + null PMS code + hard validation；失败后仅转该 child 人工复核
Parent split parent cancel 必须检查 parent group、全部 child relation、去重/锁/当前 PMS 状态；候选事件不等于已取消
未知/禁用 event 逐 event fail closed，记录 adapter_contract_error，不自动转业务人工复核，不影响其他合法 sibling events
最终输出 直接解析结构化 JSON 对象；不依赖 JSON 文件、包装层、下载链接或 output mode

5.4 尚未冻结的专属编辑区

Invoice Generation、Invoice Received、Payment Notice、Manual RateCode 的专属 extracted_fields 仍不完整。Cancel、Rooming List、TA Recorder 也没有完整覆盖旧 3.0 的全部专属字段路径。在新 schema 冻结前：

  • 允许开发通用候选卡头、目标、证据和人工复核区。
  • 不得自行发明专属字段、枚举或必填条件。
  • 建议新增 schema_version；当前先以本文日期和 skill SHA-256 锁定联调基线。

6. 明确的非法组合与 fail-closed 规则

以下情况必须拒绝自动建卡：

  • 在邮件根只生成一个三元组，忽略多个 message_events。
  • S10/S99 创建业务 TaskCard。
  • 已匹配支持事件后仍输出或转换成 S99。
  • unhandled_current_intents 创建 TaskCard。
  • 清楚但不支持的业务意图被转换成 Need Manual Review。
  • history-only 内容创建事件、Trace 或未覆盖意图。
  • 多个 group code 塞进一个 event。
  • bank slip 继续进入 Voucher Received。
  • 控房/配额取消继续进入普通 Cancel Booking。
  • Parent split 被当成普通 Update、Allotment Maintenance 或 Cancel Allotment。
  • Parent split 的 child 不使用 New Booking + Group Block，或 parent 不使用 Cancel Booking + group_block。
  • Parent split 的 parent cancel candidate 被视为已取消成功。
  • 普通房型或 Rate Code 不唯一时仍创建 normal task；Parent split raw SUITE 例外除外。
  • Parent split raw SUITE 例外中填写 SU1/SU3/SU6，或在硬校验前创建可执行任务/写 PMS。
  • Extra Bed 被当成 Update 或房量。
  • Trace subtype 不是 extra_bed/general_request。
  • trace_items[].category 被拆成多张任务卡。
  • 修改已有结构化备注被路由到 Trace，或新增补充信息被路由到 Update/Note。
  • 每个 Rooming List 目标未派生对应 TA Recorder，或两者 target/关系字段不一致。
  • Note 或 Allotment Maintenance 在没有新 schema 的情况下建卡。
  • 缺 source_message_id 时仍接受任何“合规”结果、创建业务卡或生成 S10/S99 通知；该情况必须按上游/基础设施错误处理。
  • 把 source_event_index/related_* 当真实 TaskCard ID。
  • 根据 Fix Charge 的 TBD 工具名或 payment intent 自动执行外部写入。

7. 最低验收场景

场景 预期
只有 Thanks / Noted 1 个 S10 源邮件通知，0 张业务卡
see attached 且附件不可取得，无法判断方向 1 个 S99 源邮件通知，0 张业务卡
Payment Evidence + “余款能否入住时支付” 1 张 Payment Evidence 候选卡 + 1 个未覆盖意图展示块
上述未覆盖意图展示块 同时显示 visible_message 和 text_raw；不创建 TaskCard
Update + Meeting + Extra Bed，同一目标 1 张 Update 卡 + 1 张合并 Trace 卡；Trace subtype=general_request
Rooming List 含两个目标 group 每目标 1 张 Rooming List + 1 张 TA Recorder，共 4 张候选卡；每对 case_keys 一致且 TA Recorder 关联回对应 Rooming List
Parent Group 拆 2 个 Child Group 2 张 New Booking/new_group_block + 1 张 Parent Group Cancel Booking/linked_parent_release_after_child_split；parent 必须 hard validation
Parent split 中 1 个 child 房型仅写 SUITE 该 child 仍输出 New Booking 候选；保留 room_type_raw=SUITE，PMS code 为 null，hard validation=true；其他 child 不受阻塞
非 Parent split 的 generic SUITE，或任意场景 Rate Code 无法唯一映射 1 张统一业务人工复核卡，0 张可执行业务卡；不填猜测值
同一 Update 改日期、房型、价格 1 张 Update 卡，多个修改项；不能因单值 subtype 丢字段
将订单中已有备注 A 修改为 B Update Booking，保留 before/after
当前邮件新增“客人 20:00 到店” Trace/general_request，不是 Update 或 Note
LianTai Credit Voucher Voucher Received，不是 Payment Evidence
bank transfer / cash deposit receipt Payment Evidence，不是 Voucher Received
已匹配 Update 但附件不可读 业务 Fallback 人工复核卡，不是 S99
任意业务 Need Manual Review adapter 输出 manual_review + Fallback + business_event_review（或内部 task_result=manual_review）；业务字段全量可编辑，证据/审计字段只读
已匹配支持事件但参数不安全，同时还有清楚但不支持的当前意图 1 张业务 Fallback 人工复核卡 + 1 个未覆盖意图展示块；不得因复核分支提前返回而丢失展示项
纯付款政策询问且无支持事件 S10，不是 Trace、Need Manual Review 或未覆盖意图数组
已知但当前禁用的 Note / Allotment Maintenance，或真正未知/拼写错误的 event type 该 event 记录 adapter_contract_error，0 张自动业务卡，保留源邮件；其他合法 sibling events 仍继续处理

8. 实施顺序

  1. 先实现根结构分流和逐事件循环。
  2. 实现本文件的三元组表和 fail-closed 校验。
  3. 落地统一业务人工复核卡和全量业务字段可编辑模式。
  4. 实现 Parent split 事件集、generic SUITE 例外和逐 child 隔离失败。
  5. 实现 Rooming List → TA Recorder 强制派生关系。
  6. 新增 S10/S99 源邮件通知与 unhandled_current_intents 展示组件，同时展示 visible_message/text_raw。
  7. 迁移 Cancel Allotment、Payment Evidence、Invoice、Manual RateCode 等卡型，更新 Trace、日期证据、Fix Charge 和手工价字段。
  8. 尚未冻结的专属 schema 只开发通用候选卡，不自行发明字段。
  9. 用第 7 节场景做 adapter 单元测试和端到端回归。

9. 证据位置

  • 当前输出与事件结构：skills/booking-desk-event/references/00-output-contract.md
  • 完整覆盖与未覆盖意图：skills/booking-desk-event/references/03-current-content-completeness.md
  • 路由顺序、冲突和多事件拆分：skills/booking-desk-event/references/02-event-routing-map.md
  • 业务复核/S10/S99 边界：skills/booking-desk-event/references/90-manual-review.md
  • Update 多动作：skills/booking-desk-event/references/11-update-booking.md
  • Cancel / Cancel Allotment：skills/booking-desk-event/references/12-cancel-booking.md
  • Voucher / Payment Evidence：skills/booking-desk-event/references/13-voucher-payment.md
  • Trace schema：skills/booking-desk-event/references/16-trace-notes.md
  • Parent split：skills/booking-desk-event/references/31-allotment-control-block.md
  • 房型/Rate/Fix Charge/日期：skills/booking-desk-event/references/50-room-type-mapping.md 至 54-stay-date-parsing.md