# 简造mes

**Repository Path**: wujfcode/jianzao-mes

## Basic Information

- **Project Name**: 简造mes
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-20
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 简造 MES

面向离散制造中小工厂的轻量级开源制造执行系统。

市面上的开源 MES 功能铺得很全，但对中小工厂来说太重：模块多、概念多、部署复杂，真正能跑通的业务闭环反而不清晰。简造反其道而行，只做一条完整可用的生产执行主线，并把批次追溯做透。

## 特性

- **一条完整主线**：基础数据（物料 / BOM / 工艺路线）→ 工单 → 派工 → 报工 → 完工入库，每一步真实可用
- **批次追溯**：正向（这批料流向了哪些成品）与反向（这批成品用了哪些料）双向可查
- **工程质量**：核心逻辑有单元测试，主线有基于 Testcontainers 的端到端集成测试，Docker Compose 一键启动
- **边界克制**：不做 APS 高级排产、完整 QMS、完整 WMS，设备数采规划在 v2.0

## 技术栈

| 层 | 选型 |
|---|---|
| 后端 | Spring Boot 4.1 / JDK 21（基于 RuoYi-Vue-Plus 6.0） |
| ORM | MyBatis-Plus |
| 认证 | Sa-Token |
| 前端 | Vue3 + Element Plus + Vite |
| 存储 | MySQL 8 + Redis 7 |
| 测试 | JUnit 5 + Testcontainers |

MES 业务代码独立在 `mes-core` 模块（`com.jianzao.mes` 包），与底座代码物理隔离。

## 快速开始

需要本机安装 JDK 21、Node 18+、pnpm、Docker。

```bash
git clone https://gitee.com/wujfcode/jianzao-mes.git
cd jianzao-mes

# 1. 启动 MySQL / Redis（端口 3307 / 6380，避免与本机常用端口冲突）
docker compose -f docker-compose.dev.yml up -d

# 2. 导入初始化 SQL（务必带 utf8mb4，否则中文数据导入报错）
for f in ry_vue ry_job ry_workflow ry_ai; do
  docker exec -i jianzao-mes-mysql-1 mysql -uroot -proot \
    --default-character-set=utf8mb4 jianzao_mes < script/sql/$f.sql
done

# 3. 启动后端
./mvnw install -DskipTests
cd ruoyi-admin && ../mvnw spring-boot:run

# 4. 启动前端（另开终端）
cd ui && pnpm install && pnpm dev
```

访问 http://localhost ，默认账号 `admin / admin123`。

## 路线图

| 版本 | 内容 | 时间 |
|---|---|---|
| v0.1 | 底座搭建 + 基础数据模块 | 2026-09 ~ 2026-10 |
| v0.2 | 生产执行主线（工单 / 派工 / 报工） | 2026-11 ~ 2026-12 |
| v0.3 | 批次追溯 + 简化质检 | 2027-01 |
| v1.0 | Docker Compose 部署、演示站、文档完善 | 2027-02 |
| v2.0 | 设备数采模拟器 + OEE 看板 | 规划中 |

设计文档见 [docs/design.md](docs/design.md)。

## 致谢

基于 [RuoYi-Vue-Plus](https://gitee.com/dromara/RuoYi-Vue-Plus) 与 [plus-ui](https://gitee.com/JavaLionLi/plus-ui) 开发，感谢上游社区。

## License

[MIT](LICENSE)