# 康尼映射表数据验证报告（阶段 A）

> Round 76 更新：下方“2/10 订单”是阶段 A 历史基线，已被当前 10/10 导入与 Web 试排结果替代；设备/模具现场映射缺口仍然有效。

## Round 76 当前结果

- 订单：10/10；工艺记录：72；唯一工序：26；工时来源：72/72 为 `工时.xlsx`。
- BOM：965 条源行，按产品/物料投影后 823 条。
- BOM 对账：84 条差异用量按“订单+物料+消耗工序”显式求和，58 条完全重复记录去重；不同消耗工序分别保留。
- 资源：41 台设备、40 套模具；40 台真实设备仍无工序能力，40 套模具仍缺工序/设备/寿命映射。
- 本地 trial：10 VL / 72 WO / 10 DELAY；当前共享设备占位下总延期约 33,576.13h、利用率 0.167，只作诊断。
- Web：新建项目 -> 上传 9 份 XLSX -> 分析 -> “根据这些数据排产” -> P2 -> 五策略 -> MPS trace/gap -> 订单/设备导出已实测通过。
- 数据保护：9 份源 Excel 与上传副本 SHA-256 一致；只读 CLI 前后默认 `world.json` 不变。
- 操作手册：[kangni-real-data-browser-runbook.md](./kangni-real-data-browser-runbook.md)。

已解决的历史问题：

- `Sheet2-Sheet9` 不再按 sheet 名猜订单；工艺按工时规范序列匹配，BOM 按结构化工单编号归集。
- 主订单标准工时优先回填 `工时.xlsx`，不再保留 45/30 分钟推断值。
- 映射模板兼容带括号说明的表头。

仍待现场完成：设备-工序真实能力、模具-工序/设备/寿命、库存/在途、可动率、移动/换型和班次参数。

- 日期：2026-08-17
- 角色：康尼真实数据验证工程师（sub-agent）
- 工作区：当前仓库根目录
- 数据目录：`KANGNI_DATA_DIR`（不在 git 内）
- 运行命令：`.\.venv\Scripts\python.exe -X utf8 scripts/load_kangni.py --with-siblings --no-persist`

## 阶段 A 历史结果（已被 Round 76 替代）

导入与排产成功，映射表被实际读取：

- 订单数：2 / 10（主订单 102285668 + 同源订单 102289293）
- 设备数：41 台（40 台来自 `设备.xlsx` + 1 台共享装配设备占位）
- 模具数：40 套（全部来自 `模具.xlsx`）
- 工序种：10（仅已导入 2 个订单的并集；真实源表共 26 道）
- VL / WO：2 / 20
- 冲突：2（均为 MAJOR DELAY）
- 总延期：921.31 h
- 利用率：0.0612
- 关键推断：`设备能力映射表已读取（41 台）`、`模具适配映射表已读取（40 套）`
- 全部工序落在共享设备 `EQ-SHARED-CG-01` 上，符合“保守假设 + 待现场确认”口径

## 生成 / 修改文件

- `%KANGNI_DATA_DIR%\设备能力映射模板.xlsx`（新建，非 git）
- `%KANGNI_DATA_DIR%\模具适配映射模板.xlsx`（新建，非 git）
- `docs/development/kangni-mapping-validation.md`（本报告）
- `tests/golden/test_kangni_mapping_validation.py`（解析契约测试）

未修改 `server/**`、`apps/web/**`、`docs/CHANGELOG.md`、`docs/product/**`、`康尼项目/*.xlsx`，
也未覆盖用户目录中已生成的两份模板。

## 数据口径与假设

- 真实工序编号：来自 `工时.xlsx` 10 个订单 sheet，共 26 道；`工艺路线.xlsx` 的 Sheet2-9 与 BOM 的 `工单编号`
  对应后 8 个订单，工序集合与工时表一致。
- 真实标准工时：采用 `工时.xlsx` 每道工序在各订单中的最大值（分钟/件），写入共享设备行的“单件工时”。
- 设备：40 台真实设备全部入表，`可执行工序编号` 留空，状态按源表 `启用/停用` 映射为
  `RUNNING/MAINTENANCE`；区域编码取源表工段编号，缺省 `ZONE-CG`。40 台中无装配类设备，因此不伪称能力。
- 共享设备：`EQ-SHARED-CG-01 共享装配设备（待现场确认）` 为合成占位，覆盖全部 26 道工序；
  这是保守假设，不代表任何真实设备已确认能力。
- 模具：40 套真实模具全部入表，`适用工序编号/适配设备编号/寿命上限/已用寿命` 留空，
  `requireMold=false`，不占模具槽，全部标注“待现场确认”。
- 可动率、是否可移动、移动耗时、换型耗时、班次日历均未取得现场值，使用保守默认值。

## 发现的问题

1. `工艺路线.xlsx` 和 `BOM.xlsx` 后 8 个订单位于 `Sheet2-9`，sheet 名不是订单号；
   `parse_routing_sheet` / `parse_bom_sheet` 仅按订单号查找 sheet，导致 `--with-siblings`
   只导入 2 / 10 个订单。
