# 销售管理模块 - 数据模型规范

> 本文档定义销售管理模块的数据库表结构和实体关系，供前后端开发参考。
> 
> **注意**: 字段命名采用驼峰命名法 (camelCase)，与后端 API 返回格式保持一致。

## 1. 实体关系图 (ER Diagram)

```
┌─────────────────┐       ┌─────────────────┐       ┌─────────────────┐
│    sl_client    │       │   sl_contract   │       │    sl_order     │
│   (客户档案)     │<──────│   (销售合同)     │<──────│   (销售订单)     │
└─────────────────┘       └─────────────────┘       └─────────────────┘
         │                         │                        │
         │                         │                        │
         │                         ▼                        ▼
         │                ┌─────────────────┐       ┌─────────────────┐
         │                │sl_contract_salve│       │  sl_order_salve │
         │                │  (合同产品明细)  │       │  (订单物料明细)  │
         └───────────────>└─────────────────┘       └─────────────────┘
                                                            │
         ┌──────────────────────────────────────────────────┘
         │
         ▼
┌─────────────────┐       ┌─────────────────┐       ┌─────────────────┐
│   sl_deliver    │       │   sl_invoice    │       │   sl_saleback   │
│  (发货通知单)    │       │  (开票结算单)    │       │  (退货通知单)    │
└─────────────────┘       └─────────────────┘       └─────────────────┘
         │                        │                        │
         ▼                        ▼                        ▼
┌─────────────────┐       ┌─────────────────┐       ┌─────────────────┐
│sl_deliver_salve │       │sl_invoice_salve │       │sl_saleback_salve│
│  (发货明细)      │       │  (开票明细)      │       │  (退货明细)      │
└─────────────────┘       └─────────────────┘       └─────────────────┘

                    ┌─────────────────┐
                    │     md_item     │
                    │   (物料主数据)   │
                    └─────────────────┘
                            │
                            ▼
                    ┌─────────────────┐
                    │   wm_warehouse  │
                    │     (仓库)      │
                    └─────────────────┘
```

---

## 2. 客户档案 (sl_client)

### 2.1 主表结构 (SlClient)

> API 路径: `/sl/client`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| clientId | bigint | - | N | - | 客户ID (主键) |
| clientCode | varchar | 32 | N | - | 客户编码 |
| clientName | varchar | 100 | N | - | 客户名称 |
| clientNick | varchar | 50 | Y | - | 客户简称 |
| clientEn | varchar | 100 | Y | - | 英文名称 |
| clientDes | varchar | 500 | Y | - | 客户描述 |
| clientLogo | varchar | 200 | Y | - | 客户Logo |
| clientType | varchar | 20 | Y | - | 客户类型 |
| clientLevel | varchar | 10 | Y | 'B' | 客户级别(A/B/C/D) |
| clientSource | varchar | 50 | Y | - | 客户来源 |
| clientIndustry | varchar | 50 | Y | - | 所属行业 |
| address | varchar | 200 | Y | - | 地址 |
| website | varchar | 200 | Y | - | 网址 |
| email | varchar | 100 | Y | - | 邮箱 |
| tel | varchar | 20 | Y | - | 电话 |
| contact1 | varchar | 50 | Y | - | 联系人1 |
| contact1Tel | varchar | 20 | Y | - | 联系人1电话 |
| contact2 | varchar | 50 | Y | - | 联系人2 |
| contact2Tel | varchar | 20 | Y | - | 联系人2电话 |
| creditCode | varchar | 30 | Y | - | 信用代码 |
| enableFlag | char | 1 | N | 'Y' | 启用状态(Y/N) |
| delFlag | char | 1 | N | '0' | 删除标志 |
| createBy | varchar | 64 | Y | - | 创建者 |
| createTime | datetime | - | Y | - | 创建时间 |
| updateBy | varchar | 64 | Y | - | 更新者 |
| updateTime | datetime | - | Y | - | 更新时间 |
| tenantId | varchar | 20 | N | - | 租户ID |

