Springboot vue仓库管理系统源码Java 前后端分离 WMS仓库管理 BS

Springboot vue仓库管理系统源码Java 前后端分离 WMS仓库管理 BS 功能见详情

最近在折腾一个前后端分离的仓库管理系统，用SpringBoot+Vue搞了套WMS方案。这玩意儿用起来比传统单体架构灵活不少，特别是库存实时更新这块，用WebSocket推数据比轮询舒服多了。先看后端怎么处理入库逻辑：

@PostMapping("/stock-in") public ResponseDto stockIn(@RequestBody StockOperationDto dto) { // 这里有个细节：事务里先锁库存记录防止并发问题 Inventory inventory = inventoryService.lockInventory(ddto.getMaterialId()); inventoryService.addStock(inventory, dto.getQuantity(), dto.getOperator()); // 推送到前端看板 webSocketHandler.sendStockChange(inventory); return ResponseDto.success(inventory.getCurrentStock()); }

这里用了双重保障：数据库行锁+操作日志。之前试过不加锁直接更新，结果测试时两个同时入库的请求直接把库存数搞乱了。日志表设计也花了点心思：

@Entity public class OperationLog { @Id @GeneratedValue(strategy = IDENTITY) private Long id; private String operationType; // IN/OUT/ADJUST @Column(precision = 10, scale = 2) private BigDecimal quantity; @ManyToOne private Operator operator; private LocalDateTime timestamp = LocalDateTime.now(); }

注意这个BigDecimal类型，用double的话金额计算会出精度问题。曾经有个项目因为用了double导致库存金额差了几毛钱，排查到凌晨三点...

前端用Vue3+Pinia状态管理，仓库看板组件是关键。这是库存实时更新的处理：

<script setup> const ws = new WebSocket('wss://yourdomain/ws-stock') watchEffect(() => { ws.onmessage = (event) => { const data = JSON.parse(event.data) if (data.type === 'STOCK_UPDATE') { store.updateInventoryRealTime(data.payload) } } }) </script>

这里有个坑：WebSocket重连机制。刚开始没加心跳检测，网络波动时连接断了不会自动重连。后来加了指数退避重试：

let retries = 0; function connect() { ws = new WebSocket(url); ws.onclose = () => { const timeout = Math.min(1000 * Math.pow(2, retries), 30000); setTimeout(connect, timeout); retries++; } }

权限控制方面，后端用Spring Security做了细粒度控制。比如质检员只能看到质检相关菜单：

@PreAuthorize("hasRole('QUALITY_CHECK') || hasRole('ADMIN')") @GetMapping("/quality-records") public Page<QualityRecord> getQualityRecords(Pageable pageable) { return qualityService.getRecords(pageable); }

前端路由根据权限动态生成，避免硬编码。用了个骚操作：登录后把权限树缓存在IndexedDB里，下次进系统不用重新拉取。

遇到最头疼的问题是条码打印兼容性。不同型号的打印机指令集不一样，最后用了个折中方案：后端生成PDF，让浏览器调用本地打印对话框。虽然不如直接发指令给打印机快，但兼容性无敌。

整个项目搞下来最大的体会是：仓库管理系统最核心的不是技术多牛逼，而是业务逻辑的严密性。比如库存移动必须同时记录操作日志和库存变更，任何一个环节没加事务都可能造成数据不一致。源码里用了Command模式来封装操作命令，方便回滚和审计：

public class StockOutCommand implements InventoryCommand { @Override public void execute() { // 扣减库存 // 生成出库单 // 记录操作日志 } @Override public void undo() { // 恢复库存 // 标记出库单作废 } }

这种设计在后来加撤销功能时省了不少事。前后端分离确实让迭代变快了，但接口版本管理要特别注意。我们给每个接口都加了/v1/前缀，防止前端没更新时调用到新版接口。