Appearance
0. 整体结构
仓库、产品库存、库存明细三个功能。它们的表关系如下图所示
1. 库存_产品库存、库存明细
1.1 仓库
一些信息字段,仅仅用于展示,没有什么特殊逻辑。
CREATE TABLE `erp_warehouse` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '仓库编号',
`name` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '仓库名称',
`address` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '仓库地址',
`sort` bigint NOT NULL COMMENT '排序',
`remark` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
`principal` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '负责人',
`warehouse_price` decimal(24,6) DEFAULT NULL COMMENT '仓储费,单位:元',
`truckage_price` decimal(24,6) DEFAULT NULL COMMENT '搬运费,单位:元',
`status` tinyint NOT NULL COMMENT '开启状态',
`default_status` bit(1) DEFAULT b'0' COMMENT '是否默认',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 仓库表';
1.2 产品库存
CREATE TABLE `erp_stock` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
`product_id` bigint NOT NULL COMMENT '产品编号',
`warehouse_id` bigint NOT NULL COMMENT '仓库编号',
`count` decimal(24,6) NOT NULL COMMENT '库存数量',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 产品库存表';
① product_id 和 warehouse_id 分别关联对应的产品和仓库。本质上,它就是记录一个产品在某个仓库的库存数量。
② count 是库存数量,注意它使用的是 decimal 类型,默认保留 3 位小数,并不是一个整数。
1.3 库存明细
CREATE TABLE `erp_stock_record` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
`product_id` bigint NOT NULL COMMENT '产品编号',
`warehouse_id` bigint NOT NULL COMMENT '仓库编号',
`count` decimal(24,6) NOT NULL COMMENT '出入库数量',
`total_count` decimal(24,6) NOT NULL COMMENT '总库存量',
`biz_type` tinyint NOT NULL COMMENT '业务类型',
`biz_id` bigint NOT NULL COMMENT '业务编号',
`biz_item_id` bigint NOT NULL COMMENT '业务项编号',
`biz_no` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '业务单号',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=41 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 产品库存明细表';
① product_id 和 warehouse_id 分别关联对应的产品和仓库。count 是出入库数量,total_count 是总库存量。
本质上,它是记录一个产品在某个仓库的库存变化(出入库)数量。其中 count 为正数表示入库,为负数表示出库。
② biz_type 是业务类型,比如采购入库、销售出库等。 biz_id 和 biz_item_id、biz_no 用于关联对应的业务单据信息。
有一点要注意,每个出入库操作是可以取消的,所以在 biz_type 都有一个 _CANCEL 的对应类型。例如说采购入库 PURCHASE_IN 对应的取消类型是 PURCHASE_IN_CANCEL。此时,会有两条记录:
一条是 PURCHASE_IN 的 count 正数入库 一条是 PURCHASE_IN_CANCEL 的 count 负数出库
2. 库存_其它入库、其它出库
2.0 库关系
库存管理的其它入库、其它出库
2.1 其它入库
erp_stock_in 表和 erp_stock_in_item 表,分别对应入库单和入库项。
CREATE TABLE `erp_stock_in` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '入库编号',
`no` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '入库单号',
`supplier_id` bigint DEFAULT NULL COMMENT '供应商编号',
`in_time` datetime NOT NULL COMMENT '入库时间',
`total_count` decimal(24,6) NOT NULL COMMENT '合计数量',
`total_price` decimal(24,6) NOT NULL COMMENT '合计金额,单位:元',
`status` tinyint NOT NULL COMMENT '状态',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
`file_url` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '附件 URL',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=9 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 其它入库单表';
① no:入库单号,一般是系统自动生成的,目前格式是 {prefix}{yyyyMMdd}{6 位自增}。具体可见 ErpNoRedisDAO 类,如下图所示: ② supplier_id:供应商编号。
③ total_count 和 total_price:合计数量和金额,目前只是记录,并无特殊逻辑。
④ status:状态,统一使用 ErpAuditStatus 枚举类,只有"未审批"、"已审批"两个状态,后续会接入到 BPM 工作流 中。
CREATE TABLE `erp_stock_in_item` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '入库项编号',
`in_id` bigint NOT NULL COMMENT '入库编号',
`warehouse_id` bigint NOT NULL COMMENT '仓库编号',
`product_id` bigint NOT NULL COMMENT '产品编号',
`product_unit_id` bigint NOT NULL COMMENT '产品单位编号',
`product_price` decimal(24,6) DEFAULT NULL COMMENT '产品单价',
`count` decimal(24,6) NOT NULL COMMENT '产品数量',
`total_price` decimal(24,6) DEFAULT NULL COMMENT '合计金额,单位:元',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=10 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 其它入库单项表';
① in_id:入库编号,关联到上面的 erp_stock_in 表。
② warehouse_id 和 product_id:分别关联到仓库和产品。
③ product_unit_id、product_price、count 和 total_price:产品单位编号、产品单价、数量和金额。
其中 total_price 等于 product_price * count。
2.2 其它出库
erp_stock_out 表和 erp_stock_out_item 表,分别对应出库单和出库项。
CREATE TABLE `erp_stock_out` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '出库编号',
`no` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '出库单号',
`customer_id` bigint DEFAULT NULL COMMENT '客户编号',
`out_time` datetime NOT NULL COMMENT '出库时间',
`total_count` decimal(24,6) NOT NULL COMMENT '合计数量',
`total_price` decimal(24,6) NOT NULL COMMENT '合计金额,单位:元',
`status` tinyint NOT NULL COMMENT '状态',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
`file_url` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '附件 URL',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=11 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 其它入库单表';
① no:出库单号,一般是系统自动生成的,目前格式是 {prefix}{yyyyMMdd}{6 位自增}。具体可见 ErpNoRedisDAO 类。
② customer_id:客户编号。
③ total_count 和 total_price:合计数量和金额,目前只是记录,并无特殊逻辑。
④ status:状态,统一使用 ErpAuditStatus 枚举类,只有"未审批"、"已审批"两个状态。
CREATE TABLE `erp_stock_out_item` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '出库项编号',
`out_id` bigint NOT NULL COMMENT '出库编号',
`warehouse_id` bigint NOT NULL COMMENT '仓库编号',
`product_id` bigint NOT NULL COMMENT '产品编号',
`product_unit_id` bigint NOT NULL COMMENT '产品单位编号',
`product_price` decimal(24,6) DEFAULT NULL COMMENT '产品单价',
`count` decimal(24,6) NOT NULL COMMENT '产品数量',
`total_price` decimal(24,6) DEFAULT NULL COMMENT '合计金额,单位:元',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=12 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 其它出库单项表';
① out_id:出库编号,关联到上面的 erp_stock_out 表。
② warehouse_id 和 product_id:分别关联到仓库和产品。
③ product_unit_id、product_price、count 和 total_price:产品单位编号、产品单价、数量和金额。
其中 total_price 等于 product_price * count。
3. 库存_库存调拨、库存盘点
3.0 整体关系
管理的库存调拨、库存盘点。它们的表关系如下
3.1 库存调拨
库存调拨 erp_stock_move 表和 erp_stock_move_item 表,分别对应调拨单和调拨项。
CREATE TABLE `erp_stock_move` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '调拨编号',
`no` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '调拨单号',
`move_time` datetime NOT NULL COMMENT '调拨时间',
`total_count` decimal(24,6) NOT NULL COMMENT '合计数量',
`total_price` decimal(24,6) NOT NULL COMMENT '合计金额,单位:元',
`status` tinyint NOT NULL COMMENT '状态',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
`file_url` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '附件 URL',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=11 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 库存调拨单表';
① no:调拨单号,一般是系统自动生成的,目前格式是 {prefix}{yyyyMMdd}{6 位自增}。具体可见 ErpNoRedisDAO 类。
② total_count 和 total_price:合计数量和金额,目前只是记录,并无特殊逻辑。
③ status:状态,统一使用 ErpAuditStatus 枚举类,只有"未审批"、"已审批"两个状态。
CREATE TABLE `erp_stock_move_item` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '调拨项编号',
`move_id` bigint NOT NULL COMMENT '调拨编号',
`from_warehouse_id` bigint NOT NULL COMMENT '调出仓库编号',
`to_warehouse_id` bigint NOT NULL COMMENT '调入仓库编号',
`product_id` bigint NOT NULL COMMENT '产品编号',
`product_unit_id` bigint NOT NULL COMMENT '产品单位编号',
`product_price` decimal(24,6) DEFAULT NULL COMMENT '产品单价',
`count` decimal(24,6) NOT NULL COMMENT '产品数量',
`total_price` decimal(24,6) DEFAULT NULL COMMENT '合计金额,单位:元',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=11 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 库存调拨项表';
① move_id:调拨编号,关联到上面的 erp_stock_move 表。
② from_warehouse_id 和 to_warehouse_id:调出(来源)仓库编号和调入(目标)仓库编号。
③ product_id、product_unit_id、product_price、count 和 total_price:产品编号、产品单位编号、产品单价、数量和金额。
其中 total_price 等于 product_price * count。
3.2 库存盘点
- erp_stock_check 表和 erp_stock_check_item 表,分别对应盘点单和盘点项。
CREATE TABLE `erp_stock_check` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '盘点编号',
`no` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '盘点单号',
`check_time` datetime NOT NULL COMMENT '盘点时间',
`total_count` decimal(24,6) NOT NULL COMMENT '合计数量',
`total_price` decimal(24,6) NOT NULL COMMENT '合计金额,单位:元',
`status` tinyint NOT NULL COMMENT '状态',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
`file_url` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '附件 URL',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=13 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 库存盘点单表';
① no:盘点单号,一般是系统自动生成的,目前格式是 {prefix}{yyyyMMdd}{6 位自增}。具体可见 ErpNoRedisDAO 类。
② total_count 和 total_price:合计数量和金额,目前只是记录,并无特殊逻辑。
③ status:状态,统一使用 ErpAuditStatus 枚举类,只有"未审批"、"已审批"两个状态。
CREATE TABLE `erp_stock_check_item` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '调拨项编号',
`check_id` bigint NOT NULL COMMENT '调拨编号',
`warehouse_id` bigint NOT NULL COMMENT '仓库编号',
`product_id` bigint NOT NULL COMMENT '产品编号',
`product_unit_id` bigint NOT NULL COMMENT '产品单位编号',
`product_price` decimal(24,6) DEFAULT NULL COMMENT '产品单价',
`count` decimal(24,6) NOT NULL COMMENT '盈亏数量',
`total_price` decimal(24,6) DEFAULT NULL COMMENT '合计金额,单位:元',
`stock_count` decimal(24,6) NOT NULL COMMENT '账面数量(当前库存)',
`actual_count` decimal(24,6) NOT NULL COMMENT '实际数量(实际库存)',
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '备注',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=14 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='ERP 库存盘点项表';
① check_id:盘点编号,关联到上面的 erp_stock_check 表。
② warehouse_id 和 product_id:仓库编号和产品编号,表示被盘点的产品在该仓库的库存。
③ product_unit_id、product_price、count 和 total_price:产品单位编号、产品单价、盈亏数量和金额。
其中 total_price 等于 product_price * count。
④ stock_count 和 actual_count:账面数量(当前库存)和实际数量(实际库存),这 2 个字段的差值就是盈亏数量 count。
不过也要注意,这 2 个字段更多是冗余,核心还是 count 表示盈亏。如果 count 是正数则库存增加(入库),count 是负数则库存减少(出库)