供应商订单安全对账智能体编排(最终)
供应商订单安全对账模块智能体编排
依据 .project/docs/specs/BOOKING_RECONCILIATION_IMPLEMENTATION_SPEC.md,基线日期为 2026-07-20。本编排只覆盖本轮规格允许的纯决策后端与只读前端原型;FE-05 因缺少 API、鉴权与错误契约保持阻塞。
任务清单
| ID | 任务名称 | 层级 | 负责角色 | 输入依赖 | 产出物 | 验收标准 |
|---|---|---|---|---|---|---|
| BE-01 | 后端差距清单 | 后端/分析 | 后端开发工程师 | 规格、现有测试 | 需求-测试映射 | 覆盖冲突、引用不匹配、契约校验、终态证据与优先级差距 |
| BE-02 | 建单结果安全规格 | 后端/领域 | 后端开发工程师 | BE-01 | 测试与最小服务修复 | CREATE-01 至 CREATE-07、SAFE-01 至 SAFE-06 全字段断言通过 |
| BE-03 | 查单结果规格 | 后端/领域 | 后端开发工程师 | BE-02 | 测试与最小服务修复 | QUERY-01 至 QUERY-11、次数及时间边界通过 |
| BE-04 | 终态、幂等与乱序 | 后端/领域 | 后端开发工程师 | BE-03 | 测试与最小服务修复 | STATE-01 至 STATE-08,冲突优先且终态不降级 |
| BE-05 | 契约与异常数据 | 后端/领域 | 后端开发工程师 | BE-04 | 测试与最小服务修复 | VALID-01 至 VALID-07,编程错误抛出、外部数据转人工审核 |
| BE-06 | 后端交付文档与门禁 | 后端/交付 | 主理人 | BE-05 | README、DECISIONS、AI_USAGE | 文档无过期 TODO;全量 Maven 通过且无生产基础设施扩张 |
| FE-01 | 展示类型与演示数据 | 前端/模型 | 前端开发工程师 | 第 5.2 节模型 | types.ts、cases.ts |
四个固定用例、严格类型、仅白名单拒绝为可重建 |
| FE-02 | 只读对账列表 | 前端/页面 | 前端开发工程师 | FE-01 | index.html、main.ts |
表格字段完整、details 可展开、空和错误状态独立 |
| FE-03 | 安全文案与无障碍 | 前端/交互 | 前端开发工程师 | FE-02 | index.html、main.ts |
明确文本结论、原生键盘交互、无写操作 |
| FE-04 | 响应式样式与门禁 | 前端/样式 | 前端开发工程师 | FE-03 | styles.css |
320px 至桌面无溢出、焦点可见、构建通过 |
| FE-05 | 真实 API 集成 | 前端/集成 | 前端开发工程师 | 已批准 API 契约 | 不纳入本轮 | 阻塞,未经接口、鉴权、分页与错误协议批准不得启动 |
| QA-01 | 独立规格审查与回归 | 测试/审查 | 测试工程师、代码审查员 | BE-05、FE-04 | 审查报告、回归结果 | 逐项追踪规格,验证无越界 API/基础设施或安全回归 |
角色分配
| 角色 | 职责范围 | 负责任务 | 输出要求 |
|---|---|---|---|
| 后端开发工程师 | 纯决策服务、模型契约、JUnit | BE-01 至 BE-05 | 最小代码与测试、差距映射、Maven 结果 |
| 前端开发工程师 | 只读页面、原生 DOM、样式、无障碍 | FE-01 至 FE-04 | 可构建前端代码及 320px/桌面检查结果 |
| 测试工程师 | 需求覆盖、回归、负向安全验证 | QA-01 | 可追溯的验收报告和复现命令 |
| 代码审查员 | 边界、依赖、代码质量和文档一致性 | QA-01、BE-06 | 审查结论、剩余风险或批准依据 |
| 主理人 | 依赖编排、验收、归档、交付门禁 | 全量 | 本文档、最终验收与交付文档 |
协作流程
flowchart LR
A[接口契约锁定: 规格与边界] --> B[BE-01 差距审计]
B --> C[BE-02 建单]
C --> D[BE-03 查单]
D --> E[BE-04 终态幂等]
E --> F[BE-05 校验异常]
F --> G[BE-06 文档与全量门禁]
A --> H[FE-01 类型和数据]
H --> I[FE-02 只读列表]
I --> J[FE-03 无障碍安全文案]
J --> K[FE-04 响应式门禁]
G --> L[QA-01 独立审查与回归]
K --> L
L --> M[主理人最终验收与归档]
N[FE-05 API 集成] -. 等待外部契约 .-> O[不在本轮]
| 节点 | 进入条件 | 交付关口 | 主理人验收 |
|---|---|---|---|
| 接口契约锁定 | 已读规格 | 不新增 HTTP API,不变更纯决策边界 | 确认 FE-05 阻塞 |
| 后端阶段 | 前一 BE 任务完成 | 每步针对缺口先加测试,再做最小修复 | 全字段断言与指定 Maven 测试通过 |
| 前端阶段 | 前一 FE 任务完成 | 不复制决策算法、不提供写操作 | npm run build 与视口/键盘检查通过 |
| 提测准入 | BE-05、FE-04 完成 | 完整回归与边界审查 | 无安全倒退、无未批准依赖或基础设施 |
| 发布归档 | QA-01 通过 | 文档、结果、风险一致 | 全量命令结果与需求矩阵逐项核验 |
分批任务指令
批次 1:后端安全决策
BE-01 至 BE-05,后端开发工程师:依据规格第 3、4 节,先产出需求-测试差距清单,之后严格串行补齐 CREATE、QUERY、STATE、VALID 场景。输入为现有领域模型、服务与全部相关测试;只在新增测试揭示缺口时修改
BookingReconciliationService。输出为最小代码、JUnit 覆盖和各阶段 Maven 结果。验收为所有决策字段、不可自动重建默认、终态/乱序优先级及契约错误均与规格一致。遵循.project/rules/backend/入口所路由的规则。FE-01 至 FE-04,前端开发工程师:依据规格第 5、6 节,串行实现本地只读展示原型。输入为展示模型和固定用例;输出为无依赖 TypeScript、原生 DOM、响应式样式与构建结果。验收为四种演示数据、独立空/错误状态、只读安全文案、原生键盘展开及 320px 至桌面无溢出。必须遵循
.project/rules/frontend/前端style规范.md及前端规则入口路由的规则。
批次 2:验收与交付
QA-01,测试工程师与代码审查员:在两条开发轨道完成后,以规格第 8、9 节追踪矩阵审查代码、测试和构建结果。输出为
.project/docs下的验收报告,包含通过项、问题、复现命令和范围确认。验收为无静默覆盖、无错误放宽、无 API/数据库/调度扩张,且 FE-05 未被提前实现。BE-06,主理人:在 QA-01 无阻塞问题后,更新根目录交付文档并运行全量门禁;确认文档与最终行为和测试数量一致。所有中间交付物已归档至
.project/docs。