aps-agent/docs/round-87-master-data-parall...

30 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 第 87 轮并行实施
## 分工
| 片 | 分工 | 代码所有权 | 输出 |
|---|---|---|---|
| W1 intake | 16 表结构化识别和可靠导入,5+1 订单、库存、BOM、来源、班次、人员/WIP/参数 | server/aps_domain/importers.py、folder_pack.py;新增 server/importers/ruiyang_aps.py 等本轮专用模块;test_ruiyang_aps_intake.py | 真实文件输入→结构化世界;重复导入和语义不丢失证据 |
| W2 master | 标准对象稳定映射、普通/柔性编辑一致、导入工艺可编辑、版本与周末日历 | server/aps_domain/masterdata.py、server/importers/sql_pack.py 的 master 同步 helper、server/gateway/masterdata_api.py、server/db/sync.py、相关新增测试 | 维护同一个对象;库存/工时/设备/日历验证 |
| W3 consume | 数据→排产消费:WIP、人员、维护、损耗/在途、计划起点和参数;真实闭环验收脚本 | server/engines/pool_engine.py、server/aps_domain/flex.py、readiness.py、flex_gantt.py(若存在);新增消费 helper 和测试;scripts/round87_masterdata_e2e.py | 真实文件经维护后的排产差异与完整性验证 |
| 主控 | 页面、附件、共享 workflow 接线、合并、回归、独立审查 | apps/web、server/gateway/app.py、server/aps_domain/workflow.py、project_analyze.py、docs | 用户可操作流程与汇合态验证 |
现有共享关键函数不能由其他片直接修改;通过消息提出确切接线点/接口。W1/W2/W3 同时向其他片通报数据合同,不能仅到最后才交报告。
## 合同和集成
- W1 优先提出本轮 source/provenance、工艺标准、人员/WIP/班次/参数及sandbox候选对象合同。
- W2 与 W1 对齐稳定 ID/导入完成投影接口;普通编辑写入同一标准值,对非锐扬旧数据保持兼容。
- W3 与 W1 对齐这些对象的消费规则,不重写输入源或替换已确认日期;客户工时有演示标记,方案须保留试排性质。
- 汇合顺序:W2基础 helper(若W1需要)→W1解析/导入→W3消费→主控UI/工作流接线;只 cherry-pick 已提交且自检的提交,解决冲突后跑汇合态测试。
- 独立审查复用完成实施后的可用槽位,审查者不能仅自审自己模块;读取最终汇合树和真实验证证据。
## 工作区
Round:`<round-worktree>`,分支 `codex/round-87-master-data`。
W1/W2/W3 分别在同级 w1-intake / w2-master / w3-consume,分支 codex/round-87-w1-intake / codex/round-87-w2-master / codex/round-87-w3-consume。
解释器复用已有 venv;依赖只做 junction/路径复用,禁止并发安装修改共享 node_modules。测试/运行隔离 APS_HOME、DB、世界、审批、知识、审计和端口。不得改源工作簿、原 main、其他轮次或既有 .env。
每片完成 GitNexus impact、自检、必要测试、detect_changes 后及时提交,中文 commit 摘要包含结果、证据和边界。主控保持独立完整验收责任,不用 worker 的文字成功代替实际结果。