aps-agent/docs/round-87-master-data-parallel-implementation-plan.md

第 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 的文字成功代替实际结果。