# MOM系统数据升级方案 — 销售、采购、生产计划模块

> 版本: 1.1.0  
> 创建日期: 2026-02-06  
> 更新日期: 2026-02-07  
> 基于: ERP数据字典 / erp数据库设计-DDL.sql / 映射对照表 v1.2.0

---

## 1. 升级背景

MOM系统当前定位为**生产执行层**，不直接管理销售订单、采购订单和生产计划。但随着ERP系统集成深化，MOM需要存储来自ERP的计划层数据以支撑：
- 生产排程时查看销售订单交期
- 领料时关联采购订单溯源
- 工单下发时保留计划单完整信息

本方案对比两系统在三大模块的数据模型差异，给出MOM侧的具体升级动作。

---

## 2. 现状对比总览

### 2.1 三模块表级覆盖率

| 模块 | ERP表数量 | MOM已有映射表 | MOM缺失 | 覆盖率 |
|------|----------|-------------|---------|--------|
| 销售管理 | 10 (含合同/发票) | 3 (间接: workorder+出库) | 销售订单独立存储、合同、发票 | 30% |
| 采购管理 | 9 (含发票) | 4 (到货通知+入库+退料) | 采购订单独立存储、发票 | 44% |
| 生产计划 | 6 | 2 (workorder+workorder_bom) | 计划单独立存储、物料清单、采购计划 | 33% |

### 2.2 关键差距

| 差距项 | 说明 | 影响 |
|--------|------|------|
| **无销售订单表** | 订单信息仅作为source_code存储在pro_workorder中 | 无法查看订单完整信息（客户/金额/交期/明细） |
| **无采购订单表** | 采购单号仅作为po_code存储在wm_arrival_notice中 | 无法追溯采购进度（下单/到货/入库链路） |
| **无生产计划单表** | 计划信息合并到pro_workorder | 丢失计划层的BOM版本/关联订单/齐套状态 |
| **无计划物料清单(MBOM)** | ERP的BOM计算结果无处存储 | 无法展示按供应方式拆解后的完整用料需求 |
| **无采购计划表** | ERP采购计划仅映射到wm_arrival_notice | 丢失计划采购量/已订量/缺口量等跟踪信息 |
| **pro_workorder缺字段** | 缺少ERP计划层的关键字段 | 缺少bom_version/bom_desc/sales_user/delivery_date等 |

---

## 3. 升级方案

### 3.1 方案总览

| 序号 | 升级动作 | 类型 | 优先级 | 说明 |
|------|----------|------|--------|------|
| A1 | 新建 `erp_sl_order` | 新建表 | P0 | 销售订单表头（接收ERP数据） |
| A2 | 新建 `erp_sl_order_line` | 新建表 | P0 | 销售订单明细 |
| A3 | 新建 `erp_po_order` | 新建表 | P0 | 采购订单表头（接收ERP数据） |
| A4 | 新建 `erp_po_order_line` | 新建表 | P0 | 采购订单明细 |
| A5 | 新建 `erp_mp_plan` | 新建表 | P0 | 生产计划单表头（接收ERP数据） |
| A6 | 新建 `erp_mp_plan_line` | 新建表 | P0 | 生产计划单明细 |
| A7 | 新建 `erp_mp_mbom` | 新建表 | P1 | 计划物料清单表头 |
| A8 | 新建 `erp_mp_mbom_line` | 新建表 | P1 | 计划物料清单明细 |
| A9 | 新建 `erp_mp_purchase` | 新建表 | P1 | 采购计划单 |
| B1 | 修改 `pro_workorder` | ALTER | P0 | 新增ERP计划关联字段 |
| B2 | 修改 `wm_item_recpt` | ALTER | P1 | 新增采购订单关联字段 |
| B3 | 修改 `wm_arrival_notice` | ALTER | P1 | 增强采购单关联 |

### 3.2 命名规范

新建表统一采用 `erp_` 前缀，与MOM已有的ERP同步表保持一致（如 `erp_md_item`、`erp_md_bom_line`），便于识别数据来源：

| 表前缀 | 含义 | 举例 |
|--------|------|------|
| `erp_sl_` | 同步自ERP销售模块 | erp_sl_order |
| `erp_po_` | 同步自ERP采购模块 | erp_po_order |
| `erp_mp_` | 同步自ERP生产计划模块 | erp_mp_plan |
| `pro_` | MOM原生生产执行表 | pro_workorder (已有) |
| `wm_` | MOM原生仓库管理表 | wm_item_recpt (已有) |

---

## 4. 销售模块升级 (P0)

### 4.1 新建: 销售订单表头 (erp_sl_order)

> 用途: 接收ERP销售订单审核后的数据，供生产排程和发货查询使用。只存储MOM关心的字段，不含合同/发票等财务信息。

