冷库管理系统产品系统Vibe Coding

梨子冷库仓储管理行业长期依赖纯手工记账和口头对账，入库、出库、库存盘点、客户结算等环节严重脱节。冷库主每年夏天从外地收购皇冠梨、雪梨等水果入库存储，冬季陆续出库销售，年底需要与老客、散户进行繁杂的库费结算和利润分配。传统模式下，库存数据不透明、结算差错率高、老板无法实时掌握经营状况。本项目旨在通过数字化手段解决冷库经营中的库存管理混乱、库费核算困难、客户结算繁琐等核心痛点，帮助冷库主实现从入库到出库再到结算的全链路智能化管理，大幅降低管理成本与人工差错率。

本系统覆盖冷库经营的全业务流程，具体功能模块包括：

1. **库存管理模块**：入库批次创建、二维码标签打印、批次详情查询、库存列表搜索与筛选、按品种分布统计。
2. **出库管理模块**：手机摄像头扫码识别批次、出库校验与库存扣减、出库记录查询。
3. **结算中心模块**：老客库费核算、散户利润结算、自营利润统计、客户结算状态标记与管理。
4. **经营看板模块**：总库存箱数、库费收入、自营利润、老板总收入等核心经营指标实时展示。
5. **客户与品种管理模块**：客户CRUD（老客/散户分类管理）、产品品种维护与启禁用。
6. **库存流水模块**：按批次号、变动类型、时间范围等多维度筛选查询库存变动记录。
7. **日报推送模块**：支持冷库主自定义发送时间，定时通过企业微信Webhook推送当日冷库经营详情。
8. **系统管理模块**：JWT认证鉴权、角色权限控制（老板/库管工人）、用户管理、冷库管理、操作日志记录。

系统以移动端H5为主（适配手机竖屏），涵盖从夏天收货入库、冬季出库销售到年底统一结算的完整业务生命周期，支持自营、老客、散户三种归属类型的精细化管理，老板可以随时随地掌握冷库经营全貌。

**具体任务（独立完成）**：本项目由我独立完成全部开发工作，包括后端所有RESTful API设计与实现、数据库表结构设计与初始化SQL编写、前端所有页面（登录、库存、入库、出库、经营看板、结算中心、客户管理、品种管理、库存流水、我的等20+个页面）的开发与路由配置、ZPL标签打印服务集成、企业微信日报推送功能、JWT认证与角色权限体系、全局异常处理与拦截器机制等全栈开发任务。

**技术栈/架构**：后端采用 **Spring Boot 2.7 + MyBatis-Plus 3.5.5 + MySQL 8.0**，前端采用 **Vue 3 + Vant 4 + Axios + Vue Router**，构建工具使用 **Vite**。系统采用前后端分离架构，后端遵循经典的MVC分层设计（Controller-Service-Mapper-Entity），通过BaseCrudController通用基类实现CRUD代码复用；引入JWT无状态认证、@RequireRole注解切面实现细粒度角色权限控制；集成**html5-qrcode**实现手机摄像头扫码出库；对接**斑马ZPL网络打印机**实现入库二维码标签实时打印。

**实现亮点与难点**：

- **亮点一 — 企业微信日报定时推送**：实现了一套灵活的日报推送机制，冷库主可在系统后台自定义推送时间（如每天12:30），系统每分钟轮询匹配各冷库配置的sendTime，通过企业微信群机器人Webhook准时推送当日库存概况、出入库统计、库费收入等核心经营数据，支持多冷库独立配置与定时发送。
- **亮点二 — 批次号自动生成与库存流水追溯**：按"BN+日期+三位序号"规则自动生成唯一批次号，每次入库和出库均记录完整库存流水（变动前后结余），实现全生命周期库存追溯。
- **亮点三 — 三种归属类型的差异化结算引擎*