### 2.2 开票信息 (客户表扩展字段)

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| bankName | varchar | 100 | Y | 开户银行 |
| bankAccount | varchar | 30 | Y | 银行账号 |
| taxNo | varchar | 20 | Y | 税号 |
| invoiceAddress | varchar | 200 | Y | 开票地址电话 |

---

## 3. 销售订单 (sl_order)

### 3.1 主表结构 (SlOrderMaster)

> API 路径: `/sl/order`

| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|--------|------|------|--------|--------|------|
| orderId | bigint | - | N | - | 订单ID (主键) |
| orderCode | varchar | 32 | N | - | 订单编号 |
| orderName | varchar | 100 | Y | - | 订单名称 |
| orderDate | date | - | N | - | 订单日期 |
| orderStatus | varchar | 20 | N | 'DRAFT' | 订单状态 |
| clientId | bigint | - | N | - | 客户ID |
| clientCode | varchar | 32 | Y | - | 客户编码(冗余) |
| clientName | varchar | 100 | Y | - | 客户名称(冗余) |
| deliveryDate | date | - | Y | - | 交货日期 |
| totalAmount | decimal | 18,2 | Y | 0 | 订单总金额 |
| remark | varchar | 500 | Y | - | 备注 |
| delFlag | char | 1 | N | '0' | 删除标志 |
| createBy | varchar | 64 | Y | - | 创建者 |
| createTime | datetime | - | Y | - | 创建时间 |
| updateBy | varchar | 64 | Y | - | 更新者 |
| updateTime | datetime | - | Y | - | 更新时间 |
| tenantId | varchar | 20 | N | - | 租户ID |

#### 订单状态枚举 (orderStatus)

| 值 | 说明 |
|----|------|
| DRAFT | 草稿 |
| SUBMITTED | 已提交 |
| APPROVED | 已审批 |
| REJECTED | 已驳回 |
| CLOSED | 已关闭 |
| CANCELLED | 已取消 |

### 3.2 明细表结构 (SlOrderSalve)

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| lineId | bigint | - | N | 行ID (主键) |
| orderId | bigint | - | N | 订单ID (外键) |
| itemId | bigint | - | N | 物料ID |
| itemCode | varchar | 32 | Y | 物料编码 |
| itemName | varchar | 100 | Y | 物料名称 |
| specification | varchar | 100 | Y | 规格型号 |
| unitOfMeasure | varchar | 20 | Y | 计量单位 |
| quantity | decimal | 18,4 | N | 数量 |
| unitPrice | decimal | 18,4 | Y | 单价 |
| amount | decimal | 18,2 | Y | 金额 |
| deliveredQty | decimal | 18,4 | Y | 已发货数量 |
| remark | varchar | 500 | Y | 备注 |
| delFlag | char | 1 | N | 删除标志 |

### 3.3 索引设计

```sql
-- 主表索引
CREATE INDEX idx_sl_order_code ON sl_order(orderCode);
CREATE INDEX idx_sl_order_client ON sl_order(clientId);
CREATE INDEX idx_sl_order_date ON sl_order(orderDate);
CREATE INDEX idx_sl_order_status ON sl_order(orderStatus);
CREATE INDEX idx_sl_order_tenant ON sl_order(tenantId);

-- 明细表索引
CREATE INDEX idx_sl_order_salve_order ON sl_order_salve(orderId);
CREATE INDEX idx_sl_order_salve_item ON sl_order_salve(itemId);
```

---

## 4. 发货单 (sl_deliver)

### 4.1 主表结构 (SlDeliverMaster)

