# 蜀酒慧联 **Repository Path**: jeely/ShuWineSmartLink ## Basic Information - **Project Name**: 蜀酒慧联 - **Description**: 基于JeecgBoot的川酒智慧物流协同平台 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 3 - **Created**: 2026-09-08 - **Last Updated**: 2026-09-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 蜀酒慧联——AI驱动的川酒智慧物流协同平台 ## 项目简介 **蜀酒慧联**是一款面向四川白酒行业的智慧物流仓储管理系统（WMS），基于 JeecgBoot 3.9.2 低代码开发平台构建，深度融合 AIGC 能力（DeepSeek + RAG + Function Calling），实现从原材料入库、成品出库到物流配送的全流程数字化与智能化管理。 平台聚焦川酒供应链场景，在标准 WMS 基础上创新引入 AI 自然语言交互、川酒行业知识库、智能预警分析、批次全链路追溯等能力，助力川酒企业提升仓储物流效率、实现协同化管理。 --- ## 系统功能 ### 核心模块（全部已完成） | 模块 | 表数 | 后端文件 | 前端文件 | 功能描述 | |------|:--:|:--:|:--:|------| | **基础数据管理** | 7 | 42 | 35 | 货品信息、供应商、客户档案、仓库、货位、车辆、司机 | | **入库管理** | 3 | 18 | 15 | 采购入库、生产入库、退货入库、质检验收 | | **出库管理** | 3 | 18 | 15 | 销售出库、调拨出库、发运确认 | | **库存管理** | 7 | 42 | 35 | 实时库存、库存流水、盘点、调拨、安全库存预警 | | **物流配送** | 4 | 24 | 20 | 运输计划、任务调度、在途跟踪、签收管理 | | **批次追溯** | 1 | 6 | 5 | 批次信息、正向追溯（递归下游）、反向追溯（递归上游）、追溯报告 | | **报表中心** | — | — | 3 | 库存总览报表、出入库统计报表、物流时效报表（JimuReport） | | **监控大屏** | — | — | 2 | 仓储监控大屏、物流监控大屏（JimuBI，含KPI/柱/饼/排行/折线） | | **合计** | **25** | **150** | **125** | 25张业务表 + 24个数据字典 + 3,730条模拟数据 | ### AI 创新功能（全部已完成） | 功能 | 描述 | 技术 | |------|------|------| | **川酒行业AI知识库** | 5篇行业文档（国标/产区/储存/标签/质检），RAG智能问答 | DeepSeek + pgvector | | **AI智能助手（4合1）** | 川酒知识库 / 智能库存查询 / AI质检 / 智能预警，统一Tab切换 | DeepSeek Function Calling | | **AI数据打通** | WmsToolsProvider（7个查询工具），DeepSeek可查询真实MySQL数据 | Function Calling + Service层对接 | | **AI侧边栏融合** | 品牌头部 + 能力卡片 + 实时数据统计 + 快捷提问引导 | Vue 3 组件定制 | ### 业务亮点 - **批次全链路追溯**：支持从原料到成品再到销售的正向/反向递归追溯，生成聚合追溯报告 - **AI自然语言查询**：仓管员可直接用自然语言查询库存、订单、物流状态 - **角色差异化仪表盘**：7个角色登录即见对应业务数据（仓库主管/仓管员/质检员/物流调度员/司机/admin/super_admin） - **智能预警**：库存上下限预警、安全库存配置、AI趋势分析 - **货品图片管理**：80个货品通过 MinIO 对象存储管理商品图片，支持缩略图预览 - **数据可视化**：2个监控大屏 + 3个数据报表，实时展示核心运营指标 --- ## 技术栈 | 层级 | 技术 | 版本 | |------|------|------| | **后端框架** | Spring Boot + MyBatis-Plus | 3.5.5 / 3.5.12 | | **安全框架** | Apache Shiro + JWT | 2.0.5 / 4.5.0 | | **工作流** | Flowable BPM | — | | **业务数据库** | MySQL | 8.0 (127.0.0.1:3306) | | **向量数据库** | PostgreSQL + pgvector | 16+ (127.0.0.1:5432) | | **缓存** | Redis | 7.x (127.0.0.1:6379) | | **对象存储** | MinIO | — (127.0.0.1:9000) | | **数据库迁移** | Flyway | 7.15.0 | | **AI模型** | DeepSeek (chat) + 阿里通义千问 (embedding/绘图) | LangChain4j + jeecg-boot-starter-ai | | **AI知识库** | PostgreSQL pgvector + RAG | — | | **报表工具** | JimuReport + JimuBI | 2.3.2 | | **前端框架** | Vue 3 + TypeScript + Vite 6 + Ant Design Vue 4 | — | | **状态管理** | Pinia | 2.x | | **图表** | ECharts | — | | **容器化** | Docker Compose (MySQL + Redis + MinIO) | — | | **构建工具** | Maven（后端）、pnpm（前端） | — | --- ## 快速开始 ### 环境要求 | 组件 | 最低版本 | 说明 | |------|----------|------| | JDK | 17+ | Lombok 插件 | | Node.js | 20+ | — | | pnpm | 9+ | — | | MySQL | 8.0+ | 业务数据库，端口 3306 | | Redis | 6.0+ | 缓存，端口 6379 | | PostgreSQL | 12+ | AI向量库，需 pgvector 扩展，端口 5432 | | MinIO | 最新版 | 对象存储，API 9000 / Console 9001 | | Maven | 3.6+ | — | | Python | 3.11+ | Skills 脚本运行环境 | ### Docker Compose（推荐） ```bash docker compose up -d # 启动 MySQL + Redis + MinIO ``` ### 数据库初始化 ```bash # 执行 Flyway 迁移脚本（位于 application-dev.yml 中配置） # 或手动执行 db/sql/ 目录下的初始化脚本 # 已含 25 张业务表 + 24 个数据字典 ``` ### 后端启动 1. 导入项目到 IDEA，安装 Lombok 插件 2. 修改 `jeecg-boot/jeecg-module-system/jeecg-system-start/src/main/resources/application-dev.yml`： - 数据库连接（MySQL + PostgreSQL） - Redis 连接 - DeepSeek / 阿里通义千问 API Key 3. 运行启动类 ### 前端启动 ```bash cd jeecgboot-vue3 pnpm install pnpm dev ``` ### 访问系统 | 服务 | 地址 | |------|------| | 前端页面 | `http://localhost:3100` | | 后端接口 | `http://localhost:8080/jeecg-boot` | | MinIO Console | `http://127.0.0.1:9001` | ### 默认测试账号 | 角色 | 账号 | 密码 | |------|------|------| | 超级管理员 | superadmin | 123456 | | 仓库主管 | wm01 | 123456 | | 仓管员 | keeper01 | 123456 | | 质检员 | qc01 | 123456 | | 物流调度员 | disp01 | 123456 | | 司机 | driver01 | 123456 | | 管理员 | admin | 123456 | --- ## 项目结构 ``` ShuWineSmartLink/ ├── jeecg-boot/ # 后端 Java 项目 │ ├── jeecg-boot-base-core/ # 核心框架（Shiro/JWT/MyBatis-Plus） │ ├── jeecg-module-system/ # 系统管理（用户/角色/权限/菜单） │ │ ├── jeecg-system-biz/ # 业务逻辑 │ │ └── jeecg-system-start/ # 启动入口 + 配置文件 │ │ └── src/main/resources/ │ │ ├── application-dev.yml # 主配置（DB/Redis/AI/MinIO） │ │ ├── flyway/sql/mysql/ # Flyway 数据库迁移脚本 (11个) │ │ └── ai-prompts/ # AI 系统提示词 (4个) │ └── jeecg-boot-module/ │ ├── jeecg-boot-module-airag/ # AIGC 模块（知识库/AI聊天） │ └── jeecg-boot-module-wms/ # WMS 核心业务模块 │ └── src/main/java/org/jeecg/modules/wms/ │ ├── goods/ # 货品管理 ✅ │ ├── supplier/ # 供应商档案 ✅ │ ├── warehouse/ # 仓库管理 ✅ │ ├── location/ # 货位管理 ✅ │ ├── customer/ # 客户档案 ✅ │ ├── vehicle/ # 车辆信息 ✅ │ ├── driver/ # 司机信息 ✅ │ ├── inbound/ # 入库管理(3子包) ✅ │ ├── inventory/ # 库存管理(7子包) ✅ │ ├── outbound/ # 出库管理(3子包) ✅ │ ├── logistics/ # 物流配送(4子包) ✅ │ ├── batch/ # 批次追溯 ✅ │ ├── ai/ # AI工具提供者 ✅ │ └── report/ # 报表统计 ✅ ├── jeecgboot-vue3/ # 前端 Vue 3 项目 │ └── src/views/ │ ├── dashboard/ # 角色差异化仪表盘 ✅ │ ├── base/ # 基础数据 (7模块) ✅ │ ├── wms/ # WMS 仓储页面 ✅ │ ├── logistics/ # 物流配送 (4模块) ✅ │ ├── trace/ # 批次追溯 (3页面) ✅ │ ├── ai/ # AI智能助手 (4合1) ✅ │ └── report-wms/ # 数据报表 (3个) ✅ ├── scripts/ # 操作脚本 │ ├── create_menus.py # 创建菜单 (API) │ ├── create_roles.json # 角色配置 │ ├── create_users.py # 创建用户 │ ├── assign_permissions.py # 角色授权 (API+DB) │ ├── create_vue_views.py # 创建Vue页面 + 更新DB component │ ├── insert_mock_data.py # 模拟数据插入 (3,730条) │ ├── replace_goods_images.py # 货品图片替换 (断点续传) │ └── run_flyway.py # 执行 Flyway SQL ├── db/ # 数据库脚本 ├── docs/ # 项目文档 │ ├── 需求分析与可行性研究报告.md │ ├── 创新开发方向与功能规划.md │ ├── 技术栈文档.md │ ├── 数据库设计文档.md │ ├── 菜单结构设计文档.md │ ├── 角色与测试账号.md │ ├── 项目进度跟踪.md │ ├── 项目开发记忆.md │ ├── 项目分工.md │ ├── AI与大屏技术实现文档.md │ └── skills-operations/ # Skills 操作记录 (16篇) ├── docker-compose.yml # Docker 部署配置 └── README.md # 本文档 ``` --- ## 菜单结构 ``` 🏠 工作台 → 角色差异化仪表盘（WMS Dashboard） 🤖 AI智能助手 → 4合1 Tab切换（川酒知识库/库存查询/质检/预警） 📊 监控大屏 → 仓储监控大屏 / 物流监控大屏 📦 仓储管理 → 入库单管理 / 库存查询 / 出库单管理 / 质检记录 / 安全库存 🚚 物流配送 → 运输计划 / 调度管理 / 在途跟踪 / 签收管理 🔍 批次追溯 → 批次信息管理 / 正向追溯 / 反向追溯 / 追溯报告 📈 数据报表 → 库存报表 / 出入库统计 / 物流时效报表 🗂️ 基础数据 → 货品 / 仓库 / 货位 / 供应商 / 客户 / 车辆 / 司机 ⚙️ 系统管理 → 用户/角色/菜单/字典（仅admin可见） ⚙️ 系统监控 → 日志/监控（仅admin可见） ``` --- ## 开发计划 - [x] 基础数据管理（货品、仓库、货位、供应商、客户、车辆、司机） - [x] 入库管理（采购入库、生产入库、退货入库、质检验收） - [x] 出库管理（销售出库、调拨出库、发运确认） - [x] 库存管理（实时库存、盘点、调拨、安全库存预警） - [x] 物流配送（运输计划、任务调度、在途跟踪、签收管理） - [x] 批次追溯（正向追溯、反向追溯、追溯报告，递归查询链） - [x] 报表与大屏（3个JimuReport报表 + 2个JimuBI大屏） - [x] AI知识库助手（川酒行业5篇文档 + RAG） - [x] AI智能助手（4合1 Tab + DeepSeek + Function Calling + 真实数据打通） - [x] 角色差异化仪表盘（7角色，sys_role_index路由） - [ ] 测试与部署 --- ## 模拟数据概览 | 模块 | 表数 | 记录数 | 说明 | |------|:--:|:--:|------| | 基础数据 | 7 | 570 | 80货品 + 40供应商 + 10仓库 + 300货位 + 80客户 + 30车辆 + 30司机 | | 批次追溯 | 1 | 120 | 40原料 + 40半成品 + 40成品，含 parent_batch_id 追溯链 | | 入库管理 | 3 | 550 | 100入库单 + 350明细 + 100质检 | | 库存管理 | 7 | 1,280 | 250库存 + 400流水 + 40盘点 + 250盘点明细 + 40调拨 + 150调拨明细 + 150安全库存 | | 出库管理 | 3 | 550 | 100出库单 + 350明细 + 100发运单 | | 物流配送 | 4 | 660 | 40运输计划 + 120任务 + 400在途跟踪 + 100签收 | | **合计** | **25** | **3,730** | | --- ## 参考资料 - [JeecgBoot 官方文档](https://help.jeecg.com) - [JeecgBoot GitHub](https://github.com/jeecgboot/JeecgBoot) - [JimuReport 报表工具](https://github.com/jeecgboot/JimuReport) --- ## License 本项目遵循 [Apache License 2.0](./LICENSE) 开源协议。