# 委外工单与发料管理系统使用说明

## 功能概述

委外工单与发料管理系统用于管理整机委外组装场景，支持从客户下单到物料采购、发给外协厂组装、整机回库、发给客户的完整流程。

## 适用场景

**业务流程：** 客户下单 → 我方采购物料 → 发给外协厂组装 → 整机回库 → 发给客户

## 核心功能模块

### 1. 委外工单管理

**功能说明：**
- 创建委外生产订单，关联客户订单
- 自动生成委外工单号（格式：WW+年月日+4位流水号）
- 根据产品BOM自动计算所需物料及数量
- 追踪工单状态（待发料、已发料、已完成、已取消）

**操作步骤：**
1. 进入"委外管理" → "委外工单"
2. 点击"新增委外工单"
3. 填写以下信息：
   - 客户订单号：从下拉列表选择已有客户订单
   - 成品编码：输入要生产的成品编码
   - 成品名称：输入成品名称
   - 生产数量：输入委外生产的数量
   - 外协厂：输入外协厂名称
   - 交期：选择交货日期
4. 系统自动显示物料明细（根据BOM计算）
5. 点击"保存"创建工单

**字段说明：**
- **委外工单号：** 系统自动生成，唯一标识
- **客户订单号：** 关联的客户订单
- **成品编码/名称：** 要生产的整机型号
- **生产数量：** 委外生产的台数
- **外协厂：** 负责组装的外协厂商
- **交期：** 要求的交货日期
- **物料明细：** 根据BOM自动计算的所需物料清单

### 2. 委外发料管理

**功能说明：**
- 创建发料单，记录发给外协厂的物料
- 自动生成发料单号（格式：FL+年月日+4位流水号）
- 自动扣减期初库存
- 自动增加委外在制库存

**操作步骤：**
1. 进入"委外管理" → "委外发料"
2. 点击"新增发料单"
3. 选择关联的委外工单号
4. 系统自动显示该工单的物料明细和需发数量
5. 修改实际发料数量（如有需要）
6. 选择发料日期
7. 点击"确认发料"

**业务规则：**
- 发料后自动扣减"期初库存"
- 发料后自动增加"委外在制库存"
- 发料数量可以与需发数量不同（支持分批发料）

### 3. 成品入库管理

**功能说明：**
- 记录外协厂完工的整机入库
- 自动生成入库单号（格式：RK+年月日+4位流水号）
- 自动计算物料消耗
- 自动扣减委外在制库存
- 自动增加成品库存

**操作步骤：**
1. 进入"委外管理" → "成品入库"
2. 点击"新增入库单"
3. 选择关联的委外工单号
4. 系统显示工单信息和预计物料消耗
5. 输入实际入库数量
6. 选择入库日期
7. 点击"确认入库"

**业务规则：**
- 入库时根据BOM自动计算物料消耗
- 自动扣减"委外在制库存"
- 自动增加成品的"期初库存"
- 显示物料消耗明细，方便与外协厂对账

### 4. 委外在制库存查询

**功能说明：**
- 查看已发给外协厂但未完工入库的物料
- 实时显示在制库存数量
- 支持按委外工单号、物料编码/名称搜索

**查询说明：**
- **物料种类：** 当前在制的物料种类数
- **在制总数量：** 所有在制物料的总数量
- **委外工单号：** 物料所属的委外工单
- **在制数量：** 该物料当前的在制数量

## 核心业务规则

### 1. 库存流转规则

```
客户下单 → 我方采购物料
    ↓
期初库存（采购到货后增加）
    ↓
委外发料（扣减期初库存，增加委外在制库存）
    ↓
委外在制库存（物料在外协厂）
    ↓
成品入库（扣减委外在制库存，增加成品库存）
    ↓
发给客户（扣减成品库存）
```

### 2. 采购需求计算规则

- **总需求 = 订单数量 × BOM单机用量**
- **净需求 = 总需求 - 期初库存 - 在途库存**
- **实际采购 = 净需求按最小包装向上取整**

### 3. 库存类型说明

- **期初库存：** 我方仓库的实际库存
- **在途库存：** 已下单采购但未到货的库存
- **委外在制库存：** 已发给外协厂但未完工的库存
- **成品库存：** 外协厂完工入库的成品

## 典型业务流程示例

### 场景：客户订购100台AP05整机

**步骤1：创建委外工单**
- 客户订单号：CO20260313001
- 成品编码：AP05
- 成品名称：AP05物流版
- 生产数量：100台
- 外协厂：深圳XX电子厂
- 交期：2026-03-20

**步骤2：查看物料需求**
系统根据BOM自动计算：
- 电阻-10K：100个（BOM用量1个/台）
- 电容-100uF：200个（BOM用量2个/台）
- 芯片-主控：100个（BOM用量1个/台）

**步骤3：采购物料**
在"采购需求清单"中计算采购需求，下单采购

**步骤4：物料到货**
在"期初库存"中更新库存数量

**步骤5：委外发料**
- 选择委外工单：WW202603130001
- 发料日期：2026-03-14
- 发料明细：
  - 电阻-10K：100个
  - 电容-100uF：200个
  - 芯片-主控：100个

**步骤6：成品入库**
- 选择委外工单：WW202603130001
- 入库数量：100台
- 入库日期：2026-03-19
- 系统自动计算物料消耗并扣减委外在制库存

## 权限说明

- **超级管理员（superadmin）：** 所有功能的完整权限
- **管理员（admin）：** 可操作委外工单、发料、入库等功能
- **普通用户：** 仅查看权限

## 注意事项

1. **委外工单必须关联客户订单**，确保业务可追溯
2. **发料前确保期初库存充足**，避免负库存
3. **成品入库会自动扣减委外在制库存**，请确保发料记录准确
4. **物料消耗按BOM自动计算**，如有损耗需在BOM中体现
5. **已下单采购的物料仅增加在途库存**，到货后需手动更新期初库存

## 数据表结构

### 委外工单表（outsourcing_orders）
- order_no：委外工单号（唯一）
- customer_order_no：客户订单号
- product_code：成品编码
- product_name：成品名称
- production_qty：生产数量
- outsourcing_factory：外协厂
- delivery_date：交期
- status：状态

### 委外发料表（outsourcing_material_issue）
- issue_no：发料单号（唯一）
- outsourcing_order_no：委外工单号
- material_code：物料编码
- material_name：物料名称
- issue_qty：发料数量
- issue_date：发料日期

### 委外在制库存表（outsourcing_wip_stock）
- outsourcing_order_no：委外工单号
- material_code：物料编码（唯一）
- material_name：物料名称
- wip_qty：在制数量

### 成品入库表（finished_goods_receipt）
- receipt_no：入库单号（唯一）
- outsourcing_order_no：委外工单号
- product_code：产品编码
- product_name：产品名称
- receipt_qty：入库数量
- receipt_date：入库日期

## 技术支持

如有问题，请联系系统管理员或查看系统日志。