> API 路径: `/sl/deliver`

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| deliverId | bigint | - | N | 发货单ID (主键) |
| deliverCode | varchar | 32 | N | 发货单编号 |
| deliverName | varchar | 100 | Y | 发货单名称 |
| deliverDate | date | - | N | 发货日期 |
| orderId | bigint | - | Y | 销售订单ID |
| clientId | bigint | - | N | 客户ID |
| clientName | varchar | 100 | Y | 客户名称 |
| warehouseId | bigint | - | N | 发货仓库ID |
| warehouseName | varchar | 50 | Y | 仓库名称 |
| status | varchar | 20 | N | 状态 |
| remark | varchar | 500 | Y | 备注 |
| delFlag | char | 1 | N | 删除标志 |
| createBy | varchar | 64 | Y | 创建者 |
| createTime | datetime | - | Y | 创建时间 |
| updateBy | varchar | 64 | Y | 更新者 |
| updateTime | datetime | - | Y | 更新时间 |
| tenantId | varchar | 20 | N | 租户ID |

### 4.2 明细表结构 (SlDeliverSalve)

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| lineId | bigint | - | N | 行ID (主键) |
| deliverId | bigint | - | N | 发货单ID (外键) |
| orderId | bigint | - | Y | 来源订单ID |
| orderLineId | bigint | - | Y | 来源订单明细ID |
| itemId | bigint | - | N | 物料ID |
| itemCode | varchar | 32 | Y | 物料编码 |
| itemName | varchar | 100 | Y | 物料名称 |
| specification | varchar | 100 | Y | 规格型号 |
| unitOfMeasure | varchar | 20 | Y | 计量单位 |
| orderQty | decimal | 18,4 | Y | 订单数量 |
| deliveredQty | decimal | 18,4 | Y | 已发数量 |
| deliverQty | decimal | 18,4 | N | 本次发货数量 |
| remark | varchar | 500 | Y | 备注 |
| delFlag | char | 1 | N | 删除标志 |

---

## 5. 销售发票 (sl_invoice)

### 5.1 主表结构 (SlInvoiceMaster)

> API 路径: `/sl/invoice`

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| invoiceId | bigint | - | N | 发票ID (主键) |
| invoiceCode | varchar | 32 | N | 发票编号 |
| invoiceName | varchar | 100 | Y | 发票名称 |
| invoiceDate | date | - | N | 发票日期 |
| clientId | bigint | - | N | 客户ID |
| clientName | varchar | 100 | Y | 客户名称 |
| invoiceTitle | varchar | 100 | Y | 开票名称 |
| taxRate | decimal | 5,2 | Y | 税率 |
| invoiceType | varchar | 20 | Y | 发票类型 |
| bankName | varchar | 100 | Y | 开户行 |
| bankAccount | varchar | 30 | Y | 银行账号 |
| taxNo | varchar | 20 | Y | 税号 |
| totalAmount | decimal | 18,2 | Y | 总金额 |
| taxAmount | decimal | 18,2 | Y | 税额 |
| status | varchar | 20 | N | 状态 |
| remark | varchar | 500 | Y | 备注 |
| delFlag | char | 1 | N | 删除标志 |
| createBy | varchar | 64 | Y | 创建者 |
| createTime | datetime | - | Y | 创建时间 |
| updateBy | varchar | 64 | Y | 更新者 |
| updateTime | datetime | - | Y | 更新时间 |
| tenantId | varchar | 20 | N | 租户ID |

### 5.2 明细表结构 (SlInvoiceSalve)

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| lineId | bigint | - | N | 行ID (主键) |
| invoiceId | bigint | - | N | 发票ID (外键) |
| deliverId | bigint | - | Y | 来源发货单ID |
| deliverLineId | bigint | - | Y | 来源发货明细ID |
| itemId | bigint | - | N | 物料ID |
| itemCode | varchar | 32 | Y | 物料编码 |
| itemName | varchar | 100 | Y | 物料名称 |
| specification | varchar | 100 | Y | 规格型号 |
| unitOfMeasure | varchar | 20 | Y | 计量单位 |
| quantity | decimal | 18,4 | N | 数量 |
| unitPrice | decimal | 18,4 | Y | 单价 |
| amount | decimal | 18,2 | Y | 金额 |
| remark | varchar | 500 | Y | 备注 |
| delFlag | char | 1 | N | 删除标志 |

---

## 6. 退货单 (sl_saleback)

