docs: 收口 V4 任务卡展示与确认口径

docs/project/integrations/superagent-api-contract.md

@@ -124,6 +124,8 @@ SuperAgent 不应知道或依赖内部 SourceMessage Inbox ID，也不需要为
 - Basic Information 必须先确认；业务卡逐卡确认或复核解阻，确认后永久锁定；V4 第一版不提供前端草稿。
 - `route_code=S10/S99` 使用 V4 来源通知模型，不创建隐藏技术订单，不进入订单详情时间线，不阻塞普通订单；前端只展示和 ack。
 - Account / Market / Source、Room Type、Rate Code 以本系统数据库目录稳定代码为准；SuperAgent 不应输出显示文案作为业务判断依据。
+- Rate Code 下一阶段按当前 `order_ref` 的 `basic_information.account_code` + event `target_order.booking_type`（GROUP / FIT）限定候选；SuperAgent 仍只输出稳定 `rate_code`，不输出价格、显示名或目录对象。
+- Room Information 卡的 Nights、Breakfast、Group Booking Status、当前值 / 最终值 / 差异摘要由本系统后端展示模型提供；SuperAgent 不输出这些展示派生字段。
 
 开发阶段不维护 V2/V3 旧任务兼容，测试数据可重建；该策略仅限开发 / 测试阶段，不代表生产迁移方案。生产数据迁移策略不在当前 checkpoint 处理，后续上线前另开迁移方案。
 
@@ -529,7 +531,7 @@ V4 普通业务包示例：
       },
       "arrival_date": "2026-07-26",
       "departure_date": "2026-07-29",
-      "rate_code": "BAR",
+      "rate_code": "GRPA1",
       "booking_scenario": "STANDARD",
       "room_items": [
         {
@@ -586,20 +588,27 @@ V4 字段说明：
 | `message_events[]` | 普通业务必填 | 逐 event 入站，后端按数组顺序处理。 |
 | `message_events[].event_type` | 是 | 第一版支持 `NEW_BOOKING`、`UPDATE_BOOKING`、`CANCEL_BOOKING`、`TRACE_RESERVATION_NOTES`、`ROOMING_LIST`、`PAYMENT`。 |
 | `message_events[].target_order` | 是 | `GROUP + GROUP_CODE`，或 `FIT + BOOKING_CODE / CONFIRMATION_NUMBER`。 |
+| `message_events[].rate_code` | NEW_BOOKING 必填，可为 `null` | Rate Code 稳定 code；下一阶段必须属于同 `order_ref` 的 Basic Information Account + 当前 `booking_type` 的适用范围。 |
 | `message_events[].manual_review` | 是 | 只能是 `null` 或布尔 `true`；`true` 必须能由当前对象中的未解决字段解释。 |
-| `PAYMENT.attachment_ids[]` | PAYMENT 必填 | 必须引用同包 `source_message.attachments[].id`。 |
+| Room Information 展示派生字段 | 不需要 | Nights、Breakfast、Group Booking Status、Adult、Block ID、Confirmation Number、当前订单值和差异摘要均由本系统后端查询或派生；SuperAgent 不输出。 |
+| New Booking 最终订单展示名 | 不需要 | Group Block Name / Fit Name 是信息系统最终订单投影字段，可由用户在 V4 任务卡中确认前编辑；Group 默认来自 `target_order.locator_value` 且 `locator_type=GROUP_CODE`，Fit 默认来自 `guest_name ?? target_order.locator_value`；SuperAgent 仍只输出 `target_order.locator_value` 作为目标定位线索，系统不得回写修改该原始定位值。 |
+| `TRACE_RESERVATION_NOTES.trace_items[].department_code` | Trace 必填 | 第一版固定为 `FO` / `HSK` / `FO+HSK`，不接受自由文本；正式 Department 目录后续再扩展。 |
+| `ROOMING_LIST` 专属业务字段 | 不需要 | 第一版只识别 Rooming List 事项并生成可确认任务卡；SuperAgent 不输出名单 rows、同住分组、附件 ID、Excel 或 PMS 导入参数。 |
+| `PAYMENT.attachment_ids[]` | PAYMENT 必填 | 必须引用同包 `source_message.attachments[].id`；SuperAgent 不在 PAYMENT event 内复制附件名称、URL 或完整附件对象。第一版这些 ID 是只读业务事实，用户只确认卡片，不增删或替换附件集合；前端图片缩略图 / 大图预览和非图片下载由本系统根据这些 ID 匹配 SourceMessage 附件后提供。 |
 
 当前已支持的 V4 行为：
 
 - 命中 SourceMessage 后保存 AI batch / transition，并按 `source_message + order_contexts[] + message_events[]` 处理。
 - 普通业务包按 `source_message + order_ref` 创建 V4 订单任务，并创建 `SOURCE_MESSAGE_DISPLAY`、`BASIC_INFORMATION` 和业务事件卡。
 - Basic Information 必须先确认；业务卡逐卡确认或复核解阻，确认后永久锁定；V4 第一版不提供前端草稿。
+- `ROOM_INFORMATION` 卡只由 `NEW_BOOKING`、`UPDATE_BOOKING`、`CANCEL_BOOKING` 触发；New / Update / Cancel 的最终值、差异、Nights、Breakfast、Group Booking Status 和本地订单投影展示由本系统后端展示模型提供，不扩大 SuperAgent 输入契约。
+- `ROOMING_LIST` 卡第一版只做事项确认；用户点击“确认卡片”表示已人工处理，不代表名单已解析、Excel 已生成或 PMS 已导入。
 - `route_code=S10/S99` 创建 V4 来源通知，工作台可见，订单列表和订单详情不可见；来源通知只能 ack，不创建订单、不阻塞订单。
 - V4 包级结构错误如果仍能通过 `source_message.source_message_id` 定位 SourceMessage，会返回成功接收并写入 `adapter_contract_error` transition；不创建订单任务、任务卡或来源通知。`source_message_id` 缺失或找不到 SourceMessage 时仍返回明确错误。
 - `PAYMENT.attachment_ids[]` 引用不存在的附件、`UPDATE_BOOKING` 携带不允许字段、目录代码无法匹配当前酒店数据库目录，以及其他 V4 event 契约错误，只写 `adapter_contract_error` transition，不创建用户可处理业务任务。
 - 技术契约错误不会自动转为 S10/S99，也不会创建前端可处理业务任务。
 
-当前仍未完成：真实 OPERA / OHIP、真实 PMS / OPERA / OHIP 目录同步、普通任务切换订单、SuperAgent 目录机器接口和前端订单详情 V4 化。
+当前仍未完成：Room Information 卡业务展示模型、Payment 卡附件安全摘要和预览 / 下载联动、Account + booking type 过滤 Rate Code 的后端 lookup / 校验和前端联动、真实 OPERA / OHIP、真实 PMS / OPERA / OHIP 目录同步、普通任务切换订单、SuperAgent 目录机器接口。
 
 ### 8.3 V3 S10/S99 结构化请求体
 
@@ -635,7 +644,7 @@ S10 示例：
 }
 ```
 
-S99 与 S10 使用相同结构，但 `route_code=S99`，`agent_assessment.status=material_package_unavailable`，且 `manual_review` 必须是完整入口复核对象。
+S99 与 S10 使用相同结构，但 `route_code=S99`，`agent_assessment.status=material_package_unavailable`。当前 V4 来源通知第一版不输出入口 `manual_review` 对象，`manual_review` 固定为 `null`；历史 V3 / 0711 入口复核对象只作为兼容资料，不作为 V4 新数据契约。
 
 ### 8.4 V3 业务根请求体