# KP-MES

**Repository Path**: yxl/KP-MES

## Basic Information

- **Project Name**: KP-MES
- **Description**: 用于管理和控制生产过程的系统。它连接了企业的计划层和执行层，实时监控和调度生产活动，确保生产计划的顺利执行。
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2016-06-30
- **Last Updated**: 2026-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
    <img src="https://doc.buildadmin.com/images/logo.png" alt="KP-MES" />
    <h1 style="font-size: 36px;color: #2c3e50;font-weight: 600;margin: 0 0 6px 0;">KP-MES</h1>
    <p style="font-size: 17px;color: #6a8bad;margin-bottom: 10px;">基于 BuildAdmin 的智能工厂流程控制系统</p>
    <a href="https://uni.buildadmin.com" target="_blank">BuildAdmin官网</a> |
    <a href="https://doc.buildadmin.com/" target="_blank">文档</a> |
    <a href="https://gitee.com/yxl/KP-MES" target="_blank">Gitee仓库</a>
</div>

<p align="center">
    <a href="https://www.thinkphp.cn/" target="_blank">
        <img src="https://img.shields.io/badge/ThinkPHP-%3E 8.1-brightgreen?color=91aac3&labelColor=439EFD" alt="vue">
    </a>
    <a href="https://v3.vuejs.org/" target="_blank">
        <img src="https://img.shields.io/badge/Vue-%3E 3.5-brightgreen?color=91aac3&labelColor=439EFD" alt="vue">
    </a>
    <a href="https://cn.vitejs.dev/" target="_blank">
        <img src="https://img.shields.io/badge/Vite-%3E 8.0-blue?color=91aac3&labelColor=439EFD" alt="vite">
    </a>
    <a href="https://element-plus.org/zh-CN/guide/changelog.html" target="_blank">
        <img src="https://img.shields.io/badge/Element--Plus-%3E 2.13-brightgreen?color=91aac3&labelColor=439EFD" alt="element plus">
    </a>
    <a href="https://www.tslang.cn/" target="_blank">
        <img src="https://img.shields.io/badge/TypeScript-%3E 6.0-blue?color=91aac3&labelColor=439EFD" alt="typescript">
    </a>
    <a href="https://pinia.vuejs.org/" target="_blank">
        <img src="https://img.shields.io/badge/Pinia-%3E 3.0-blue?color=91aac3&labelColor=439EFD" alt="vite">
    </a>
</p>

---

## 项目概述

KP-MES 是基于 **BuildAdmin** 框架开发的智能工厂流程控制系统，结合人工智能技术实现智能化生产管理。系统提供生产工单管理、设备状态监控、物料流转追踪、质量检验管理以及 AI 驱动的预测分析等核心功能。

### 核心特性

- **📋 生产工单管理**: 完整的工单生命周期管理，支持工单创建、派工、执行、完成全流程跟踪
- **🔧 设备状态监控**: 实时监控设备运行状态，包括温度、压力、振动、功耗等关键指标
- **📦 物料流转管理**: 全程追溯物料流转过程，支持原材料、半成品、成品的全生命周期管理
- **✅ 质量检验管理**: 支持 IPQC、FQC、OQC 多类型检验，实现质量追溯和缺陷分析
- **🤖 AI 智能预测**: 集成多种 AI 模型，实现设备故障预测、质量预测、生产效率优化
- **📊 智能决策支持**: 基于 AI 分析提供生产优化建议和智能决策支持

---

## 技术架构

### 技术栈

| 分类    | 技术           | 版本      |
|-------|--------------|---------|
| 后端框架  | ThinkPHP     | >= 8.1  |
| 前端框架  | Vue          | >= 3.5  |
| 构建工具  | Vite         | >= 8.0  |
| UI 组件 | Element Plus | >= 2.13 |
| 类型安全  | TypeScript   | >= 6.0  |
| 状态管理  | Pinia        | >= 3.0  |
| 数据库   | MySQL        | >= 8.0  |

### 系统架构

```
┌─────────────────────────────────────────────────────────────────┐
│                        前端层 (Vue 3)                           │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐   │
│  │生产管理  │ │设备管理  │ │物料管理 │ │质量管理  │ │AI分析   │    │
│  └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘   │
│       │           │           │           │           │        │
└───────┼───────────┼───────────┼───────────┼───────────┼────────┘
        │           │           │           │           │
        ▼           ▼           ▼           ▼           ▼
┌─────────────────────────────────────────────────────────────────┐
│                        后端层 (ThinkPHP 8)                      │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │              API 网关 / 控制器层                           │  │
│  ├───────────────────────────────────────────────────────────┤  │
│  │  服务层  │  业务逻辑  │  数据访问层  │  AI模型服务           │  │
│  ├───────────────────────────────────────────────────────────┤  │
│  │              中间件 / 认证 / 日志                          │  │
│  └───────────────────────────────────────────────────────────┘  │
└────────────────────────────┬────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────────┐
│                        数据层 (MySQL)                            │
│  ┌───────────────┐ ┌───────────────┐ ┌───────────────┐          │
│  │生产流程数据    │ │设备监控数据    │ │质量检验数据    │          │
│  ├───────────────┤ ├───────────────┤ ├───────────────┤          │
│  │AI预测数据      │ │物料流转数据    │ │系统配置数据    │          │
│  └───────────────┘ └───────────────┘ └───────────────┘          │
└─────────────────────────────────────────────────────────────────┘
```

