模具管理

# 模具管理模块 — 系统设计与功能说明

> 目的：讲清楚模具管理"有什么、怎么用、边界在哪、客户常问的问题怎么答"

---

## 一、模块定位（一句话）

模具管理 = **模具资产台账 + 模具采购闭环 + 寿命自动分摊**。
它管的是"模具这项资产从买入、使用到寿命耗尽的全过程"，**不是**一个仓储库存模块，也**不含**维修保养功能。

## 二、两种业务对象：模具 vs 工装夹具

系统里"模具"有双重身份，由 **模具类型（mold_types）上的"归属"字段** 决定，行为模式完全不同：

| | 模具（含模芯） | 工装夹具 |
|---|---|---|
| 归属 belong_to | 1（模具） | 2（工装夹具） |
| 寿命扣减时机 | 生产入库 / 委外入库 **审核通过时** | 生产**报工**时（按报工测试数量） |
| 领用管理 | 无领用概念 | 有：领用 → 归还 / 报废 三步 |
| 状态 | 无状态机（靠单据推断） | 空闲 FREE → 使用中 USE → 归还回 FREE 或报废 SCRAP（终态） |
| 报工校验 | 不校验 | 工位配置了必用夹具时，**未领用不能报工** |

> 实施要点：建模具类型时"归属"选错，后续寿命扣减走的通道就全错了，且档案已产生业务后很难改。**开账前务必确认每个模具类型的归属。**

## 三、功能清单与操作流程

### 3.1 模具档案（模具管理 → 模具列表）

- **新增**：料号必须唯一；保存时按"关键参数组（勾选了 is_key 的参数）"查重，若存在参数完全相同的模具，提示"料号XX具有相同参数"（提醒性质，确认后可继续）。
- **复制**：列表中选中模具可一键复制，用于"再买一套同款模具"的场景（复制后改料号/编号即可）。
- **启用/停用（is_active）**：只有 **已审核（status=3）且启用** 的模具才参与寿命分摊。
- 模具下可挂**模芯**，模芯有独立寿命，独立扣减。

### 3.2 模具采购闭环（模具管理 → 供应商模具）

标准流程：

```
① 采购合同 → 审核
② 付款计划（合同上维护：定金/发货款/尾款等分期）
③ 付款申请（按计划逐笔申请 → 审核 → 财务付款）
④ 采购合同入库 → 审核（模具做好验收，记为"在库"）
⑤ 出库单 → 审核（模具发往供应商上机生产，记为"在外"）
```

各单据说明：

| 单据 | 表名 | 说明 |
|---|---|---|
| 采购合同 | mold_supply_orders | 采购主单据，挂模具明细与付款计划 |
| 付款申请 | mold_payment_plans | 每期付款单独申请，可配审核流 |
| 入库单 | mold_supply_stockin | 供应商交付验收入库 |
| 出库单 | mold_supply_stockout | 模具外发供应商生产（见 4.1） |

**反审核防护**：采购合同一旦存在下游单据（入库单、出库单、财务分摊记录），**禁止反审核**，系统直接报错拦截。要改合同必须先逐级删除/反审核下游单据。

### 3.3 寿命分摊（核心自动逻辑，无需人工操作）

这是模具模块最核心的自动化能力，实施必须理解：

- **触发时机**：
  - 模具/模芯：**生产入库单、委外入库单审核通过**时，按入库数量自动生成分摊记录，扣减剩余寿命；
  - 工装夹具：**生产报工**时按测试数量扣减。
- **扣减规则**：剩余寿命不足时**只扣到 0，不透支为负数**，并按实际扣减比例重算该笔分摊金额。
- **分摊金额**：进入财务入库明细，实现"模具费摊入产品成本"。
- **反审核**：入库单反审核会删除对应分摊记录、寿命回冲。

> ⚠️ 实施注意（已知设计假设/风险点）：
> 1. 分摊按"产品关联的启用模具"取数，**默认一个产品同一时间只挂一套启用模具**。新旧两套同款模具同时启用会导致分摊归属混乱（见 6.3）。
> 2. 寿命扣减发生在入库审核这个动作上，与真实机台冲次可能有时间差，属正常设计。

### 3.4 模具库存与流转（重要：不是数量库存）

系统**没有模具库存余额表**。模具"在库还是在外"是靠**流转明细（mold_stock_details）最后一条记录的方向**推断的：

- 方向 = 1（入库）→ 模具在自己仓库
- 方向 = -1（出库）→ 模具在某供应商处（记录了供应商）

所以入库单/出库单的本质是**资产位置登记**，不是数量增减。

## 四、客户高频问题标准答复（实施FAQ）

### 4.1 "模具为什么还要出库？出库是什么意思？"

**出库 ≠ 卖掉/报废，而是"模具发给外部供应商使用"的登记。**

业务背景：模具通常是客户出钱做的、产权归客户，但实际生产在委外厂/注塑厂进行。模具验收入库后要拿去供应商处上机，就开出库单做交接留痕。出库单审核后记录"方向 = -1 + 供应商"，用于回答"这套模具现在在谁手里"，服务于资产盘点与责任追溯。

**出库不扣寿命**——寿命扣减靠入库分摊，是另一条独立线。

> ⚠️ 已知缺口：出库有单据，但**没有"归还单"**。模具从供应商收回时系统无标准动作记回"在库"，只能在档案备注登记。给客户解释时提前说明。

### 4.2 "申请付款后，首页待审核单据里点不进审核页面？"

