# 系统完整性审计（2026-08-01）

> 范围：`erp jingmi` 后端 + 前端 + 文档目标（五金×精密 / 博元规则 / 算数工单复用）  
> 结论摘要：**P0 演示主链路可跑通约 75%；精密仓规则半闭环；五金特性包基本未做；MES 派工层缺口大。**

---

## 1. 总体评分

| 维度 | 分 | 说明 |
|------|----|------|
| 模块骨架（菜单/路由/表） | ★★★★☆ | 11 域、46 控制器、45 前端路由、56 表 |
| P0 演示闭环 | ★★★☆☆ | 销→采→工单→报工→质检入库→发货→应收应付可演示 |
| 博元 6 条仓规则 | ★★★☆☆ | R1/R5/R6/工资侧料废工废较好；R3 耗料、R4 来源仓未落地 |
| 五金特性包 | ★☆☆☆☆ | 套装/多单位/分批发货/合同价等几乎全无 |
| 精密 MES 加深 | ★★☆☆☆ | 无派工到人/机台、齐套、WIP 报表、轻量 APS |
| 工程可运行性 | ★★★★☆ | install + seed_demo + 本地启动文档齐全；线上仅介绍站 |
| 前后端一致性 | ★★★☆☆ | 主链路对齐；3 处菜单/路由孤儿；生产 API 仍指向 xianshu |

**一句话**：够讲「精密机加通用 Demo」，不够当「工贸一体可签约全功能产品」。

---

## 2. P0 主链路检查清单

| 步骤 | 后端 | 前端 | 闭环 |
|------|------|------|------|
| 规格询价（不建料号） | ✅ Inquiry | ✅ | ⚠ 无法一键转 PO |
| 采购订单 → 入库默认毛坯库 | ✅ | ✅ | ✅ R1 |
| 销售订单 → 拆工单 | ✅ fromOrder | ✅ | ✅ |
| 工单下达 + process_target | ✅ | ✅ | ⚠ R4 未校验 |
| 无领料（拒领料） | ✅ 默认拒 | ✅ 强制领料开关 | ⚠ 报工不扣原料库存 |
| 扫码报工 + 料废/工废 | ✅ Report + Wage | ✅ PC + mobile | ✅ 工资侧 |
| 质检员定仓入库 | ✅ QcInbound | ✅ | ✅ R6 |
| 委外发料限外协库 | ✅ Outsource | ✅ | ✅ R5 |
| 发货 → 应收只读 | ✅ | ✅ | ⚠ 对账无 settle |
| 采购 → 应付只读 | ✅ | ✅ | ✅ |
| 呆滞 / 日报 / 客诉 | ✅ | ✅ | ✅ |
| IQC 门禁采购入库 | ❌ | 部分 inspections | ❌ 收货直入 |

---

## 3. 博元规则 R1–R6

| 规则 | 状态 | 缺口 |
|------|------|------|
| R1 采购进毛坯 / 外协默认仓 | ✅ | — |
| R2 粗/精加工目标 | ◐ 字段有 | 未驱动仓逻辑 |
| R3 无领料 | ◐ 拒领料 | 无「报工隐式耗料」 |
| R4 粗选自毛坯、精选自毛坯+粗 | ❌ 方法未调用 | `assertProcessSourceWarehouse` 零引用 |
| R5 外协库发料 | ✅ | — |
| R6 质检定仓 | ✅ | — |
| 料废/工废工资 | ✅ | 退供/补料后续 ❌ |

---

## 4. 五金 × 精密目标缺口（按优先级）

### 已有（可演示）

销采存、5 仓、规格询价、工单/报工/质检入库、委外、BOM/图纸/ECN、追溯/NCR/客诉、应收应付只读、MRP/标签、车间日报/工资汇总、介绍站。

### Phase A 必补（签约转化）

| 项 | 行业 | 现状 |
|----|------|------|
| 询价 → PO | 共用 | 断点 |
| 多计量单位 UI + 换算落地 | 五金 | Service 有、业务弱 |
| 套装/组套 BOM | 五金 | 无 |
| 分批/合并发货 | 五金 | 无 |
| 派工到人（可扩机台） | 精密 | 无（可复用工单） |
| IQC/IPQC/OQC 类型齐全 | 共用 | inspections 类型不全 |
| 收付款多单核销 / 订单毛利 | 共用 | 无 |
| 工单成本（料+工+外协） | 精密 | 无 |
| R3 耗料 + R4 校验 | 精密 | 未闭环 |

### Phase B

齐套、轻量 APS、返工、审批流、采购合同 PDF、等级价、直发仓、设备维养、编号打印统一、角色权限写接口。

### Phase C / 加购

外贸多币种单证、OEE、完整总账、HR。

---

## 5. 工程与一致性问题（应先修）

| 问题 | 位置 | 影响 |
|------|------|------|
| 菜单 `/qms/crimp-first` 无路由 | migrate_menus vs router | 点击 404 |
| `electrical.vue` / `tech/crimp.vue` 孤儿页 | frontend | 死代码或应删 |
| 生产 `VITE_API_BASE` 默认 xianshu | `request.js` | 部署指错后端 |
| Vite proxy 8080 vs README 8081 | vite.config | 本地联调踩坑 |
| `erp_qms_complaint` 不在 install | Complaint 运行时建表 | Schema 不一致 |
| Role 仅 list 无分配 API | backend route | 权限难改 |
| 无 DELETE 路由 | 全局 | 演示可接受 |
| 线上仅介绍站 | p.zerocod.cn/erp-jingmi | 系统本体未部署 |
| `migrate_and_build.bat` 仍指 xianshu | 根目录 | 误导 |

---

## 6. 资产盘点

| 资产 | 数量/状态 |
|------|-----------|
| 业务控制器 | 46 |
| Service | 8 |
| 数据表 | 56（+客诉运行时） |
| 前端路由 | ~45 |
| 视图 vue | 47（3 孤儿） |
| 介绍站 | ✅ https://p.zerocod.cn/erp-jingmi/ |
| 算数工单源码 | `code/gongdan`（参考，未迁入） |
| Demo 种子 | `seed_demo.php` 有 |

---

## 7. 建议修复顺序（2 周内）

1. **修一致性**：crimp-first 路由、API base、端口、complaint 进 install  
2. **补 P0 断点**：询价转 PO、R4 校验、对账 settle（或演示说明）  
3. **迁工单 P0**：派工任务 + WIP 口径 + 质检类型  
4. **五金最小集**：多单位 + 分批发货（或套装二选一先做）  
5. **部署**：frontend + backend 上到 `/erp-jingmi/`，介绍站 CTA 链到真实登录  

---

## 8. 相关文档

- [三源需求映射](./requirement-mapping.md)
- [五金×精密功能全景](./competitor-feature-map.md)
- [算数工单复用](./gongdan-reuse-map.md)
- [演示剧本](./demo-script.md)