# RouYi-AI-WMS

**Repository Path**: doucore/rou-yi-ai-wms

## Basic Information

- **Project Name**: RouYi-AI-WMS
- **Description**: 基于 RuoYi 的智能进销存 WMS 系统，支持多租户 SaaS、AI 智能助手，前后端分离（Spring Boot 3 + Vue）。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-11-05
- **Last Updated**: 2026-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
	<img alt="logo" src="https://oscimg.oschina.net/oscnet/up-d3d0a9303e11d522a06cd263f3079027715.png">
</p>
<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">RuoYi-AI-WMS</h1>
<h4 align="center">基于 SpringBoot + Vue 的多租户进销存管理系统（内置 AI 助手）</h4>
<p align="center">
	<a href="https://gitee.com/y_project/RuoYi-Vue"><img src="https://img.shields.io/badge/RuoYi--AI--WMS-v3.9.1-brightgreen.svg"></a>
	<a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
	<a href="https://zhicun.site"><img src="https://img.shields.io/badge/%E5%9C%A8%E7%BA%BF%E6%BC%94%E7%A4%BA-zhicun.site-orange.svg"></a>
</p>

## 平台简介

RuoYi-AI-WMS 是一套基于 [RuoYi-Vue](https://gitee.com/y_project/RuoYi-Vue) 框架二次开发的多租户进销存（WMS）管理系统，在若依成熟的权限体系之上，扩展了完整的采购 / 销售 / 库存业务链路，并内置 PC 端 AI 助手，支持通过自然语言对话、语音输入、截图识别等方式快速完成单据录入与查询。

* 前端：Vue 2.6 + Element UI
* 后端：Spring Boot 3.5 / Spring Security + JWT / MyBatis-Plus / Redis
* 数据库：MySQL 8.x
* 多租户 SaaS 架构，租户间数据隔离
* AI 能力基于阿里云 DashScope（通义千问系列模型）

## 在线演示

演示地址：**[https://zhicun.site](https://zhicun.site)**

无需注册，打开即可体验。

## 核心特性

### 进销存业务

- **商品管理**：商品档案、分类、规格、条码管理
- **采购管理**：采购订单、采购入库、供应商管理与比价
- **销售管理**：销售订单、销售出库、客户管理
- **库存管理**：实时库存、库存流水、盘点、库存预警
- **单据打印**：出/入库单据 PDF 打印，打印模板可配置
- **多租户**：租户注册、租户级数据隔离与独立配置

### AI 助手（PC 端）

- **对话式建单**：一句话创建采购/销售单据，AI 自动补全缺失信息、逐项确认
- **语音录入**：语音转文字，动口即可录入商品明细
- **截图识别**：粘贴/上传单据截图，AI 视觉模型自动提取商品明细填充表单
- **智能查询**：自然语言查询库存、订单状态等业务数据

<p align="center">
	<img src="./docs/images/demo-ai-assistant.gif" alt="AI 助手演示：对话建单、语音录入、截图识别" width="800">
</p>

## 内置功能（若依基础模块）

1. 用户管理、部门管理、岗位管理
2. 菜单管理、角色管理（按钮级权限、数据权限）
3. 字典管理、参数管理、通知公告
4. 操作日志、登录日志、在线用户
5. 定时任务调度、代码生成、系统接口（Swagger）
6. 服务监控、缓存监控、连接池监视

## 快速开始

### 环境要求

- JDK 17
- MySQL 8.x
- Redis
- Node.js 14+（前端构建）

### 后端

```bash
# 1. 创建数据库 ry-vue（utf8mb4），执行 sql/ry-vue-20261029.sql 初始化脚本（内容见下方说明）
# 2. 修改 ruoyi-admin/src/main/resources/application-druid.yml 中的数据库连接
#    修改 application.yml 中的 Redis 配置
# 3. 启动
mvn clean package -DskipTests
java -jar ruoyi-admin/target/ruoyi-admin.jar
# 或在 IDEA 中直接运行 RuoYiApplication
```

后端默认运行在 `http://localhost:8080`。

### 前端

```bash
cd ruoyi-ui
npm install
npm run dev
```

访问 `http://localhost:8081`（开发模式，已配置代理转发至后端 8080）。

### 默认账号

- 管理员：`admin / admin123`
- 体验账号：登录页点击「体验一下」一键进入（`zhaoyun`，所属演示租户）

### 数据库脚本说明

`sql/ry-vue-20261029.sql` 为开箱即用的初始化脚本，直接导入即可：

| 内容 | 说明 |
| --- | --- |
| 表结构 | 全部 82 张表的建表语句（系统表 + 进销存业务表 + AI 相关表） |
| 基础配置数据 | 菜单、角色、角色-菜单授权、部门、岗位、字典、参数配置、定时任务等 |
| 演示数据 | 租户与演示账号（`admin`、`zhaoyun`），无任何业务单据 |
| 业务数据 | 已清空（销售/采购/库存/日志等），导入后是干净的空库 |

> 该脚本已做脱敏处理：不含任何 API 密钥、真实手机号、公司信息与业务数据，演示账号的租户级 AI 配置为占位符，运行前请在 `application.yml` 或「企业设置」中填入自己的 DashScope Key。

## AI 能力配置

在 `ruoyi-admin/src/main/resources/application.yml` 的 `ai.service` 段配置阿里云 DashScope：

```yaml
ai:
  service:
    qwen:
      api-key: 你的 DashScope API Key   # https://dashscope.console.aliyun.com
      model: qwen3.8-flash              # 对话模型
      thinking-enabled: false           # 关闭 qwen3.x 思考模式，降低录单/解析类任务延迟
    vision:
      model: qwen3.8-omni-flash         # 截图识别视觉模型
```

各租户也可在「企业设置」页面配置自己的 API Key 与模型，租户未配置时回退使用全局配置。

## 目录结构

```
RuoYi-AI-WMS
├── ruoyi-admin      # 主应用（启动入口、Web 控制器）
├── ruoyi-wms        # WMS 业务（进销存、AI 助手、打印）
├── ruoyi-system     # 系统模块（用户/角色/菜单等）
├── ruoyi-framework  # 框架核心（安全、多租户、拦截器）
├── ruoyi-common     # 通用工具
├── ruoyi-generator  # 代码生成
├── ruoyi-quartz     # 定时任务
├── ruoyi-ui         # 前端（Vue2 + Element UI）
├── sql              # 数据库脚本
└── docs             # 文档与图片素材
```

## 联系作者

对项目有问题、建议或商务合作，欢迎微信扫码添加作者交流：

<p align="center">
	<img src="./docs/images/wechat-contact.jpg" alt="微信联系作者" width="360">
</p>

## 致谢

- [RuoYi-Vue](https://gitee.com/y_project/RuoYi-Vue)：本项目的基础框架
- [DashScope](https://dashscope.console.aliyun.com)：AI 能力支持

## License

[MIT](./LICENSE)