### 目录结构

```
kp-mes/
├── app/                    # 应用目录
│   ├── admin/              # 后台管理模块
│   │   ├── controller/     # 控制器
│   │   ├── model/          # 数据模型
│   │   ├── validate/       # 数据验证
│   │   └── lang/           # 语言包
│   ├── api/                # API接口模块
│   └── common/             # 公共模块
├── config/                 # 配置文件
├── extend/                 # 扩展库
├── public/                 # 静态资源
├── web/                    # 前端项目
│   ├── src/
│   │   ├── views/          # 页面视图
│   │   ├── api/            # API调用
│   │   ├── components/     # 公共组件
│   │   └── stores/         # 状态管理
│   └── package.json
├── database/               # 数据库脚本
│   ├── ai.sql              # AI功能配套数据库
│   └── base.sql            # 工厂流程控制数据库
├── composer.json           # PHP依赖
└── README.md               # 项目说明
```

---

## 安装部署

### 环境要求

| 环境       | 要求      |
|----------|---------|
| PHP      | >= 8.1  |
| MySQL    | >= 8.0  |
| Node.js  | >= 18.0 |
| Composer | >= 2.0  |

### 安装步骤

1. **克隆项目**

```bash
git clone https://gitee.com/wonderful-code/buildadmin.git kp-mes
cd kp-mes
```

2. **安装后端依赖**

```bash
composer install
```

3. **安装前端依赖**

```bash
cd web
npm install
```

4. **配置数据库**

```bash
cp .env-example .env
```

编辑 `.env` 文件，配置数据库连接信息：

```env
DATABASE_HOSTNAME=localhost
DATABASE_DATABASE=kp_mes
DATABASE_USERNAME=root
DATABASE_PASSWORD=your_password
```

5. **导入数据库**

```bash
mysql -u root -p kp_mes < database/base.sql
mysql -u root -p kp_mes < database/ai.sql
```

6. **启动开发服务器**

```bash
# 后端服务
php think run

# 前端开发服务（新终端）
cd web
npm run dev
```

### 访问地址

- 后台管理: `http://localhost:8000/admin`
- 默认账号: `admin` / `123456`

---

## 功能模块

### 1. 生产管理模块

#### 1.1 生产线管理 (`kp_production_line`)

- 生产线信息维护（名称、类型、位置、产能等）
- 生产线状态管理（启用/停用）
- 产能统计与分析

#### 1.2 生产工单管理 (`kp_production_order`)

- 工单创建与编辑
- 工单状态跟踪（待处理/进行中/暂停/完成/取消）
- 工单优先级管理
- 生产进度实时监控

#### 1.3 流程节点管理 (`kp_production_node`)

- 生产流程定义
- 节点类型（开始、结束、处理、检验）
- 执行顺序配置
- 质量标准定义

#### 1.4 工艺参数配置 (`kp_process_parameter`)

- 温度、压力、速度等参数配置
- 参数阈值设定
- 自动/手动控制模式
- 关键参数标识

### 2. 设备管理模块

#### 2.1 设备状态监控 (`kp_equipment_status`)

- 实时监控设备运行状态
- 温度、压力、振动、功耗实时采集
- 设备稼动率统计
- 保养周期提醒

#### 2.2 设备异常识别 (`kp_ai_anomaly_record`)

- AI 驱动的异常检测
- 异常类型识别（温度异常、振动异常、压力故障）
- 异常等级划分（警告/严重）
- 告警处理与跟踪

### 3. 物料管理模块

#### 3.1 物料流转管理 (`kp_material_flow`)

- 物料出入库管理
- 批次追溯
- 物料类型管理（原材料/半成品/成品）
- 流转记录查询

### 4. 质量管理模块

#### 4.1 质量检验管理 (`kp_quality_inspection`)

- IPQC（过程检验）
- FQC（最终检验）
- OQC（出货检验）
- 缺陷等级划分
- 检验结果统计分析

### 5. AI 智能模块

#### 5.1 模型版本管理 (`kp_ai_model_version`)

- AI 模型生命周期管理
- 模型参数配置
- 性能指标追踪
- 部署状态管理

#### 5.2 预测分析 (`kp_ai_prediction_result`)

- 设备故障预测
- 产品质量预测
- 生产效率预测
- 预测结果确认与反馈

#### 5.3 智能决策 (`kp_ai_decision_history`)

- 设备调整决策
- 工艺优化决策
- 生产排程决策
- 决策效果评估

#### 5.4 优化建议 (`kp_ai_optimization_suggestion`)

- 生产效率优化
- 质量改进建议
- 成本降低建议
- 节能优化建议

---

## 数据库设计

### 核心数据表关系

