供应商订单安全对账智能体编排(最终)

report
2026年7月20日阅读约 3 分钟496 字

更新于 2026年7月20日

供应商订单安全对账模块智能体编排

依据 .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.tscases.ts 四个固定用例、严格类型、仅白名单拒绝为可重建
FE-02 只读对账列表 前端/页面 前端开发工程师 FE-01 index.htmlmain.ts 表格字段完整、details 可展开、空和错误状态独立
FE-03 安全文案与无障碍 前端/交互 前端开发工程师 FE-02 index.htmlmain.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