# my-mini-mes

**Repository Path**: gotfocus/my-mini-mes

## Basic Information

- **Project Name**: my-mini-mes
- **Description**: 玻璃深加工行业（汽车玻璃 + 家电玻璃）缺少一套覆盖全链路的最小可行 MES 系统 Demo。当前行业痛点：原片排版依赖人工经验导致利用率低、工序流转缺少实时追溯、钢化炉/烘弯炉温度曲线无法在线监控。需要构建一个可运行的闭环 Demo，覆盖从原片入库到包装追溯的全流程，用于演示验证和技术方案落地。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-21
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mini-MES 玻璃深加工执行系统

面向汽车与家电玻璃深加工行业的轻量级制造执行系统（MES）Demo。

## 功能特性

- **基础主数据**：物料管理、原片库存（FIFO + 发霉预警）、BOM、工艺路线、设备管理
- **排版优化引擎**：Guillotine 切割算法，支持成品旋转、淋子方向约束、刀缝损耗计算
- **生产执行**：订单 → 工单 → 报工（REST/MQTT）→ 看板实时刷新
- **质量追溯**：A/B/C/废品四级分级，完整链路追溯
- **设备监控**：钢化炉/烘弯炉温度模拟，超温告警，WebSocket 推送
- **能耗看板**：按设备/班次统计天然气与电量消耗

## 技术栈

| 层 | 技术 |
|---|------|
| 后端 | Java 17 + Spring Boot 3.2 + MyBatis-Plus |
| 前端 | Vue 3 + Element Plus + ECharts + Pinia |
| 数据库 | MySQL 8.0（业务）+ TDengine 3.x（时序） |
| 通信 | MQTT (EMQX) + WebSocket (STOMP) |
| 部署 | Docker Compose（6 服务编排） |

![输入图片说明](scripts/Snipaste_2026-07-22_22-23-28.png)
![输入图片说明](scripts/Snipaste_2026-07-22_22-21-49.png)
![输入图片说明](scripts/Snipaste_2026-07-22_22-20-50.png)
## 快速启动

### Docker Compose（推荐）

```bash
docker compose up -d
```

服务启动后访问：
- 前端：http://localhost
- 后端 API：http://localhost:8080
- EMQX Dashboard：http://localhost:18083

### 本地开发

**后端**

```bash
cd backend
mvn spring-boot:run \
  -Dspring-boot.run.arguments="--spring.datasource.url=jdbc:mysql://127.0.0.1:3306/mini_mes --simulator.enabled=false"
```

**前端**

```bash
cd frontend
npm install
npm run dev
```

## 项目结构

```
├── backend/                 # Spring Boot 后端
│   ├── src/main/java/
│   │   ├── algorithm/      # Guillotine 排版算法
│   │   ├── config/         # JWT、MQTT、WebSocket、TDengine 配置
│   │   ├── controller/     # REST API 控制器
│   │   ├── entity/         # 数据实体（16 个）
│   │   ├── mapper/         # MyBatis-Plus Mapper
│   │   ├── service/        # 业务服务
│   │   └── simulator/      # 设备温度模拟器
│   └── src/main/resources/
│       ├── application.yml
│       └── sql/            # schema.sql + seed.sql + tdengine-init.sql
├── frontend/               # Vue 3 前端
│   └── src/
│       ├── api/           # Axios 封装
│       ├── router/        # 路由配置
│       ├── store/         # Pinia 状态管理
│       ├── utils/         # WebSocket 客户端
│       └── views/         # 页面视图（11 个）
├── scripts/               # MQTT 测试脚本
├── docker-compose.yml     # 6 服务编排
└── README.md
```

## API 概览

| 模块 | 端点 | 说明 |
|------|------|------|
| 认证 | `POST /api/auth/login` | 登录获取 JWT |
| 看板 | `GET /api/dashboard/summary` | 产量/OEE/利用率/A级品率 |
| 排版 | `POST /api/nesting/optimize` | Guillotine 排版优化 |
| 订单 | `POST /api/prod-orders/{id}/release` | 释放订单→生成工单 |
| 报工 | `POST /api/reports` | REST 报工 |
| 质量 | `POST /api/quality` | 质检录入 |
| 设备 | `GET /api/equipment/{code}/temperature` | 温度曲线查询 |
| 能耗 | `GET /api/energy/dashboard` | 能耗统计 |

## 默认账户

- 用户名：`admin`
- 密码：`admin`

## 许可证

MIT