aps-agent/docs/development/kangni-real-data-browser-runbook.md

康尼真实数据 Web 试排操作手册

更新日期：2026-08-18

1. 使用边界

本流程用于康尼真实数据的本地 APS 试排，停止在真实 MES 下发前。当前设备/模具映射仍未现场确认，系统必须显示 productionReady=false；任何延期、利用率和推荐策略都只能作为试排诊断，不能作为生产承诺。

2. 打开工作台

• 本轮隔离验收地址：http://127.0.0.1:5186/
• 常规本地开发地址：http://localhost:5173/

页面标题应为“APS 智能排产工作台”，浏览器 console 不应出现 warning/error。

3. 创建项目并上传数据

1. 左侧“项目”右侧点击 +。
2. 项目名称填写“康尼真实数据试排”，工程目录留空，点击“创建”。
3. 打开项目的“项目操作” -> “文件”。
4. 点击“上传”，一次选择以下 9 份文件：
   • 订单.xlsx
   • 工艺路线.xlsx
   • 工时.xlsx
   • BOM.xlsx
   • 设备.xlsx
   • 模具.xlsx
   • 物料.xlsx
   • 设备能力映射模板.xlsx
   • 模具适配映射模板.xlsx
5. 页面应显示“已上传 9 个文件到项目目录”。

原始 Excel 只读；上传文件写入当前项目隔离目录，不覆盖源文件。

4. 分析与 P2 试排

1. 在对话框输入：分析一下数据文件。
2. 分析结果应识别 10 个订单、72 条工艺记录和 823 条投影 BOM。
3. 输入：根据这些数据排产。
   • 不要用“跑一版柔性排产”代替这一步；后者是已入库世界的严格排产口令。
4. 检查 P2 卡：
   • 冻结工作簿：9 份
   • 订单：10
   • 工艺记录：72
   • 设备：41
   • 模具：40
   • productionReady=false
   • 明确写有“共享占位、仅试排、不得生产发布或下发 MES”
5. 点击“批准执行”。

批准后应显示：

• salesOrders=10
• flexOrders=10
• flexRoutings=72
• flexEquipment=41
• flexMolds=40
• 虚拟产线 10、工单 72、冲突 10

5. 查看策略和结果

1. 打开右侧“柔性工作台”。
2. “排产”页应显示“柔性订单（10）”。
3. 点击“五模式对比”。
4. 应出现：正排、倒排、瓶颈锚、齐套优先、技能优先。
5. 齐套/技能数据不足的策略应显示降级证据，不得进入推荐；当前推荐状态应为 TRIAL_ONLY。
6. “当前试排结果”区域可点击：
   • “订单方案”
   • “设备方案”

两个下载都显式绑定当前 versionId，不会默认回落到其它最新草稿。

6. 保存 MPS 并关联试排版本

1. 在对话中输入：时间分桶计划。
2. 打开右侧“会话结果”，选择“分桶计划”。
3. 点击“MPS 草稿”。
4. 点击“保存草稿”，页面应显示 TR-... 追踪号。
5. 在“本地排产版本”选择当前柔性版本，例如 flex/FV...。
6. 点击“关联采用版本”。
7. 追踪事件应变为：OPEN -> SCHEDULE -> ADOPT。
8. 点击“gap 对比”，检查计划需求、排程工单、需求缺口、负荷差和风险差。

本轮不要点击“记录发布事实”，因为当前版本是 DRAFT trial；更不要进入“MES 执行”下发。

7. 当前结果口径

• 数据链已验证：10/10 订单、72 条工序、26 个唯一工序、965 条源 BOM、823 条投影 BOM。
• 72/72 工序工时来自 工时.xlsx。
• 40/41 台设备没有真实工序能力，唯一覆盖者为共享占位设备。
• 40 套模具均缺工序、适配设备和寿命上限。
• 当前延期和利用率只反映占位资源模型，现场补齐映射后必须重新试排。