实现M002 V3 P0.1 Parent Group路由修订
This commit is contained in:
@@ -8,9 +8,9 @@
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 文档版本 | 0.5 |
|
||||
| 日期 | 2026-07-11 |
|
||||
| 状态 | V2 兼容 + M002 V3 CP1-CP6 入站解析、同卡复核和 P0 fixtures 回归基线;后续业务流程以 `M002-order-task-workflow-v3.md` 为准 |
|
||||
| 文档版本 | 0.6 |
|
||||
| 日期 | 2026-07-12 |
|
||||
| 状态 | V2 兼容 + M002 V3 CP1-CP7 入站解析、同卡复核、P0 fixtures 回归和 P0.1 Parent Group 路由修订;后续业务流程以 `M002-order-task-workflow-v3.md` 为准 |
|
||||
| 适用范围 | SuperAgent / Main Agent 调用本系统提交 AI 任务结果 |
|
||||
| 主要读者 | 后端、SuperAgent 对接方、测试、后续协作 agent |
|
||||
|
||||
@@ -20,7 +20,7 @@
|
||||
|
||||
本文承接 `M002-order-task-workflow-v2.md`,只定义本系统入站接口、鉴权、幂等、请求响应和技术校验边界,不定义 SuperAgent 内部 prompt、Skill 实现、OPERA 真实接口或前端展示细节。
|
||||
|
||||
2026-07-11 后,M002 后续开发基线已迁移到 `M002-order-task-workflow-v3.md`。当前后端已完成 CP1-CP6:结构化 `S10/S99` 入站、V3 业务根基础解析、42 路由枚举 / 稳定配置、`UNHANDLED_CURRENT_INTENT` 和 route 相关字段最小落库、type-known manual review 同卡解阻第一版、typed `infrastructure_input_error` 响应和 P0 fixtures 回归基线。旧 `S000/S999` 和 `ai_task_results[]` 仍作为兼容路径保留。对外联调以 `docs/project/integrations/superagent-api-contract.md` 为准。
|
||||
2026-07-11 后,M002 后续开发基线已迁移到 `M002-order-task-workflow-v3.md`。2026-07-12 起,Parent Group / Allotment 路由采用 P0.1 增量修订:当前后端目标为结构化 `S10/S99` 入站、V3 业务根基础解析、40 路由枚举 / 稳定配置、`UNHANDLED_CURRENT_INTENT` 和 route 相关字段最小落库、type-known manual review 同卡解阻第一版、typed `infrastructure_input_error` 响应、P0 fixtures 回归基线和 Parent split `Cancel Allotment` 路由。旧 `S000/S999` 和 `ai_task_results[]` 仍作为兼容路径保留。对外联调以 `docs/project/integrations/superagent-api-contract.md` 为准。
|
||||
|
||||
## 2. 接口概览
|
||||
|
||||
@@ -41,6 +41,7 @@
|
||||
- 本接口只做技术校验和系统接收,不替代用户确认和 OPERA 模拟操作。
|
||||
- `application/json` 用于 V3 结构化 `S10/S99`、V3 业务根或 V2 `normal_task` / `manual_review` 兼容结构化任务。
|
||||
- `text/plain` 用于旧 `S000,source_message_id` / `S999,source_message_id` 特殊入口结果兼容。
|
||||
- P0.1 后,V3 业务根中的完整 Parent split 父事件必须使用 `event_type=Cancel Allotment` 和 `task_subtype=cancel_allotment_control_block`;当前新入站不接受 `Cancel Booking + linked_parent_release_after_child_split` 作为合法业务任务,旧 V2 `ai_task_results[]` 兼容入口也不能继续提交该三元组。
|
||||
|
||||
### 2.1 SourceMessage ID 口径
|
||||
|
||||
@@ -251,6 +252,8 @@ S999,mail-20260708-0001
|
||||
- `task_type` 属于当前系统可识别的稳定值或可进入 Fallback 处理。
|
||||
- 同一个请求内 `source_event_index` 和数组顺序可保存。
|
||||
- 关键字符串长度不超过数据库限制。
|
||||
- V3 P0.1 Parent split 当前合法结构必须是 `Cancel Allotment + cancel_allotment_control_block`;`Cancel Booking + linked_parent_release_after_child_split` 属于当前 producer 契约错误,只能作为历史 payload 只读兼容。
|
||||
- 同一个 Parent split cluster 只能有一个 Parent 候选;重复 Parent 候选不创建第二张业务任务卡。
|
||||
|
||||
### 5.2 不在本接口判断
|
||||
|
||||
@@ -260,6 +263,7 @@ S999,mail-20260708-0001
|
||||
- 不因为字段缺失自动改成 Fallback。
|
||||
- 不直接执行 OPERA 模拟。
|
||||
- 不直接把 AI 原始值写入 OPERA 参数。
|
||||
- 不把 Parent split 的 adapter 契约校验理解为业务成功;即使生成 `Cancel Allotment` 任务,也必须等待用户确认、Preflight 和后续 OPERA/OHIP 接入。
|
||||
|
||||
## 6. 幂等设计
|
||||
|
||||
|
||||
Reference in New Issue
Block a user