# MES-DDD

**Repository Path**: wanghehe/mes-ddd

## Basic Information

- **Project Name**: MES-DDD
- **Description**: 基于 DDD & EventSourcing 的现代响应式 CQRS 架构微服务开发的 MES 系统，主要面向单产线场景设计，提供工艺路线配置、产品与工单管理、生产进度跟踪、返修管理等核心功能。未来计划支持多产线、跨产线返修等更复杂场景。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-09-06
- **Last Updated**: 2025-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏭 MES-DDD

基于 **DDD** & **EventSourcing** 的现代响应式 **CQRS** 架构微服务开发的 MES 系统

---

## 项目介绍

本项目是一个面向单体产线的 MES（制造执行系统），采用领域驱动设计（DDD）、事件溯源（Event Sourcing）和命令查询职责分离（CQRS）架构，支持现代响应式微服务开发。

- **master 分支**  
  - 完整版功能，功能较复杂，适合深入研究和扩展  
- **mini 分支**  
  - 精简版，简化功能，适合快速上手和小型场景（暂未实现）

本系统主要面向单产线场景设计，提供工艺路线配置、产品与工单管理、生产进度跟踪、返修管理等核心功能。未来计划支持多产线、跨产线返修等更复杂场景。

---
## MES业务时序图
![img.png](docs/dev-ops/images/MES时序图.png)
---

## ✨ 支持的功能聚合（Aggregate）

系统根据业务领域划分以下聚合：

1. **设备聚合（Equipment）**  
   管理设备的生命周期、状态及调度。

2. **工位聚合（Workstation）**  
   管理产线上的各个工位信息。

3. **产线聚合（ProductionLine）**  
   管理整个生产线的结构与配置。

4. **工序聚合（Process）**  
   管理工序步骤，定义生产过程中的作业步骤。

5. **工艺路线聚合（Route）**  
   定义产品生产所需的工艺路线和流程。

6. **产品聚合（Product）**  
   管理产品信息及其对应的工艺路线。

7. **工单聚合（WorkOrder）**  
   管理生产工单，包括排产、进度和完成情况。

---

## 技术栈

- Java 17+
- Spring Boot
- Spring Cloud 微服务架构（可选）
- DDD + Event Sourcing + CQRS
- MyBatis-Plus / JPA（持久层）
- Kafka / RabbitMQ（事件消息总线）
- PostgreSQL（主数据库）
- Redis（缓存与状态存储）
- Docker（容器化部署）

---

---

## 🌱 项目结构说明

| 模块名称              | 说明                                                                 |
| --------------------- | -------------------------------------------------------------------- |
| `mes-ddd-api`         | 对外接口层：定义 API、DTO、协议规范                                    |
| `mes-ddd-app`         | 应用启动层：各种config配置，以及启动层                                  |
| `mes-ddd-domain`      | 领域模型层：核心业务逻辑，包含聚合根、实体、值对象、领域服务等             |
| `mes-ddd-infrastructure` | 基础设施层：持久化、消息总线、缓存、外部系统集成等                    |
| `mes-ddd-query`       |  读模型层：只负责读取数据（视图模型）                                   |
| `mes-ddd-trigger`     | 事件触发与监听模块：负责异步事件处理与发布                                |
| `mes-ddd-types`       | 通用类型定义：包含枚举、基础值对象、统一返回结构、工具类等                 |

---

## 快速开始

1. 克隆项目  
```bash
git clone https://gitee.com/dxycc/mes-ddd.git
cd mes-ddd
````

2. 选择分支

```bash
git checkout master  # 完整版
# 或
git checkout mini    # 精简版
```

3. 配置数据库和消息中间件（PostgreSQL、Kafka等）

4. 使用 Maven 构建

```bash
mvn clean install
```

5. 启动应用

```bash
java -jar target/mes-ddd.jar
```

---

## 贡献指南

欢迎提交 Issues 和 Pull Requests！
请遵循项目编码规范和提交规范。

---

## 联系方式

* 作者：dxy
* 交流QQ群：733798895
* 邮箱：[4955910871@qq.com](mailto:4955910871@qq.com)
* 仓库地址：[https://gitee.com/dxycc/mes-ddd](https://gitee.com/dxycc/mes-ddd)

---
# 前端菜单结构

## 1. 首页

## 2. 数据大屏

## 3. 基础数据
### 3.1 生产布局管理
- 3.1.1 工厂管理
- 3.1.2 车间管理
- 3.1.3 产线管理
- 3.1.4 工位管理

### 3.2 物料管理
- 3.2.1 物料群组
- 3.2.2 产品物料
- 3.2.3 BOM 管理
- 3.2.4 替代料管理

### 3.3 产品管理
- 3.3.1 产品信息维护
- 3.3.2 产品规格配置
- 3.3.3 产品类别管理

## 4. 工艺管理
### 4.1 工艺路线管理
### 4.2 工序管理

## 5. 生产管理
- 5.1 工单管理
- 5.2 订单排产
- 5.3 生产任务监控
- 5.4 生产进度追踪

## 6. 设备管理
- 6.1 设备类型
- 6.2 设备台账
- 6.3 工装夹具
- 6.4 点检保养
    - 6.4.1 项目维护
    - 6.4.2 项目表单
    - 6.4.3 计划配置
    - 6.4.4 点检保养记录

## 7. 库存管理
- 7.1 原材料库存
- 7.2 成品库存
- 7.3 库存调拨 / 入库 / 出库

## 8. 质量管理
- 8.1 质检标准管理
- 8.2 生产质检记录
- 8.3 不合格品处理

## 9. 报表中心
- 9.1 生产报表
- 9.2 设备报表
- 9.3 质量报表
- 9.4 库存报表

## 10. 系统配置
- 10.1 用户管理
- 10.2 角色管理
- 10.3 系统组织
- 10.4 参数管理
- 10.5 消息管理
- 10.6 操作日志

---
## 页面预览
![输入图片说明](ui/src/assets/images/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20250810233640.png)

![输入图片说明](ui/src/assets/images/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20250810233652.png)

![img.png](docs/dev-ops/images/img1.png)

![img.png](docs/dev-ops/images/img3.png)

![img.png](docs/dev-ops/images/img4.png)

![img.png](docs/dev-ops/images/img2.png)

![img.png](docs/dev-ops/images/img5.png)

![输入图片说明](ui/src/assets/images/MES%E7%94%9F%E4%BA%A7%E4%BA%A7%E7%BA%BF.jpg)