分三层排查：

1. **审核流是否启用**：申请付款时系统查 `check_tables` 表中 `mold_payment_plans` 的配置——
   - 已启用 → 单据进入"待审核"（status=2）；
   - **未启用 → 直接视同审核通过（status=3）**，根本不会有待审核记录。
2. **审核操作入口在哪**：在 **"模具管理 → 供应商模具 → 付款申请"** 页面，打开待审核单据详情才显示审核节点按钮。付款计划页面看不到审核按钮，这是设计如此。
3. **首页跳转配置**：首页待审核列表按 `check_tables` 的 `route` 字段跳转。`mold_payment_plans` 的路由应为 `molds.payment_apply`。若该行 `is_active=0` 或 `route` 为空/错误，就会出现"看得到待审核、点不进去"。

**实施操作**：数据库查 `check_tables` 中 `name='mold_payment_plans'`，确认 `is_active=1`、`route='molds.payment_apply'`，并在审核流设置中配好审核节点/审核人。

### 4.3 "需要再采购一套相同的模具怎么做？"

1. 模具列表 → 选中旧模具 → **复制**，改料号（如加序号后缀 `M001-2`）。保存时会提示"具有相同参数"，同款复制属正常，确认继续；
2. 新建**模具采购合同**挂新模具 → 审核 → 按付款计划申请付款 → 交付后入库 → （需要时）出库发供应商；
3. **关键动作**：新模具启用后，**把旧模具停用（is_active 置为停用）**，或等旧模具寿命用尽再启用新模具。保证同一产品同时只有一套启用模具在扣寿命，否则分摊归属会乱。

### 4.4 "模具需要维修怎么办？"

**直接答复：当前系统没有模具维修/保养功能，属于功能边界之外。**（对比：设备有独立的"设备维保"单据和审核流，模具没有对应功能。）

现阶段变通方案：

1. **送外修**：开一张**出库单**发给维修供应商（留痕"模具在谁手里"），摘要注明"送修"；修好收回后在模具档案备注登记（无归还单，见 4.1）；
2. **维修费用**：走财务通用的费用/付款申请流程单独处理，无法自动摊入模具成本；
3. **修模延寿**：维修后寿命恢复（如换模芯）的，手工调整模具/模芯的寿命数值即可，**不要改历史分摊记录**。

如客户维修是高频需求，可作为二开需求提报：参照设备维保模式扩展"模具维修单"（维修申请→审核→送修出库→修复回库→费用登记+寿命调整），可顺带补上"出库无归还"缺口。

## 五、审核流配置总表（check_tables）

模具相关可配审核流的单据（初始 seeder 均为未启用，**以客户数据库 check_tables 实际配置为准**）：

| 单据 | 表名 | 跳转路由 | 业务分类 |
|---|---|---|---|
| 模具档案 | molds | molds | 模具设备 |
| 模具采购合同 | mold_supply_orders | — | 模具设备 |
| 模具采购入库 | mold_supply_stockin | — | 模具设备 |
| 模具付款申请 | mold_payment_plans | molds.payment_apply | 模具设备 |

> 待办事项配置（pendingConfig）中**没有任何模具相关条目**——即模具单据只有"首页待审核"通道，没有"待办事项"推送。

## 六、功能边界与已知风险点（实施必读）

### 6.1 系统"有"的

模具/模芯/夹具档案、模具类型与参数模板、采购合同、付款计划与付款申请、入库/出库（位置登记）、寿命自动分摊入成本、夹具领用归还报废、报工夹具校验、通用审核流与反审核防护。

### 6.2 系统"没有"的（客户提需求时明确告知为边界外/二开）

- ❌ 模具**维修、保养计划**、维修费用归集
- ❌ 出库后的**归还/回库单**
- ❌ **寿命预警**（寿命接近耗尽不会提醒，需人工盯剩余寿命）
- ❌ 数量化库存余额与盘点（模具是一物一档的资产逻辑）
- ❌ 模具**报废审批**流程（夹具有报废动作但无审批；模具连报废动作都没有，只能停用）
- ❌ 模具转移单（供应商A → 供应商B 直调，需先出后入变通或备注登记）

### 6.3 已知设计假设与风险

| 风险点 | 说明 | 实施对策 |
|---|---|---|
| 一产品一模具假设 | 分摊按产品取启用模具，多套同款同时启用会摊乱 | 新旧交替时及时停用旧模具 |
| 寿命扣减非原子 | 高并发审核入库时寿命扣减理论上可能有竞争 | 避免同一模具的入库单被多人同时审核 |
| 双通道消耗 | 模具走入库分摊、夹具走报工分摊，归属选错类型则通道全错 | 开账前核对模具类型的"归属"字段 |
| 状态靠推断 | 在库/在外靠最后一条流转记录推断，无归还单会导致长期显示"在外" | 向客户说明，配合台账备注管理 |

## 七、开账/上线检查清单

- [ ] 模具类型的"归属"（模具/工装夹具）逐一核对
- [ ] 模具档案料号规则确定（唯一性），关键参数组（is_key）按客户需求勾选
- [ ] 历史模具的剩余寿命期初值录入准确（直接影响后续分摊金额）
- [ ] 每个产品只挂一套启用模具
- [ ] check_tables 中模具相关单据的审核流按客户要求启用，`mold_payment_plans` 的 route 确认为 `molds.payment_apply`，审核人配置到位
- [ ] 向客户交底功能边界（第六节），维修/归还/寿命预警等需求走二开评估