WMS Warehouse Management
Based on the latest RuoyiPlus backend architecture, 30 DOs / 29 Controllers, menu ID starting at 5000, building an intelligent warehousing and supply chain collaboration system
1. Enhancement Positioning and Architecture
1.1 Product Positioning
RuoYiPlus WMS provides enterprise-level enhancements around three core areas: multi-warehouse management, intelligent operations, and precise inventory control, achieving a complete warehousing management closed loop from inbound to outbound.
1.2 Module Scale
| Metric | Value |
|---|---|
| Data Objects (DO) | 30 |
| Controllers | 29 |
| Menu ID Start | 5000 |
| Maven Module | yudao-module-wms |
1.3 Core Data Tables
| Table Name | Description |
|---|---|
wms_receipt | Receiving management |
wms_shipment | Shipping management |
wms_movement | Inventory movement |
wms_check | Counting management |
wms_qc | QC management |
wms_damage | Damage management |
wms_replenishment | Replenishment management |
wms_inventory | Inventory management |
wms_item | Item management |
wms_batch | Batch management |
wms_merchant | Merchant management |
wms_warehouse | Warehouse management |
graph TB
subgraph "RuoYiPlus WMS Enhancement Architecture"
subgraph "Warehouse Layer"
A1[Central Warehouse]
A2[Regional Warehouse]
A3[Forward Warehouse]
A4[Store Warehouse]
A5[Virtual Warehouse]
end
subgraph "Operations Layer"
B1[Inbound Management]
B2[Outbound Management]
B3[In-Warehouse Management]
B4[Counting Management]
end
subgraph "Strategy Layer"
C1[Location Recommendation]
C2[Wave Picking]
C3[Inventory Alert]
C4[Replenishment Suggestions]
end
subgraph "Execution Layer"
D1[PDA Mobile Operations]
D2[Task Management]
D3[Operations Monitoring]
end
subgraph "Control Layer"
E1[Warehouse Permissions]
E2[Inventory Permissions]
E3[Operation Audit]
E4[Data Security]
end
end
A1 --> B1
A2 --> B1
A3 --> B1
A4 --> B1
A5 --> B1
B1 --> B2
B2 --> B3
B3 --> B4
B4 --> C1
C1 --> C2
C2 --> C3
C3 --> C4
C4 --> D1
D1 --> D2
D2 --> D3
D3 --> E1
E1 --> E2
E2 --> E3
E3 --> E4
1.4 Capability Comparison
| Dimension | Yudao Native Capability | RuoYiPlus WMS Enhancement |
|---|---|---|
| Inventory Management | Basic inventory | Multi-warehouse + fine-grained location management |
| Inbound Management | Simple inbound | Multi-source inbound + QC process |
| Outbound Management | Simple outbound | Intelligent picking + wave management |
| Inventory Alert | None | Multi-dimensional alerts + replenishment suggestions |
| Warehouse Operations | None | PDA mobile operations + task management |
| Data Analytics | None | Inventory turnover + operational efficiency analysis |
| Permission Control | Basic permissions | Warehouse-level data permissions |
| Audit Compliance | Simple logs | Full-chain inventory operation audit |
2. Multi-Warehouse Management System
2.1 Warehouse Architecture
graph TB
subgraph "Multi-Warehouse Architecture"
subgraph "Physical Warehouses"
A1[Central Warehouse]
A2[Regional Warehouse]
A3[Forward Warehouse]
A4[Store Warehouse]
A5[3PL Warehouse]
end
subgraph "Virtual Warehouses"
B1[In-Transit Warehouse]
B2[QC Pending Warehouse]
end
end
A1 --> A2
A2 --> A3
A3 --> A4
A1 --> A5
A1 --> B1
A1 --> B2
| Capability | Description |
|---|---|
| Warehouse Types | Central / Branch / Store / 3PL |
| Warehouse Attributes | Region, type, capacity, operational capability |
| Inventory Transfer | Inter-warehouse transfer, transfer approval |
| Inventory Sync | Real-time multi-warehouse inventory sync |
| Intelligent Allocation | Intelligent order split by warehouse for shipping |
2.2 Warehouse Permission Control
The WMS system implements warehouse-based and data-scope-based permission control to ensure inventory data security.
| Permission Level | Scope | Description |
|---|---|---|
| Warehouse Keeper | Own warehouse | Can only manage inventory and operations of their warehouse |
| Regional Manager | Regional warehouses | Can view all regional warehouse data |
| HQ Operations | All warehouses | Can view all warehouse data |
| Finance Staff | Inventory value | Can view inventory value but cannot modify inventory |
// WMS data permission example
@DataPermission(scope = "warehouse")
public class InventoryServiceImpl {
// Warehouse keeper can only manage their own warehouse inventory
// Automatically filters data by warehouse
}
2.3 Inventory Operation Audit
All inventory operations record complete audit logs, supporting inventory change traceability.
graph LR
A[Inbound Operation] --> B[Inventory Increase]
C[Outbound Operation] --> D[Inventory Decrease]
E[Transfer Operation] --> F[Inventory Movement]
G[Counting Operation] --> H[Inventory Adjustment]
B -.-> I[Audit Log]
D -.-> I
F -.-> I
H -.-> I
I --> J[Inventory Traceability]
I --> K[Compliance Report]
| Audit Item | Description |
|---|---|
| Inbound Record | Records inbound time, quantity, warehouse |
| Outbound Record | Records outbound time, quantity, warehouse |
| Transfer Record | Records transfer time, source warehouse, target warehouse |
| Counting Record | Records counting time, counter, discrepancy |
| Inventory Adjustment | Records adjustment time, reason, quantity |
3. Fine-Grained Location Management
3.1 Location Management
graph TB
subgraph "Location Management"
subgraph "Location Encoding"
A1[Warehouse]
A2[Zone]
A3[Shelf]
A4[Level]
A5[Position]
end
subgraph "Location Types"
B1[Storage Location]
B2[Picking Location]
B3[Staging Location]
B4[Exception Location]
end
subgraph "Location Status"
C1[Empty]
C2[Occupied]
C3[Locked]
C4[Disabled]
end
subgraph "Location Strategy"
D1[Location Recommendation]
D2[Location Optimization]
end
end
A1 --> A2
A2 --> A3
A3 --> A4
A4 --> A5
A5 --> B1
B1 --> B2
B2 --> B3
B3 --> B4
B4 --> C1
C1 --> C2
C2 --> C3
C3 --> C4
C4 --> D1
D1 --> D2
wms:
location:
encoding: "WH-ZONE-SHELF-LEVEL-POSITION"
types:
- storage: "Storage Location"
- picking: "Picking Location"
- staging: "Staging Location"
- exception: "Exception Location"
recommendation:
strategy: "frequency-based" # Recommend by turnover frequency
hot-zone: "Zone A" # High-frequency item zone
4. Inbound and Outbound Processes
4.1 Inbound Process
graph TB
subgraph "Inbound Process"
subgraph "Purchase Inbound"
A1[Purchase Order]
A2[Receiving Appointment]
A3[Receiving Registration]
A4[QC Process]
A5[Putaway Operation]
A6[Location Recommendation]
A7[Inbound Confirmation]
end
subgraph "Return Inbound"
B1[Return Request]
B2[Return Approval]
B3[Return Receiving]
B4[QC Process]
B5[Inbound / Scrap]
end
subgraph "Transfer Inbound"
C1[Transfer Order]
C2[In-Transit Tracking]
C3[Receipt Confirmation]
end
end
A1 --> A2
A2 --> A3
A3 --> A4
A4 --> A5
A5 --> A6
A6 --> A7
B1 --> B2
B2 --> B3
B3 --> B4
B4 --> B5
C1 --> C2
C2 --> C3
4.2 Outbound Process
graph TB
subgraph "Outbound Process"
subgraph "Sales Outbound"
A1[Order Receiving]
A2[Order Validation]
A3[Inventory Reservation]
A4[Wave Generation]
A5[Wave Assignment]
A6[Picking Task]
A7[Picking Operation]
A8[Picking Verification]
A9[Packing Operation]
A10[Shipping Operation]
A11[Logistics Integration]
A12[Outbound Confirmation]
end
end
A1 --> A2
A2 --> A3
A3 --> A4
A4 --> A5
A5 --> A6
A6 --> A7
A7 --> A8
A8 --> A9
A9 --> A10
A10 --> A11
A11 --> A12
5. Inventory Alert System
5.1 Alert Types
| Alert Type | Trigger Condition | Response Action |
|---|---|---|
| Insufficient Stock | Stock < Safety stock | Generate replenishment suggestion |
| Overstock | Inventory turnover > 90 days | Promotion suggestion |
| Expiry Alert | Days to expiry < 30 | Priority outbound / promotion |
| Location Overload | Location occupancy > 90% | Location adjustment suggestion |
| Abnormal Inventory | Quality issue locked | Exception handling reminder |
5.2 Replenishment Suggestions
wms:
replenishment:
safety-stock:
formula: "avg_daily_sales * lead_time * safety_factor"
safety-factor: 1.5
suggestions:
- condition: "stock < safety_stock"
action: "create_purchase_suggestion"
priority: "high"
- condition: "stock < min_stock"
action: "urgent_purchase"
priority: "critical"
6. Technical Architecture
graph TB
subgraph "yudao-module-wms-plus"
subgraph "wms-biz"
A1[warehouse Warehouse Management]
A2[location Location Management]
A3[inventory Inventory Management]
A4[inbound Inbound Management]
A5[outbound Outbound Management]
A6[wave Wave Management]
A7[picking Picking Management]
A8[task Task Management]
A9[alert Alert Management]
A10[replenishment Replenishment Management]
A11[counting Counting Management]
A12[analytics Data Analytics]
end
subgraph "Permissions & Audit"
B1[permission Permission Control]
B2[audit Audit Logs]
B3[traceability Inventory Traceability]
end
end
A1 --> B1
A2 --> B1
A3 --> B2
A4 --> B2
A5 --> B2
A6 --> B2
A7 --> B3
A8 --> B2
7. Business Value
| Value Point | Description |
|---|---|
| Reduce Inventory Cost | Precise inventory, reduce overstock |
| Improve Operational Efficiency | Intelligent picking, mobile operations |
| Increase Accuracy | Scan-based operations, verification process |
| Optimize Locations | Location recommendation, turnover optimization |
| Alert Response | Timely replenishment, expiry management |
| Compliance Control | Warehouse permissions, inventory audit |