订货单生成系统

项目介绍

这是一套为连锁便利店「定期订货」场景定制的订货建议生成系统，基于若依 RuoYi v3.9.1（Spring Boot 4.x / JDK 17 分支）深度定制。业务的痛点是：每个网点、每件商品都要在订货周期内决定「订多少」，纯靠人工翻销量、查库存效率低且容易漏订、超订。系统给出的解法很直接——把业务方日常维护的「便利店订货目录、库存表、销售表」三份 Excel 原样导入，再按一条可配置的订货规则批量算出每个网点每个商品的建议订货量，业务人员在页面上微调后导出成订货 Excel 即可。

核心功能

• 三类 Excel 导入入库：订货建议页顶部提供商品目录、库存、销售三个上传入口，支持拖拽上传 .xls/.xlsx，后端用 POI 解析后批量 upsert。解析器会做表头必需列校验、日期与数字格式容错、空行跳过，坏行不会中断导入，而是收集为行级错误并汇总展示（如”已跳过 N 行错误数据：第 3 行的’库存数量’格式不正确”）。
• 双模式生成建议：生成页支持「Excel 直传」——再次上传三份 Excel 现场解析直接生成结果（不落库）；也支持「数据库取数」——选定库存业务日期与销售日期范围，从已导入的库存表、销售表取数生成。取数模式对无数据日期会给出明确报错。
• 建议明细与页内调整：结果表逐网点逐商品展示现有库存、本月销量、销售天数、日均销量、系统建议量、最大可调量，业务人员可手工输入调整后订货量（前端实时校验不可超过最大可调量）；支持按网点、商品编码、商品名称与标注（新品/活动品/常规品）筛选，并统计新品、活动品、常规品各自的行数。
• 订货建议导出：点击导出时后端 buildExportItems 会对常规品逐条重算最大可调量并校验调整后量不超上限，超限直接拒绝导出并指出具体商品，校验通过后按若依 ExcelUtil 导出为「订货建议数据」Excel；导入、生成、导出动作均受 ordering:import:*、ordering:recommend:generate、ordering:recommend:export 等权限点控制。

功能截图

订货管理