# MES 制造执行系统启动指南

## 系统架构
- **后端**: Spring Boot + MySQL + MyBatis (端口: 8088)
- **前端**: Vue 3 + Element Plus + ECharts (端口: 3000)
- **数据库**: MySQL 8.0 (端口: 3306)

## 前置条件

### 必需软件
1. **Java JDK 17+** 
   - 验证: `java -version`
   - 下载: https://adoptium.net/

2. **Node.js 16+**
   - 验证: `node --version`
   - 下载: https://nodejs.org/

3. **MySQL 8.0**
   - 验证: `mysql --version`
   - 数据库名: `mes_sorter`
   - 用户: `root`
   - 密码: `Minato@114514`

## 项目结构
```
WorkBench_Remake/
├── Back/
│   └── mes-sorter/           # Spring Boot后端
├── Front/
│   └── mes-frontend/         # Vue.js前端
└── start.bat                # 一键启动脚本
```

## 快速启动

### 一键启动
```bash
start.bat
```

## 手动启动（推荐用于调试）

### 后端启动
```bash
cd Back\mes-sorter
mvn spring-boot:run
```

### 前端启动
```bash
cd Front\mes-frontend
npm install  # 首次运行
npm run dev
```

## 访问地址
- **前端界面**: http://localhost:3000
- **后端API**: http://localhost:8088
- **API文档**: http://localhost:8088/swagger-ui.html

## 故障排除

### 1. 编译错误
检查Java和Maven环境，确保依赖完整

### 2. 数据库连接错误
检查配置: `Back\mes-sorter\src\main\resources\application.properties`
```properties
spring.datasource.url=jdbc:mysql://localhost:3306/mes_sorter
spring.datasource.username=root
spring.datasource.password=Minato@114514
```

### 3. 端口占用
- 后端端口8088被占用: 修改 `application.properties` 中的 `server.port`
- 前端端口3000被占用: 修改 `vite.config.js` 中的 `server.port`

### 4. 前端代理错误
检查 `Front\mes-frontend\vite.config.js`:
```js
proxy: {
  '/ep': {
    target: 'http://localhost:8088',
    changeOrigin: true
  }
}
```

### 5. MyBatis映射错误
确保存在以下文件：
- `Back\mes-sorter\src\main\resources\mapper\PieceMapper.xml`
- `Back\mes-sorter\src\main\resources\mapper\DispatchMapper.xml`

### 6. Maven依赖问题
```bash
cd Back\mes-sorter
mvn clean install
```

### 7. NPM依赖问题
```bash
cd Front\mes-frontend
npm install --force
```

## API端点测试

### 仪表盘数据
```bash
curl http://localhost:8088/ep/mes/dashboard/stats
```

### 工位列表
```bash
curl http://localhost:8088/ep/mes/workstations/list
```

### 生产计划
```bash
curl http://localhost:8088/ep/mes/plan/items?pplansheet=20250618
```

## 开发调试

### 后端日志
- 日志级别: DEBUG
- 查看控制台输出
- 检查 `logs/` 目录

### 前端调试
- 浏览器F12开发者工具
- 网络面板查看API请求
- Console查看错误信息

### 数据库调试
```sql
-- 查看数据库状态
USE mes_sorter;
SHOW TABLES;

-- 检查关键表
SELECT COUNT(*) FROM piece;
SELECT COUNT(*) FROM workstation;
SELECT COUNT(*) FROM dispatch;
```

## 常见问题

### Q: 前端页面空白
A: 检查浏览器控制台错误，通常是API调用失败

### Q: 后端启动失败
A: 检查数据库连接，确保MySQL服务运行

### Q: API返回500错误
A: 检查后端控制台日志，通常是数据库操作错误

### Q: 跨域问题
A: 前端已配置代理，确保代理目标端口正确

## 系统功能验证

启动成功后，验证以下功能：
1. ✅ 仪表盘统计数据加载
2. ✅ 工位列表显示
3. ✅ 生产计划查询
4. ✅ 工件管理操作
5. ✅ 设备状态监控
6. ✅ 工人管理功能

## 联系支持
如果遇到问题，请提供：
1. 错误截图
2. 控制台日志
3. 系统环境信息