2. 主订单 102285668 从 `outputs/.../订单102285668_完整生产路线.xlsx` 解析时未回填 `工时.xlsx`
   真实值，10 道工序仍按类型推断为 45 / 30 分钟；同源订单 102289293 已使用真实工时。
3. `康尼项目/设备能力映射模板.xlsx`、`模具适配映射模板.xlsx` 的表头带括号说明
   （如 `单件工时(分钟,工序:分钟;多值分号)`、`适配模具编号(逗号分隔)`），
   而 `parse_equipment_capability_map` / `parse_mold_adaptation_map` 的列别名不含括号，
   导致这两份模板即使填写了单件工时、适配模具/设备，也会被解析为空。本次未修改该目录文件；
   新建于 `康尼/数据` 的两份映射表使用解析器精确表头，已验证可完整解析。

## 缺什么

- 设备 → 工序真实能力映射（当前仅共享设备占位）
- 模具 → 工序 / 适配设备 / 寿命上限 / 已用寿命映射
- 8 个订单的 sheet 命名或按 `工单编号` 列解析的导入支持
- 主订单真实工时回填
- 可动率、移动耗时、换型耗时、班次日历、库存 / 在途等现场参数

## 下一步

- 由现场确认 26 道工序实际使用哪些设备/工装，再回填 `康尼/数据` 两份映射表；
- 将工艺/BOM 的 Sheet2-9 重命名或增强导入解析（需 `server` 改动，本 sub-agent 不擅自改）；
- 补齐主订单工时回填后，重跑 10 订单全量导入并核对延期/利用率。

## 协作沟通记录

本 sub-agent 会话未暴露 `multi_agent_v1__send_input` 工具（函数列表与 MCP 资源均为空），
因此无法直接向 peer 发送消息。以下为已备好、供 supervisor/协调层转发的中文消息：

握手（发给 `01a00bc6-091a-7110-a7d7-22604e1cdd85` MPS 计划台接线、
`01a00bc6-2106-7831-bbcc-f722bcdf37ff` 策略/导出增强）：

> 我是康尼真实数据验证工程师。我的数据范围：`康尼/数据` 的工艺路线/工时/设备/模具/订单/BOM，
> 输出 `设备能力映射模板.xlsx` 与 `模具适配映射模板.xlsx`（40 真实设备 + 1 共享设备占位、
> 40 套真实模具，能力/适配均标注“待现场确认”）。预计在 2026-08-17 完成导入验证与报告。
> 请确认共享工作区可读可写；如你们涉及订单结构、设备/模具主数据口径，请同步告知。

完成摘要（发给两位 peer）：

> 康尼映射验证完成。已生成/更新 `康尼/数据` 两份映射表并跑通
> `load_kangni.py --with-siblings --no-persist`：读取 41 台设备、40 套模具，
> 2 订单/20 WO，冲突 2，总延期 921.31h，利用率 0.0612，全部工序走共享设备占位。
> 注意：真实源表共 26 道工序，但工艺/BOM 后 8 个订单在 Sheet2-9（sheet 名非订单号），
> 当前导入只覆盖 2 个订单；主订单工时仍为推断值；康尼项目模板表头带括号说明，解析器读不到
> 单件工时/适配模具/适配设备。需要你们在 MPS/导出侧按“2 订单 + 共享设备”口径处理，
> 完整 10 订单能力待现场确认后重跑。

2026-08-17 收到 supervisor 转发的 peer `01a00bc6-091a-7110-a7d7-22604e1cdd85`（MPS 计划台接线）
握手与完成摘要：其范围为 client.ts/types.ts/PlanBucketsView.tsx MPS 页签、mps_api.py 契约小修、
test_mps_planning.py，不碰 engines/flex/reports/docs/康尼项目；persist/trace/gap 接线完成，
mps_planning 9 passed + contract_sync 12 passed + build:web 通过；调用 `/api/mps/persist` 时
`createdBy` 请使用 `LLM/USER/SYSTEM`。已核对共享工作区存在对应未提交改动
（`server/gateway/mps_api.py`、`server/aps_domain/mps_planning.py` 等），与 peer 描述一致。

回复文本（供 supervisor 转发给该 peer）：

> 收到，握手和完成摘要已确认。我的数据侧口径：26 道真实工序、40 台真实设备 + 1 台共享设备占位、
> 40 套真实模具，映射均标注“待现场确认”；`load_kangni.py --with-siblings --no-persist`
> 当前只导入 2 个订单，全部工序走 `EQ-SHARED-CG-01`。`createdBy` 我会按 `LLM/USER/SYSTEM`
> 口径使用，不额外引入自定义值。需要你们在 MPS 侧把 2 订单共享设备结果视为保守占位，
> 完整 10 订单待 Sheet2-9/工时回填问题解决后重跑。