### 6.1 主表结构 (SlSalebackMaster)

> API 路径: `/sl/saleback`

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| salebackId | bigint | - | N | 退货单ID (主键) |
| salebackCode | varchar | 32 | N | 退货单编号 |
| salebackDate | date | - | N | 退货日期 |
| orderId | bigint | - | Y | 原销售订单ID |
| clientId | bigint | - | N | 客户ID |
| clientName | varchar | 100 | Y | 客户名称 |
| reason | varchar | 200 | Y | 退货原因 |
| status | varchar | 20 | N | 状态 |
| remark | varchar | 500 | Y | 备注 |
| delFlag | char | 1 | N | 删除标志 |
| createBy | varchar | 64 | Y | 创建者 |
| createTime | datetime | - | Y | 创建时间 |
| updateBy | varchar | 64 | Y | 更新者 |
| updateTime | datetime | - | Y | 更新时间 |
| tenantId | varchar | 20 | N | 租户ID |

### 6.2 明细表结构 (SlSalebackSalve)

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| lineId | bigint | - | N | 行ID (主键) |
| salebackId | bigint | - | N | 退货单ID (外键) |
| deliverId | bigint | - | Y | 来源发货单ID |
| deliverLineId | bigint | - | Y | 来源发货明细ID |
| itemId | bigint | - | N | 物料ID |
| itemCode | varchar | 32 | Y | 物料编码 |
| itemName | varchar | 100 | Y | 物料名称 |
| specification | varchar | 100 | Y | 规格型号 |
| unitOfMeasure | varchar | 20 | Y | 计量单位 |
| deliveredQty | decimal | 18,4 | Y | 已发数量 |
| returnQty | decimal | 18,4 | N | 退货数量 |
| remark | varchar | 500 | Y | 备注 |
| delFlag | char | 1 | N | 删除标志 |

---

## 7. 物料主数据 (md_item)

### 7.1 主表结构 (MdItem)

> API 路径: `/md/item`

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| itemId | bigint | - | N | 物料ID (主键) |
| itemCode | varchar | 32 | N | 物料编码 |
| itemName | varchar | 100 | N | 物料名称 |
| specification | varchar | 100 | Y | 规格型号 |
| unitOfMeasure | varchar | 20 | Y | 计量单位 |
| itemTypeId | bigint | - | Y | 物料分类ID |
| itemTypeName | varchar | 50 | Y | 物料分类名称 |
| itemOrProduct | varchar | 20 | Y | 物料/产品 (ITEM/PRODUCT) |
| safeStockFlag | char | 1 | Y | 是否启用安全库存(Y/N) |
| minStock | decimal | 18,4 | Y | 最小库存 |
| maxStock | decimal | 18,4 | Y | 最大库存 |
| enableFlag | char | 1 | N | 启用状态(Y/N) |
| remark | varchar | 500 | Y | 备注 |
| delFlag | char | 1 | N | 删除标志 |
| createBy | varchar | 64 | Y | 创建者 |
| createTime | datetime | - | Y | 创建时间 |
| updateBy | varchar | 64 | Y | 更新者 |
| updateTime | datetime | - | Y | 更新时间 |
| tenantId | varchar | 20 | N | 租户ID |

### 7.2 物料分类 (MdItemType)

> API 路径: `/md/itemtype`

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| itemTypeId | bigint | - | N | 分类ID (主键) |
| itemTypeCode | varchar | 32 | N | 分类编码 |
| itemTypeName | varchar | 50 | N | 分类名称 |
| parentTypeId | bigint | - | Y | 父分类ID |
| orderNum | int | - | Y | 排序号 |
| enableFlag | char | 1 | N | 启用状态(Y/N) |

---

## 8. 仓库 (wm_warehouse)

### 8.1 仓库主表

> API 路径: `/wm/warehouse`

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| warehouseId | bigint | - | N | 仓库ID (主键) |
| warehouseCode | varchar | 32 | N | 仓库编码 |
| warehouseName | varchar | 50 | N | 仓库名称 |
| location | varchar | 100 | Y | 位置 |
| area | decimal | 10,2 | Y | 面积 |
| charge | varchar | 50 | Y | 负责人 |
| enableFlag | char | 1 | N | 启用状态(Y/N) |