```sql
DROP TABLE IF EXISTS `erp_sl_order`;
CREATE TABLE `erp_sl_order` (
  `order_id` bigint(20) NOT NULL COMMENT '订单ID (同步自ERP)',
  `tenant_id` varchar(20) DEFAULT NULL COMMENT '租户ID',
  `order_code` varchar(32) NOT NULL COMMENT '订单编码',
  `order_name` varchar(100) DEFAULT NULL COMMENT '订单名称',
  `order_date` date DEFAULT NULL COMMENT '订单日期',
  `status` varchar(20) DEFAULT 'DRAFT' COMMENT '单据状态(DRAFT/APPROVED/CLOSED)',
  `business_status` varchar(20) DEFAULT 'NORMAL' COMMENT '业务状态',
  `order_type` varchar(20) DEFAULT NULL COMMENT '订单类型(销售/备货)',
  `contract_id` bigint(20) DEFAULT NULL COMMENT '合同ID',
  `contract_code` varchar(32) DEFAULT NULL COMMENT '合同编码',
  `client_id` bigint(20) DEFAULT NULL COMMENT '客户ID',
  `client_code` varchar(32) DEFAULT NULL COMMENT '客户编码',
  `client_name` varchar(100) DEFAULT NULL COMMENT '客户名称',
  `sales_user_id` bigint(20) DEFAULT NULL COMMENT '销售员ID',
  `sales_user_name` varchar(50) DEFAULT NULL COMMENT '销售员名称',
  `dept_id` bigint(20) DEFAULT NULL COMMENT '部门ID',
  `dept_name` varchar(50) DEFAULT NULL COMMENT '部门名称',
  `delivery_date` date DEFAULT NULL COMMENT '交货日期',
  `delivery_address` varchar(200) DEFAULT NULL COMMENT '收货地址',
  `total_quantity` decimal(18,4) DEFAULT 0 COMMENT '总数量',
  `total_amount` decimal(18,2) DEFAULT 0 COMMENT '总金额',
  `delivered_quantity` decimal(18,4) DEFAULT 0 COMMENT '已发货数量',
  `delivered_amount` decimal(18,2) DEFAULT 0 COMMENT '已发货金额',
  `pp_number` varchar(50) DEFAULT NULL COMMENT '跟单编号',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `operator_id` bigint(20) DEFAULT NULL COMMENT '操作员ID',
  `operator_name` varchar(50) DEFAULT NULL COMMENT '操作员名称',
  `approver_id` bigint(20) DEFAULT NULL COMMENT '审核员ID',
  `approver_name` varchar(50) DEFAULT NULL COMMENT '审核员名称',
  `approve_date` datetime DEFAULT NULL COMMENT '审核日期',
  `erp_sync_time` datetime DEFAULT NULL COMMENT 'ERP同步时间',
  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`order_id`),
  UNIQUE KEY `uk_sl_order_code` (`order_code`, `tenant_id`),
  KEY `idx_sl_order_client` (`client_id`),
  KEY `idx_sl_order_date` (`delivery_date`),
  KEY `idx_sl_order_pp` (`pp_number`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='销售订单表头(同步自ERP)';
```

**与ERP字段对照:** 已按《erp数据库设计-数据字典》与 DDL 补齐与 ERP 同名字段，保证 1:1 同步时字段一致。pp_number、erp_sync_time 为 MOM 扩展字段。

### 4.2 新建: 销售订单明细 (erp_sl_order_line)

```sql
DROP TABLE IF EXISTS `erp_sl_order_line`;
CREATE TABLE `erp_sl_order_line` (
  `line_id` bigint(20) NOT NULL COMMENT '明细ID (同步自ERP)',
  `order_id` bigint(20) NOT NULL COMMENT '订单ID',
  `order_code` varchar(32) NOT NULL COMMENT '订单编码',
  `line_no` int DEFAULT NULL COMMENT '行号',
  `track_code` varchar(32) DEFAULT NULL COMMENT '跟单编号',
  `contract_line_id` bigint(20) DEFAULT NULL COMMENT '合同明细ID',
  `item_id` bigint(20) NOT NULL COMMENT '物料ID',
  `item_code` varchar(64) DEFAULT NULL COMMENT '物料编码',
  `item_name` varchar(255) DEFAULT NULL COMMENT '物料名称',
  `specification` varchar(500) DEFAULT NULL COMMENT '规格型号',
  `unit_id` bigint(20) DEFAULT NULL COMMENT '计量单位ID',
  `unit_of_measure` varchar(64) DEFAULT NULL COMMENT '计量单位',
  `unit_name` varchar(64) DEFAULT NULL COMMENT '单位名称',
  `quantity` decimal(18,4) NOT NULL DEFAULT 0 COMMENT '订单数量',
  `unit_price` decimal(18,4) DEFAULT 0 COMMENT '单价',
  `amount` decimal(18,2) DEFAULT 0 COMMENT '金额',
  `delivered_qty` decimal(18,4) DEFAULT 0 COMMENT '已发货数量',
  `quality_req` varchar(200) DEFAULT NULL COMMENT '质量要求',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志',
  `tenant_id` varchar(20) DEFAULT NULL COMMENT '租户ID',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`line_id`),
  KEY `idx_sl_order_line_oid` (`order_id`),
  KEY `idx_sl_order_line_item` (`item_id`),
  KEY `idx_sl_order_line_track` (`track_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='销售订单明细(同步自ERP)';