```
生产工单 (kp_production_order)
        │
        ├── 关联 ──→ 生产线 (kp_production_line)
        ├── 关联 ──→ 流程节点 (kp_production_node)
        ├── 关联 ──→ 质量检验 (kp_quality_inspection)
        └── 关联 ──→ 物料流转 (kp_material_flow)

设备状态 (kp_equipment_status)
        │
        └── 关联 ──→ 设备异常记录 (kp_ai_anomaly_record)

AI模型版本 (kp_ai_model_version)
        │
        ├── 关联 ──→ 训练数据 (kp_ai_training_data)
        └── 关联 ──→ 预测结果 (kp_ai_prediction_result)

预测结果 (kp_ai_prediction_result)
        │
        └── 关联 ──→ 决策历史 (kp_ai_decision_history)
```

### 数据表说明

| 表名                              | 说明     | 核心字段                                                   |
|---------------------------------|--------|--------------------------------------------------------|
| `kp_production_line`            | 生产线信息  | line_code, line_name, capacity, status                 |
| `kp_production_order`           | 生产工单   | order_no, product_code, plan_quantity, order_status    |
| `kp_production_node`            | 流程节点   | node_code, node_type, execution_order                  |
| `kp_equipment_status`           | 设备状态   | equipment_code, running_status, temperature, vibration |
| `kp_material_flow`              | 物料流转   | material_code, flow_type, quantity, batch_no           |
| `kp_quality_inspection`         | 质量检验   | inspection_code, inspection_type, inspection_result    |
| `kp_process_parameter`          | 工艺参数   | parameter_code, target_value, min_value, max_value     |
| `kp_ai_model_version`           | AI模型版本 | model_name, version, deployment_status                 |
| `kp_ai_prediction_result`       | 预测结果   | prediction_type, prediction_result, confidence         |
| `kp_ai_decision_history`        | 决策历史   | decision_type, decision_result, ai_confidence          |
| `kp_ai_anomaly_record`          | 异常记录   | equipment_code, anomaly_type, anomaly_level            |
| `kp_ai_optimization_suggestion` | 优化建议   | suggestion_type, improvement_ratio, roi                |

### 数据流向

```
传感器数据采集 → kp_equipment_status → AI分析 → kp_ai_prediction_result
                                                      ↓
                                              kp_ai_decision_history → 生产决策
                                                      ↓
                                              kp_production_order → 工单执行
                                                      ↓
                                              kp_material_flow → 物料流转
                                                      ↓
                                              kp_quality_inspection → 质量检验
```

---

## 使用指南

### 快速开始

1. **登录系统**: 访问 `http://localhost:8000/admin`，使用账号 `admin`/`123456` 登录

2. **查看仪表盘**: 登录后进入仪表盘，查看生产概览、设备状态、质量统计

3. **创建工单**: 进入「生产管理」→「生产工单」→「新增工单」

4. **监控设备**: 进入「设备管理」→「设备状态」查看实时监控数据

5. **查看AI预测**: 进入「AI分析」→「预测结果」查看AI生成的预测分析

### 操作流程

#### 工单管理流程

```
创建工单 → 分配生产线 → 开始生产 → 工序执行 → 质量检验 → 完成工单
```

#### 设备维护流程

```
状态监控 → 异常检测 → 告警通知 → 维护处理 → 状态恢复
```

#### 质量检验流程

```
IPQC巡检 → FQC终检 → OQC出货检 → 缺陷记录 → 统计分析
```

---

## 常见问题解答

### 安装问题

**Q: Composer 安装失败？**
A: 请确保 PHP 版本 >= 8.1，并配置正确的 PHP 环境变量。

**Q: 数据库连接失败？**
A: 请检查 `.env` 文件中的数据库配置，确保数据库服务已启动。

### 运行问题

**Q: 前端页面无法加载？**
A: 请确保已在 `web` 目录下执行 `npm install`，并启动前端开发服务器。

**Q: 登录失败？**
A: 请确认账号密码正确（默认 `admin`/`123456`），或检查数据库是否正确导入。

### 数据问题

**Q: 设备状态不更新？**
A: 请检查设备监控服务是否正常运行，网络连接是否正常。

**Q: AI预测结果不准确？**
A: AI模型需要持续训练优化，可通过增加训练数据提升准确性。

---

## 附录

### API 接口说明

系统提供 RESTful API 接口，支持：

- 生产工单 CRUD 操作
- 设备状态查询
- 物料流转记录查询
- AI 预测分析接口
- 质量检验数据接口

接口文档: `http://localhost:8000/api/doc`

### 配置文件说明

| 配置文件                  | 说明     |
|-----------------------|--------|
| `.env`                | 环境变量配置 |
| `config/database.php` | 数据库配置  |
| `config/app.php`      | 应用配置   |
| `web/.env`            | 前端环境配置 |

### 许可证信息

KP-MES 遵循 `Apache 2.0` 开源协议，基于 BuildAdmin 框架开发。

---

**支持项目**: 如果觉得项目不错，欢迎到 [Gitee](https://gitee.com/yxl/KP-MES) 点个 ⭐ Star！