仓储物流管理系统-一物一码

这个项目是基于若依（RuoYi）v3.8.2 深度二次开发的一套企业级“一物一码追溯与供应链协同平台”。
主要服务快消制造场景中的箱码、瓶码、托盘码关联管理与全链路追踪：支持箱托关系查询、码级明细下钻、入库/出库记录管理、历史追溯以及多工厂维度的数据过滤；同时提供问题上报与闭环处理能力，支持按工厂、产线、供应商、问题类型进行协同流转，并可导出统计数据。系统还集成了微信小程序接口，支持移动端登录、权限下发、扫码查询、业务操作上报，便于一线人员在仓库、产线和现场快速处理任务。此外，项目接入了人脸认证流程（含二维码校验、认证次数控制、认证结果回写），用于关键操作场景的身份核验与风控。结合 WMS、外部平台调用与日志审计能力，这个项目本质上是一套将“防伪追溯、仓储物流、现场质控、移动协同、身份认证”打通的数字化运营系统，目标是提升数据可追踪性、作业规范性和异常处理效率。

1）整体架构和设计思路
项目是基于若依做的深度业务化改造，定位是一物一码追溯 + WMS仓储协同 + 移动端现场作业。
整体采用前后端分离架构：
后端：Spring Boot + Spring Security + JWT + Redis + MyBatis-Plus（Maven多模块）
前端：Vue2 + Element UI
数据侧：MySQL + 分页插件 + Excel导出能力
扩展能力：微信小程序接口、人脸识别接口、外部系统对接
设计上分成四条主线：
基础能力层：用户、角色、权限、日志、定时任务
核心业务层：箱码/瓶码/托盘码关联、追溯查询、入库/出库流程
协同闭环层：问题上报、流转、处理、统计分析
渠道接入层：PC后台 + 微信小程序 + 第三方接口统一接入
核心思路是：把“码流”和“物流”统一到同一套数据链路里，保证每一次扫码、每一笔出入库、每一个异常工单都可追溯、可审计、可统计。

2）我主要负责的模块和结果
A. 箱/瓶/托全链路追溯模块
负责内容：追溯接口设计、码关系查询、明细下钻（托盘→箱→瓶）、高频查询优化。
结果：
支撑了质检、仓储、客服三类场景共用同一套追溯口径，减少跨部门对账争议。
B. WMS入库/出库与工厂权限隔离模块
负责内容：入库、出库、导出、工厂维度数据隔离、操作权限控制。
结果：
完成入出库全流程线上化，减少手工台账；
按“用户所属工厂”做数据过滤，避免跨工厂数据误看误改；
出入库报表导出标准化后，统计口径统一，月度盘点效率显著提升
C. 微信小程序现场作业模块
负责内容：小程序登录、权限获取、扫码查询、问题上报、现场操作接口联调。
结果：
关键现场动作从PC迁移到移动端，一线可边作业边上报；
缩短“发现问题→发起处理”链路时长；
推动现场数据实时回传，管理端看板时效性提升。

3）我遇到的难点、坑和解决方案
难点1：码体系复杂，历史数据口径不一致
坑：不同阶段对箱码、托盘码、虚拟托盘码命名不统一，导致查询结果容易“看起来对不上”。
解决：先统一领域模型和接口入参语义，再做兼容映射；对关键查询加审计日志，便于复盘。
收益：追溯口径稳定后，业务和技术沟通成本明显下降。
难点2：多角色、多工厂权限下的数据安全与可用性平衡
坑：权限收得太紧影响使用，放得太开又有越权风险。
解决：采用“功能权限 + 数据权限（工厂维度）”双层控制；列表查询统一加工厂过滤。
收益：既满足一线使用效率，也保证了跨工厂数据隔离。
难点3：外部接口与现场网络不稳定，导致流程偶发失败

坑：小程序、第三方接口、认证服务偶发超时，现场用户感知差。
解决：关键接口增加重试与兜底提示；异步日志记录完整请求链路，方便快速定位。
收益：接口可用性和问题定位效率都提升，线上故障恢复时间缩短。