```

---

## 5. 采购模块升级 (P0)

### 5.1 新建: 采购订单表头 (erp_po_order)

> 用途: 接收ERP采购订单数据，用于入库时关联溯源、齐套检查时查看采购进度。

```sql
DROP TABLE IF EXISTS `erp_po_order`;
CREATE TABLE `erp_po_order` (
  `order_id` bigint(20) NOT NULL COMMENT '订单ID (同步自ERP)',
  `tenant_id` varchar(20) DEFAULT NULL COMMENT '租户ID',
  `order_code` varchar(32) NOT NULL COMMENT '订单编码',
  `order_date` date DEFAULT NULL COMMENT '订单日期',
  `status` varchar(20) DEFAULT 'DRAFT' COMMENT '单据状态',
  `business_status` varchar(20) DEFAULT 'NORMAL' COMMENT '业务状态',
  `business_type` varchar(20) DEFAULT NULL COMMENT '业务类型',
  `order_type` varchar(20) DEFAULT NULL COMMENT '单据类型',
  `material_need` varchar(20) DEFAULT NULL COMMENT '用料需求',
  `supplier_id` bigint(20) DEFAULT NULL COMMENT '供应商ID (与ERP一致)',
  `supplier_code` varchar(32) DEFAULT NULL COMMENT '供应商编码',
  `supplier_name` varchar(100) DEFAULT NULL COMMENT '供应商名称',
  `dept_id` bigint(20) DEFAULT NULL COMMENT '采购部门ID',
  `dept_name` varchar(50) DEFAULT NULL COMMENT '采购部门名称',
  `user_id` bigint(20) DEFAULT NULL COMMENT '采购人员ID',
  `user_name` varchar(50) DEFAULT NULL COMMENT '采购人员名称',
  `delivery_date` date DEFAULT NULL COMMENT '到货日期',
  `contract_no` varchar(50) DEFAULT NULL COMMENT '合同号',
  `contract_file` varchar(500) DEFAULT NULL COMMENT '合同附件',
  `total_quantity` decimal(18,4) DEFAULT 0 COMMENT '总数量',
  `total_amount` decimal(18,2) DEFAULT 0 COMMENT '总金额',
  `arrived_quantity` decimal(18,4) DEFAULT 0 COMMENT '已到货数量',
  `plan_code` varchar(32) DEFAULT NULL COMMENT '关联计划单编码',
  `pp_number` varchar(50) DEFAULT NULL COMMENT '跟单编号',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `operator_id` bigint(20) DEFAULT NULL COMMENT '操作员ID',
  `operator_name` varchar(50) DEFAULT NULL COMMENT '操作员名称',
  `approver_id` bigint(20) DEFAULT NULL COMMENT '审核员ID',
  `approver_name` varchar(50) DEFAULT NULL COMMENT '审核员名称',
  `approve_date` datetime DEFAULT NULL COMMENT '审核日期',
  `erp_sync_time` datetime DEFAULT NULL COMMENT 'ERP同步时间',
  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`order_id`),
  UNIQUE KEY `uk_po_order_code` (`order_code`, `tenant_id`),
  KEY `idx_po_order_supplier` (`supplier_id`),
  KEY `idx_po_order_date` (`delivery_date`),
  KEY `idx_po_order_pp` (`pp_number`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='采购订单表头(同步自ERP)';
```

### 5.2 新建: 采购订单明细 (erp_po_order_line)

```sql
DROP TABLE IF EXISTS `erp_po_order_line`;
CREATE TABLE `erp_po_order_line` (
  `line_id` bigint(20) NOT NULL COMMENT '明细ID (同步自ERP)',
  `order_id` bigint(20) NOT NULL COMMENT '订单ID',
  `order_code` varchar(32) NOT NULL COMMENT '订单编码',
  `line_no` int DEFAULT NULL COMMENT '行号',
  `track_code` varchar(32) DEFAULT NULL COMMENT '跟单编号',
  `plan_code` varchar(32) DEFAULT NULL COMMENT '计划单号',
  `plan_line_id` bigint(20) DEFAULT NULL COMMENT '计划明细ID',
  `item_id` bigint(20) NOT NULL COMMENT '物料ID',
  `item_code` varchar(64) DEFAULT NULL COMMENT '物料编码',
  `item_name` varchar(255) DEFAULT NULL COMMENT '物料名称',
  `specification` varchar(500) DEFAULT NULL COMMENT '型号规格',
  `unit_id` bigint(20) DEFAULT NULL COMMENT '计量单位ID',
  `unit_of_measure` varchar(64) DEFAULT NULL COMMENT '计量单位',
  `unit_name` varchar(64) DEFAULT NULL COMMENT '单位名称',
  `need_date` date DEFAULT NULL COMMENT '需求日期',
  `quantity` decimal(18,4) NOT NULL DEFAULT 0 COMMENT '采购数量',
  `unit_price` decimal(18,4) DEFAULT 0 COMMENT '采购单价',
  `amount` decimal(18,2) DEFAULT 0 COMMENT '金额',
  `arrived_quantity` decimal(18,4) DEFAULT 0 COMMENT '已到货数量',
  `remark` varchar(500) DEFAULT NULL COMMENT '采购说明',
  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志',
  `tenant_id` varchar(20) DEFAULT NULL COMMENT '租户ID',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`line_id`),
  KEY `idx_po_order_line_oid` (`order_id`),
  KEY `idx_po_order_line_item` (`item_id`),
  KEY `idx_po_order_line_track` (`track_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='采购订单明细(同步自ERP)';
```

---

## 6. 生产计划模块升级 (P0)

### 6.1 新建: 生产计划单表头 (erp_mp_plan)

> 用途: 接收ERP生产计划单数据，保留计划层的完整信息（BOM版本、关联销售订单、计划数量等），pro_workorder通过source_code关联。

```sql
DROP TABLE IF EXISTS `erp_mp_plan`;
CREATE TABLE `erp_mp_plan` (
  `plan_id` bigint(20) NOT NULL COMMENT '计划ID (同步自ERP)',
  `tenant_id` varchar(20) DEFAULT NULL COMMENT '租户ID',
  `plan_code` varchar(32) NOT NULL COMMENT '计划单编码',
  `plan_date` date DEFAULT NULL COMMENT '计划日期',
  `status` varchar(20) DEFAULT 'DRAFT' COMMENT '单据状态',
  `business_status` varchar(20) DEFAULT 'NORMAL' COMMENT '业务状态',
  `business_type` varchar(20) DEFAULT NULL COMMENT '业务类型',
  `work_type` int DEFAULT 0 COMMENT '工作类型(0计划单/1零部件计划/2零部件订单)',
  `sales_order_id` bigint(20) DEFAULT NULL COMMENT '销售订单ID',
  `sales_order_code` varchar(32) DEFAULT NULL COMMENT '销售订单编码',
  `sales_user_id` bigint(20) DEFAULT NULL COMMENT '销售员ID',
  `sales_user_name` varchar(50) DEFAULT NULL COMMENT '销售员名称',
  `delivery_date` date DEFAULT NULL COMMENT '订单交期',
  `bom_id` bigint(20) DEFAULT NULL COMMENT 'BOM ID',
  `bom_version` varchar(20) DEFAULT NULL COMMENT 'BOM版本号',
  `bom_desc` varchar(200) DEFAULT NULL COMMENT 'BOM版本说明',
  `total_quantity` decimal(18,4) DEFAULT 0 COMMENT '生产总量',
  `pp_number` varchar(50) DEFAULT NULL COMMENT '跟单编号',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `operator_id` bigint(20) DEFAULT NULL COMMENT '操作员ID',
  `operator_name` varchar(50) DEFAULT NULL COMMENT '操作员名称',
  `approver_id` bigint(20) DEFAULT NULL COMMENT '审核员ID',
  `approver_name` varchar(50) DEFAULT NULL COMMENT '审核员名称',
  `approve_date` datetime DEFAULT NULL COMMENT '审核日期',
  `erp_sync_time` datetime DEFAULT NULL COMMENT 'ERP同步时间',
  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`plan_id`),
  UNIQUE KEY `uk_mp_plan_code` (`plan_code`, `tenant_id`),
  KEY `idx_mp_plan_sales` (`sales_order_code`),
  KEY `idx_mp_plan_date` (`plan_date`),
  KEY `idx_mp_plan_pp` (`pp_number`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='生产计划单表头(同步自ERP)';
```

### 6.2 新建: 生产计划单明细 (erp_mp_plan_line)

```sql
DROP TABLE IF EXISTS `erp_mp_plan_line`;
CREATE TABLE `erp_mp_plan_line` (
  `line_id` bigint(20) NOT NULL COMMENT '明细ID (同步自ERP)',
  `plan_id` bigint(20) NOT NULL COMMENT '计划ID',
  `plan_code` varchar(32) NOT NULL COMMENT '计划单编码',
  `line_no` int DEFAULT NULL COMMENT '行号',
  `sales_line_id` bigint(20) DEFAULT NULL COMMENT '销售订单明细ID',
  `track_code` varchar(32) DEFAULT NULL COMMENT '跟单编号',
  `item_id` bigint(20) NOT NULL COMMENT '产品物料ID',
  `item_code` varchar(64) DEFAULT NULL COMMENT '产品物料编码',
  `item_name` varchar(255) DEFAULT NULL COMMENT '产品物料名称',
  `specification` varchar(500) DEFAULT NULL COMMENT '规格型号',
  `unit_id` bigint(20) DEFAULT NULL COMMENT '计量单位ID',
  `unit_of_measure` varchar(64) DEFAULT NULL COMMENT '计量单位',
  `unit_name` varchar(64) DEFAULT NULL COMMENT '单位名称',
  `quantity` decimal(18,4) NOT NULL DEFAULT 0 COMMENT '计划数量',
  `supply_type` varchar(20) DEFAULT NULL COMMENT '供应方式',
  `quality_req` varchar(200) DEFAULT NULL COMMENT '质量要求',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志',
  `tenant_id` varchar(20) DEFAULT NULL COMMENT '租户ID',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`line_id`),
  KEY `idx_mp_plan_line_pid` (`plan_id`),
  KEY `idx_mp_plan_line_item` (`item_id`),
  KEY `idx_mp_plan_line_sales` (`sales_line_id`),
  KEY `idx_mp_plan_line_track` (`track_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='生产计划单明细(同步自ERP)';
```

---

## 7. 生产计划模块升级 (P1)

### 7.1 新建: 计划物料清单表头 (erp_mp_mbom)

> 用途: 接收ERP BOM计算后的物料需求清单，按供应方式拆解（生产/采购/委外），支撑齐套检查。

```sql
DROP TABLE IF EXISTS `erp_mp_mbom`;
CREATE TABLE `erp_mp_mbom` (
  `mbom_id` bigint(20) NOT NULL COMMENT '物料清单ID (同步自ERP)',
  `tenant_id` varchar(20) DEFAULT NULL COMMENT '租户ID',
  `mbom_code` varchar(32) NOT NULL COMMENT '物料清单编码',
  `mbom_date` date DEFAULT NULL COMMENT '单据日期',
  `status` varchar(20) DEFAULT 'DRAFT' COMMENT '单据状态',
  `business_type` varchar(20) DEFAULT NULL COMMENT '业务类型',
  `issue_status` varchar(20) DEFAULT NULL COMMENT '下发状态',
  `plan_id` bigint(20) NOT NULL COMMENT '生产计划ID',
  `plan_code` varchar(32) NOT NULL COMMENT '生产计划编码',
  `sales_order_id` bigint(20) DEFAULT NULL COMMENT '销售订单ID',
  `sales_order_code` varchar(32) DEFAULT NULL COMMENT '销售订单编码',
  `delivery_date` date DEFAULT NULL COMMENT '订单交期',
  `item_id` bigint(20) NOT NULL COMMENT '产品物料ID',
  `item_code` varchar(64) DEFAULT NULL COMMENT '产品物料编码',
  `item_name` varchar(255) DEFAULT NULL COMMENT '产品物料名称',
  `unit_name` varchar(64) DEFAULT NULL COMMENT '计量单位',
  `supply_type` varchar(20) DEFAULT NULL COMMENT '供应方式(生产/加工/装配/委外/采购)',
  `quantity` decimal(18,4) NOT NULL DEFAULT 0 COMMENT '生产数量',
  `workshop_id` bigint(20) DEFAULT NULL COMMENT '下发车间ID',
  `workshop_name` varchar(50) DEFAULT NULL COMMENT '下发车间名称',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `operator_id` bigint(20) DEFAULT NULL COMMENT '操作员ID',
  `operator_name` varchar(50) DEFAULT NULL COMMENT '操作员名称',
  `approver_id` bigint(20) DEFAULT NULL COMMENT '审核员ID',
  `approver_name` varchar(50) DEFAULT NULL COMMENT '审核员名称',
  `approve_date` datetime DEFAULT NULL COMMENT '审核日期',
  `completed_qty` decimal(18,4) DEFAULT 0 COMMENT '已完成数量(MOM回写)',
  `workorder_id` bigint(20) DEFAULT NULL COMMENT '关联MOM工单ID(MOM扩展)',
  `workorder_code` varchar(64) DEFAULT NULL COMMENT '关联MOM工单编码(MOM扩展)',
  `pp_number` varchar(50) DEFAULT NULL COMMENT '跟单编号(MOM扩展)',
  `erp_sync_time` datetime DEFAULT NULL COMMENT 'ERP同步时间',
  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`mbom_id`),
  KEY `idx_mp_mbom_plan` (`plan_id`),
  KEY `idx_mp_mbom_item` (`item_id`),
  KEY `idx_mp_mbom_wo` (`workorder_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='计划物料清单表头(同步自ERP)';
```

### 7.2 新建: 计划物料清单明细 (erp_mp_mbom_line)

> 与 ERP `erp_mp_mbom_line` 字段一致，保证 1:1 同步。

```sql
DROP TABLE IF EXISTS `erp_mp_mbom_line`;
CREATE TABLE `erp_mp_mbom_line` (
  `line_id` bigint(20) NOT NULL COMMENT '明细ID (同步自ERP)',
  `mbom_id` bigint(20) NOT NULL COMMENT '物料清单ID',
  `mbom_code` varchar(32) NOT NULL COMMENT '物料清单编码',
  `line_no` int DEFAULT NULL COMMENT '行号',
  `parent_item_id` bigint(20) DEFAULT NULL COMMENT '父级物料ID',
  `bom_level` int DEFAULT 1 COMMENT 'BOM层级',
  `item_id` bigint(20) NOT NULL COMMENT '子件物料ID',
  `item_code` varchar(64) DEFAULT NULL COMMENT '子件物料编码',
  `item_name` varchar(255) DEFAULT NULL COMMENT '子件物料名称',
  `specification` varchar(500) DEFAULT NULL COMMENT '型号规格',
  `unit_name` varchar(64) DEFAULT NULL COMMENT '计量单位',
  `base_qty` decimal(18,6) DEFAULT 1 COMMENT '基本用量',
  `quantity` decimal(18,4) NOT NULL DEFAULT 0 COMMENT '需求数量',
  `loss_rate` decimal(5,2) DEFAULT 0 COMMENT '损耗率(%)',
  `supply_type` varchar(20) DEFAULT NULL COMMENT '供应方式',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志',
  `tenant_id` varchar(20) DEFAULT NULL COMMENT '租户ID',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`line_id`),
  KEY `idx_mp_mbom_line_mbom` (`mbom_id`),
  KEY `idx_mp_mbom_line_item` (`item_id`),
  KEY `idx_mp_mbom_line_parent` (`parent_item_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='计划物料清单明细(同步自ERP)';
```

### 7.3 新建: 采购计划单 (erp_mp_purchase)

```sql
DROP TABLE IF EXISTS `erp_mp_purchase`;
CREATE TABLE `erp_mp_purchase` (
  `purchase_id` bigint(20) NOT NULL COMMENT '采购计划ID (同步自ERP)',
  `tenant_id` varchar(20) DEFAULT NULL COMMENT '租户ID',
  `purchase_code` varchar(32) NOT NULL COMMENT '采购计划编码',
  `purchase_date` date DEFAULT NULL COMMENT '计划日期',
  `status` varchar(20) DEFAULT 'DRAFT' COMMENT '单据状态',
  `need_type` int DEFAULT 0 COMMENT '需求方式(0订单用料/1库存备料)',
  `plan_id` bigint(20) DEFAULT NULL COMMENT '生产计划ID',
  `plan_code` varchar(32) DEFAULT NULL COMMENT '生产计划编码',
  `sales_order_id` bigint(20) DEFAULT NULL COMMENT '销售订单ID',
  `sales_order_code` varchar(32) DEFAULT NULL COMMENT '销售订单编码',
  `delivery_date` date DEFAULT NULL COMMENT '订单交期',
  `item_id` bigint(20) NOT NULL COMMENT '物料ID',
  `item_code` varchar(64) DEFAULT NULL COMMENT '物料编码',
  `item_name` varchar(255) DEFAULT NULL COMMENT '物料名称',
  `specification` varchar(500) DEFAULT NULL COMMENT '型号规格',
  `unit_name` varchar(64) DEFAULT NULL COMMENT '计量单位',
  `purchase_qty` decimal(18,4) NOT NULL DEFAULT 0 COMMENT '采购数量',
  `ordered_qty` decimal(18,4) DEFAULT 0 COMMENT '已下单数量',
  `arrived_qty` decimal(18,4) DEFAULT 0 COMMENT '已到货数量(MOM扩展)',
  `pp_number` varchar(50) DEFAULT NULL COMMENT '跟单编号(MOM扩展)',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  `operator_id` bigint(20) DEFAULT NULL COMMENT '操作员ID',
  `operator_name` varchar(50) DEFAULT NULL COMMENT '操作员名称',
  `approver_id` bigint(20) DEFAULT NULL COMMENT '审核员ID',
  `approver_name` varchar(50) DEFAULT NULL COMMENT '审核员名称',
  `approve_date` datetime DEFAULT NULL COMMENT '审核日期',
  `erp_sync_time` datetime DEFAULT NULL COMMENT 'ERP同步时间',
  `del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`purchase_id`),
  KEY `idx_mp_purchase_plan` (`plan_id`),
  KEY `idx_mp_purchase_item` (`item_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='采购计划单(同步自ERP)';
```

---

## 8. 现有表结构升级 (ALTER)

### 8.1 pro_workorder 新增ERP关联字段

```sql
-- ============================================================
-- pro_workorder 新增ERP计划层关联字段
-- ============================================================

-- 关联ERP计划单（保留完整计划信息）
CALL proc_add_column_if_not_exists('pro_workorder', 'plan_id', 'bigint(20) DEFAULT NULL COMMENT ''ERP生产计划ID''');
CALL proc_add_column_if_not_exists('pro_workorder', 'plan_code', 'varchar(32) DEFAULT NULL COMMENT ''ERP生产计划编码''');

-- BOM版本信息（ERP选择的具体BOM版本）
CALL proc_add_column_if_not_exists('pro_workorder', 'bom_id', 'bigint(20) DEFAULT NULL COMMENT ''BOM ID''');
CALL proc_add_column_if_not_exists('pro_workorder', 'bom_version', 'varchar(20) DEFAULT NULL COMMENT ''BOM版本号''');

-- 销售订单交期（排程核心参数）
CALL proc_add_column_if_not_exists('pro_workorder', 'delivery_date', 'date DEFAULT NULL COMMENT ''订单交货日期''');

-- 销售员（跟单查询）
CALL proc_add_column_if_not_exists('pro_workorder', 'sales_user_name', 'varchar(50) DEFAULT NULL COMMENT ''销售员''');

-- 跟单编号（ERP全流程追溯）
CALL proc_add_column_if_not_exists('pro_workorder', 'pp_number', 'varchar(50) DEFAULT NULL COMMENT ''跟单编号(ERP全流程追溯)''');

-- MBOM关联（对应ERP物料清单哪一条）
CALL proc_add_column_if_not_exists('pro_workorder', 'mbom_id', 'bigint(20) DEFAULT NULL COMMENT ''ERP物料清单ID''');
CALL proc_add_column_if_not_exists('pro_workorder', 'mbom_code', 'varchar(32) DEFAULT NULL COMMENT ''ERP物料清单编码''');

-- ERP同步标记
CALL proc_add_column_if_not_exists('pro_workorder', 'erp_sync_time', 'datetime DEFAULT NULL COMMENT ''ERP同步时间''');

-- 创建索引
CALL proc_add_index_if_not_exists('pro_workorder', 'idx_wo_plan', 'plan_code');
CALL proc_add_index_if_not_exists('pro_workorder', 'idx_wo_pp', 'pp_number');
CALL proc_add_index_if_not_exists('pro_workorder', 'idx_wo_delivery', 'delivery_date');
```

### 8.2 wm_item_recpt 新增采购关联字段

```sql
-- ============================================================
-- wm_item_recpt 增强采购订单关联
-- ============================================================

-- 采购订单关联（已有po_code字段，补充订单ID和行ID）
CALL proc_add_column_if_not_exists('wm_item_recpt', 'po_order_id', 'bigint(20) DEFAULT NULL COMMENT ''采购订单ID''');
CALL proc_add_column_if_not_exists('wm_item_recpt', 'po_line_id', 'bigint(20) DEFAULT NULL COMMENT ''采购订单行ID''');

-- 跟单编号
CALL proc_add_column_if_not_exists('wm_item_recpt', 'pp_number', 'varchar(50) DEFAULT NULL COMMENT ''跟单编号''');

-- ERP同步标记
CALL proc_add_column_if_not_exists('wm_item_recpt', 'erp_sync_time', 'datetime DEFAULT NULL COMMENT ''ERP同步时间''');
```

### 8.3 wm_arrival_notice 增强关联

```sql
-- ============================================================
-- wm_arrival_notice 增强采购计划关联
-- ============================================================

-- 采购计划关联
CALL proc_add_column_if_not_exists('wm_arrival_notice', 'purchase_plan_id', 'bigint(20) DEFAULT NULL COMMENT ''采购计划ID''');
CALL proc_add_column_if_not_exists('wm_arrival_notice', 'purchase_plan_code', 'varchar(32) DEFAULT NULL COMMENT ''采购计划编码''');

-- 跟单编号
CALL proc_add_column_if_not_exists('wm_arrival_notice', 'pp_number', 'varchar(50) DEFAULT NULL COMMENT ''跟单编号''');
```

---

## 9. 数据同步策略

### 9.1 同步方向和时机

| 同步路径 | 方向 | 触发时机 | 说明 |
|---------|------|---------|------|
| erp_sl_order → erp_sl_order | ERP→MOM | 销售订单审核后 | 只同步已审核订单 |
| erp_po_order → erp_po_order | ERP→MOM | 采购订单审核后 | 只同步已审核订单 |
| erp_mp_plan → erp_mp_plan | ERP→MOM | 生产计划审核后 | 只同步已审核计划 |
| erp_mp_plan → pro_workorder | ERP→MOM | 计划下发时 | BOM计算后按供应方式拆解创建工单 |
| erp_mp_mbom → erp_mp_mbom | ERP→MOM | BOM计算完成后 | 保留计划层完整物料需求 |
| erp_mp_purchase → erp_mp_purchase | ERP→MOM | 采购计划审核后 | 同步采购需求 |
| pro_workorder.status → erp_mp_mbom | MOM→ERP | 工单完工时 | 回写已完成数量 |
| wm_item_recpt → erp_po_checkin | MOM→ERP | 入库审核时 | 回写已入库数量 |

### 9.2 主键策略

| 策略 | 说明 |
|------|------|
| **使用ERP主键** | erp_sl/po/mp 新表的主键直接使用ERP侧的ID值（非自增），确保一一对应 |
| **编码关联** | pro_workorder 通过 `source_code = plan_code` 关联，不存储ERP主键 |
| **同步时间戳** | 所有同步表增加 `erp_sync_time` 字段，用于增量同步判断 |

### 9.3 状态值映射

| ERP状态 | MOM存储值 | 说明 |
|---------|----------|------|
| DRAFT(开立) | DRAFT | 直接存储，不转换 |
| APPROVED(审核) | APPROVED | 直接存储 |
| CLOSED(关闭) | CLOSED | 直接存储 |
| CANCELLED(取消) | CANCELLED | 直接存储 |

> **原则**: erp_sl/po/mp 表作为ERP数据的镜像，状态值不做转换，保持与ERP一致。仅pro_workorder的状态使用MOM自有体系(PREPARE/CONFIRMED/PRODUCING/FINISHED)。

---

## 10. 执行计划

### 10.1 执行顺序

```
阶段1 (P0 - 基础表创建):
  ├── 1.1 创建 erp_sl_order / erp_sl_order_line
  ├── 1.2 创建 erp_po_order / erp_po_order_line
  ├── 1.3 创建 erp_mp_plan / erp_mp_plan_line
  └── 1.4 ALTER pro_workorder (新增关联字段)
        ↓
阶段2 (P1 - 扩展表创建):
  ├── 2.1 创建 erp_mp_mbom / erp_mp_mbom_line (DDL见 7.1、7.2；字段与ERP数据字典一致)
  ├── 2.2 创建 erp_mp_purchase (DDL见 7.3)
  ├── 2.3 ALTER wm_item_recpt
  └── 2.4 ALTER wm_arrival_notice
        ↓
阶段3 (同步接口开发):
  ├── 3.1 ERP→MOM 数据同步API
  ├── 3.2 MOM→ERP 回写API
  └── 3.3 增量同步定时任务
```

### 10.2 回滚策略

所有新建表使用 `DROP TABLE IF EXISTS` 前缀，可安全回滚。ALTER操作使用 `proc_add_column_if_not_exists` 存储过程，具有幂等性。

### 10.3 验证清单

| 检查项 | 验证SQL |
|--------|---------|
| 新表已创建 | `SHOW TABLES LIKE 'erp_%';` |
| pro_workorder字段已加 | `SHOW COLUMNS FROM pro_workorder LIKE 'plan_code';` |
| 索引已创建 | `SHOW INDEX FROM erp_sl_order;` |
| 数据同步测试 | `SELECT COUNT(*) FROM erp_sl_order WHERE erp_sync_time IS NOT NULL;` |

---

## 11. 升级前后对比

### 升级前

```
ERP                              MOM
┌──────────┐                    ┌──────────────┐
│ sl_order │──(只传编码)──────►│ pro_workorder │
│ sl_line  │                    │ .source_code │
└──────────┘                    └──────────────┘
┌──────────┐                    ┌──────────────┐
│ po_order │──(只传编码)──────►│wm_arrival_    │
│ po_line  │                    │ notice.po_code│
└──────────┘                    └──────────────┘
┌──────────┐                    ┌──────────────┐
│ mp_plan  │──(转成工单)──────►│ pro_workorder │
│ mp_mbom  │                    │ (丢失计划信息)│
└──────────┘                    └──────────────┘
```

### 升级后

```
ERP                              MOM
┌──────────┐   ┌───────────┐   ┌──────────────┐
│ sl_order │──►│erp_sl_order│──►│ pro_workorder │
│ sl_line  │   │erp_sl_line │   │ .plan_code   │
└──────────┘   └───────────┘   │ .pp_number   │
                                │ .delivery_date│
┌──────────┐   ┌───────────┐   └──────┬───────┘
│ po_order │──►│erp_po_order│──►│wm_item_recpt │
│ po_line  │   │erp_po_line │   │.po_order_id  │
└──────────┘   └───────────┘   └──────────────┘
┌──────────┐   ┌───────────┐   ┌──────────────┐
│ mp_plan  │──►│erp_mp_plan │──►│ pro_workorder │
│ mp_mbom  │   │erp_mp_mbom │   │ .plan_code   │
│ mp_purch │   │erp_mp_purch│   │ .bom_version │
└──────────┘   └───────────┘   └──────────────┘
```

**升级收益**: MOM系统获得完整的计划层数据镜像，可实现订单交期可视化、采购进度追踪、计划-执行全链路追溯，同时不破坏MOM原有的生产执行数据结构。

---

## 修订历史

| 版本 | 日期 | 修订内容 | 修订人 |
|------|------|----------|--------|
| 1.0.0 | 2026-02-06 | 初始版本 | System |
| 1.0.1 | 2026-02-06 | 新表前缀由 mom_ 统一改为 erp_，与已有ERP同步表命名一致 | System |
| 1.1.0 | 2026-02-07 | 与ERP同名字段补齐：对照《erp数据库设计-数据字典》及 DDL，对 erp_sl_order/line、erp_po_order/line、erp_mp_plan/line、erp_mp_mbom、erp_mp_mbom_line、erp_mp_purchase 补齐ERP中已有字段；采购表统一为 supplier_id/code/name；销售明细 track_code/contract_line_id/unit_id/unit_price/amount/quality_req；补全 erp_mp_mbom_line 的 DDL | System |