# wms-lzl

**Repository Path**: chef_git/wms-lzl

## Basic Information

- **Project Name**: wms-lzl
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-21
- **Last Updated**: 2026-10-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WMS 智能仓储管理系统

## 项目简介

本项目是一套基于若依框架开发的 WMS（Warehouse Management System）智能仓储管理系统，集成了 AI 智能助理功能，支持库存、入库、出库、移库、盘点等仓储核心业务，并通过 AI 技术实现智能问答和单据自动化处理。

## 项目架构

```
wms-lzl
├── wms-ai-agent/          # AI 智能助理后端服务
│   ├── app/
│   │   ├── graphs/        # AI 流程编排（入库、出库、移库、盘点、知识库）
│   │   ├── knowledge/     # RAG 知识库管理
│   │   └── tools/         # WMS 工具集成
│   └── tests/             # 单元测试
├── wms-ruoyi/             # Spring Boot 后端服务
│   ├── ruoyi-admin-wms/   # WMS 业务模块
│   ├── ruoyi-common/      # 公共模块
│   └── ruoyi-modules/     # 系统模块
└── ruo-yi-wms-vue/        # Vue3 前端应用
    └── src/
        ├── api/           # API 接口
        ├── views/         # 页面视图
        └── components/    # 组件
```

## 核心功能

### 基础管理
- **仓库管理** - 仓库的增删改查
- **物料管理** - 物料及 SKU 管理
- **品牌管理** - 物料品牌维护
- **商户管理** - 往来单位管理
- **物料分类** - 分类树形结构

### 仓储业务
- **入库管理** - 采购入库、生产入库等
- **出库管理** - 销售出库、调拨出库等
- **移库管理** - 库位间物料移动
- **盘点管理** - 库存盘点与差异处理
- **库存查询** - 实时库存查询与统计

### AI 智能助理
- **智能问答** - 基于 RAG 知识库的智能问答
- **单据创建** - 自然语言创建入库/出库/移库单据
- **单据查询** - 语音/文字查询业务单据
- **HITL 机制** - 人工介入确认机制
- **状态持久化** - Redis 持久化会话状态

## 技术栈

### 后端
- Java 17 + Spring Boot 3.x
- MyBatis-Plus + MySQL
- Redis + Redisson
- Sa-Token 权限认证
- LangChain4j AI 框架

### 前端
- Vue 3 + Vite
- Element Plus UI
- Pinia 状态管理
- Vue Router

### AI
- LangChain4j
- 阿里云百炼大模型
- Redis 向量存储
- SSE 实时流输出

## 快速开始

### 环境要求
- JDK 17+
- MySQL 8.0+
- Redis 6.0+
- Node.js 18+
- Python 3.10+（AI 服务）

### 后端启动

1. 导入数据库脚本

2. 修改配置文件 `wms-ruoyi/ruoyi-admin-wms/src/main/resources/application.yml`

3. 启动后端服务
```bash
cd wms-ruoyi
mvn clean install
cd ruoyi-admin-wms
java -jar ruoyi-admin-wms.jar
```

### 前端启动

```bash
cd ruo-yi-wms-vue
npm install
npm run dev
```

### AI 服务启动

```bash
cd wms-ai-agent
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env 配置
uvicorn app.main:app --host 0.0.0.0 --port 8089
```

## API 接口

### AI 智能助理
- `POST /agent` - AI Agent 对话接口（SSE 流式响应）
- `GET /health` - 健康检查
- `GET /lookup/sku` - SKU 搜索
- `GET /lookup/merchant` - 商户搜索

### WMS 业务接口
- `/wms/receiptOrder` - 入库单管理
- `/wms/shipmentOrder` - 出库单管理
- `/wms/movementOrder` - 移库单管理
- `/wms/checkOrder` - 盘点单管理
- `/wms/inventory` - 库存查询

## 目录结构说明

```
wms-lzl
│
├─ wms-ai-agent              # AI 智能助理服务
│  ├─ app/
│  │  ├─ auth.py            # Token 透传认证
│  │  ├─ cards.py           # 卡片组件定义
│  │  ├─ checkpointer.py    # Redis 状态持久化
│  │  ├─ config.py          # 配置管理
│  │  ├─ graphs/            # AI 流程编排
│  │  │  ├─ receiving.py    # 入库流程
│  │  │  ├─ outbound.py     # 出库流程
│  │  │  ├─ movement.py     # 移库流程
│  │  │  ├─ inventory_check.py # 盘点流程
│  │  │  ├─ knowledge.py    # 知识问答
│  │  │  └─ router.py       # 意图路由
│  │  ├─ knowledge/         # RAG 知识库
│  │  └─ tools/             # WMS 工具封装
│  └─ pyproject.toml        # Python 依赖
│
├─ wms-ruoyi                 # Spring Boot 后端
│  ├─ ruoyi-admin-wms/      # WMS 业务模块
│  │  └─ src/main/java/com/ruoyi/wms/
│  │     ├─ controller/     # 控制器
│  │     ├─ domain/         # 实体与DTO
│  │     ├─ mapper/         # 数据访问层
│  │     └─ service/        # 业务逻辑层
│  ├─ ruoyi-common/         # 公共模块
│  │  ├─ ruoyi-common-core       # 核心工具
│  │  ├─ ruoyi-common-redis      # Redis 集成
│  │  ├─ ruoyi-common-security   # 安全模块
│  │  └─ ruoyi-common-mybatis    # 数据库模块
│  └─ ruoyi-modules/        # 系统模块
│
└─ ruo-yi-wms-vue           # Vue3 前端
   └─ src/
      ├─ api/               # API 接口封装
      ├─ views/
      │  ├─ wms/            # WMS 业务页面
      │  └─ ai/             # AI 助理页面
      └─ components/
         └─ ai/             # AI 组件
```

## 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/xxx`)
3. 提交更改 (`git commit -m 'Add xxx'`)
4. 推送到分支 (`git push origin feature/xxx`)
5. 创建 Pull Request

## 许可证

MIT License

## 联系方式

- 问题反馈：https://gitee.com/chef_git/wms-lzl/issues
- 项目文档：https://gitee.com/chef_git/wms-lzl/wikis