aps-agent/docs/round-87-master-data-work-p...

45 lines
4.2 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 轮:主数据改得对、排产用得上
## 授权与范围
用户已明确要求创建 Goal、自主创建多个可交流子 Agent,并在测试成功后才宣告完成。本轮直接进入实施,使用此前主数据审查、锐扬指定工作簿基准与整改顺序,不重复询问已确定方向。
唯一客户输入:`<ROUND87_SOURCE>`,SHA-256 `c0598c422567a35029d32504d2020780bf6b0417e0887a9749fc86584a5aa687`。原文件不修改。数据日期为 2026-08-04;明确保留真实来源与演示补充区分。
原工作区 main@f9873ee 的 19 个已有变更文件已逐字节复制到独立 round 工作区,原目录保持不变。继承先前聊天、目录计数及一次审批一次排产修复。基线哈希与补丁位于轮次目录 evidence/source-worktree-baseline.json 和 source-worktree.patch。不合入 Round 85,不操作用户服务,不向真实工厂系统写入。
## 验收目标
1. 完整读取 16 张表的业务语义,明确分类处理,不将人员、在制、班次等关键资料标为无关而丢弃。
2. 45 个产品/物料、15 台设备、42 条 BOM、15 道工艺;5 张正式订单,SO-006 留在沙盒候选;12 条关键料、BOM 损耗、在途总量 420 及到货日期保持;工时来源不冒充实测。
3. 26 名人员、班组技能、5 条在制任务、白班/关闭晚班/设备维护、21天周期及24小时冻结映射到可消费的结构化对象,来源明确。
4. 主数据采用稳定 ID/来源映射;页面展示的导入工艺可以编辑,物料/工时/设备维护反馈到实际排产输入;重复导入不产生重复对象、库存表不覆盖其他主数据字段。
5. 维护周末班次有效;已有版本不因编辑主数据被回写。
6. 真实工作簿隔离 API/运行验收证明:库存改变→齐套变化,工时改变→新计划时长变化,设备停用→不再分配,WIP/维护/人员约束影响实际计算;沙盒插单批准前不混入正式单。
7. 简明页面能完成上传、检查、确认、维护、生成试排和查看结果;原始字段/证据可展开,危险缺项不以“可开排”掩盖。
## 实施原则
- 稳定标准对象加显式兼容投影,统一维护与消费;不通过盲目双向覆盖解决两套表。
- 已有存量数据保持,映射按明确编码/关联字段,避免把临时显示 ID 当可编辑对象。
- 模板、推断、未知与实测分开;客户表本身的演示补充仅允许带标记试排。
- 确认与工具执行复用既有 Harness 和 runtime;Pi 可辅助理解/提问,确定性数据和算法验证是事实依据。本轮不建设完整 Pi 调度中心。
- GitNexus 在修改符号前作影响分析,HIGH/CRITICAL 先告知;共享入口按受限分支改动。
- 实施 commit 只在隔离分支,中文标题与说明;提交前 detect_changes。main/push/部署不在本轮自动发布范围。
## 验证
主环境解释器:`<PYTHON_EXE>`,在各 worktree 工作目录运行;测试使用 conftest 隔离路径。
- 各片新增必要回归和真实文件只读验证,要求数据文件存在,不通过跳过把客户验收算成功。
- 主数据/导入/日历/确认/排产/契约相邻回归;Web build、Node;最后运行全量可用测试并区分外部输入跳过。
- 隔离 HTTP 实际审批与排产,完整输出输入哈希、版本、约束、前后差异和清理结果。
- 浏览器验收优先通过 CUA;若通道不可用,排查真实环境或使用已授权的测试工具;缺浏览器验收不标完整完成。
- 独立审查检查代码、业务语义、真实输入与运行结果的一致性;任何阻断发现修复后复验。
## 可行性审查
输入路径和哈希已验证;失败场景均有前轮直接证据。三个片拥有互斥代码范围,主控承担共享工作流/页面接线;每片先做真实文件检查后汇合。数据对象合同由三个片先交流并在状态文档记录,涉及另一片由主控集成。范围内变更不依赖外部凭据。长期现场生产规则确认不虚构通过。
计划审查:PASS(实施授权已由用户给出;浏览器通道是否恢复是待实时验证项)。完成后提供已测试分支和具体差异,目标分支合并前给用户可复核结果并遵守最终合并边界。