### 8.2 库存 (wm_stock)

> API 路径: `/wm/stock`

| 字段名 | 类型 | 长度 | 允许空 | 说明 |
|--------|------|------|--------|------|
| stockId | bigint | - | N | 库存ID (主键) |
| itemId | bigint | - | N | 物料ID |
| itemCode | varchar | 32 | Y | 物料编码 |
| itemName | varchar | 100 | Y | 物料名称 |
| warehouseId | bigint | - | N | 仓库ID |
| warehouseName | varchar | 50 | Y | 仓库名称 |
| quantityOnHand | decimal | 18,4 | Y | 在库数量 |
| quantityLocked | decimal | 18,4 | Y | 锁定数量 |
| quantityAvailable | decimal | 18,4 | Y | 可用数量 |

---

## 9. 视图设计

### 9.1 销售订单明细视图 (v_sl_order_detail)

```sql
CREATE VIEW v_sl_order_detail AS
SELECT 
    o.orderId,
    o.orderCode,
    o.orderDate,
    o.orderStatus,
    o.clientId,
    o.clientName,
    o.deliveryDate,
    o.totalAmount,
    s.lineId,
    s.itemId,
    s.itemCode,
    s.itemName,
    s.specification,
    s.unitOfMeasure,
    s.quantity,
    s.unitPrice,
    s.amount,
    s.deliveredQty,
    (s.quantity - COALESCE(s.deliveredQty, 0)) AS undeliveredQty
FROM sl_order o
LEFT JOIN sl_order_salve s ON o.orderId = s.orderId AND s.delFlag = '0'
WHERE o.delFlag = '0';
```

### 9.2 7天交货明细视图 (v_sl_7day_delivery)

```sql
CREATE VIEW v_sl_7day_delivery AS
SELECT 
    o.orderId,
    o.orderCode,
    o.orderDate,
    o.clientId,
    o.clientName,
    o.deliveryDate,
    s.itemId,
    s.itemCode,
    s.itemName,
    s.quantity AS orderQty,
    s.deliveredQty,
    (s.quantity - COALESCE(s.deliveredQty, 0)) AS undeliveredQty
FROM sl_order o
LEFT JOIN sl_order_salve s ON o.orderId = s.orderId AND s.delFlag = '0'
WHERE o.delFlag = '0'
  AND o.orderStatus = 'APPROVED'
  AND o.deliveryDate BETWEEN CURDATE() AND DATE_ADD(CURDATE(), INTERVAL 7 DAY)
  AND (s.quantity - COALESCE(s.deliveredQty, 0)) > 0;
```

---

## 10. 状态枚举定义

### 10.1 单据状态 (status / orderStatus)

| 状态值 | 说明 |
|--------|------|
| DRAFT | 草稿 |
| SUBMITTED | 已提交 |
| APPROVED | 已审批 |
| REJECTED | 已驳回 |
| CLOSED | 已关闭 |
| CANCELLED | 已取消 |

### 10.2 启用状态 (enableFlag)

| 状态值 | 说明 |
|--------|------|
| Y | 启用 |
| N | 停用 |

### 10.3 物料类型 (itemOrProduct)

| 状态值 | 说明 |
|--------|------|
| ITEM | 物料 |
| PRODUCT | 产品 |

---

## 11. API 模块路径对照

| 模块 | API路径前缀 | 说明 |
|------|-------------|------|
| 销售模块 | /sl | Sales |
| 仓库模块 | /wm | Warehouse Management |
| 物料模块 | /md | Master Data |
| 采购模块 | /po | Procurement |
| 生产模块 | /pd | Production |
| 计划模块 | /pl | Planning |
| 研发模块 | /rd | Research & Development |
| 委外模块 | /pu | Outsourcing |
| 财务模块 | /fd | Finance |