522 lines
21 KiB
Markdown
522 lines
21 KiB
Markdown
|
# 采购管理模块 - 数据模型
|
||
|
|
|
||
|
|
> 本文档定义采购管理模块的数据库表结构、实体关系和视图设计。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 1. 实体关系图 (ER Diagram)
|
||
|
|
|
||
|
|
```
|
||
|
|
┌─────────────────┐ 1:N ┌─────────────────┐
|
||
|
|
│ po_supplier │◄─────────────►│ po_order │
|
||
|
|
│ (供应商) │ │ (采购订单) │
|
||
|
|
└─────────────────┘ └────────┬────────┘
|
||
|
|
│ 1:N
|
||
|
|
▼
|
||
|
|
┌─────────────────┐
|
||
|
|
│ po_order_line │
|
||
|
|
│ (采购订单明细) │
|
||
|
|
└────────┬────────┘
|
||
|
|
│
|
||
|
|
┌───────────────────────────────┼───────────────────────────────┐
|
||
|
|
│ │ │
|
||
|
|
▼ 1:N ▼ 1:N ▼ 1:N
|
||
|
|
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
||
|
|
│ po_checkin │ │ po_invoice │ │ po_reject │
|
||
|
|
│ (采购到货) │ │ (采购发票) │ │ (采购退货) │
|
||
|
|
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
|
||
|
|
│ 1:N │ 1:N │ 1:N
|
||
|
|
▼ ▼ ▼
|
||
|
|
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
||
|
|
│ po_checkin_line │ │ po_invoice_line │ │ po_reject_line │
|
||
|
|
│ (到货单明细) │ │ (发票明细) │ │ (退货单明细) │
|
||
|
|
└─────────────────┘ └─────────────────┘ └─────────────────┘
|
||
|
|
|
||
|
|
关联表：
|
||
|
|
┌─────────────────┐
|
||
|
|
│ md_item │ ◄──── 采购订单明细、到货明细、退货明细关联
|
||
|
|
│ (物料档案) │
|
||
|
|
└─────────────────┘
|
||
|
|
|
||
|
|
┌─────────────────┐
|
||
|
|
│ wm_warehouse │ ◄──── 到货单、入库单关联
|
||
|
|
│ (仓库) │
|
||
|
|
└─────────────────┘
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. 供应商档案表 (po_supplier)
|
||
|
|
|
||
|
|
> API 路径: `/po/supplier`
|
||
|
|
|
||
|
|
### 2.1 主表结构
|
||
|
|
|
||
|
|
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|
||
|
|
|--------|------|------|--------|--------|------|
|
||
|
|
| supplierId | bigint | - | N | - | 供应商ID (主键) |
|
||
|
|
| supplierCode | varchar | 32 | N | - | 供应商编码 |
|
||
|
|
| supplierName | varchar | 100 | N | - | 供应商名称 |
|
||
|
|
| supplierAlias | varchar | 100 | Y | - | 供应商别名 |
|
||
|
|
| supplierNick | varchar | 50 | Y | - | 供应商简称 |
|
||
|
|
| supplierType | varchar | 20 | Y | - | 供应商分类 |
|
||
|
|
| supplierLevel | varchar | 10 | Y | 'B' | 供应商等级(A/B/C/D) |
|
||
|
|
| province | varchar | 50 | Y | - | 省份 |
|
||
|
|
| city | varchar | 50 | Y | - | 城市 |
|
||
|
|
| address | varchar | 200 | Y | - | 公司地址 |
|
||
|
|
| zipCode | varchar | 10 | Y | - | 邮编 |
|
||
|
|
| tel | varchar | 20 | Y | - | 电话 |
|
||
|
|
| fax | varchar | 20 | Y | - | 传真 |
|
||
|
|
| email | varchar | 100 | Y | - | 邮箱 |
|
||
|
|
| website | varchar | 200 | Y | - | 网址 |
|
||
|
|
| contact1 | varchar | 50 | Y | - | 业务联系人 |
|
||
|
|
| contact1Tel | varchar | 20 | Y | - | 业务联系人电话 |
|
||
|
|
| contact2 | varchar | 50 | Y | - | 财务联系人 |
|
||
|
|
| contact2Tel | varchar | 20 | Y | - | 财务联系人电话 |
|
||
|
|
| bankName | varchar | 100 | Y | - | 开户银行 |
|
||
|
|
| bankAccount | varchar | 30 | Y | - | 银行账号 |
|
||
|
|
| bankAddress | varchar | 200 | Y | - | 开票地址电话 |
|
||
|
|
| taxNo | varchar | 30 | Y | - | 税号 |
|
||
|
|
| supplyItems | varchar | 500 | Y | - | 供应料品(逗号分隔) |
|
||
|
|
| remark | varchar | 500 | 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 索引设计
|
||
|
|
|
||
|
|
| 索引名 | 索引字段 | 类型 | 说明 |
|
||
|
|
|--------|----------|------|------|
|
||
|
|
| pk_supplier | supplierId | 主键 | 主键索引 |
|
||
|
|
| uk_supplier_code | supplierCode, tenantId | 唯一 | 供应商编码唯一 |
|
||
|
|
| idx_supplier_name | supplierName | 普通 | 名称查询 |
|
||
|
|
| idx_supplier_tenant | tenantId | 普通 | 租户筛选 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 3. 采购订单表 (po_order)
|
||
|
|
|
||
|
|
> API 路径: `/po/order`
|
||
|
|
|
||
|
|
### 3.1 主表结构
|
||
|
|
|
||
|
|
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|
||
|
|
|--------|------|------|--------|--------|------|
|
||
|
|
| orderId | bigint | - | N | - | 订单ID (主键) |
|
||
|
|
| orderCode | varchar | 32 | N | - | 订单编码 |
|
||
|
|
| orderDate | date | - | N | - | 订单日期 |
|
||
|
|
| status | varchar | 20 | N | 'DRAFT' | 单据状态 |
|
||
|
|
| businessStatus | varchar | 20 | Y | 'NORMAL' | 业务状态 |
|
||
|
|
| businessType | varchar | 20 | N | - | 业务类型 |
|
||
|
|
| orderType | varchar | 20 | N | - | 单据类型 |
|
||
|
|
| materialNeed | varchar | 20 | N | - | 用料需求 |
|
||
|
|
| supplierId | bigint | - | Y | - | 供应商ID |
|
||
|
|
| supplierName | varchar | 100 | Y | - | 供应商名称 |
|
||
|
|
| deptId | bigint | - | Y | - | 采购部门ID |
|
||
|
|
| deptName | varchar | 50 | Y | - | 采购部门名称 |
|
||
|
|
| userId | bigint | - | Y | - | 采购人员ID |
|
||
|
|
| userName | varchar | 50 | Y | - | 采购人员名称 |
|
||
|
|
| deliveryDate | date | - | Y | - | 到货日期 |
|
||
|
|
| contractNo | varchar | 50 | Y | - | 合同号 |
|
||
|
|
| contractFile | varchar | 500 | Y | - | 合同附件 |
|
||
|
|
| totalQuantity | decimal | 18,4 | Y | 0 | 总数量 |
|
||
|
|
| totalAmount | decimal | 18,2 | Y | 0 | 总金额 |
|
||
|
|
| arrivedQuantity | decimal | 18,4 | Y | 0 | 已到货数量 |
|
||
|
|
| remark | varchar | 500 | Y | - | 备注 |
|
||
|
|
| operatorId | bigint | - | Y | - | 操作员ID |
|
||
|
|
| operatorName | varchar | 50 | Y | - | 操作员名称 |
|
||
|
|
| approverId | bigint | - | Y | - | 审核员ID |
|
||
|
|
| approverName | varchar | 50 | Y | - | 审核员名称 |
|
||
|
|
| approveDate | datetime | - | 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 |
|
||
|
|
|
||
|
|
### 3.2 明细表结构 (po_order_line)
|
||
|
|
|
||
|
|
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|
||
|
|
|--------|------|------|--------|--------|------|
|
||
|
|
| lineId | bigint | - | N | - | 明细ID (主键) |
|
||
|
|
| orderId | bigint | - | N | - | 订单ID (外键) |
|
||
|
|
| orderCode | varchar | 32 | N | - | 订单编码 |
|
||
|
|
| lineNo | int | - | N | - | 行号 |
|
||
|
|
| trackCode | varchar | 32 | Y | - | 跟单编号 |
|
||
|
|
| planCode | varchar | 32 | Y | - | 计划单号 |
|
||
|
|
| planLineId | bigint | - | Y | - | 计划明细ID |
|
||
|
|
| itemId | bigint | - | N | - | 物料ID |
|
||
|
|
| itemCode | varchar | 32 | N | - | 物料编码 |
|
||
|
|
| itemName | varchar | 100 | N | - | 物料名称 |
|
||
|
|
| specification | varchar | 200 | Y | - | 型号规格 |
|
||
|
|
| unitId | bigint | - | Y | - | 计量单位ID |
|
||
|
|
| unitName | varchar | 20 | Y | - | 计量单位 |
|
||
|
|
| needDate | date | - | Y | - | 需求日期 |
|
||
|
|
| quantity | decimal | 18,4 | N | 0 | 采购数量 |
|
||
|
|
| unitPrice | decimal | 18,4 | Y | 0 | 采购单价 |
|
||
|
|
| amount | decimal | 18,2 | Y | 0 | 金额 |
|
||
|
|
| arrivedQuantity | decimal | 18,4 | Y | 0 | 已到货数量 |
|
||
|
|
| remark | varchar | 200 | Y | - | 采购说明 |
|
||
|
|
| delFlag | char | 1 | N | '0' | 删除标志 |
|
||
|
|
| createTime | datetime | - | Y | - | 创建时间 |
|
||
|
|
| tenantId | varchar | 20 | N | - | 租户ID |
|
||
|
|
|
||
|
|
### 3.3 索引设计
|
||
|
|
|
||
|
|
| 索引名 | 索引字段 | 类型 | 说明 |
|
||
|
|
|--------|----------|------|------|
|
||
|
|
| pk_order | orderId | 主键 | 主键索引 |
|
||
|
|
| uk_order_code | orderCode, tenantId | 唯一 | 订单编码唯一 |
|
||
|
|
| idx_order_supplier | supplierId | 普通 | 供应商查询 |
|
||
|
|
| idx_order_date | orderDate | 普通 | 日期查询 |
|
||
|
|
| idx_order_status | status | 普通 | 状态查询 |
|
||
|
|
| pk_order_line | lineId | 主键 | 明细主键 |
|
||
|
|
| idx_line_order | orderId | 普通 | 订单关联 |
|
||
|
|
| idx_line_item | itemId | 普通 | 物料查询 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 4. 采购到货单表 (po_checkin)
|
||
|
|
|
||
|
|
> API 路径: `/po/checkin`
|
||
|
|
|
||
|
|
### 4.1 主表结构
|
||
|
|
|
||
|
|
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|
||
|
|
|--------|------|------|--------|--------|------|
|
||
|
|
| checkinId | bigint | - | N | - | 到货单ID (主键) |
|
||
|
|
| checkinCode | varchar | 32 | N | - | 到货单编码 |
|
||
|
|
| checkinDate | date | - | N | - | 到货日期 |
|
||
|
|
| status | varchar | 20 | N | 'DRAFT' | 单据状态 |
|
||
|
|
| businessType | varchar | 20 | N | - | 业务类型 |
|
||
|
|
| orderId | bigint | - | Y | - | 采购订单ID |
|
||
|
|
| orderCode | varchar | 32 | Y | - | 采购订单编码 |
|
||
|
|
| supplierId | bigint | - | Y | - | 供应商ID |
|
||
|
|
| supplierName | varchar | 100 | Y | - | 供应商名称 |
|
||
|
|
| warehouseId | bigint | - | Y | - | 仓库ID |
|
||
|
|
| warehouseName | varchar | 50 | Y | - | 仓库名称 |
|
||
|
|
| totalQuantity | decimal | 18,4 | Y | 0 | 总到货数量 |
|
||
|
|
| stockedQuantity | decimal | 18,4 | Y | 0 | 已入库数量 |
|
||
|
|
| remark | varchar | 500 | Y | - | 备注 |
|
||
|
|
| operatorId | bigint | - | Y | - | 操作员ID |
|
||
|
|
| operatorName | varchar | 50 | Y | - | 操作员名称 |
|
||
|
|
| approverId | bigint | - | Y | - | 审核员ID |
|
||
|
|
| approverName | varchar | 50 | Y | - | 审核员名称 |
|
||
|
|
| approveDate | datetime | - | 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 |
|
||
|
|
|
||
|
|
### 4.2 明细表结构 (po_checkin_line)
|
||
|
|
|
||
|
|
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|
||
|
|
|--------|------|------|--------|--------|------|
|
||
|
|
| lineId | bigint | - | N | - | 明细ID (主键) |
|
||
|
|
| checkinId | bigint | - | N | - | 到货单ID (外键) |
|
||
|
|
| checkinCode | varchar | 32 | N | - | 到货单编码 |
|
||
|
|
| lineNo | int | - | N | - | 行号 |
|
||
|
|
| orderLineId | bigint | - | Y | - | 采购订单明细ID |
|
||
|
|
| trackCode | varchar | 32 | Y | - | 跟单编号 |
|
||
|
|
| itemId | bigint | - | N | - | 物料ID |
|
||
|
|
| itemCode | varchar | 32 | N | - | 物料编码 |
|
||
|
|
| itemName | varchar | 100 | N | - | 物料名称 |
|
||
|
|
| specification | varchar | 200 | Y | - | 型号规格 |
|
||
|
|
| unitName | varchar | 20 | Y | - | 计量单位 |
|
||
|
|
| orderQuantity | decimal | 18,4 | Y | 0 | 订单数量 |
|
||
|
|
| quantity | decimal | 18,4 | N | 0 | 到货数量 |
|
||
|
|
| stockedQuantity | decimal | 18,4 | Y | 0 | 已入库数量 |
|
||
|
|
| remark | varchar | 200 | Y | - | 备注 |
|
||
|
|
| delFlag | char | 1 | N | '0' | 删除标志 |
|
||
|
|
| createTime | datetime | - | Y | - | 创建时间 |
|
||
|
|
| tenantId | varchar | 20 | N | - | 租户ID |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 5. 采购发票表 (po_invoice)
|
||
|
|
|
||
|
|
> API 路径: `/po/invoice`
|
||
|
|
|
||
|
|
### 5.1 主表结构
|
||
|
|
|
||
|
|
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|
||
|
|
|--------|------|------|--------|--------|------|
|
||
|
|
| invoiceId | bigint | - | N | - | 发票ID (主键) |
|
||
|
|
| invoiceCode | varchar | 32 | N | - | 发票单据编码 |
|
||
|
|
| invoiceDate | date | - | N | - | 单据日期 |
|
||
|
|
| status | varchar | 20 | N | 'DRAFT' | 单据状态 |
|
||
|
|
| financeStatus | varchar | 20 | N | 'RECORDED' | 财务状态 |
|
||
|
|
| businessType | varchar | 20 | N | - | 业务类型 |
|
||
|
|
| supplierId | bigint | - | N | - | 供应商ID |
|
||
|
|
| supplierName | varchar | 100 | N | - | 供应商名称 |
|
||
|
|
| invoiceNo | varchar | 50 | Y | - | 发票号码 |
|
||
|
|
| invoiceAmount | decimal | 18,2 | N | 0 | 发票金额(不含税) |
|
||
|
|
| taxRate | decimal | 5,2 | Y | 0 | 税率(%) |
|
||
|
|
| taxAmount | decimal | 18,2 | Y | 0 | 税额 |
|
||
|
|
| totalAmount | decimal | 18,2 | Y | 0 | 价税合计 |
|
||
|
|
| remark | varchar | 500 | Y | - | 备注 |
|
||
|
|
| operatorId | bigint | - | Y | - | 操作员ID |
|
||
|
|
| operatorName | varchar | 50 | Y | - | 操作员名称 |
|
||
|
|
| approverId | bigint | - | Y | - | 审核员ID |
|
||
|
|
| approverName | varchar | 50 | Y | - | 审核员名称 |
|
||
|
|
| approveDate | datetime | - | 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 |
|
||
|
|
|
||
|
|
### 5.2 明细表结构 (po_invoice_line)
|
||
|
|
|
||
|
|
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|
||
|
|
|--------|------|------|--------|--------|------|
|
||
|
|
| lineId | bigint | - | N | - | 明细ID (主键) |
|
||
|
|
| invoiceId | bigint | - | N | - | 发票ID (外键) |
|
||
|
|
| invoiceCode | varchar | 32 | N | - | 发票单据编码 |
|
||
|
|
| lineNo | int | - | N | - | 行号 |
|
||
|
|
| checkinLineId | bigint | - | Y | - | 到货明细ID |
|
||
|
|
| itemId | bigint | - | N | - | 物料ID |
|
||
|
|
| itemCode | varchar | 32 | N | - | 物料编码 |
|
||
|
|
| itemName | varchar | 100 | N | - | 物料名称 |
|
||
|
|
| specification | varchar | 200 | Y | - | 型号规格 |
|
||
|
|
| unitName | varchar | 20 | Y | - | 计量单位 |
|
||
|
|
| quantity | decimal | 18,4 | N | 0 | 开票数量 |
|
||
|
|
| unitPrice | decimal | 18,4 | Y | 0 | 单价 |
|
||
|
|
| amount | decimal | 18,2 | Y | 0 | 金额 |
|
||
|
|
| taxAmount | decimal | 18,2 | Y | 0 | 税额 |
|
||
|
|
| remark | varchar | 200 | Y | - | 备注 |
|
||
|
|
| delFlag | char | 1 | N | '0' | 删除标志 |
|
||
|
|
| createTime | datetime | - | Y | - | 创建时间 |
|
||
|
|
| tenantId | varchar | 20 | N | - | 租户ID |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 6. 采购退货单表 (po_reject)
|
||
|
|
|
||
|
|
> API 路径: `/po/reject`
|
||
|
|
|
||
|
|
### 6.1 主表结构
|
||
|
|
|
||
|
|
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|
||
|
|
|--------|------|------|--------|--------|------|
|
||
|
|
| rejectId | bigint | - | N | - | 退货单ID (主键) |
|
||
|
|
| rejectCode | varchar | 32 | N | - | 退货单编码 |
|
||
|
|
| rejectDate | date | - | N | - | 退货日期 |
|
||
|
|
| status | varchar | 20 | N | 'DRAFT' | 单据状态 |
|
||
|
|
| businessType | varchar | 20 | N | - | 业务类型 |
|
||
|
|
| supplierId | bigint | - | N | - | 供应商ID |
|
||
|
|
| supplierName | varchar | 100 | N | - | 供应商名称 |
|
||
|
|
| checkinId | bigint | - | Y | - | 到货单ID |
|
||
|
|
| checkinCode | varchar | 32 | Y | - | 到货单编码 |
|
||
|
|
| totalQuantity | decimal | 18,4 | Y | 0 | 退货总数量 |
|
||
|
|
| outQuantity | decimal | 18,4 | Y | 0 | 已出库数量 |
|
||
|
|
| returnQuantity | decimal | 18,4 | Y | 0 | 补收数量 |
|
||
|
|
| reason | varchar | 500 | Y | - | 退货原因 |
|
||
|
|
| remark | varchar | 500 | Y | - | 备注 |
|
||
|
|
| operatorId | bigint | - | Y | - | 操作员ID |
|
||
|
|
| operatorName | varchar | 50 | Y | - | 操作员名称 |
|
||
|
|
| approverId | bigint | - | Y | - | 审核员ID |
|
||
|
|
| approverName | varchar | 50 | Y | - | 审核员名称 |
|
||
|
|
| approveDate | datetime | - | 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 |
|
||
|
|
|
||
|
|
### 6.2 明细表结构 (po_reject_line)
|
||
|
|
|
||
|
|
| 字段名 | 类型 | 长度 | 允许空 | 默认值 | 说明 |
|
||
|
|
|--------|------|------|--------|--------|------|
|
||
|
|
| lineId | bigint | - | N | - | 明细ID (主键) |
|
||
|
|
| rejectId | bigint | - | N | - | 退货单ID (外键) |
|
||
|
|
| rejectCode | varchar | 32 | N | - | 退货单编码 |
|
||
|
|
| lineNo | int | - | N | - | 行号 |
|
||
|
|
| checkinLineId | bigint | - | Y | - | 到货明细ID |
|
||
|
|
| trackCode | varchar | 32 | Y | - | 跟单编号 |
|
||
|
|
| itemId | bigint | - | N | - | 物料ID |
|
||
|
|
| itemCode | varchar | 32 | N | - | 物料编码 |
|
||
|
|
| itemName | varchar | 100 | N | - | 物料名称 |
|
||
|
|
| specification | varchar | 200 | Y | - | 型号规格 |
|
||
|
|
| unitName | varchar | 20 | Y | - | 计量单位 |
|
||
|
|
| quantity | decimal | 18,4 | N | 0 | 退货数量 |
|
||
|
|
| outQuantity | decimal | 18,4 | Y | 0 | 已出库数量 |
|
||
|
|
| returnQuantity | decimal | 18,4 | Y | 0 | 补收数量 |
|
||
|
|
| reason | varchar | 200 | Y | - | 退货原因 |
|
||
|
|
| remark | varchar | 200 | Y | - | 备注 |
|
||
|
|
| delFlag | char | 1 | N | '0' | 删除标志 |
|
||
|
|
| createTime | datetime | - | Y | - | 创建时间 |
|
||
|
|
| tenantId | varchar | 20 | N | - | 租户ID |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 7. 视图设计
|
||
|
|
|
||
|
|
### 7.1 采购订单明细视图 (v_po_order_detail)
|
||
|
|
|
||
|
|
```sql
|
||
|
|
CREATE VIEW v_po_order_detail AS
|
||
|
|
SELECT
|
||
|
|
l.lineId,
|
||
|
|
l.orderId,
|
||
|
|
o.orderCode,
|
||
|
|
o.orderDate,
|
||
|
|
o.status,
|
||
|
|
o.businessType,
|
||
|
|
o.materialNeed,
|
||
|
|
o.supplierId,
|
||
|
|
o.supplierName,
|
||
|
|
l.trackCode,
|
||
|
|
l.planCode,
|
||
|
|
l.itemId,
|
||
|
|
l.itemCode,
|
||
|
|
l.itemName,
|
||
|
|
l.specification,
|
||
|
|
l.unitName,
|
||
|
|
l.needDate,
|
||
|
|
l.quantity AS orderQuantity,
|
||
|
|
l.unitPrice,
|
||
|
|
l.amount,
|
||
|
|
l.arrivedQuantity,
|
||
|
|
(l.quantity - IFNULL(l.arrivedQuantity, 0)) AS pendingQuantity,
|
||
|
|
o.tenantId
|
||
|
|
FROM po_order_line l
|
||
|
|
INNER JOIN po_order o ON l.orderId = o.orderId
|
||
|
|
WHERE l.delFlag = '0' AND o.delFlag = '0';
|
||
|
|
```
|
||
|
|
|
||
|
|
### 7.2 采购执行汇总视图 (v_po_order_summary)
|
||
|
|
|
||
|
|
```sql
|
||
|
|
CREATE VIEW v_po_order_summary AS
|
||
|
|
SELECT
|
||
|
|
i.itemTypeCode AS itemTypeCode,
|
||
|
|
i.itemTypeName AS itemTypeName,
|
||
|
|
l.itemId,
|
||
|
|
l.itemCode,
|
||
|
|
l.itemName,
|
||
|
|
SUM(l.quantity) AS totalOrderQty,
|
||
|
|
SUM(IFNULL(l.arrivedQuantity, 0)) AS totalArrivedQty,
|
||
|
|
SUM(l.quantity - IFNULL(l.arrivedQuantity, 0)) AS totalPendingQty,
|
||
|
|
o.tenantId
|
||
|
|
FROM po_order_line l
|
||
|
|
INNER JOIN po_order o ON l.orderId = o.orderId AND o.status = 'APPROVED'
|
||
|
|
LEFT JOIN md_item i ON l.itemId = i.itemId
|
||
|
|
WHERE l.delFlag = '0' AND o.delFlag = '0'
|
||
|
|
GROUP BY i.itemTypeCode, i.itemTypeName, l.itemId, l.itemCode, l.itemName, o.tenantId;
|
||
|
|
```
|
||
|
|
|
||
|
|
### 7.3 采购到货明细视图 (v_po_checkin_detail)
|
||
|
|
|
||
|
|
```sql
|
||
|
|
CREATE VIEW v_po_checkin_detail AS
|
||
|
|
SELECT
|
||
|
|
l.lineId,
|
||
|
|
l.checkinId,
|
||
|
|
c.checkinCode,
|
||
|
|
c.checkinDate,
|
||
|
|
c.status,
|
||
|
|
c.businessType,
|
||
|
|
c.orderCode,
|
||
|
|
c.supplierId,
|
||
|
|
c.supplierName,
|
||
|
|
l.trackCode,
|
||
|
|
l.itemId,
|
||
|
|
l.itemCode,
|
||
|
|
l.itemName,
|
||
|
|
l.specification,
|
||
|
|
l.unitName,
|
||
|
|
l.orderQuantity,
|
||
|
|
l.quantity AS checkinQuantity,
|
||
|
|
l.stockedQuantity,
|
||
|
|
c.tenantId
|
||
|
|
FROM po_checkin_line l
|
||
|
|
INNER JOIN po_checkin c ON l.checkinId = c.checkinId
|
||
|
|
WHERE l.delFlag = '0' AND c.delFlag = '0';
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 8. 状态枚举定义
|
||
|
|
|
||
|
|
### 8.1 单据状态 (status)
|
||
|
|
|
||
|
|
| 枚举值 | 中文名 | 说明 |
|
||
|
|
|--------|--------|------|
|
||
|
|
| DRAFT | 开立 | 草稿，可编辑 |
|
||
|
|
| APPROVED | 审核 | 已审核，不可编辑 |
|
||
|
|
| CLOSED | 关闭 | 已关闭 |
|
||
|
|
| RETURNED | 退回 | 已退回（发票专用） |
|
||
|
|
|
||
|
|
### 8.2 财务状态 (financeStatus)
|
||
|
|
|
||
|
|
| 枚举值 | 中文名 | 说明 |
|
||
|
|
|--------|--------|------|
|
||
|
|
| RECORDED | 录入 | 已录入 |
|
||
|
|
| ENTERED | 入账 | 已入账 |
|
||
|
|
|
||
|
|
### 8.3 业务状态 (businessStatus)
|
||
|
|
|
||
|
|
| 枚举值 | 中文名 | 说明 |
|
||
|
|
|--------|--------|------|
|
||
|
|
| NORMAL | 正常 | 正常执行 |
|
||
|
|
| PAUSE | 暂停 | 暂停执行 |
|
||
|
|
| CANCEL | 取消 | 已取消 |
|
||
|
|
|
||
|
|
### 8.4 业务类型 (businessType)
|
||
|
|
|
||
|
|
| 枚举值 | 中文名 | 说明 |
|
||
|
|
|--------|--------|------|
|
||
|
|
| RAW_MATERIAL | 原材料 | 原材料采购 |
|
||
|
|
| PARTS | 零部件 | 零部件采购 |
|
||
|
|
| ASSEMBLY | 装配件 | 装配件采购 |
|
||
|
|
| FINISHED | 成品 | 成品采购 |
|
||
|
|
| HARDWARE | 五金件 | 五金件采购 |
|
||
|
|
| PACKAGING | 包装物 | 包装物采购 |
|
||
|
|
|
||
|
|
### 8.5 用料需求 (materialNeed)
|
||
|
|
|
||
|
|
| 枚举值 | 中文名 | 说明 |
|
||
|
|
|--------|--------|------|
|
||
|
|
| ORDER_USE | 订单用料 | 按订单需求采购 |
|
||
|
|
| STOCK_USE | 备库用料 | 备库采购 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 9. API 模块路径对照
|
||
|
|
|
||
|
|
| 业务模块 | API前缀 | 说明 |
|
||
|
|
|----------|---------|------|
|
||
|
|
| 供应商 | /po/supplier | 供应商档案 |
|
||
|
|
| 采购订单 | /po/order | 采购订单 |
|
||
|
|
| 采购到货 | /po/checkin | 采购到货单 |
|
||
|
|
| 采购发票 | /po/invoice | 采购发票 |
|
||
|
|
| 采购退货 | /po/reject | 采购退货单 |
|
||
|
|
| 采购报表 | /po/report | 采购统计报表 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 10. 数据权限说明
|
||
|
|
|
||
|
|
### 10.1 租户隔离
|
||
|
|
|
||
|
|
所有表都包含 `tenantId` 字段，用于多租户数据隔离。
|
||
|
|
|
||
|
|
### 10.2 数据权限范围
|
||
|
|
|
||
|
|
| 权限类型 | 说明 |
|
||
|
|
|----------|------|
|
||
|
|
| 全部数据 | 可查看所有数据 |
|
||
|
|
| 部门数据 | 只能查看本部门数据 |
|
||
|
|
| 部门及以下数据 | 可查看本部门及下级部门数据 |
|
||
|
|
| 仅本人数据 | 只能查看自己创建的数据 |
|