# ERP系统数据库设计 - 数据字典

> 版本: 1.0.0  
> 创建日期: 2026-01-25  
> 数据库: MySQL 8.0+  
> 字符集: utf8mb4

---

## 目录

1. [概述](#1-概述)
2. [命名规范](#2-命名规范)
3. [公共字段说明](#3-公共字段说明)
4. [基础数据模块](#4-基础数据模块)
5. [仓库管理模块](#5-仓库管理模块)
6. [销售管理模块](#6-销售管理模块)
7. [采购管理模块](#7-采购管理模块)
8. [生产计划模块](#8-生产计划模块)
9. [枚举值定义](#9-枚举值定义)
10. [索引设计规范](#10-索引设计规范)
11. [ER图](#11-er图)

---

## 1. 概述

### 1.1 文档目的

本文档定义ERP系统的数据库表结构、字段说明、枚举值和关联关系，为后端API开发和系统维护提供数据模型支持。

### 1.2 涵盖模块

| 模块 | 表前缀 | API前缀 | 说明 | 本文档状态 |
|------|--------|---------|------|-----------|
| 系统管理 | erp_sys_ | /system | 租户、用户、部门等 | ✅ 已收录 |
| 基础数据 | erp_md_ | /md | 物料、BOM、单位等 | ✅ 已收录 |
| 仓库管理 | erp_wm_ | /wm | 仓库、库存、出入库等 | ✅ 已收录 |
| 销售管理 | erp_sl_ | /sl | 客户、订单、发货等 | ✅ 已收录 |
| 采购管理 | erp_po_ | /po | 供应商、采购订单等 | ✅ 已收录 |
| 生产计划 | erp_mp_ | /mp | 生产计划、物料清单等 | ✅ 已收录 |
| 生产管理 | erp_prs_ | /prs | 生产订单、领料、完工、入库等 | ⚠️ 见补充文档 |
| 研发管理 | erp_rd_ | /rd | EBOM、样品配方、孪生物料等 | ⚠️ 见补充文档 |
| 委外管理 | erp_pu_ | /pu | 委外订单、发料、入库等 | ⚠️ 见补充文档 |
| 财务管理 | erp_fd_ | /fd | 凭证、应收应付、成本核算等 | ⚠️ 见补充文档 |

> ⚠️ 标记的模块详见 `erp数据库设计-Swagger补充模块.md`

### 1.3 表清单总览

| 序号 | 表名 | 中文名 | 模块 |
|------|------|--------|------|
| 1 | sys_tenant | 租户表 | 系统管理 |
| 2 | erp_md_item_type | 物料分类表 | 基础数据 |
| 3 | erp_md_item | 物料档案表 | 基础数据 |
| 4 | erp_md_unit | 计量单位表 | 基础数据 |
| 5 | erp_md_bom | BOM表头 | 基础数据 |
| 6 | erp_md_bom_line | BOM明细表 | 基础数据 |
| 7 | erp_wm_warehouse | 仓库表 | 仓库管理 |
| 8 | erp_wm_location | 库区表 | 仓库管理 |
| 9 | erp_wm_area | 库位表 | 仓库管理 |
| 10 | erp_wm_stock | 库存表 | 仓库管理 |
| 11 | erp_wm_item_recpt | 入库单表头 | 仓库管理 |
| 12 | erp_wm_item_recpt_line | 入库单明细 | 仓库管理 |
| 13 | erp_wm_issue | 出库单表头 | 仓库管理 |
| 14 | erp_wm_issue_line | 出库单明细 | 仓库管理 |
| 15 | erp_sl_contract | 销售合同表头 | 销售管理 |
| 17 | erp_sl_contract_line | 销售合同明细 | 销售管理 |
| 18 | erp_sl_order | 销售订单表头 | 销售管理 |
| 19 | erp_sl_order_line | 销售订单明细 | 销售管理 |
| 20 | erp_sl_deliver | 发货单表头 | 销售管理 |
| 21 | erp_sl_deliver_line | 发货单明细 | 销售管理 |
| 22 | erp_sl_invoice | 销售发票表头 | 销售管理 |
| 23 | erp_sl_invoice_line | 销售发票明细 | 销售管理 |
| 24 | erp_sl_saleback | 销售退货单表头 | 销售管理 |
| 25 | erp_sl_saleback_line | 销售退货单明细 | 销售管理 |
| 26 | erp_po_supplier | 供应商档案表 | 采购管理 |
| 27 | erp_po_order | 采购订单表头 | 采购管理 |
| 28 | erp_po_order_line | 采购订单明细 | 采购管理 |
| 29 | erp_po_checkin | 采购到货单表头 | 采购管理 |
| 30 | erp_po_checkin_line | 采购到货单明细 | 采购管理 |
| 31 | erp_po_invoice | 采购发票表头 | 采购管理 |
| 32 | erp_po_invoice_line | 采购发票明细 | 采购管理 |
| 33 | erp_po_reject | 采购退货单表头 | 采购管理 |
| 34 | erp_po_reject_line | 采购退货单明细 | 采购管理 |
| 35 | erp_mp_plan | 生产计划单表头 | 生产计划 |
| 36 | erp_mp_plan_line | 生产计划单明细 | 生产计划 |
| 37 | erp_mp_mbom | 物料清单表头 | 生产计划 |
| 38 | erp_mp_mbom_line | 物料清单明细 | 生产计划 |
| 39 | erp_mp_purchase | 采购计划单表 | 生产计划 |
| 40 | erp_mp_parts | 零部件订单表 | 生产计划 |
| | **以下为Swagger API发现的待补充表** | | |
| 41 | erp_prs_order | 生产订单表头 | 生产管理 |
| 42 | erp_prs_order_line | 生产订单明细 | 生产管理 |
| 43 | erp_prs_pick | 生产领料单表头 | 生产管理 |
| 44 | erp_prs_product | 生产完工单表头 | 生产管理 |
| 45 | erp_prs_checkin | 生产入库单表头 | 生产管理 |
| 46 | erp_prs_instruct | 生产指令单表头 | 生产管理 |
| 47 | erp_prs_yield | 生产报工单表头 | 生产管理 |
| 48 | erp_prs_beltline | 生产线 | 生产管理 |
| 49 | erp_prs_team | 班组 | 生产管理 |
| 50 | erp_prs_worker | 工人 | 生产管理 |
| 51 | erp_prs_jobs | 工种 | 生产管理 |
| 52 | erp_prs_operate_section | 标准工序段 | 生产管理 |
| 53 | erp_prs_process_route | 工艺路线 | 生产管理 |
| 54 | erp_prs_equipment | 设备 | 生产管理 |
| 55 | erp_rd_ebom | EBOM表头 | 研发管理 |
| 56 | erp_rd_ebom_line | EBOM明细 | 研发管理 |
| 57 | erp_rd_sample | 样品配方表头 | 研发管理 |
| 58 | erp_rd_sample_line | 样品配方明细 | 研发管理 |
| 59 | erp_rd_twin | 孪生物料表头 | 研发管理 |
| 60 | erp_rd_twin_line | 孪生物料明细 | 研发管理 |
| 61 | erp_rd_tret | 放量表 | 研发管理 |
| 62 | erp_rd_setting | 研发设置 | 研发管理 |
| 63 | erp_pu_supplier | 委外商档案 | 委外管理 |
| 64 | erp_pu_order | 委外订单表头 | 委外管理 |
| 65 | erp_pu_order_line | 委外订单明细 | 委外管理 |
| 66 | erp_pu_product | 委外到货单表头 | 委外管理 |
| 67 | erp_pu_checkin | 委外入库单表头 | 委外管理 |
| 68 | erp_pu_pick | 委外发料单表头 | 委外管理 |
| 69 | erp_pu_unpick | 委外退料单表头 | 委外管理 |
| 70 | erp_pu_fapiao | 委外发票表头 | 委外管理 |

---

## 2. 命名规范

### 2.1 表命名规范

| 规则 | 说明 | 示例 |
|------|------|------|
| 前缀 | erp_模块缩写_业务名 | erp_sl_order (销售订单) |
| 主从表 | 主表不加后缀，从表加_line | erp_sl_order, erp_sl_order_line |
| 小写 | 全部小写，下划线分隔 | erp_po_order_line |

### 2.2 字段命名规范

| 规则 | 说明 | 示例 |
|------|------|------|
| 主键 | 业务名_id | order_id, item_id |
| 编码 | 业务名_code | order_code, item_code |
| 名称 | 业务名_name | order_name, item_name |
| 外键 | 关联表业务名_id | client_id, supplier_id |
| 冗余字段 | 关联表业务名_code/name | client_code, client_name |
| 标志 | xxx_flag | del_flag, enable_flag |
| 数量 | quantity, xxx_qty | quantity, delivered_qty |
| 金额 | amount, xxx_amount | amount, total_amount |

### 2.3 数据类型规范

| 用途 | 数据类型 | 说明 |
|------|----------|------|
| 主键 | bigint | 自增长ID |
| 编码 | varchar(32) | 业务编码 |
| 名称 | varchar(100) | 短名称 |
| 描述 | varchar(500) | 长文本 |
| 日期 | date | 纯日期 |
| 时间 | datetime | 日期时间 |
| 数量 | decimal(18,4) | 数量类 |
| 金额 | decimal(18,2) | 金额类 |
| 单价 | decimal(18,4) | 单价类 |
| 比例 | decimal(5,2) | 百分比 |
| 标志 | char(1) | Y/N, 0/1 |
| 状态 | varchar(20) | 状态枚举 |

---

## 3. 公共字段说明

### 3.1 必备公共字段

所有业务表必须包含以下字段：

| 字段名 | 类型 | 说明 |
|--------|------|------|
| tenant_id | varchar(20) | 租户ID (多租户隔离) |
| del_flag | char(1) | 删除标志 (0存在 1删除) |
| create_by | varchar(64) | 创建者 |
| create_time | datetime | 创建时间 |
| update_by | varchar(64) | 更新者 |
| update_time | datetime | 更新时间 |

### 3.2 单据类公共字段

单据类表通常包含以下字段：

| 字段名 | 类型 | 说明 |
|--------|------|------|
| status | varchar(20) | 单据状态 |
| operator_id | bigint | 操作员ID |
| operator_name | varchar(50) | 操作员名称 |
| approver_id | bigint | 审核员ID |
| approver_name | varchar(50) | 审核员名称 |
| approve_date | datetime | 审核日期 |
| remark | varchar(500) | 备注 |

---

## 4. 基础数据模块

### 4.1 物料分类表 (erp_md_item_type)

> API路径: `/md/itemtype`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| item_type_id | bigint | - | N | AUTO | 分类ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| item_type_code | varchar | 32 | N | - | 分类编码 |
| item_type_name | varchar | 50 | N | - | 分类名称 |
| parent_type_id | bigint | - | Y | NULL | 父分类ID |
| ancestors | varchar | 500 | Y | NULL | 祖级列表 |
| order_num | int | - | Y | 0 | 排序号 |
| enable_flag | char | 1 | N | 'Y' | 启用状态 |
| del_flag | char | 1 | N | '0' | 删除标志 |
| create_by | varchar | 64 | Y | NULL | 创建者 |
| create_time | datetime | - | Y | NULL | 创建时间 |
| update_by | varchar | 64 | Y | NULL | 更新者 |
| update_time | datetime | - | Y | NULL | 更新时间 |

**索引设计:**

| 索引名 | 字段 | 类型 |
|--------|------|------|
| uk_item_type_code | item_type_code, tenant_id | UNIQUE |
| idx_item_type_parent | parent_type_id | INDEX |
| idx_item_type_tenant | tenant_id | INDEX |

---

### 4.2 物料档案表 (erp_md_item)

> API路径: `/md/item`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| item_id | bigint | - | N | AUTO | 物料ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| item_code | varchar | 32 | N | - | 物料编码 |
| item_name | varchar | 100 | N | - | 物料名称 |
| specification | varchar | 200 | Y | NULL | 规格型号 |
| unit_of_measure | varchar | 20 | Y | NULL | 主计量单位 |
| item_type_id | bigint | - | Y | NULL | 物料分类ID |
| item_type_code | varchar | 32 | Y | NULL | 物料分类编码 |
| item_type_name | varchar | 50 | Y | NULL | 物料分类名称 |
| item_sub_type_code | varchar | 32 | Y | NULL | 二级分类编码 |
| item_sub_type_name | varchar | 50 | Y | NULL | 二级分类名称 |
| item_or_product | varchar | 20 | Y | 'ITEM' | 物料/产品 |
| safe_stock_flag | char | 1 | Y | 'N' | 启用安全库存 |
| min_stock | decimal | 18,4 | Y | 0 | 最小库存 |
| max_stock | decimal | 18,4 | Y | 0 | 最大库存 |
| default_warehouse_id | bigint | - | Y | NULL | 默认仓库ID |
| default_warehouse_name | varchar | 50 | Y | NULL | 默认仓库名称 |
| weight | decimal | 18,6 | Y | NULL | 重量(kg) |
| volume | decimal | 18,6 | Y | NULL | 体积(m³) |
| enable_flag | char | 1 | N | 'Y' | 启用状态 |
| remark | varchar | 500 | Y | NULL | 备注 |
| del_flag | char | 1 | N | '0' | 删除标志 |
| create_by | varchar | 64 | Y | NULL | 创建者 |
| create_time | datetime | - | Y | NULL | 创建时间 |
| update_by | varchar | 64 | Y | NULL | 更新者 |
| update_time | datetime | - | Y | NULL | 更新时间 |

**索引设计:**

| 索引名 | 字段 | 类型 |
|--------|------|------|
| uk_item_code | item_code, tenant_id | UNIQUE |
| idx_item_type | item_type_id | INDEX |
| idx_item_name | item_name | INDEX |
| idx_item_tenant | tenant_id | INDEX |

---

### 4.3 BOM表头 (erp_md_bom)

> API路径: `/md/bom`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| bom_id | bigint | - | N | AUTO | BOM ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| bom_code | varchar | 32 | N | - | BOM编码 |
| bom_name | varchar | 100 | Y | NULL | BOM名称 |
| item_id | bigint | - | N | - | 产品物料ID |
| item_code | varchar | 32 | N | - | 产品物料编码 |
| item_name | varchar | 100 | N | - | 产品物料名称 |
| unit_name | varchar | 20 | Y | NULL | 计量单位 |
| base_qty | decimal | 18,4 | N | 1 | 基本数量 |
| version | varchar | 20 | Y | NULL | 版本号 |
| version_desc | varchar | 200 | Y | NULL | 版本说明 |
| status | varchar | 20 | N | 'DRAFT' | 状态 |
| enable_flag | char | 1 | N | 'Y' | 启用状态 |
| remark | varchar | 500 | Y | NULL | 备注 |
| del_flag | char | 1 | N | '0' | 删除标志 |

### 4.4 BOM明细表 (erp_md_bom_line)

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| line_id | bigint | - | N | AUTO | 明细ID (主键) |
| bom_id | bigint | - | N | - | BOM ID (外键) |
| line_no | int | - | N | - | 行号 |
| item_id | bigint | - | N | - | 子件物料ID |
| item_code | varchar | 32 | N | - | 子件物料编码 |
| item_name | varchar | 100 | N | - | 子件物料名称 |
| specification | varchar | 200 | Y | NULL | 规格型号 |
| unit_name | varchar | 20 | Y | NULL | 计量单位 |
| base_qty | decimal | 18,6 | N | 1 | 基本用量 |
| loss_rate | decimal | 5,2 | Y | 0 | 损耗率(%) |
| supply_type | varchar | 20 | Y | 'PURCHASE' | 供应方式 |
| remark | varchar | 200 | Y | NULL | 备注 |
| del_flag | char | 1 | N | '0' | 删除标志 |
| tenant_id | varchar | 20 | N | - | 租户ID |

---

## 5. 仓库管理模块

### 5.1 仓库表 (erp_wm_warehouse)

> API路径: `/wm/warehouse`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| warehouse_id | bigint | - | N | AUTO | 仓库ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| warehouse_code | varchar | 32 | N | - | 仓库编码 |
| warehouse_name | varchar | 50 | N | - | 仓库名称 |
| warehouse_type | varchar | 20 | Y | NULL | 仓库类型 |
| location | varchar | 100 | Y | NULL | 位置 |
| area | decimal | 10,2 | Y | NULL | 面积(m²) |
| charge | varchar | 50 | Y | NULL | 负责人 |
| charge_tel | varchar | 20 | Y | NULL | 负责人电话 |
| enable_flag | char | 1 | N | 'Y' | 启用状态 |
| remark | varchar | 500 | Y | NULL | 备注 |
| del_flag | char | 1 | N | '0' | 删除标志 |

### 5.2 库存表 (erp_wm_stock)

> API路径: `/wm/stock`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| stock_id | bigint | - | N | AUTO | 库存ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| item_id | bigint | - | N | - | 物料ID |
| item_code | varchar | 32 | Y | NULL | 物料编码 |
| item_name | varchar | 100 | Y | NULL | 物料名称 |
| specification | varchar | 200 | Y | NULL | 规格型号 |
| unit_name | varchar | 20 | Y | NULL | 计量单位 |
| warehouse_id | bigint | - | N | - | 仓库ID |
| warehouse_code | varchar | 32 | Y | NULL | 仓库编码 |
| warehouse_name | varchar | 50 | Y | NULL | 仓库名称 |
| location_id | bigint | - | Y | NULL | 库区ID |
| area_id | bigint | - | Y | NULL | 库位ID |
| batch_no | varchar | 50 | Y | NULL | 批次号 |
| quantity_on_hand | decimal | 18,4 | N | 0 | 在库数量 |
| quantity_locked | decimal | 18,4 | N | 0 | 锁定数量 |
| quantity_available | decimal | 18,4 | N | 0 | 可用数量 |
| unit_cost | decimal | 18,4 | Y | 0 | 单位成本 |
| expire_date | date | - | Y | NULL | 有效期 |
| update_time | datetime | - | Y | NULL | 更新时间 |

**业务规则:**
- `quantity_available = quantity_on_hand - quantity_locked`
- 库存更新时自动计算可用数量

---

## 6. 销售管理模块

> 说明: 客户档案表使用 md_client（基础数据模块），已合并原 erp_sl_client 的所有字段

### 6.1 销售订单表头 (erp_sl_order)

> API路径: `/sl/order`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| order_id | bigint | - | N | AUTO | 订单ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| order_code | varchar | 32 | N | - | 订单编码 |
| order_name | varchar | 100 | Y | NULL | 订单名称 |
| order_date | date | - | N | - | 订单日期 |
| status | varchar | 20 | N | 'DRAFT' | 单据状态 |
| business_status | varchar | 20 | Y | 'NORMAL' | 业务状态 |
| order_type | varchar | 20 | Y | NULL | 订单类型 |
| contract_id | bigint | - | Y | NULL | 合同ID |
| contract_code | varchar | 32 | Y | NULL | 合同编码 |
| client_id | bigint | - | N | - | 客户ID |
| client_code | varchar | 32 | Y | NULL | 客户编码 |
| client_name | varchar | 100 | Y | NULL | 客户名称 |
| sales_user_id | bigint | - | Y | NULL | 销售员ID |
| sales_user_name | varchar | 50 | Y | NULL | 销售员名称 |
| dept_id | bigint | - | Y | NULL | 部门ID |
| dept_name | varchar | 50 | Y | NULL | 部门名称 |
| delivery_date | date | - | Y | NULL | 交货日期 |
| delivery_address | varchar | 200 | Y | NULL | 收货地址 |
| total_quantity | decimal | 18,4 | Y | 0 | 总数量 |
| total_amount | decimal | 18,2 | Y | 0 | 总金额 |
| delivered_quantity | decimal | 18,4 | Y | 0 | 已发货数量 |
| delivered_amount | decimal | 18,2 | Y | 0 | 已发货金额 |
| remark | varchar | 500 | Y | NULL | 备注 |
| operator_id | bigint | - | Y | NULL | 操作员ID |
| operator_name | varchar | 50 | Y | NULL | 操作员名称 |
| approver_id | bigint | - | Y | NULL | 审核员ID |
| approver_name | varchar | 50 | Y | NULL | 审核员名称 |
| approve_date | datetime | - | Y | NULL | 审核日期 |
| del_flag | char | 1 | N | '0' | 删除标志 |

### 6.2 销售订单明细 (erp_sl_order_line)

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| line_id | bigint | - | N | AUTO | 明细ID (主键) |
| order_id | bigint | - | N | - | 订单ID (外键) |
| order_code | varchar | 32 | N | - | 订单编码 |
| line_no | int | - | N | - | 行号 |
| track_code | varchar | 32 | Y | NULL | 跟单编号 |
| contract_line_id | bigint | - | Y | NULL | 合同明细ID |
| item_id | bigint | - | N | - | 物料ID |
| item_code | varchar | 32 | N | - | 物料编码 |
| item_name | varchar | 100 | N | - | 物料名称 |
| specification | varchar | 200 | Y | NULL | 规格型号 |
| unit_id | bigint | - | Y | NULL | 计量单位ID |
| unit_name | varchar | 20 | Y | NULL | 计量单位 |
| quantity | decimal | 18,4 | N | 0 | 订单数量 |
| unit_price | decimal | 18,4 | Y | 0 | 单价 |
| amount | decimal | 18,2 | Y | 0 | 金额 |
| delivered_qty | decimal | 18,4 | Y | 0 | 已发货数量 |
| quality_req | varchar | 200 | Y | NULL | 质量要求 |
| remark | varchar | 200 | Y | NULL | 备注 |
| del_flag | char | 1 | N | '0' | 删除标志 |
| tenant_id | varchar | 20 | N | - | 租户ID |

### 6.4 发货单表头 (erp_sl_deliver)

> API路径: `/sl/deliver`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| deliver_id | bigint | - | N | AUTO | 发货单ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| deliver_code | varchar | 32 | N | - | 发货单编码 |
| deliver_name | varchar | 100 | Y | NULL | 发货单名称 |
| deliver_date | date | - | N | - | 发货日期 |
| status | varchar | 20 | N | 'DRAFT' | 状态 |
| order_id | bigint | - | Y | NULL | 销售订单ID |
| order_code | varchar | 32 | Y | NULL | 销售订单编码 |
| client_id | bigint | - | N | - | 客户ID |
| client_code | varchar | 32 | Y | NULL | 客户编码 |
| client_name | varchar | 100 | Y | NULL | 客户名称 |
| warehouse_id | bigint | - | Y | NULL | 发货仓库ID |
| warehouse_name | varchar | 50 | Y | NULL | 仓库名称 |
| delivery_address | varchar | 200 | Y | NULL | 收货地址 |
| total_quantity | decimal | 18,4 | Y | 0 | 总数量 |
| total_amount | decimal | 18,2 | Y | 0 | 总金额 |
| remark | varchar | 500 | Y | NULL | 备注 |

---

## 7. 采购管理模块

### 7.1 供应商档案表 (erp_po_supplier)

> API路径: `/po/supplier`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| supplier_id | bigint | - | N | AUTO | 供应商ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| supplier_code | varchar | 32 | N | - | 供应商编码 |
| supplier_name | varchar | 100 | N | - | 供应商名称 |
| supplier_alias | varchar | 100 | Y | NULL | 供应商别名 |
| supplier_nick | varchar | 50 | Y | NULL | 供应商简称 |
| supplier_type | varchar | 20 | Y | NULL | 供应商分类 |
| supplier_level | varchar | 10 | Y | 'B' | 供应商等级(A/B/C/D) |
| province | varchar | 50 | Y | NULL | 省份 |
| city | varchar | 50 | Y | NULL | 城市 |
| address | varchar | 200 | Y | NULL | 公司地址 |
| zip_code | varchar | 10 | Y | NULL | 邮编 |
| tel | varchar | 20 | Y | NULL | 电话 |
| fax | varchar | 20 | Y | NULL | 传真 |
| email | varchar | 100 | Y | NULL | 邮箱 |
| website | varchar | 200 | Y | NULL | 网址 |
| contact1 | varchar | 50 | Y | NULL | 业务联系人 |
| contact1_tel | varchar | 20 | Y | NULL | 业务联系人电话 |
| contact2 | varchar | 50 | Y | NULL | 财务联系人 |
| contact2_tel | varchar | 20 | Y | NULL | 财务联系人电话 |
| bank_name | varchar | 100 | Y | NULL | 开户银行 |
| bank_account | varchar | 30 | Y | NULL | 银行账号 |
| bank_address | varchar | 200 | Y | NULL | 开票地址电话 |
| tax_no | varchar | 30 | Y | NULL | 税号 |
| supply_items | varchar | 500 | Y | NULL | 供应料品 |
| enable_flag | char | 1 | N | 'Y' | 启用状态 |
| remark | varchar | 500 | Y | NULL | 备注 |
| del_flag | char | 1 | N | '0' | 删除标志 |

### 7.2 采购订单表头 (erp_po_order)

> API路径: `/po/order`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| order_id | bigint | - | N | AUTO | 订单ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| order_code | varchar | 32 | N | - | 订单编码 |
| order_date | date | - | N | - | 订单日期 |
| status | varchar | 20 | N | 'DRAFT' | 单据状态 |
| business_status | varchar | 20 | Y | 'NORMAL' | 业务状态 |
| business_type | varchar | 20 | Y | NULL | 业务类型 |
| order_type | varchar | 20 | Y | NULL | 单据类型 |
| material_need | varchar | 20 | Y | NULL | 用料需求 |
| supplier_id | bigint | - | Y | NULL | 供应商ID |
| supplier_code | varchar | 32 | Y | NULL | 供应商编码 |
| supplier_name | varchar | 100 | Y | NULL | 供应商名称 |
| dept_id | bigint | - | Y | NULL | 采购部门ID |
| dept_name | varchar | 50 | Y | NULL | 采购部门名称 |
| user_id | bigint | - | Y | NULL | 采购人员ID |
| user_name | varchar | 50 | Y | NULL | 采购人员名称 |
| delivery_date | date | - | Y | NULL | 到货日期 |
| contract_no | varchar | 50 | Y | NULL | 合同号 |
| contract_file | varchar | 500 | Y | NULL | 合同附件 |
| total_quantity | decimal | 18,4 | Y | 0 | 总数量 |
| total_amount | decimal | 18,2 | Y | 0 | 总金额 |
| arrived_quantity | decimal | 18,4 | Y | 0 | 已到货数量 |
| remark | varchar | 500 | Y | NULL | 备注 |

### 7.3 采购订单明细 (erp_po_order_line)

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| line_id | bigint | - | N | AUTO | 明细ID (主键) |
| order_id | bigint | - | N | - | 订单ID (外键) |
| order_code | varchar | 32 | N | - | 订单编码 |
| line_no | int | - | N | - | 行号 |
| track_code | varchar | 32 | Y | NULL | 跟单编号 |
| plan_code | varchar | 32 | Y | NULL | 计划单号 |
| plan_line_id | bigint | - | Y | NULL | 计划明细ID |
| item_id | bigint | - | N | - | 物料ID |
| item_code | varchar | 32 | N | - | 物料编码 |
| item_name | varchar | 100 | N | - | 物料名称 |
| specification | varchar | 200 | Y | NULL | 型号规格 |
| unit_id | bigint | - | Y | NULL | 计量单位ID |
| unit_name | varchar | 20 | Y | NULL | 计量单位 |
| need_date | date | - | Y | NULL | 需求日期 |
| quantity | decimal | 18,4 | N | 0 | 采购数量 |
| unit_price | decimal | 18,4 | Y | 0 | 采购单价 |
| amount | decimal | 18,2 | Y | 0 | 金额 |
| arrived_quantity | decimal | 18,4 | Y | 0 | 已到货数量 |
| remark | varchar | 200 | Y | NULL | 采购说明 |
| del_flag | char | 1 | N | '0' | 删除标志 |
| tenant_id | varchar | 20 | N | - | 租户ID |

---

## 8. 生产计划模块

### 8.1 生产计划单表头 (erp_mp_plan)

> API路径: `/mp/plan/order`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| plan_id | bigint | - | N | AUTO | 计划ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| plan_code | varchar | 32 | N | - | 计划单编码 |
| plan_date | date | - | N | - | 计划日期 |
| status | varchar | 20 | N | 'DRAFT' | 单据状态 |
| business_status | varchar | 20 | Y | 'NORMAL' | 业务状态 |
| business_type | varchar | 20 | Y | NULL | 业务类型 |
| work_type | int | - | N | 0 | 工作类型 |
| sales_order_id | bigint | - | Y | NULL | 销售订单ID |
| sales_order_code | varchar | 32 | Y | NULL | 销售订单编码 |
| sales_user_id | bigint | - | Y | NULL | 销售员ID |
| sales_user_name | varchar | 50 | Y | NULL | 销售员名称 |
| delivery_date | date | - | Y | NULL | 订单交期 |
| bom_id | bigint | - | Y | NULL | BOM ID |
| bom_version | varchar | 20 | Y | NULL | BOM版本号 |
| bom_desc | varchar | 200 | Y | NULL | BOM版本说明 |
| total_quantity | decimal | 18,4 | Y | 0 | 生产总量 |
| remark | varchar | 500 | Y | NULL | 备注 |

### 8.2 物料清单表头 (erp_mp_mbom)

> API路径: `/mp/plan/mbom`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| mbom_id | bigint | - | N | AUTO | 物料清单ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| mbom_code | varchar | 32 | N | - | 物料清单编码 |
| mbom_date | date | - | N | - | 单据日期 |
| status | varchar | 20 | N | 'DRAFT' | 单据状态 |
| business_type | varchar | 20 | Y | NULL | 业务类型 |
| issue_status | varchar | 20 | Y | NULL | 下发状态 |
| plan_id | bigint | - | N | - | 生产计划ID |
| plan_code | varchar | 32 | N | - | 生产计划编码 |
| sales_order_id | bigint | - | Y | NULL | 销售订单ID |
| sales_order_code | varchar | 32 | Y | NULL | 销售订单编码 |
| delivery_date | date | - | Y | NULL | 订单交期 |
| item_id | bigint | - | N | - | 产品物料ID |
| item_code | varchar | 32 | N | - | 产品物料编码 |
| item_name | varchar | 100 | N | - | 产品物料名称 |
| unit_name | varchar | 20 | Y | NULL | 计量单位 |
| supply_type | varchar | 20 | Y | NULL | 供应方式 |
| quantity | decimal | 18,4 | N | 0 | 生产数量 |
| workshop_id | bigint | - | Y | NULL | 下发车间ID |
| workshop_name | varchar | 50 | Y | NULL | 下发车间名称 |
| remark | varchar | 500 | Y | NULL | 备注 |

### 8.3 采购计划单表 (erp_mp_purchase)

> API路径: `/mp/plan/purchase`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| purchase_id | bigint | - | N | AUTO | 采购计划ID (主键) |
| tenant_id | varchar | 20 | N | - | 租户ID |
| purchase_code | varchar | 32 | N | - | 采购计划编码 |
| purchase_date | date | - | N | - | 计划日期 |
| status | varchar | 20 | N | 'DRAFT' | 单据状态 |
| need_type | int | - | N | 0 | 需求方式 |
| plan_id | bigint | - | Y | NULL | 生产计划ID |
| plan_code | varchar | 32 | Y | NULL | 生产计划编码 |
| sales_order_id | bigint | - | Y | NULL | 销售订单ID |
| sales_order_code | varchar | 32 | Y | NULL | 销售订单编码 |
| delivery_date | date | - | Y | NULL | 订单交期 |
| item_id | bigint | - | N | - | 物料ID |
| item_code | varchar | 32 | N | - | 物料编码 |
| item_name | varchar | 100 | N | - | 物料名称 |
| specification | varchar | 200 | Y | NULL | 型号规格 |
| unit_name | varchar | 20 | Y | NULL | 计量单位 |
| purchase_qty | decimal | 18,4 | N | 0 | 采购数量 |
| ordered_qty | decimal | 18,4 | Y | 0 | 已订数量 |
| remark | varchar | 500 | Y | NULL | 备注 |

---

## 9. 枚举值定义

### 9.1 通用单据状态 (status)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| DRAFT | 开立/草稿 | 可编辑状态 |
| SUBMITTED | 已提交 | 等待审核 |
| APPROVED | 已审核 | 审核通过，不可编辑 |
| REJECTED | 已驳回 | 审核驳回 |
| CLOSED | 已关闭 | 业务完结 |
| CANCELLED | 已取消 | 取消作废 |

### 9.2 业务状态 (business_status)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| NORMAL | 正常 | 正常执行 |
| PAUSE | 暂停 | 暂停执行 |
| CANCEL | 取消 | 已取消 |

### 9.3 启用状态 (enable_flag)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| Y | 启用 | 正常使用 |
| N | 停用 | 禁止使用 |

### 9.4 删除标志 (del_flag)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| 0 | 存在 | 正常数据 |
| 1 | 删除 | 逻辑删除 |

### 9.5 物料类型 (item_or_product)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| ITEM | 物料 | 原材料/零部件 |
| PRODUCT | 产品 | 成品 |

### 9.6 供应方式 (supply_type)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| PURCHASE | 采购 | 外部采购 |
| SELF_MADE | 自制 | 自己生产 |
| OUTSOURCE | 委外 | 委外加工 |

### 9.7 采购业务类型 (business_type)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| RAW_MATERIAL | 原材料 | 原材料采购 |
| PARTS | 零部件 | 零部件采购 |
| ASSEMBLY | 装配件 | 装配件采购 |
| FINISHED | 成品 | 成品采购 |
| HARDWARE | 五金件 | 五金件采购 |
| PACKAGING | 包装物 | 包装物采购 |

### 9.8 用料需求 (material_need)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| ORDER_USE | 订单用料 | 按订单需求采购 |
| STOCK_USE | 备库用料 | 备库采购 |

### 9.9 工作类型 (work_type)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| 0 | 生产计划单 | 主生产计划 |
| 1 | 零部件计划单 | 零部件生产计划 |
| 2 | 零部件订单 | 零部件加工订单 |

### 9.10 需求方式 (need_type)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| 0 | 订单用料 | 按订单需求采购 |
| 1 | 库存备料 | 备库采购 |

### 9.11 下发状态 (issue_status)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| NOT_ISSUED | 未下发 | 未下发到车间 |
| ISSUED | 已下发 | 已下发到车间 |
| COMPLETED | 已完成 | 生产完成 |

### 9.12 财务状态 (finance_status)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| RECORDED | 录入 | 已录入 |
| ENTERED | 入账 | 已入账 |

### 9.13 客户/供应商等级 (client_level / supplier_level)

| 枚举值 | 中文名 | 说明 |
|--------|--------|------|
| A | A级 | 核心客户/供应商 |
| B | B级 | 重要客户/供应商 |
| C | C级 | 一般客户/供应商 |
| D | D级 | 潜在客户/供应商 |

---

## 10. 索引设计规范

### 10.1 索引命名规范

| 索引类型 | 命名格式 | 示例 |
|----------|----------|------|
| 主键 | pk_表名 | pk_sl_order |
| 唯一索引 | uk_表名_字段 | uk_sl_order_code |
| 普通索引 | idx_表名_字段 | idx_sl_order_date |
| 组合索引 | idx_表名_字段1_字段2 | idx_sl_order_client_date |

### 10.2 必建索引

| 场景 | 索引字段 | 说明 |
|------|----------|------|
| 主键 | xxx_id | 主键自动创建 |
| 租户 | tenant_id | 多租户隔离 |
| 编码 | xxx_code + tenant_id | 编码唯一 |
| 外键 | 关联字段ID | 关联查询 |
| 日期 | xxx_date | 范围查询 |
| 状态 | status | 条件筛选 |

### 10.3 索引设计原则

1. **主键索引**: 使用自增bigint，避免UUID
2. **唯一索引**: 编码字段 + tenant_id 组合唯一
3. **外键索引**: 所有外键字段必须建立索引
4. **组合索引**: 遵循最左前缀原则
5. **避免冗余**: 不要在已有索引字段上重复建索引

---

## 11. ER图

### 11.1 销售模块ER图

```
┌──────────────────────┐   ┌──────────────────────┐   ┌──────────────────────┐
│   md_client          │   │  erp_sl_contract     │   │    erp_sl_order      │
│   (客户档案)         │<──│  (销售合同)          │<──│   (销售订单)         │
└──────────────────────┘   └──────────┬───────────┘   └──────────┬───────────┘
                                      │ 1:N                      │ 1:N
                                      ▼                          ▼
                           ┌──────────────────────┐   ┌──────────────────────┐
                           │erp_sl_contract_line  │   │  erp_sl_order_line   │
                           │  (合同明细)          │   │  (订单明细)          │
                           └──────────────────────┘   └──────────────────────┘
                                                               │
            ┌──────────────────────────────────────────────────┤
            │                       │                          │
            ▼                       ▼                          ▼
┌──────────────────────┐   ┌──────────────────────┐   ┌──────────────────────┐
│   erp_sl_deliver     │   │   erp_sl_invoice     │   │   erp_sl_saleback    │
│   (发货单)           │   │   (销售发票)         │   │   (退货单)           │
└──────────┬───────────┘   └──────────┬───────────┘   └──────────┬───────────┘
           │ 1:N                      │ 1:N                      │ 1:N
           ▼                          ▼                          ▼
┌──────────────────────┐   ┌──────────────────────┐   ┌──────────────────────┐
│ erp_sl_deliver_line  │   │erp_sl_invoice_line   │   │erp_sl_saleback_line  │
│   (发货明细)         │   │   (发票明细)         │   │   (退货明细)         │
└──────────────────────┘   └──────────────────────┘   └──────────────────────┘
```

### 11.2 采购模块ER图

```
┌──────────────────────┐      1:N       ┌──────────────────────┐
│  erp_po_supplier     │◄──────────────►│    erp_po_order      │
│   (供应商)           │                │   (采购订单)         │
└──────────────────────┘                └──────────┬───────────┘
                                                   │ 1:N
                                                   ▼
                                        ┌──────────────────────┐
                                        │  erp_po_order_line   │
                                        │  (采购明细)          │
                                        └──────────┬───────────┘
                                                   │
           ┌───────────────────────────────────────┼───────────────────────────────────────┐
           │                                       │                                       │
           ▼ 1:N                                  ▼ 1:N                                   ▼ 1:N
┌──────────────────────┐              ┌──────────────────────┐              ┌──────────────────────┐
│   erp_po_checkin     │              │   erp_po_invoice     │              │   erp_po_reject      │
│   (采购到货)         │              │   (采购发票)         │              │   (采购退货)         │
└──────────┬───────────┘              └──────────┬───────────┘              └──────────┬───────────┘
           │ 1:N                                 │ 1:N                                 │ 1:N
           ▼                                     ▼                                     ▼
┌──────────────────────┐              ┌──────────────────────┐              ┌──────────────────────┐
│erp_po_checkin_line   │              │erp_po_invoice_line   │              │ erp_po_reject_line   │
│  (到货明细)          │              │   (发票明细)         │              │  (退货明细)          │
└──────────────────────┘              └──────────────────────┘              └──────────────────────┘
```

### 11.3 生产计划模块ER图

```
┌──────────────────────┐      1:N       ┌──────────────────────┐
│   erp_sl_order       │◄──────────────►│    erp_mp_plan       │
│  (销售订单)          │                │  (生产计划单)        │
└──────────────────────┘                └──────────┬───────────┘
                                                   │ 1:N
                                                   ▼
                                        ┌──────────────────────┐
                                        │  erp_mp_plan_line    │
                                        │ (生产计划明细)       │
                                        └──────────┬───────────┘
                                                   │
           ┌───────────────────────────────────────┼───────────────────────────────────────┐
           │                                       │                                       │
           ▼ 1:N                                  ▼ 1:N                                   ▼ 1:N
┌──────────────────────┐              ┌──────────────────────┐              ┌──────────────────────┐
│    erp_mp_mbom       │              │  erp_mp_purchase     │              │   erp_mp_parts       │
│  (物料清单)          │              │  (采购计划单)        │              │ (零部件订单)         │
└──────────┬───────────┘              └──────────────────────┘              └──────────────────────┘
           │ 1:N
           ▼
┌──────────────────────┐
│  erp_mp_mbom_line    │
│ (物料清单明细)       │
└──────────────────────┘
```

### 11.4 基础数据关联

```
                    ┌──────────────────────┐
                    │   erp_md_item_type   │
                    │   (物料分类)         │
                    └──────────┬───────────┘
                               │ 1:N
                               ▼
┌──────────────────────┐  ┌──────────────────────┐  ┌──────────────────────┐
│   erp_wm_warehouse   │  │    erp_md_item       │  │    erp_md_bom        │
│     (仓库)           │  │   (物料档案)         │  │   (BOM档案)          │
└──────────┬───────────┘  └──────────┬───────────┘  └──────────┬───────────┘
           │                         │                         │
           ▼                         │                         ▼
┌──────────────────────┐             │              ┌──────────────────────┐
│    erp_wm_stock      │◄────────────┘              │  erp_md_bom_line     │
│     (库存)           │                            │   (BOM明细)          │
└──────────────────────┘                            └──────────────────────┘
```

---

## 附录A: API模块路径对照

| 模块 | API前缀 | 说明 |
|------|---------|------|
| 系统管理 | /system | 用户、角色、部门等 |
| 基础数据 | /md | 物料、BOM、单位等 |
| 仓库管理 | /wm | 仓库、库存、出入库等 |
| 销售管理 | /sl | 客户、订单、发货等 |
| 采购管理 | /po | 供应商、采购订单等 |
| 生产计划 | /mp | 生产计划、物料清单等 |
| 生产执行 | /pm | 工单、生产任务等 |
| 研发管理 | /rd | 研发BOM、样品等 |
| 委外管理 | /pu | 委外订单、委外加工等 |
| 财务管理 | /fd | 应收应付、凭证等 |

---

## 附录B: 数据权限说明

### B.1 租户隔离

所有业务表都包含 `tenant_id` 字段，用于多租户数据隔离。

**隔离规则:**
- 查询时自动追加租户条件
- 新增时自动填充租户ID
- 租户之间数据完全隔离

### B.2 数据权限范围

| 权限类型 | 说明 | 实现方式 |
|----------|------|----------|
| 全部数据 | 可查看所有数据 | 不追加条件 |
| 部门数据 | 只能查看本部门数据 | dept_id = 当前部门 |
| 部门及以下 | 可查看本部门及下级部门数据 | dept_id IN (部门树) |
| 仅本人数据 | 只能查看自己创建的数据 | create_by = 当前用户 |

---

## 附录C: 未覆盖模块说明

> 以下模块已通过Swagger API发现但尚未纳入本数据字典，详见 `erp数据库设计-Swagger补充模块.md`

### C.1 未覆盖模块清单

| 模块 | API前缀 | Java包前缀 | 估计表数量 | 说明 |
|------|---------|-----------|-----------|------|
| 生产管理(车间) | /prs | Prs* | ~20 | 生产订单、领料、完工、入库、报工、指令单等 |
| 研发管理 | /rd | Rd* | ~10 | 产品BOM(EBOM)、样品配方、孪生物料、放量、设置 |
| 委外管理 | /pu | Pu* | ~14 | 委外商、委外订单、到货、入库、发料、退料、发票 |
| 财务管理 | /fd | Fd* | ~30+ | 期间、账套、科目、凭证、应收应付、收付款、成本核算等 |
| 车间设置 | /prs (基础) | Prs* | ~8 | 生产线、班组、工人、工种、工序段、工艺路线、设备 |

### C.2 Swagger API揭示的命名差异

目标ERP系统的实际API字段命名与本文档中基于行业惯例设计的字段命名存在差异：

| 概念 | 本文档命名 | Swagger实际命名 | 差异说明 |
|------|-----------|---------------|---------|
| 主键 | xxx_id (如 order_id) | uniqueId | ERP统一使用uniqueId |
| 物料编码 | item_code | invCode | inv = Inventory |
| 物料名称 | item_name | invName | inv = Inventory |
| 物料分类ID | item_type_id | invSortId | sort = 分类 |
| 跟单编号 | track_code | ppNumber | 全局唯一 |
| 操作员 | operator_name | userOper | |
| 审核员 | approver_name | userCheck | |
| 审核日期 | approve_date | checkDate | |
| 业务状态 | business_status | workStatus | |

> **说明**: 本文档中的字段命名遵循行业通用规范，便于理解和对接。实际集成时需根据API字段名进行映射转换。具体映射关系详见 `erp数据库设计-Swagger补充模块.md` 第1节。

### C.3 相关文档

| 文档 | 说明 |
|------|------|
| `erp数据库设计-Swagger补充模块.md` | Swagger API分析的完整报告，含所有缺失模块的字段定义 |
| `目标erp系统接口文档Swagger-API.md` | 已整理的API接口文档（含9个模块） |
| `ERP系统接口API文档.md` | API接口文档的引用版本 |

---

## 修订历史

| 版本 | 日期 | 修订内容 | 修订人 |
|------|------|----------|--------|
| 1.0.0 | 2026-01-25 | 初始版本 | System |
| 1.1.0 | 2026-02-06 | 增加附录C：基于Swagger API分析的未覆盖模块说明和命名差异对照 | System |