112 lines
3.2 KiB
Markdown
112 lines
3.2 KiB
Markdown
# CLAUDE.md
|
||
|
||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||
|
||
## 项目概述
|
||
|
||
这是一个基于Spring Boot + Vue.js开发的智能化仓库管理系统（WMS），专门为宝应梦阳公司设计。包含两个版本：
|
||
- **202504-Wms-MengYang-box**: 箱式仓库版本
|
||
- **202504-Wms-MengYang-tp**: 托盘式仓库版本
|
||
|
||
## 开发命令
|
||
|
||
### 后端开发 (Spring Boot)
|
||
```bash
|
||
# 进入后端目录
|
||
cd 202504-Wms-MengYang-tp/wms_serve_mengyang
|
||
# 或 cd 202504-Wms-MengYang-box/wms_serve_mengyang
|
||
|
||
# Maven构建
|
||
mvn clean install
|
||
|
||
# 运行后端服务 (端口12315)
|
||
mvn spring-boot:run
|
||
|
||
# 编译打包
|
||
mvn package
|
||
```
|
||
|
||
### 前端开发 (Vue.js)
|
||
```bash
|
||
# 进入前端目录
|
||
cd 202504-Wms-MengYang-tp/wms_web_mengyang
|
||
# 或 cd 202504-Wms-MengYang-box/wms_web_mengyang
|
||
|
||
# 安装依赖
|
||
npm install
|
||
|
||
# 开发服务器
|
||
npm run serve
|
||
|
||
# 生产构建
|
||
npm run build
|
||
```
|
||
|
||
### 数据库设置
|
||
```sql
|
||
-- 导入数据库脚本
|
||
-- TP版本: 202504-Wms-MengYang-tp/db/wms_mengyang_tp.sql
|
||
-- Box版本: 202504-Wms-MengYang-box/db/wms_mengyang_box.sql
|
||
```
|
||
|
||
## 架构设计
|
||
|
||
### 后端分层架构
|
||
- **controller**: REST API控制层，分为标准WMS控制器和自定义MyWMS控制器
|
||
- **service**: 业务服务层，包含api、business、controller、quartz_job四个子模块
|
||
- **dao/mapper**: 数据访问层，使用MyBatis Plus
|
||
- **model**: 数据模型层，包含po/dto/vo/bo四种对象类型
|
||
- **repository**: 仓储模式实现，支持HTTP和TCP通信
|
||
- **config**: 配置层，包含MybatisPlus、资源配置等
|
||
|
||
### 核心业务模块
|
||
- **库存管理**: TAppStock（库存表）、TAppLocation（库位表）
|
||
- **订单管理**: TAppOrderIn（入库）、TAppOrderOut（出库）、TAppTask（任务）
|
||
- **货物管理**: TAppGoods（货物）、TAppProduct（产品）、TAppVehicle（载具）
|
||
- **设备集成**: WCS接口、AGV锁定、堆垛机任务控制
|
||
|
||
### 前端架构
|
||
- 基于Vue 3 + Element Plus的SPA应用
|
||
- 使用Vuex进行状态管理，Vue Router处理路由
|
||
- 支持Excel导入导出、二维码扫描、打印功能
|
||
|
||
## 技术栈
|
||
|
||
### 后端
|
||
- Spring Boot 3.3.5 + Java 21
|
||
- MyBatis Plus 3.5.7 + MySQL 8.0
|
||
- Quartz调度 + Fastjson + Hutool工具库
|
||
|
||
### 前端
|
||
- Vue 3.2.13 + Element Plus 2.4.0
|
||
- Axios HTTP客户端 + QRCode二维码支持
|
||
- EasyExcel处理Excel文件
|
||
|
||
## 关键配置
|
||
|
||
### 应用配置
|
||
- 后端服务端口：12315
|
||
- 数据库连接：application.yml中配置
|
||
- 前端代理配置：vue.config.js中的devServer设置
|
||
|
||
### 重要枚举
|
||
- **AppConfigKeyEnums**: 系统配置项枚举
|
||
- **TaskTypeEnums**: 任务类型枚举
|
||
- **StockStatusEnums**: 库存状态枚举
|
||
|
||
## 开发注意事项
|
||
|
||
### 代码结构约定
|
||
- Controller层只处理HTTP请求响应，业务逻辑放在Service层
|
||
- 使用DTO在Controller层传输数据，内部业务使用BO对象
|
||
- 数据库操作统一通过MyBatis Plus的BaseMapper进行
|
||
|
||
### WCS集成规范
|
||
- WCS API调用通过IWcsApiService接口统一管理
|
||
- AGV设备操作需要使用锁定机制防止冲突
|
||
- 任务下发前要检查设备状态和库位可用性
|
||
|
||
### 数据处理规范
|
||
- Excel导入导出使用EasyExcel库，统一在excel包下处理
|
||
- 图片文件存储路径通过配置管理，支持本地和云存储
|
||
- 二维码生成和识别功能封装在utils工具类中 |