實戰(zhàn)：從選型到Spring Boot實現(xiàn)與并發(fā)控制)
先聊聊我最近的感受。很多中小型制造企業(yè)和貿(mào)易公司在庫存管理上其實一直處于“半手工”狀態(tài)采購靠Excel登記銷售開單靠聊天記錄倉庫盤點靠人肉數(shù)數(shù)。一開始訂單量小還沒感覺等業(yè)務(wù)跑起來之后庫存賬面和實物對不上、訂單超賣、采購重復(fù)下單等問題就會接連出現(xiàn)。企業(yè)想直接上SAP、Oracle這類商業(yè)ERP成本太高實施周期也長。這時候開源免費的ERP庫存管理系統(tǒng)就成了一個性價比很高的選擇。市面上確實有不少成熟的開源項目也有不少團(tuán)隊選擇基于開源框架二次開發(fā)一套自己的庫存管理系統(tǒng)。這篇文章我就從開源ERP庫存管理系統(tǒng)的選型思路、核心概念、數(shù)據(jù)庫設(shè)計、接口實現(xiàn)到常見問題和工程化建議做一次完整的拆解幫助你從零搭建一套可用的庫存管理系統(tǒng)或者幫助你評估現(xiàn)有開源項目的落地方式。文章會包含大量可復(fù)用的SQL、Java和Vue代碼重點講清楚庫存系統(tǒng)的核心閉環(huán)入庫、出庫、庫存流水、庫存余額以及并發(fā)扣減庫存時的安全問題。不管你是準(zhǔn)備學(xué)習(xí)ERP開發(fā)還是要在企業(yè)內(nèi)部推動開源ERP落地這篇文章都值得收藏備用。1. 開源ERP庫存管理系統(tǒng)是什么解決什么問題1.1 什么是ERP庫存管理系統(tǒng)ERPEnterprise Resource Planning是企業(yè)資源計劃系統(tǒng)的簡稱它覆蓋財務(wù)、采購、銷售、生產(chǎn)、庫存、人力資源等模塊。而庫存管理系統(tǒng)通常指其中負(fù)責(zé)物料管理和庫存核算的部分它要回答幾個核心問題倉庫里現(xiàn)在有什么物料每個物料的數(shù)量是多少這些物料分布在哪些倉庫庫存的變化是由哪張業(yè)務(wù)單據(jù)觸發(fā)的當(dāng)前的可用庫存是否能滿足一張銷售訂單所以庫存管理系統(tǒng)并不是簡單的“進(jìn)銷存登記表”。它必須把采購入庫、銷售出庫、生產(chǎn)領(lǐng)料、退貨、盤點、調(diào)撥這些業(yè)務(wù)動作統(tǒng)一建模形成一條完整的數(shù)據(jù)鏈路。1.2 開源ERP與傳統(tǒng)商業(yè)ERP的區(qū)別對比維度開源ERP商業(yè)ERP軟件許可費用免費或低成本按模塊、用戶數(shù)、年費計費源代碼通常開放可二次開發(fā)閉源定制依賴原廠實施方式自研團(tuán)隊或第三方實施原廠或授權(quán)顧問實施擴(kuò)展能力可靈活修改業(yè)務(wù)邏輯受限于平臺能力技術(shù)門檻較高需要懂開發(fā)和運維較低配置為主典型代表Odoo、ERPNext、Apache OFBizSAP、Oracle EBS、用友、金蝶選擇開源ERP庫存管理系統(tǒng)并不意味著“免費所以湊合”。相反你需要具備一定的技術(shù)能力去掌控它。很多企業(yè)選擇開源方案核心訴求是三點源代碼可控業(yè)務(wù)邏輯可以按需改造。無License授權(quán)壓力尤其是對預(yù)算敏感的成長型企業(yè)。技術(shù)棧公開透明不綁定特定廠商。1.3 常見的開源ERP項目概覽項目名稱技術(shù)棧適用場景許可證OdooPython PostgreSQL中小型制造、貿(mào)易、電商LGPLERPNextPython Frappe框架中小企業(yè)全模塊管理GPLApache OFBizJava Tomcat大型企業(yè)復(fù)雜業(yè)務(wù)Apache 2.0華夏ERP基于SpringBootJava Vue MySQL國內(nèi)中小企業(yè)進(jìn)銷存GPL若依RuoYiJava Vue適合二次開發(fā)后臺管理系統(tǒng)MIT需要說明的是開源項目的許可證非常關(guān)鍵。如果企業(yè)計劃對系統(tǒng)做閉源二次發(fā)行那么GPL類協(xié)議會有較嚴(yán)格的約束如果是內(nèi)部使用不對外發(fā)行通常影響較小。做技術(shù)選型時一定要去對應(yīng)開源倉庫確認(rèn)License原文不能只看社區(qū)傳聞。1.4 開源庫存管理系統(tǒng)適合哪些場景年營收在幾千萬到幾億之間、還在用Excel管理庫存的中小制造企業(yè)。有技術(shù)團(tuán)隊、希望自己掌控核心業(yè)務(wù)系統(tǒng)的成長型公司。高校、實驗室、非營利組織預(yù)算有限但又需要規(guī)范流程管理。個人開發(fā)者學(xué)習(xí)ERP業(yè)務(wù)邏輯接觸真實進(jìn)銷存場景。軟件公司希望基于成熟開源框架快速交付客戶項目。2. 開源ERP庫存管理系統(tǒng)的技術(shù)選型與架構(gòu)設(shè)計2.1 技術(shù)棧選型建議在實際項目中庫存管理系統(tǒng)通常作為整個ERP系統(tǒng)中的子模塊出現(xiàn)。如果從零開始搭建一套輕量級庫存管理系統(tǒng)我比較推薦下面的技術(shù)組合技術(shù)層次推薦方案說明前端框架Vue 3 Element Plus組件生態(tài)豐富適合中后臺系統(tǒng)后端框架Spring Boot 2.x / 3.xJava生態(tài)成熟事務(wù)與并發(fā)控制能力強(qiáng)數(shù)據(jù)庫MySQL 8.0使用廣泛運維成本低權(quán)限框架Spring Security JWT實現(xiàn)登錄認(rèn)證與接口權(quán)限構(gòu)建工具M(jìn)aven / npm標(biāo)準(zhǔn)工程構(gòu)建方式部署方式Docker Compose便于本地環(huán)境與生產(chǎn)環(huán)境保持一致這里的版本號只是推薦具體需要結(jié)合你的項目要求來定。Spring Boot 3.x基于Jakarta EE與Spring Boot 2.x在某些依賴上不兼容MySQL 8.0支持窗口函數(shù)和更好的鎖機(jī)制但如果你已有的生產(chǎn)環(huán)境是5.7也不必強(qiáng)行升級。本文側(cè)重講解庫存管理系統(tǒng)的核心設(shè)計代碼示例會盡量保持通用。2.2 整體架構(gòu)圖文字版Vue 3 Element Plus | | HTTP/JSON v Spring Boot 后端服務(wù) |--- 認(rèn)證模塊 (JWT) |--- 商品管理模塊 |--- 倉庫管理模塊 |--- 入庫單模塊 |--- 出庫單模塊 |--- 庫存流水模塊 |--- 庫存余額模塊 | | JDBC v MySQL 數(shù)據(jù)庫 |--- sys_user 用戶表 |--- bas_product 商品表 |--- bas_warehouse 倉庫表 |--- stk_inbound 入庫單表 |--- stk_inbound_item 入庫明細(xì)表 |--- stk_outbound 出庫單表 |--- stk_outbound_item 出庫明細(xì)表 |--- stk_stock_flow 庫存流水表 |--- stk_stock_balance 庫存余額表從整體架構(gòu)可以看出庫存管理系統(tǒng)的核心是“單據(jù) 流水 余額”三層模型。業(yè)務(wù)操作不直接修改庫存數(shù)量而是通過生成入庫單或出庫單同時記錄庫存流水最后更新庫存余額。2.3 核心業(yè)務(wù)閉環(huán)庫存系統(tǒng)的完整閉環(huán)可以拆成下面幾步用戶創(chuàng)建入庫單填寫供應(yīng)商、收貨倉庫、商品和數(shù)量。入庫單審核通過后系統(tǒng)生成入庫庫存流水。系統(tǒng)更新對應(yīng)倉庫、對應(yīng)商品的庫存余額。用戶創(chuàng)建出庫單填寫客戶、發(fā)貨倉庫、商品和數(shù)量。出庫單審核時系統(tǒng)檢查可用庫存是否充足。庫存充足則扣減庫存不足則提示庫存不足。財務(wù)或管理人員通過報表查看庫存變動、庫存價值、出入庫趨勢。這個閉環(huán)看起來簡單但實際開發(fā)中并發(fā)扣減庫存、事務(wù)一致性、冪等性等問題非常容易出現(xiàn)。3. 數(shù)據(jù)庫表設(shè)計庫存系統(tǒng)的基石3.1 數(shù)據(jù)模型設(shè)計原則在設(shè)計庫存管理系統(tǒng)數(shù)據(jù)庫時至少要遵循以下原則單據(jù)與明細(xì)分離主表存單據(jù)頭信息明細(xì)表存商品明細(xì)避免單表字段過多。數(shù)量與金額精度控制庫存數(shù)量使用DECIMAL不使用浮點類型避免精度丟失。庫存流水只增不改流水表通過流水號唯一約束一旦寫入不允許修改和刪除只能通過沖銷單糾正。庫存余額必須有版本號或鎖機(jī)制用于處理并發(fā)更新防止超賣。所有業(yè)務(wù)表都要帶創(chuàng)建人、創(chuàng)建時間、更新人、更新時間和邏輯刪除標(biāo)記。3.2 商品表和倉庫表-- 商品表 CREATE TABLE bas_product ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, product_code VARCHAR(50) NOT NULL COMMENT 商品編碼, product_name VARCHAR(100) NOT NULL COMMENT 商品名稱, category_id BIGINT COMMENT 分類ID, unit VARCHAR(20) DEFAULT 件 COMMENT 單位, spec VARCHAR(100) COMMENT 規(guī)格型號, status TINYINT DEFAULT 1 COMMENT 狀態(tài)1啟用0停用, deleted TINYINT DEFAULT 0 COMMENT 邏輯刪除0否1是, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_product_code (product_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT商品表; -- 倉庫表 CREATE TABLE bas_warehouse ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, warehouse_code VARCHAR(50) NOT NULL COMMENT 倉庫編碼, warehouse_name VARCHAR(100) NOT NULL COMMENT 倉庫名稱, address VARCHAR(255) COMMENT 倉庫地址, manager VARCHAR(50) COMMENT 負(fù)責(zé)人, status TINYINT DEFAULT 1 COMMENT 狀態(tài)1啟用0停用, deleted TINYINT DEFAULT 0 COMMENT 邏輯刪除, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_warehouse_code (warehouse_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT倉庫表;3.3 入庫單和入庫明細(xì)表-- 入庫單主表 CREATE TABLE stk_inbound ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, inbound_no VARCHAR(50) NOT NULL COMMENT 入庫單號, inbound_type TINYINT COMMENT 入庫類型1采購入庫2生產(chǎn)入庫3退貨入庫4盤點入庫, supplier_id BIGINT COMMENT 供應(yīng)商ID, warehouse_id BIGINT NOT NULL COMMENT 收貨倉庫ID, inbound_date DATE NOT NULL COMMENT 入庫日期, status TINYINT DEFAULT 0 COMMENT 狀態(tài)0草稿1已審核2已作廢, remark VARCHAR(500) COMMENT 備注, deleted TINYINT DEFAULT 0, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_inbound_no (inbound_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT入庫單主表; -- 入庫明細(xì)表 CREATE TABLE stk_inbound_item ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, inbound_id BIGINT NOT NULL COMMENT 入庫單主表ID, product_id BIGINT NOT NULL COMMENT 商品ID, quantity DECIMAL(18,3) NOT NULL COMMENT 入庫數(shù)量, price DECIMAL(18,2) DEFAULT 0 COMMENT 入庫單價, amount DECIMAL(18,2) DEFAULT 0 COMMENT 金額, remark VARCHAR(200) COMMENT 明細(xì)備注, KEY idx_inbound_id (inbound_id), KEY idx_product_id (product_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT入庫明細(xì)表;3.4 出庫單和出庫明細(xì)表出庫表和入庫表結(jié)構(gòu)非常相似這里可以單獨建表也可以設(shè)計成一張通用庫存單據(jù)表。對于初學(xué)者來說分表更容易理解。如果業(yè)務(wù)擴(kuò)展后單據(jù)類型增多再考慮將公共字段抽取為通用單據(jù)表。-- 出庫單主表 CREATE TABLE stk_outbound ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, outbound_no VARCHAR(50) NOT NULL COMMENT 出庫單號, outbound_type TINYINT COMMENT 出庫類型1銷售出庫2生產(chǎn)領(lǐng)料3報損出庫4盤虧出庫, customer_id BIGINT COMMENT 客戶ID, warehouse_id BIGINT NOT NULL COMMENT 發(fā)貨倉庫ID, outbound_date DATE NOT NULL COMMENT 出庫日期, status TINYINT DEFAULT 0 COMMENT 狀態(tài)0草稿1已審核2已作廢, remark VARCHAR(500) COMMENT 備注, deleted TINYINT DEFAULT 0, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_outbound_no (outbound_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT出庫單主表; -- 出庫明細(xì)表 CREATE TABLE stk_outbound_item ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, outbound_id BIGINT NOT NULL COMMENT 出庫單主表ID, product_id BIGINT NOT NULL COMMENT 商品ID, quantity DECIMAL(18,3) NOT NULL COMMENT 出庫數(shù)量, price DECIMAL(18,2) DEFAULT 0 COMMENT 出庫單價, amount DECIMAL(18,2) DEFAULT 0 COMMENT 金額, remark VARCHAR(200) COMMENT 明細(xì)備注, KEY idx_outbound_id (outbound_id), KEY idx_product_id (product_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT出庫明細(xì)表;3.5 庫存流水表和庫存余額表庫存流水表和庫存余額表是整個庫存系統(tǒng)的核心。簡單來說流水表記錄了每一次庫存變化余額表保存當(dāng)前庫存數(shù)量。查詢報表時可以先看余額表要追溯時可以查流水表。-- 庫存流水表 CREATE TABLE stk_stock_flow ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, flow_no VARCHAR(50) NOT NULL COMMENT 流水號, product_id BIGINT NOT NULL COMMENT 商品ID, warehouse_id BIGINT NOT NULL COMMENT 倉庫ID, change_type TINYINT COMMENT 變動類型1入庫2出庫3盤點調(diào)整4調(diào)撥出5調(diào)撥入, source_no VARCHAR(50) COMMENT 來源單據(jù)號, source_type TINYINT COMMENT 來源單據(jù)類型1入庫單2出庫單3盤點單4調(diào)撥單, quantity_change DECIMAL(18,3) NOT NULL COMMENT 變動數(shù)量入庫為正出庫為負(fù), before_quantity DECIMAL(18,3) DEFAULT 0 COMMENT 變動前庫存, after_quantity DECIMAL(18,3) DEFAULT 0 COMMENT 變動后庫存, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_flow_no (flow_no), KEY idx_product_warehouse (product_id, warehouse_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT庫存流水表; -- 庫存余額表 CREATE TABLE stk_stock_balance ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, product_id BIGINT NOT NULL COMMENT 商品ID, warehouse_id BIGINT NOT NULL COMMENT 倉庫ID, stock_quantity DECIMAL(18,3) NOT NULL DEFAULT 0 COMMENT 庫存數(shù)量, locked_quantity DECIMAL(18,3) NOT NULL DEFAULT 0 COMMENT 鎖定數(shù)量, available_quantity DECIMAL(18,3) NOT NULL DEFAULT 0 COMMENT 可用數(shù)量, version INT NOT NULL DEFAULT 0 COMMENT 樂觀鎖版本號, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_product_warehouse (product_id, warehouse_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT庫存余額表;這里引入了一個“鎖定數(shù)量”字段。這個概念在電商庫存系統(tǒng)中用得非常多。當(dāng)用戶提交訂單但還沒付款時可以先占用一部分庫存避免其他訂單繼續(xù)超賣。在普通ERP庫存系統(tǒng)中如果業(yè)務(wù)流程沒有“預(yù)占”環(huán)節(jié)可以暫時不用這個字段但保留它能為以后的復(fù)雜業(yè)務(wù)留出擴(kuò)展空間。3.6 為什么需要 before_quantity 和 after_quantity在設(shè)計庫存流水表時有人會問既然有了 quantity_change為什么還要存 before_quantity 和 after_quantity原因很簡單便于對賬和排查。如果某一天發(fā)現(xiàn)庫存余額不平可以通過流水表快速看到每筆操作發(fā)生前后的庫存快照。特別是在多人同時操作的情況下光靠變動數(shù)量無法還原當(dāng)時的庫存上下文。保留這兩個字段相當(dāng)于給每次庫存變動記錄了系統(tǒng)日志。4. 后端核心實現(xiàn)Spring Boot 庫存服務(wù)4.1 項目基礎(chǔ)結(jié)構(gòu)假設(shè)我們使用Spring Boot MyBatis-Plus來構(gòu)建后端服務(wù)項目結(jié)構(gòu)如下erp-stock-system ├── pom.xml └── src └── main ├── java │ └── com │ └── example │ └── erp │ ├── ErpApplication.java │ ├── common │ │ ├── Result.java │ │ └── BusinessException.java │ ├── controller │ │ └── StockController.java │ ├── entity │ │ ├── StockBalance.java │ │ ├── StockFlow.java │ │ ├── Inbound.java │ │ └── Outbound.java │ ├── mapper │ │ ├── StockBalanceMapper.java │ │ ├── StockFlowMapper.java │ │ ├── InboundMapper.java │ │ └── OutboundMapper.java │ └── service │ ├── InboundService.java │ └── OutboundService.java └── resources ├── application.yml └── mapper4.2 Maven 依賴配置dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies4.3 庫存扣減的核心邏輯庫存扣減是庫存系統(tǒng)里最容易出Bug的地方。下面用一個出庫場景來演示核心代碼。注意這里的示例重點是事務(wù)和并發(fā)控制。首先定義庫存余額實體Data TableName(stk_stock_balance) public class StockBalance { TableId(type IdType.AUTO) private Long id; private Long productId; private Long warehouseId; private BigDecimal stockQuantity; private BigDecimal lockedQuantity; private BigDecimal availableQuantity; Version private Integer version; }然后在Service中實現(xiàn)出庫審核邏輯Service public class OutboundService { Resource private StockBalanceMapper stockBalanceMapper; Resource private StockFlowMapper stockFlowMapper; Transactional(rollbackFor Exception.class) public void auditOutbound(Outbound outbound, ListOutboundItem items) { for (OutboundItem item : items) { // 1. 查詢庫存余額 StockBalance balance stockBalanceMapper.selectByProductAndWarehouse( item.getProductId(), outbound.getWarehouseId()); if (balance null) { throw new BusinessException(庫存余額不存在請先初始化庫存); } // 2. 校驗可用庫存 if (balance.getAvailableQuantity().compareTo(item.getQuantity()) 0) { throw new BusinessException(商品庫存不足); } // 3. 使用樂觀鎖更新庫存 int rows stockBalanceMapper.deductStock( balance.getId(), item.getQuantity(), balance.getVersion()); if (rows 0) { throw new BusinessException(庫存扣減失敗請重試); } // 4. 寫入庫存流水 StockFlow flow new StockFlow(); flow.setFlowNo(generateFlowNo()); flow.setProductId(item.getProductId()); flow.setWarehouseId(outbound.getWarehouseId()); flow.setChangeType(2); flow.setSourceNo(outbound.getOutboundNo()); flow.setSourceType(2); flow.setQuantityChange(item.getQuantity().negate()); flow.setBeforeQuantity(balance.getStockQuantity()); flow.setAfterQuantity(balance.getStockQuantity().subtract(item.getQuantity())); flow.setCreateBy(outbound.getUpdateBy()); stockFlowMapper.insert(flow); } // 5. 更新出庫單狀態(tài)為已審核 outbound.setStatus(1); outboundMapper.updateById(outbound); } }對應(yīng)的Mapper SQL如下update iddeductStock UPDATE stk_stock_balance SET stock_quantity stock_quantity - #{quantity}, available_quantity available_quantity - #{quantity}, version version 1 WHERE id #{id} AND version #{version} AND available_quantity gt; #{quantity} /update這段SQL的關(guān)鍵點在于UPDATE語句中同時帶上了version條件并且通過available_quantity大于等于待扣數(shù)量來做額外的庫存約束。在數(shù)據(jù)庫層面這種寫法可以防止并發(fā)場景下兩個請求同時扣減同一份庫存。4.4 入庫審核的核心邏輯入庫相對簡單核心是生成流水并累加庫存Transactional(rollbackFor Exception.class) public void auditInbound(Inbound inbound, ListInboundItem items) { for (InboundItem item : items) { StockBalance balance stockBalanceMapper.selectByProductAndWarehouse( item.getProductId(), inbound.getWarehouseId()); if (balance null) { // 初始化一條庫存余額記錄 balance new StockBalance(); balance.setProductId(item.getProductId()); balance.setWarehouseId(inbound.getWarehouseId()); balance.setStockQuantity(BigDecimal.ZERO); balance.setLockedQuantity(BigDecimal.ZERO); balance.setAvailableQuantity(BigDecimal.ZERO); stockBalanceMapper.insert(balance); } // 增加庫存 int rows stockBalanceMapper.addStock( balance.getId(), item.getQuantity(), balance.getVersion()); if (rows 0) { throw new BusinessException(庫存更新失敗請重試); } // 寫入流水 StockFlow flow new StockFlow(); flow.setFlowNo(generateFlowNo()); flow.setProductId(item.getProductId()); flow.setWarehouseId(inbound.getWarehouseId()); flow.setChangeType(1); flow.setSourceNo(inbound.getInboundNo()); flow.setSourceType(1); flow.setQuantityChange(item.getQuantity()); flow.setBeforeQuantity(balance.getStockQuantity()); flow.setAfterQuantity(balance.getStockQuantity().add(item.getQuantity())); flow.setCreateBy(inbound.getUpdateBy()); stockFlowMapper.insert(flow); } inbound.setStatus(1); inboundMapper.updateById(inbound); }這里有幾個容易被忽略的點新增庫存余額記錄時要注意并發(fā)插入。如果在極短時間內(nèi)同時收到兩條入庫請求且?guī)齑嬗囝~記錄不存在可能會插入兩條重復(fù)記錄。解決方式有兩種一是利用數(shù)據(jù)庫唯一索引uk_product_warehouse兜底二是先查詢?nèi)绻淮嬖趧t通過INSERT IGNORE或ON DUPLICATE KEY UPDATE方式處理。流水號建議使用類似“年月日隨機(jī)數(shù)”或“日期序列”的格式。這里可以使用Redis自增序列也可以直接用數(shù)據(jù)庫的ID生成器但一定要保證唯一。4.5 事務(wù)與并發(fā)控制方案選擇在庫存扣減場景中常見的并發(fā)控制方案有三種方案實現(xiàn)方式優(yōu)點缺點樂觀鎖使用version字段更新時校驗版本號簡單、性能好沖突時需要重試悲觀鎖SELECT ... FOR UPDATE鎖定記錄實現(xiàn)直觀不會重試并發(fā)高時鎖競爭激烈數(shù)據(jù)庫約束使用條件更新 WHERE available_quantity quantity數(shù)據(jù)庫層面兜底需要配合樂觀鎖或事務(wù)使用實際項目中我比較推薦“樂觀鎖 條件更新”的組合方式。先用樂觀鎖保證版本一致性再用數(shù)據(jù)庫條件更新作為最終約束這樣既不會因為鎖等待導(dǎo)致系統(tǒng)卡頓又能防止超賣。5. 前端頁面Vue 3 Element Plus 快速搭建5.1 前端項目結(jié)構(gòu)前端部分使用Vue 3 Vite Element Plus項目結(jié)構(gòu)如下erp-web ├── index.html ├── package.json ├── vite.config.js └── src ├── main.js ├── App.vue ├── api │ └── stock.js └── views ├── dashboard.vue ├── inbound.vue ├── outbound.vue └── stock.vue5.2 庫存余額展示頁面下面是一個簡單的庫存余額列表頁面template div classstock-page el-card el-form :inlinetrue el-form-item label商品編碼 el-input v-modelqueryParam.productCode placeholder請輸入商品編碼 clearable / /el-form-item el-form-item label倉庫 el-select v-modelqueryParam.warehouseId placeholder請選擇倉庫 clearable el-option v-foritem in warehouseList :keyitem.id :labelitem.warehouseName :valueitem.id / /el-select /el-form-item el-form-item el-button typeprimary clickloadStockList查詢/el-button el-button clickresetQuery重置/el-button /el-form-item /el-form /el-card el-card stylemargin-top: 16px el-table :datastockList border stripe el-table-column propproductCode label商品編碼 min-width120 / el-table-column propproductName label商品名稱 min-width150 / el-table-column propwarehouseName label倉庫名稱 min-width120 / el-table-column propstockQuantity label庫存數(shù)量 min-width100 alignright / el-table-column proplockedQuantity label鎖定數(shù)量 min-width100 alignright / el-table-column propavailableQuantity label可用數(shù)量 min-width100 alignright / /el-table /el-card /div /template script setup import { ref, onMounted } from vue import { getStockList } from /api/stock const queryParam ref({ productCode: , warehouseId: null }) const stockList ref([]) const warehouseList ref([]) async function loadStockList() { const res await getStockList(queryParam.value) stockList.value res.data.records } function resetQuery() { queryParam.value { productCode: , warehouseId: null } loadStockList() } onMounted(() { loadStockList() }) /script這個頁面的作用是展示當(dāng)前庫存余額讓管理者可以快速看到某個倉庫中所有商品的數(shù)量分布。實際系統(tǒng)中還可以加入庫存預(yù)警閾值當(dāng)可用庫存低于某個下限時在列表里用紅色標(biāo)識提示需要補(bǔ)貨。5.3 前端接口封裝import request from /utils/request export function getStockList(params) { return request({ url: /api/stock/list, method: get, params }) } export function auditInbound(data) { return request({ url: /api/inbound/audit, method: post, data }) } export function auditOutbound(data) { return request({ url: /api/outbound/audit, method: post, data }) }前端做好數(shù)據(jù)展示和交互即可真正的業(yè)務(wù)規(guī)則必須放在后端服務(wù)中。尤其是庫存扣減、事務(wù)、權(quán)限校驗這類邏輯如果放在前端任何人都可以通過瀏覽器控制臺繞過。6. 開源許可證與二次開發(fā)注意事項6.1 許可證怎么選很多開發(fā)者在Gitee或GitHub上創(chuàng)建開源項目時都會糾結(jié)許可證怎么選。這里給出一個簡單的選擇建議許可證特點適合場景MIT寬松允許商用允許閉源個人項目、內(nèi)部系統(tǒng)、希望被廣泛使用Apache 2.0寬松附帶專利授權(quán)條款企業(yè)級開源項目GPL傳染性衍生代碼需開源希望生態(tài)保持開源LGPL修改庫文件才需要開源被其他項目以庫形式引用MPL文件級別傳染混合開源開發(fā)模型如果你在開發(fā)開源ERP庫存管理系統(tǒng)需要明確一個問題允許別人拿去商用而不開源嗎如果允許建議MIT或Apache 2.0如果希望商業(yè)公司在使用后把增強(qiáng)功能回饋社區(qū)可以選擇GPL。6.2 二次開發(fā)時的注意事項保留上游項目版權(quán)聲明不要刪除License文件。修改代碼時盡量以模塊化方式擴(kuò)展避免在核心代碼上大面積改動。如果是基于GPL項目二次開發(fā)對外分發(fā)時需要注意源代碼開放義務(wù)。如果只是企業(yè)內(nèi)部使用不分發(fā)給第三方GPL和MIT的影響相對可控但也要咨詢法務(wù)。7. 常見問題與排查思路7.1 常見問題匯總表問題現(xiàn)象常見原因解決思路庫存扣減后變成負(fù)數(shù)未使用樂觀鎖或條件更新并發(fā)扣減在UPDATE語句中增加可用庫存判斷使用version同一商品出現(xiàn)多條庫存余額記錄并發(fā)插入庫存余額唯一索引失效創(chuàng)建唯一索引插入時使用ON DUPLICATE KEY UPDATE頁面顯示庫存和實際盤點不一致手工修改數(shù)據(jù)庫導(dǎo)致流水?dāng)嗔呀故止じ膸齑嫱ㄟ^盤點單調(diào)整超賣訂單提交和庫存扣減不是同一事務(wù)將訂單創(chuàng)建與庫存扣減放在同一事務(wù)中流水號重復(fù)使用時間戳或簡單隨機(jī)數(shù)生成流水號使用Redis自增或數(shù)據(jù)庫序列報表查詢慢庫存流水表全表掃描為product_id、warehouse_id、create_time建立聯(lián)合索引Decimal類型計算出現(xiàn)精度問題使用double或float存儲金額金額和數(shù)量統(tǒng)一使用DECIMAL7.2 復(fù)盤一個典型的庫存變負(fù)事故假設(shè)系統(tǒng)上線后運營反饋某個商品庫存從“3件”變成了“-1件”。排查思路如下查詢該商品的庫存流水表看看最近有哪些出入庫記錄。找出導(dǎo)致庫存變負(fù)的那條流水確認(rèn)來源單據(jù)。檢查該單據(jù)審核時后端是否執(zhí)行了“可用庫存是否充足”的判斷。如果判斷邏輯存在再看是否是并發(fā)導(dǎo)致的兩個請求同時讀到庫存為3同時扣2理論上最終結(jié)果應(yīng)該是1但由于沒有版本號控制兩條SQL都成功執(zhí)行結(jié)果變成-1。修復(fù)方式為庫存余額表增加version字段修改UPDATE語句增加available_quantity quantity條件。這個案例說明庫存系統(tǒng)不是“能增能減”就行必須把并發(fā)控制放到數(shù)據(jù)庫層而不是依賴應(yīng)用層的判斷。8. 最佳實踐與工程建議8.1 單據(jù)驅(qū)動禁止直接改庫存很多初學(xué)ERP開發(fā)的朋友會犯一個錯誤用戶點擊“庫存調(diào)整”直接寫一條UPDATE語句把庫存數(shù)量改了。這樣做表面上很快實際是在給系統(tǒng)埋雷。正確的做法是引入“盤點單”。盤點的本質(zhì)是“賬面數(shù)量 vs 實盤數(shù)量”差異部分通過盤點單生成盤盈或盤虧流水最終調(diào)整庫存余額。這樣做的好處是所有庫存變動都可追溯每筆變更都能找到對應(yīng)的業(yè)務(wù)單據(jù)。8.2 庫存流水只增不改庫存流水表記錄了企業(yè)所有庫存變動的歷史是一份極其重要的審計數(shù)據(jù)。設(shè)計上應(yīng)該做到流水表不提供修改和刪除接口。即使對應(yīng)的入庫單或出庫單作廢流水表仍然保留。作廢單據(jù)時需要生成一張反向沖銷的流水而不是物理刪除原來的流水。這樣設(shè)計雖然會增加一些開發(fā)量但長期來看系統(tǒng)的數(shù)據(jù)可信度會高很多。8.3 永遠(yuǎn)在事務(wù)中操作庫存所有涉及庫存余額變化的操作都必須放在數(shù)據(jù)庫事務(wù)中。Spring中可以通過Transactional注解實現(xiàn)。事務(wù)的隔離級別建議設(shè)置為默認(rèn)的數(shù)據(jù)庫隔離級別不要輕易提高。另外事務(wù)中盡量縮短業(yè)務(wù)邏輯的執(zhí)行時間不要在事務(wù)內(nèi)調(diào)用第三方HTTP接口、發(fā)送短信郵件、等待MQ消息等耗時操作。否則會導(dǎo)致數(shù)據(jù)庫連接長時間占用系統(tǒng)吞吐量下降。8.4 權(quán)限與安全邊界庫存管理系統(tǒng)涉及企業(yè)的核心資產(chǎn)數(shù)據(jù)安全設(shè)計不能放松接口必須做登錄認(rèn)證不能裸奔。權(quán)限控制建議做到按鈕級別不只是頁面級別。審核入庫單和創(chuàng)建入庫單建議由不同角色承擔(dān)形成簡單復(fù)核機(jī)制。所有寫操作都要記錄操作日志包括操作人、操作時間、IP、操作內(nèi)容。不要在前端頁面暴露全量庫存導(dǎo)出接口或者至少加入權(quán)限校驗和數(shù)據(jù)量限制防止數(shù)據(jù)被批量拉取。8.5 數(shù)據(jù)備份與灰度發(fā)布生產(chǎn)環(huán)境數(shù)據(jù)庫必須配置自動備份策略。庫存數(shù)據(jù)一旦丟失或錯亂恢復(fù)成本極高。建議每周至少做一次全量備份每天做一次增量備份備份文件要存儲到獨立存儲空間。系統(tǒng)升級時先在測試環(huán)境完整跑一遍出入庫流程確認(rèn)無問題后再發(fā)布到生產(chǎn)。如果條件允許可以采用灰度發(fā)布方式先讓倉庫部門的少量賬號使用新版本驗證穩(wěn)定后再全員切換。8.6 性能優(yōu)化要點庫存流水表數(shù)據(jù)量會隨著業(yè)務(wù)增長快速膨脹建議按季度或按年做分區(qū)。常用查詢條件要建立聯(lián)合索引例如(product_id, warehouse_id, create_time)。庫存余額表的查詢非常頻繁盡量通過組合條件唯一命中記錄避免全表掃描。報表類查詢不要直接在業(yè)務(wù)庫執(zhí)行可以通過定時任務(wù)把數(shù)據(jù)同步到統(tǒng)計庫或者使用讀從庫。9. 總結(jié)與學(xué)習(xí)路線寫到這里開源ERP庫存管理系統(tǒng)的核心內(nèi)容已經(jīng)拆解得比較完整了。如果你是從零開始學(xué)習(xí)ERP開發(fā)建議按下面的路線繼續(xù)深入先理解“單據(jù) 流水 余額”三層模型這是整個庫存系統(tǒng)的靈魂。自己動手建一套MySQL表結(jié)構(gòu)手工插入幾條入庫單、出庫單數(shù)據(jù)查看庫存余額變化。學(xué)習(xí)Spring Boot事務(wù)管理和MyBatis-Plus的樂觀鎖插件寫一個簡單的庫存扣減接口。完善單據(jù)審核流程、庫存盤點、庫存預(yù)警、調(diào)撥單逐步擴(kuò)展系統(tǒng)能力。閱讀優(yōu)秀開源項目的源碼比如Odoo庫存模塊、ERPNext的Stock模塊學(xué)習(xí)它們的業(yè)務(wù)抽象方式。最后嘗試把庫存模塊與采購、銷售、財務(wù)模塊打通理解ERP系統(tǒng)各模塊之間的關(guān)聯(lián)。開源ERP庫存管理系統(tǒng)的優(yōu)勢在于你可以邊看源碼邊學(xué)習(xí)遇到不滿足的業(yè)務(wù)需求還能自己改。但這也意味著你需要投入時間和精力不能把自己當(dāng)成普通的軟件使用者。如果你所在的企業(yè)正好需要一個庫存管理系統(tǒng)不妨先從本文提到的數(shù)據(jù)模型和核心接口入手搭一個最小可運行版本再根據(jù)實際業(yè)務(wù)去迭代。我在文章里分享的SQL和Java代碼均是可以直接參考的核心片段。實際項目里你還需要補(bǔ)充用戶認(rèn)證、菜單權(quán)限、操作日志、報表統(tǒng)計等功能。如果遇到庫存扣減并發(fā)問題優(yōu)先檢查你們的庫存余額表是否使用了樂觀鎖以及UPDATE語句是否帶有庫存數(shù)量約束條件——大部分問題都出在這兩個地方。如果你準(zhǔn)備把某個開源ERP項目引入公司也不要急著部署。先讓運維和開發(fā)團(tuán)隊把技術(shù)棧、部署方式、License條款、二次開發(fā)成本都評估清楚。庫存系統(tǒng)是業(yè)務(wù)系統(tǒng)的核心一旦跑了錯誤的數(shù)據(jù)業(yè)務(wù)方對系統(tǒng)的信任度會大打折扣。希望這篇文章能幫你少走一些彎路。 開源ERP庫存管理系統(tǒng)實戰(zhàn)：從選型到Spring Boot實現(xiàn)與并發(fā)控制
先聊聊我最近的感受。很多中小型制造企業(yè)和貿(mào)易公司在庫存管理上其實一直處于“半手工”狀態(tài)采購靠Excel登記銷售開單靠聊天記錄倉庫盤點靠人肉數(shù)數(shù)。一開始訂單量小還沒感覺等業(yè)務(wù)跑起來之后庫存賬面和實物對不上、訂單超賣、采購重復(fù)下單等問題就會接連出現(xiàn)。企業(yè)想直接上SAP、Oracle這類商業(yè)ERP成本太高實施周期也長。這時候開源免費的ERP庫存管理系統(tǒng)就成了一個性價比很高的選擇。市面上確實有不少成熟的開源項目也有不少團(tuán)隊選擇基于開源框架二次開發(fā)一套自己的庫存管理系統(tǒng)。這篇文章我就從開源ERP庫存管理系統(tǒng)的選型思路、核心概念、數(shù)據(jù)庫設(shè)計、接口實現(xiàn)到常見問題和工程化建議做一次完整的拆解幫助你從零搭建一套可用的庫存管理系統(tǒng)或者幫助你評估現(xiàn)有開源項目的落地方式。文章會包含大量可復(fù)用的SQL、Java和Vue代碼重點講清楚庫存系統(tǒng)的核心閉環(huán)入庫、出庫、庫存流水、庫存余額以及并發(fā)扣減庫存時的安全問題。不管你是準(zhǔn)備學(xué)習(xí)ERP開發(fā)還是要在企業(yè)內(nèi)部推動開源ERP落地這篇文章都值得收藏備用。1. 開源ERP庫存管理系統(tǒng)是什么解決什么問題1.1 什么是ERP庫存管理系統(tǒng)ERPEnterprise Resource Planning是企業(yè)資源計劃系統(tǒng)的簡稱它覆蓋財務(wù)、采購、銷售、生產(chǎn)、庫存、人力資源等模塊。而庫存管理系統(tǒng)通常指其中負(fù)責(zé)物料管理和庫存核算的部分它要回答幾個核心問題倉庫里現(xiàn)在有什么物料每個物料的數(shù)量是多少這些物料分布在哪些倉庫庫存的變化是由哪張業(yè)務(wù)單據(jù)觸發(fā)的當(dāng)前的可用庫存是否能滿足一張銷售訂單所以庫存管理系統(tǒng)并不是簡單的“進(jìn)銷存登記表”。它必須把采購入庫、銷售出庫、生產(chǎn)領(lǐng)料、退貨、盤點、調(diào)撥這些業(yè)務(wù)動作統(tǒng)一建模形成一條完整的數(shù)據(jù)鏈路。1.2 開源ERP與傳統(tǒng)商業(yè)ERP的區(qū)別對比維度開源ERP商業(yè)ERP軟件許可費用免費或低成本按模塊、用戶數(shù)、年費計費源代碼通常開放可二次開發(fā)閉源定制依賴原廠實施方式自研團(tuán)隊或第三方實施原廠或授權(quán)顧問實施擴(kuò)展能力可靈活修改業(yè)務(wù)邏輯受限于平臺能力技術(shù)門檻較高需要懂開發(fā)和運維較低配置為主典型代表Odoo、ERPNext、Apache OFBizSAP、Oracle EBS、用友、金蝶選擇開源ERP庫存管理系統(tǒng)并不意味著“免費所以湊合”。相反你需要具備一定的技術(shù)能力去掌控它。很多企業(yè)選擇開源方案核心訴求是三點源代碼可控業(yè)務(wù)邏輯可以按需改造。無License授權(quán)壓力尤其是對預(yù)算敏感的成長型企業(yè)。技術(shù)棧公開透明不綁定特定廠商。1.3 常見的開源ERP項目概覽項目名稱技術(shù)棧適用場景許可證OdooPython PostgreSQL中小型制造、貿(mào)易、電商LGPLERPNextPython Frappe框架中小企業(yè)全模塊管理GPLApache OFBizJava Tomcat大型企業(yè)復(fù)雜業(yè)務(wù)Apache 2.0華夏ERP基于SpringBootJava Vue MySQL國內(nèi)中小企業(yè)進(jìn)銷存GPL若依RuoYiJava Vue適合二次開發(fā)后臺管理系統(tǒng)MIT需要說明的是開源項目的許可證非常關(guān)鍵。如果企業(yè)計劃對系統(tǒng)做閉源二次發(fā)行那么GPL類協(xié)議會有較嚴(yán)格的約束如果是內(nèi)部使用不對外發(fā)行通常影響較小。做技術(shù)選型時一定要去對應(yīng)開源倉庫確認(rèn)License原文不能只看社區(qū)傳聞。1.4 開源庫存管理系統(tǒng)適合哪些場景年營收在幾千萬到幾億之間、還在用Excel管理庫存的中小制造企業(yè)。有技術(shù)團(tuán)隊、希望自己掌控核心業(yè)務(wù)系統(tǒng)的成長型公司。高校、實驗室、非營利組織預(yù)算有限但又需要規(guī)范流程管理。個人開發(fā)者學(xué)習(xí)ERP業(yè)務(wù)邏輯接觸真實進(jìn)銷存場景。軟件公司希望基于成熟開源框架快速交付客戶項目。2. 開源ERP庫存管理系統(tǒng)的技術(shù)選型與架構(gòu)設(shè)計2.1 技術(shù)棧選型建議在實際項目中庫存管理系統(tǒng)通常作為整個ERP系統(tǒng)中的子模塊出現(xiàn)。如果從零開始搭建一套輕量級庫存管理系統(tǒng)我比較推薦下面的技術(shù)組合技術(shù)層次推薦方案說明前端框架Vue 3 Element Plus組件生態(tài)豐富適合中后臺系統(tǒng)后端框架Spring Boot 2.x / 3.xJava生態(tài)成熟事務(wù)與并發(fā)控制能力強(qiáng)數(shù)據(jù)庫MySQL 8.0使用廣泛運維成本低權(quán)限框架Spring Security JWT實現(xiàn)登錄認(rèn)證與接口權(quán)限構(gòu)建工具M(jìn)aven / npm標(biāo)準(zhǔn)工程構(gòu)建方式部署方式Docker Compose便于本地環(huán)境與生產(chǎn)環(huán)境保持一致這里的版本號只是推薦具體需要結(jié)合你的項目要求來定。Spring Boot 3.x基于Jakarta EE與Spring Boot 2.x在某些依賴上不兼容MySQL 8.0支持窗口函數(shù)和更好的鎖機(jī)制但如果你已有的生產(chǎn)環(huán)境是5.7也不必強(qiáng)行升級。本文側(cè)重講解庫存管理系統(tǒng)的核心設(shè)計代碼示例會盡量保持通用。2.2 整體架構(gòu)圖文字版Vue 3 Element Plus | | HTTP/JSON v Spring Boot 后端服務(wù) |--- 認(rèn)證模塊 (JWT) |--- 商品管理模塊 |--- 倉庫管理模塊 |--- 入庫單模塊 |--- 出庫單模塊 |--- 庫存流水模塊 |--- 庫存余額模塊 | | JDBC v MySQL 數(shù)據(jù)庫 |--- sys_user 用戶表 |--- bas_product 商品表 |--- bas_warehouse 倉庫表 |--- stk_inbound 入庫單表 |--- stk_inbound_item 入庫明細(xì)表 |--- stk_outbound 出庫單表 |--- stk_outbound_item 出庫明細(xì)表 |--- stk_stock_flow 庫存流水表 |--- stk_stock_balance 庫存余額表從整體架構(gòu)可以看出庫存管理系統(tǒng)的核心是“單據(jù) 流水 余額”三層模型。業(yè)務(wù)操作不直接修改庫存數(shù)量而是通過生成入庫單或出庫單同時記錄庫存流水最后更新庫存余額。2.3 核心業(yè)務(wù)閉環(huán)庫存系統(tǒng)的完整閉環(huán)可以拆成下面幾步用戶創(chuàng)建入庫單填寫供應(yīng)商、收貨倉庫、商品和數(shù)量。入庫單審核通過后系統(tǒng)生成入庫庫存流水。系統(tǒng)更新對應(yīng)倉庫、對應(yīng)商品的庫存余額。用戶創(chuàng)建出庫單填寫客戶、發(fā)貨倉庫、商品和數(shù)量。出庫單審核時系統(tǒng)檢查可用庫存是否充足。庫存充足則扣減庫存不足則提示庫存不足。財務(wù)或管理人員通過報表查看庫存變動、庫存價值、出入庫趨勢。這個閉環(huán)看起來簡單但實際開發(fā)中并發(fā)扣減庫存、事務(wù)一致性、冪等性等問題非常容易出現(xiàn)。3. 數(shù)據(jù)庫表設(shè)計庫存系統(tǒng)的基石3.1 數(shù)據(jù)模型設(shè)計原則在設(shè)計庫存管理系統(tǒng)數(shù)據(jù)庫時至少要遵循以下原則單據(jù)與明細(xì)分離主表存單據(jù)頭信息明細(xì)表存商品明細(xì)避免單表字段過多。數(shù)量與金額精度控制庫存數(shù)量使用DECIMAL不使用浮點類型避免精度丟失。庫存流水只增不改流水表通過流水號唯一約束一旦寫入不允許修改和刪除只能通過沖銷單糾正。庫存余額必須有版本號或鎖機(jī)制用于處理并發(fā)更新防止超賣。所有業(yè)務(wù)表都要帶創(chuàng)建人、創(chuàng)建時間、更新人、更新時間和邏輯刪除標(biāo)記。3.2 商品表和倉庫表-- 商品表 CREATE TABLE bas_product ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, product_code VARCHAR(50) NOT NULL COMMENT 商品編碼, product_name VARCHAR(100) NOT NULL COMMENT 商品名稱, category_id BIGINT COMMENT 分類ID, unit VARCHAR(20) DEFAULT 件 COMMENT 單位, spec VARCHAR(100) COMMENT 規(guī)格型號, status TINYINT DEFAULT 1 COMMENT 狀態(tài)1啟用0停用, deleted TINYINT DEFAULT 0 COMMENT 邏輯刪除0否1是, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_product_code (product_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT商品表; -- 倉庫表 CREATE TABLE bas_warehouse ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, warehouse_code VARCHAR(50) NOT NULL COMMENT 倉庫編碼, warehouse_name VARCHAR(100) NOT NULL COMMENT 倉庫名稱, address VARCHAR(255) COMMENT 倉庫地址, manager VARCHAR(50) COMMENT 負(fù)責(zé)人, status TINYINT DEFAULT 1 COMMENT 狀態(tài)1啟用0停用, deleted TINYINT DEFAULT 0 COMMENT 邏輯刪除, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_warehouse_code (warehouse_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT倉庫表;3.3 入庫單和入庫明細(xì)表-- 入庫單主表 CREATE TABLE stk_inbound ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, inbound_no VARCHAR(50) NOT NULL COMMENT 入庫單號, inbound_type TINYINT COMMENT 入庫類型1采購入庫2生產(chǎn)入庫3退貨入庫4盤點入庫, supplier_id BIGINT COMMENT 供應(yīng)商ID, warehouse_id BIGINT NOT NULL COMMENT 收貨倉庫ID, inbound_date DATE NOT NULL COMMENT 入庫日期, status TINYINT DEFAULT 0 COMMENT 狀態(tài)0草稿1已審核2已作廢, remark VARCHAR(500) COMMENT 備注, deleted TINYINT DEFAULT 0, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_inbound_no (inbound_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT入庫單主表; -- 入庫明細(xì)表 CREATE TABLE stk_inbound_item ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, inbound_id BIGINT NOT NULL COMMENT 入庫單主表ID, product_id BIGINT NOT NULL COMMENT 商品ID, quantity DECIMAL(18,3) NOT NULL COMMENT 入庫數(shù)量, price DECIMAL(18,2) DEFAULT 0 COMMENT 入庫單價, amount DECIMAL(18,2) DEFAULT 0 COMMENT 金額, remark VARCHAR(200) COMMENT 明細(xì)備注, KEY idx_inbound_id (inbound_id), KEY idx_product_id (product_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT入庫明細(xì)表;3.4 出庫單和出庫明細(xì)表出庫表和入庫表結(jié)構(gòu)非常相似這里可以單獨建表也可以設(shè)計成一張通用庫存單據(jù)表。對于初學(xué)者來說分表更容易理解。如果業(yè)務(wù)擴(kuò)展后單據(jù)類型增多再考慮將公共字段抽取為通用單據(jù)表。-- 出庫單主表 CREATE TABLE stk_outbound ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, outbound_no VARCHAR(50) NOT NULL COMMENT 出庫單號, outbound_type TINYINT COMMENT 出庫類型1銷售出庫2生產(chǎn)領(lǐng)料3報損出庫4盤虧出庫, customer_id BIGINT COMMENT 客戶ID, warehouse_id BIGINT NOT NULL COMMENT 發(fā)貨倉庫ID, outbound_date DATE NOT NULL COMMENT 出庫日期, status TINYINT DEFAULT 0 COMMENT 狀態(tài)0草稿1已審核2已作廢, remark VARCHAR(500) COMMENT 備注, deleted TINYINT DEFAULT 0, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_outbound_no (outbound_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT出庫單主表; -- 出庫明細(xì)表 CREATE TABLE stk_outbound_item ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, outbound_id BIGINT NOT NULL COMMENT 出庫單主表ID, product_id BIGINT NOT NULL COMMENT 商品ID, quantity DECIMAL(18,3) NOT NULL COMMENT 出庫數(shù)量, price DECIMAL(18,2) DEFAULT 0 COMMENT 出庫單價, amount DECIMAL(18,2) DEFAULT 0 COMMENT 金額, remark VARCHAR(200) COMMENT 明細(xì)備注, KEY idx_outbound_id (outbound_id), KEY idx_product_id (product_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT出庫明細(xì)表;3.5 庫存流水表和庫存余額表庫存流水表和庫存余額表是整個庫存系統(tǒng)的核心。簡單來說流水表記錄了每一次庫存變化余額表保存當(dāng)前庫存數(shù)量。查詢報表時可以先看余額表要追溯時可以查流水表。-- 庫存流水表 CREATE TABLE stk_stock_flow ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, flow_no VARCHAR(50) NOT NULL COMMENT 流水號, product_id BIGINT NOT NULL COMMENT 商品ID, warehouse_id BIGINT NOT NULL COMMENT 倉庫ID, change_type TINYINT COMMENT 變動類型1入庫2出庫3盤點調(diào)整4調(diào)撥出5調(diào)撥入, source_no VARCHAR(50) COMMENT 來源單據(jù)號, source_type TINYINT COMMENT 來源單據(jù)類型1入庫單2出庫單3盤點單4調(diào)撥單, quantity_change DECIMAL(18,3) NOT NULL COMMENT 變動數(shù)量入庫為正出庫為負(fù), before_quantity DECIMAL(18,3) DEFAULT 0 COMMENT 變動前庫存, after_quantity DECIMAL(18,3) DEFAULT 0 COMMENT 變動后庫存, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_flow_no (flow_no), KEY idx_product_warehouse (product_id, warehouse_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT庫存流水表; -- 庫存余額表 CREATE TABLE stk_stock_balance ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 主鍵, product_id BIGINT NOT NULL COMMENT 商品ID, warehouse_id BIGINT NOT NULL COMMENT 倉庫ID, stock_quantity DECIMAL(18,3) NOT NULL DEFAULT 0 COMMENT 庫存數(shù)量, locked_quantity DECIMAL(18,3) NOT NULL DEFAULT 0 COMMENT 鎖定數(shù)量, available_quantity DECIMAL(18,3) NOT NULL DEFAULT 0 COMMENT 可用數(shù)量, version INT NOT NULL DEFAULT 0 COMMENT 樂觀鎖版本號, create_by VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_by VARCHAR(50), update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_product_warehouse (product_id, warehouse_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT庫存余額表;這里引入了一個“鎖定數(shù)量”字段。這個概念在電商庫存系統(tǒng)中用得非常多。當(dāng)用戶提交訂單但還沒付款時可以先占用一部分庫存避免其他訂單繼續(xù)超賣。在普通ERP庫存系統(tǒng)中如果業(yè)務(wù)流程沒有“預(yù)占”環(huán)節(jié)可以暫時不用這個字段但保留它能為以后的復(fù)雜業(yè)務(wù)留出擴(kuò)展空間。3.6 為什么需要 before_quantity 和 after_quantity在設(shè)計庫存流水表時有人會問既然有了 quantity_change為什么還要存 before_quantity 和 after_quantity原因很簡單便于對賬和排查。如果某一天發(fā)現(xiàn)庫存余額不平可以通過流水表快速看到每筆操作發(fā)生前后的庫存快照。特別是在多人同時操作的情況下光靠變動數(shù)量無法還原當(dāng)時的庫存上下文。保留這兩個字段相當(dāng)于給每次庫存變動記錄了系統(tǒng)日志。4. 后端核心實現(xiàn)Spring Boot 庫存服務(wù)4.1 項目基礎(chǔ)結(jié)構(gòu)假設(shè)我們使用Spring Boot MyBatis-Plus來構(gòu)建后端服務(wù)項目結(jié)構(gòu)如下erp-stock-system ├── pom.xml └── src └── main ├── java │ └── com │ └── example │ └── erp │ ├── ErpApplication.java │ ├── common │ │ ├── Result.java │ │ └── BusinessException.java │ ├── controller │ │ └── StockController.java │ ├── entity │ │ ├── StockBalance.java │ │ ├── StockFlow.java │ │ ├── Inbound.java │ │ └── Outbound.java │ ├── mapper │ │ ├── StockBalanceMapper.java │ │ ├── StockFlowMapper.java │ │ ├── InboundMapper.java │ │ └── OutboundMapper.java │ └── service │ ├── InboundService.java │ └── OutboundService.java └── resources ├── application.yml └── mapper4.2 Maven 依賴配置dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies4.3 庫存扣減的核心邏輯庫存扣減是庫存系統(tǒng)里最容易出Bug的地方。下面用一個出庫場景來演示核心代碼。注意這里的示例重點是事務(wù)和并發(fā)控制。首先定義庫存余額實體Data TableName(stk_stock_balance) public class StockBalance { TableId(type IdType.AUTO) private Long id; private Long productId; private Long warehouseId; private BigDecimal stockQuantity; private BigDecimal lockedQuantity; private BigDecimal availableQuantity; Version private Integer version; }然后在Service中實現(xiàn)出庫審核邏輯Service public class OutboundService { Resource private StockBalanceMapper stockBalanceMapper; Resource private StockFlowMapper stockFlowMapper; Transactional(rollbackFor Exception.class) public void auditOutbound(Outbound outbound, ListOutboundItem items) { for (OutboundItem item : items) { // 1. 查詢庫存余額 StockBalance balance stockBalanceMapper.selectByProductAndWarehouse( item.getProductId(), outbound.getWarehouseId()); if (balance null) { throw new BusinessException(庫存余額不存在請先初始化庫存); } // 2. 校驗可用庫存 if (balance.getAvailableQuantity().compareTo(item.getQuantity()) 0) { throw new BusinessException(商品庫存不足); } // 3. 使用樂觀鎖更新庫存 int rows stockBalanceMapper.deductStock( balance.getId(), item.getQuantity(), balance.getVersion()); if (rows 0) { throw new BusinessException(庫存扣減失敗請重試); } // 4. 寫入庫存流水 StockFlow flow new StockFlow(); flow.setFlowNo(generateFlowNo()); flow.setProductId(item.getProductId()); flow.setWarehouseId(outbound.getWarehouseId()); flow.setChangeType(2); flow.setSourceNo(outbound.getOutboundNo()); flow.setSourceType(2); flow.setQuantityChange(item.getQuantity().negate()); flow.setBeforeQuantity(balance.getStockQuantity()); flow.setAfterQuantity(balance.getStockQuantity().subtract(item.getQuantity())); flow.setCreateBy(outbound.getUpdateBy()); stockFlowMapper.insert(flow); } // 5. 更新出庫單狀態(tài)為已審核 outbound.setStatus(1); outboundMapper.updateById(outbound); } }對應(yīng)的Mapper SQL如下update iddeductStock UPDATE stk_stock_balance SET stock_quantity stock_quantity - #{quantity}, available_quantity available_quantity - #{quantity}, version version 1 WHERE id #{id} AND version #{version} AND available_quantity gt; #{quantity} /update這段SQL的關(guān)鍵點在于UPDATE語句中同時帶上了version條件并且通過available_quantity大于等于待扣數(shù)量來做額外的庫存約束。在數(shù)據(jù)庫層面這種寫法可以防止并發(fā)場景下兩個請求同時扣減同一份庫存。4.4 入庫審核的核心邏輯入庫相對簡單核心是生成流水并累加庫存Transactional(rollbackFor Exception.class) public void auditInbound(Inbound inbound, ListInboundItem items) { for (InboundItem item : items) { StockBalance balance stockBalanceMapper.selectByProductAndWarehouse( item.getProductId(), inbound.getWarehouseId()); if (balance null) { // 初始化一條庫存余額記錄 balance new StockBalance(); balance.setProductId(item.getProductId()); balance.setWarehouseId(inbound.getWarehouseId()); balance.setStockQuantity(BigDecimal.ZERO); balance.setLockedQuantity(BigDecimal.ZERO); balance.setAvailableQuantity(BigDecimal.ZERO); stockBalanceMapper.insert(balance); } // 增加庫存 int rows stockBalanceMapper.addStock( balance.getId(), item.getQuantity(), balance.getVersion()); if (rows 0) { throw new BusinessException(庫存更新失敗請重試); } // 寫入流水 StockFlow flow new StockFlow(); flow.setFlowNo(generateFlowNo()); flow.setProductId(item.getProductId()); flow.setWarehouseId(inbound.getWarehouseId()); flow.setChangeType(1); flow.setSourceNo(inbound.getInboundNo()); flow.setSourceType(1); flow.setQuantityChange(item.getQuantity()); flow.setBeforeQuantity(balance.getStockQuantity()); flow.setAfterQuantity(balance.getStockQuantity().add(item.getQuantity())); flow.setCreateBy(inbound.getUpdateBy()); stockFlowMapper.insert(flow); } inbound.setStatus(1); inboundMapper.updateById(inbound); }這里有幾個容易被忽略的點新增庫存余額記錄時要注意并發(fā)插入。如果在極短時間內(nèi)同時收到兩條入庫請求且?guī)齑嬗囝~記錄不存在可能會插入兩條重復(fù)記錄。解決方式有兩種一是利用數(shù)據(jù)庫唯一索引uk_product_warehouse兜底二是先查詢?nèi)绻淮嬖趧t通過INSERT IGNORE或ON DUPLICATE KEY UPDATE方式處理。流水號建議使用類似“年月日隨機(jī)數(shù)”或“日期序列”的格式。這里可以使用Redis自增序列也可以直接用數(shù)據(jù)庫的ID生成器但一定要保證唯一。4.5 事務(wù)與并發(fā)控制方案選擇在庫存扣減場景中常見的并發(fā)控制方案有三種方案實現(xiàn)方式優(yōu)點缺點樂觀鎖使用version字段更新時校驗版本號簡單、性能好沖突時需要重試悲觀鎖SELECT ... FOR UPDATE鎖定記錄實現(xiàn)直觀不會重試并發(fā)高時鎖競爭激烈數(shù)據(jù)庫約束使用條件更新 WHERE available_quantity quantity數(shù)據(jù)庫層面兜底需要配合樂觀鎖或事務(wù)使用實際項目中我比較推薦“樂觀鎖 條件更新”的組合方式。先用樂觀鎖保證版本一致性再用數(shù)據(jù)庫條件更新作為最終約束這樣既不會因為鎖等待導(dǎo)致系統(tǒng)卡頓又能防止超賣。5. 前端頁面Vue 3 Element Plus 快速搭建5.1 前端項目結(jié)構(gòu)前端部分使用Vue 3 Vite Element Plus項目結(jié)構(gòu)如下erp-web ├── index.html ├── package.json ├── vite.config.js └── src ├── main.js ├── App.vue ├── api │ └── stock.js └── views ├── dashboard.vue ├── inbound.vue ├── outbound.vue └── stock.vue5.2 庫存余額展示頁面下面是一個簡單的庫存余額列表頁面template div classstock-page el-card el-form :inlinetrue el-form-item label商品編碼 el-input v-modelqueryParam.productCode placeholder請輸入商品編碼 clearable / /el-form-item el-form-item label倉庫 el-select v-modelqueryParam.warehouseId placeholder請選擇倉庫 clearable el-option v-foritem in warehouseList :keyitem.id :labelitem.warehouseName :valueitem.id / /el-select /el-form-item el-form-item el-button typeprimary clickloadStockList查詢/el-button el-button clickresetQuery重置/el-button /el-form-item /el-form /el-card el-card stylemargin-top: 16px el-table :datastockList border stripe el-table-column propproductCode label商品編碼 min-width120 / el-table-column propproductName label商品名稱 min-width150 / el-table-column propwarehouseName label倉庫名稱 min-width120 / el-table-column propstockQuantity label庫存數(shù)量 min-width100 alignright / el-table-column proplockedQuantity label鎖定數(shù)量 min-width100 alignright / el-table-column propavailableQuantity label可用數(shù)量 min-width100 alignright / /el-table /el-card /div /template script setup import { ref, onMounted } from vue import { getStockList } from /api/stock const queryParam ref({ productCode: , warehouseId: null }) const stockList ref([]) const warehouseList ref([]) async function loadStockList() { const res await getStockList(queryParam.value) stockList.value res.data.records } function resetQuery() { queryParam.value { productCode: , warehouseId: null } loadStockList() } onMounted(() { loadStockList() }) /script這個頁面的作用是展示當(dāng)前庫存余額讓管理者可以快速看到某個倉庫中所有商品的數(shù)量分布。實際系統(tǒng)中還可以加入庫存預(yù)警閾值當(dāng)可用庫存低于某個下限時在列表里用紅色標(biāo)識提示需要補(bǔ)貨。5.3 前端接口封裝import request from /utils/request export function getStockList(params) { return request({ url: /api/stock/list, method: get, params }) } export function auditInbound(data) { return request({ url: /api/inbound/audit, method: post, data }) } export function auditOutbound(data) { return request({ url: /api/outbound/audit, method: post, data }) }前端做好數(shù)據(jù)展示和交互即可真正的業(yè)務(wù)規(guī)則必須放在后端服務(wù)中。尤其是庫存扣減、事務(wù)、權(quán)限校驗這類邏輯如果放在前端任何人都可以通過瀏覽器控制臺繞過。6. 開源許可證與二次開發(fā)注意事項6.1 許可證怎么選很多開發(fā)者在Gitee或GitHub上創(chuàng)建開源項目時都會糾結(jié)許可證怎么選。這里給出一個簡單的選擇建議許可證特點適合場景MIT寬松允許商用允許閉源個人項目、內(nèi)部系統(tǒng)、希望被廣泛使用Apache 2.0寬松附帶專利授權(quán)條款企業(yè)級開源項目GPL傳染性衍生代碼需開源希望生態(tài)保持開源LGPL修改庫文件才需要開源被其他項目以庫形式引用MPL文件級別傳染混合開源開發(fā)模型如果你在開發(fā)開源ERP庫存管理系統(tǒng)需要明確一個問題允許別人拿去商用而不開源嗎如果允許建議MIT或Apache 2.0如果希望商業(yè)公司在使用后把增強(qiáng)功能回饋社區(qū)可以選擇GPL。6.2 二次開發(fā)時的注意事項保留上游項目版權(quán)聲明不要刪除License文件。修改代碼時盡量以模塊化方式擴(kuò)展避免在核心代碼上大面積改動。如果是基于GPL項目二次開發(fā)對外分發(fā)時需要注意源代碼開放義務(wù)。如果只是企業(yè)內(nèi)部使用不分發(fā)給第三方GPL和MIT的影響相對可控但也要咨詢法務(wù)。7. 常見問題與排查思路7.1 常見問題匯總表問題現(xiàn)象常見原因解決思路庫存扣減后變成負(fù)數(shù)未使用樂觀鎖或條件更新并發(fā)扣減在UPDATE語句中增加可用庫存判斷使用version同一商品出現(xiàn)多條庫存余額記錄并發(fā)插入庫存余額唯一索引失效創(chuàng)建唯一索引插入時使用ON DUPLICATE KEY UPDATE頁面顯示庫存和實際盤點不一致手工修改數(shù)據(jù)庫導(dǎo)致流水?dāng)嗔呀故止じ膸齑嫱ㄟ^盤點單調(diào)整超賣訂單提交和庫存扣減不是同一事務(wù)將訂單創(chuàng)建與庫存扣減放在同一事務(wù)中流水號重復(fù)使用時間戳或簡單隨機(jī)數(shù)生成流水號使用Redis自增或數(shù)據(jù)庫序列報表查詢慢庫存流水表全表掃描為product_id、warehouse_id、create_time建立聯(lián)合索引Decimal類型計算出現(xiàn)精度問題使用double或float存儲金額金額和數(shù)量統(tǒng)一使用DECIMAL7.2 復(fù)盤一個典型的庫存變負(fù)事故假設(shè)系統(tǒng)上線后運營反饋某個商品庫存從“3件”變成了“-1件”。排查思路如下查詢該商品的庫存流水表看看最近有哪些出入庫記錄。找出導(dǎo)致庫存變負(fù)的那條流水確認(rèn)來源單據(jù)。檢查該單據(jù)審核時后端是否執(zhí)行了“可用庫存是否充足”的判斷。如果判斷邏輯存在再看是否是并發(fā)導(dǎo)致的兩個請求同時讀到庫存為3同時扣2理論上最終結(jié)果應(yīng)該是1但由于沒有版本號控制兩條SQL都成功執(zhí)行結(jié)果變成-1。修復(fù)方式為庫存余額表增加version字段修改UPDATE語句增加available_quantity quantity條件。這個案例說明庫存系統(tǒng)不是“能增能減”就行必須把并發(fā)控制放到數(shù)據(jù)庫層而不是依賴應(yīng)用層的判斷。8. 最佳實踐與工程建議8.1 單據(jù)驅(qū)動禁止直接改庫存很多初學(xué)ERP開發(fā)的朋友會犯一個錯誤用戶點擊“庫存調(diào)整”直接寫一條UPDATE語句把庫存數(shù)量改了。這樣做表面上很快實際是在給系統(tǒng)埋雷。正確的做法是引入“盤點單”。盤點的本質(zhì)是“賬面數(shù)量 vs 實盤數(shù)量”差異部分通過盤點單生成盤盈或盤虧流水最終調(diào)整庫存余額。這樣做的好處是所有庫存變動都可追溯每筆變更都能找到對應(yīng)的業(yè)務(wù)單據(jù)。8.2 庫存流水只增不改庫存流水表記錄了企業(yè)所有庫存變動的歷史是一份極其重要的審計數(shù)據(jù)。設(shè)計上應(yīng)該做到流水表不提供修改和刪除接口。即使對應(yīng)的入庫單或出庫單作廢流水表仍然保留。作廢單據(jù)時需要生成一張反向沖銷的流水而不是物理刪除原來的流水。這樣設(shè)計雖然會增加一些開發(fā)量但長期來看系統(tǒng)的數(shù)據(jù)可信度會高很多。8.3 永遠(yuǎn)在事務(wù)中操作庫存所有涉及庫存余額變化的操作都必須放在數(shù)據(jù)庫事務(wù)中。Spring中可以通過Transactional注解實現(xiàn)。事務(wù)的隔離級別建議設(shè)置為默認(rèn)的數(shù)據(jù)庫隔離級別不要輕易提高。另外事務(wù)中盡量縮短業(yè)務(wù)邏輯的執(zhí)行時間不要在事務(wù)內(nèi)調(diào)用第三方HTTP接口、發(fā)送短信郵件、等待MQ消息等耗時操作。否則會導(dǎo)致數(shù)據(jù)庫連接長時間占用系統(tǒng)吞吐量下降。8.4 權(quán)限與安全邊界庫存管理系統(tǒng)涉及企業(yè)的核心資產(chǎn)數(shù)據(jù)安全設(shè)計不能放松接口必須做登錄認(rèn)證不能裸奔。權(quán)限控制建議做到按鈕級別不只是頁面級別。審核入庫單和創(chuàng)建入庫單建議由不同角色承擔(dān)形成簡單復(fù)核機(jī)制。所有寫操作都要記錄操作日志包括操作人、操作時間、IP、操作內(nèi)容。不要在前端頁面暴露全量庫存導(dǎo)出接口或者至少加入權(quán)限校驗和數(shù)據(jù)量限制防止數(shù)據(jù)被批量拉取。8.5 數(shù)據(jù)備份與灰度發(fā)布生產(chǎn)環(huán)境數(shù)據(jù)庫必須配置自動備份策略。庫存數(shù)據(jù)一旦丟失或錯亂恢復(fù)成本極高。建議每周至少做一次全量備份每天做一次增量備份備份文件要存儲到獨立存儲空間。系統(tǒng)升級時先在測試環(huán)境完整跑一遍出入庫流程確認(rèn)無問題后再發(fā)布到生產(chǎn)。如果條件允許可以采用灰度發(fā)布方式先讓倉庫部門的少量賬號使用新版本驗證穩(wěn)定后再全員切換。8.6 性能優(yōu)化要點庫存流水表數(shù)據(jù)量會隨著業(yè)務(wù)增長快速膨脹建議按季度或按年做分區(qū)。常用查詢條件要建立聯(lián)合索引例如(product_id, warehouse_id, create_time)。庫存余額表的查詢非常頻繁盡量通過組合條件唯一命中記錄避免全表掃描。報表類查詢不要直接在業(yè)務(wù)庫執(zhí)行可以通過定時任務(wù)把數(shù)據(jù)同步到統(tǒng)計庫或者使用讀從庫。9. 總結(jié)與學(xué)習(xí)路線寫到這里開源ERP庫存管理系統(tǒng)的核心內(nèi)容已經(jīng)拆解得比較完整了。如果你是從零開始學(xué)習(xí)ERP開發(fā)建議按下面的路線繼續(xù)深入先理解“單據(jù) 流水 余額”三層模型這是整個庫存系統(tǒng)的靈魂。自己動手建一套MySQL表結(jié)構(gòu)手工插入幾條入庫單、出庫單數(shù)據(jù)查看庫存余額變化。學(xué)習(xí)Spring Boot事務(wù)管理和MyBatis-Plus的樂觀鎖插件寫一個簡單的庫存扣減接口。完善單據(jù)審核流程、庫存盤點、庫存預(yù)警、調(diào)撥單逐步擴(kuò)展系統(tǒng)能力。閱讀優(yōu)秀開源項目的源碼比如Odoo庫存模塊、ERPNext的Stock模塊學(xué)習(xí)它們的業(yè)務(wù)抽象方式。最后嘗試把庫存模塊與采購、銷售、財務(wù)模塊打通理解ERP系統(tǒng)各模塊之間的關(guān)聯(lián)。開源ERP庫存管理系統(tǒng)的優(yōu)勢在于你可以邊看源碼邊學(xué)習(xí)遇到不滿足的業(yè)務(wù)需求還能自己改。但這也意味著你需要投入時間和精力不能把自己當(dāng)成普通的軟件使用者。如果你所在的企業(yè)正好需要一個庫存管理系統(tǒng)不妨先從本文提到的數(shù)據(jù)模型和核心接口入手搭一個最小可運行版本再根據(jù)實際業(yè)務(wù)去迭代。我在文章里分享的SQL和Java代碼均是可以直接參考的核心片段。實際項目里你還需要補(bǔ)充用戶認(rèn)證、菜單權(quán)限、操作日志、報表統(tǒng)計等功能。如果遇到庫存扣減并發(fā)問題優(yōu)先檢查你們的庫存余額表是否使用了樂觀鎖以及UPDATE語句是否帶有庫存數(shù)量約束條件——大部分問題都出在這兩個地方。如果你準(zhǔn)備把某個開源ERP項目引入公司也不要急著部署。先讓運維和開發(fā)團(tuán)隊把技術(shù)棧、部署方式、License條款、二次開發(fā)成本都評估清楚。庫存系統(tǒng)是業(yè)務(wù)系統(tǒng)的核心一旦跑了錯誤的數(shù)據(jù)業(yè)務(wù)方對系統(tǒng)的信任度會大打折扣。希望這篇文章能幫你少走一些彎路。