实现酒店上下文单酒店收口

This commit is contained in:
andy
2026-07-10 15:31:51 +08:00
parent 7492c21350
commit d69f3975ef
52 changed files with 1183 additions and 188 deletions

View File

@@ -4,7 +4,7 @@
| 项目 | 内容 |
| --- | --- |
| 文档版本 | 0.2 |
| 文档版本 | 0.3 |
| 日期 | 2026-07-08 |
| 状态 | 第一版后端实现依据与落地记录 |
| 适用范围 | SuperAgent / Main Agent 调用本系统查询订单和任务上下文 |
@@ -33,7 +33,7 @@
- 如果查询 key 来自历史线程,调用方必须传 `target_key_source=body_thread_evidence``body_thread_used_only_as_evidence=true`
- 第一版不伪造 OPERA 字段。当前系统没有可靠来源的字段返回 `null`,并在 `warnings``hard_validation_warnings` 中说明。
- SuperAgent 允许作为全局上下文查询方按任意业务 key 查询;`source_message_id``source_event_index` 在查询阶段对本系统没有业务作用,第一版接收但忽略,不做格式校验,也不作为查询边界。
- 导入契约没有显式要求 `hotel_id`本系统订单、任务和 AI 过渡表`hotel_id` 隔离。第一版请求体必须显式传 `hotel_id`
- 导入契约没有显式要求 `hotel_id`,本系统订单、任务和 AI 过渡表`hotel_id` 隔离。M005 后 SuperAgent 默认不传 `hotel_id`,后端按平台酒店表唯一 `ACTIVE` 酒店解析;兼容旧调用传入时必须与系统酒店一致
## 3. Skill 对接口 1、2 的实际需要
@@ -146,7 +146,7 @@ POST /api/ai-query/v1/case-context
| 字段 | 是否必填 | 中文说明 | 当前系统来源或用途 |
| --- | --- | --- | --- |
| `hotel_id` | | 酒店或业务上下文 ID | 用于隔离 `workflow_reservation_*` 表 |
| `hotel_id` | | 酒店或业务上下文 ID | SuperAgent 默认不传;后端解析系统酒店后用于隔离 `workflow_reservation_*` 表 |
| `source_message_id` | 否 | SuperAgent 透传的外部来源消息 ID | 全局上下文查询可不传;传入时后端接收但忽略,不做格式校验 |
| `source_event_index` | 否 | SuperAgent 透传的 current 事件序号 | 全局上下文查询可不传;传入时后端接收但忽略,不做正整数校验 |
| `group_code` | 条件必填 | Group / Allotment 优先业务 key | 查询 `GROUP_CODE` 类型订单和 AI 过渡记录 |
@@ -321,7 +321,7 @@ POST /api/ai-query/v1/object-detail
| 字段 | 是否必填 | 中文说明 | 当前系统来源或用途 |
| --- | --- | --- | --- |
| `hotel_id` | | 酒店或业务上下文 ID | 用于隔离订单和任务 |
| `hotel_id` | | 酒店或业务上下文 ID | SuperAgent 默认不传;后端解析系统酒店后用于隔离订单和任务 |
| `object_id` | 是 | 接口 1 返回的对象 ID | 第一版支持 `ORDER:{order_id}` |
| `object_type` | 否 | 对象类型提示 | 用于校验调用方预期和实际对象类型 |
@@ -425,8 +425,8 @@ POST /api/ai-query/v1/object-detail
| 能力 | 当前来源 |
| --- | --- |
| 按 `hotel_id + GROUP_CODE` 查询 ACTIVE 订单 | `workflow_reservation_order.order_key_type``active_business_key` |
| 按 `hotel_id + CONFIRMATION_NUMBER` 查询 ACTIVE 订单 | `workflow_reservation_order.order_key_type``active_business_key` |
| 按“后端解析出的酒店 ID + GROUP_CODE查询 ACTIVE 订单 | `workflow_reservation_order.order_key_type``active_business_key` |
| 按“后端解析出的酒店 ID + CONFIRMATION_NUMBER查询 ACTIVE 订单 | `workflow_reservation_order.order_key_type``active_business_key` |
| 查询临时订单、终止订单、逻辑删除订单 | `workflow_reservation_order.order_status` |
| 查询同订单任务队列 | `workflow_reservation_task.order_id``queue_participation``execution_order` |
| 查询 pending/open task | `workflow_reservation_task.task_status` |
@@ -463,7 +463,7 @@ POST /api/ai-query/v1/object-detail
已落地能力:
- 接口 1 可按 `hotel_id + group_code``hotel_id + confirmation_number` 查询订单上下文,允许不传 `source_message_id``source_event_index` 的全局上下文查询;即使传入这两个字段,后端也不把它们作为查询或校验条件。
- 接口 1 可按“后端解析出的酒店 ID + group_code”或“后端解析出的酒店 ID + confirmation_number查询订单上下文,允许不传 `source_message_id``source_event_index` 的全局上下文查询;即使传入这两个字段,后端也不把它们作为查询或校验条件。
- 接口 1 返回 `matched_order_records``pending_or_open_tasks``active_workflows``terminated_records``target_object_validation``key_relationships`
- `active_workflows` 当前无独立表源,固定返回空数组。
- 接口 2 支持 `ORDER:{order_id}` 查询本系统订单快照。