# KP仓库管理程序

**Repository Path**: yxl/KpMES

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KP MES 制造执行系统

<div align="center">

![GitHub release](https://img.shields.io/github/v/release/your-repo/kp-mes)
![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Laravel](https://img.shields.io/badge/Laravel-11-red.svg)
![PHP](https://img.shields.io/badge/PHP-8.2+-blue.svg)

[English](README_EN.md) | 简体中文

</div>

---

## 📖 项目简介

**KP MES（制造执行系统）** 是一款面向离散型制造企业的现代化生产管理系统。本系统基于 Laravel 11 框架开发，采用 B/S 架构，具有高度的集成性、灵活性和可扩展性。

系统通过实时监控生产过程、优化生产调度、改进质量管理、优化库存管理等核心功能，帮助制造企业实现：

- ✅ **生产全流程管控** - 从订单到交付的完整生命周期管理
- ✅ **信息追溯** - 完整的生产数据记录和追踪
- ✅ **柔性化生产** - 灵活应对多品种、小批量生产需求
- ✅ **精细化管理** - 数据驱动的生产决策和优化

---

## 🎯 核心功能模块

### 1️⃣ 订单管理
> 完整的订单生命周期管理

- 📋 订单接收与录入
- 🔧 订单处理与审核
- 📊 订单排产与分配
- 📍 订单跟踪与监控
- 📝 订单变更管理

### 2️⃣ 生产计划排程
> 智能化生产调度中心

- 📅 生产计划制定
- 🏭 生产线分配与调度
- 📈 生产进度实时跟踪
- ⚖️ 产能平衡与优化
- 🔄 计划调整与插单处理

### 3️⃣ 物料管理
> 精准的物料控制体系

- 🛒 物料采购管理
- 📦 物料入库管理
- 📤 物料领用与发放
- 🔥 物料消耗监控
- ⚠️ 库存预警与安全库存

### 4️⃣ 生产执行
> 生产过程精细化控制

- 🎛️ 生产过程控制
- ⚙️ 设备运行控制
- ✔️ 在线质量检测
- 📐 工艺参数管理
- 📸 生产数据采集

### 5️⃣ 质量管理
> 全面的质量控制体系

- 🔍 质量检验管理
- 📊 质量统计分析
- 🎯 质量控制点管理
- 🚨 质量异常处理
- 📑 质量追溯管理

### 6️⃣ 设备管理
> 设备全生命周期管理

- 🔧 设备维护保养
- ⏰ 保养计划管理
- 🛠️ 设备故障报修
- 📊 设备状态监控
- 📈 设备效率分析

### 7️⃣ 数据采集和分析
> 数据驱动决策

- 📥 生产数据采集
- 💾 数据存储与管理
- 📊 数据分析挖掘
- 📈 数据报表生成
- 📉 可视化数据看板

### 8️⃣ 人员管理
> 人力资源优化配置

- 👥 员工考勤管理
- 📚 员工培训管理
- 📊 员工绩效考核
- 🎯 技能矩阵管理
- 💼 工时管理

### 9️⃣ 报告和分析
> 智能决策支持

- 📊 生产报表管理
- 📈 生产数据分析
- 💡 生产决策支持
- 🎯 KPI 指标分析
- 📱 移动端报表查看

---

## 🛠️ 技术栈

### 后端技术
- **框架**: Laravel 11.x
- **语言**: PHP 8.2+
- **数据库**: MySQL 8.0+
- **缓存**: Redis
- **队列**: Laravel Queue

### 前端技术
- **框架**: Vue.js 3
- **构建工具**: Vite
- **UI 组件**: Inertia.js
- **样式**: Tailwind CSS
- **图表**: ECharts / Chart.js

### 开发工具
- **包管理**: Composer, NPM
- **版本控制**: Git
- **测试**: PHPUnit, Jest

---

## 🚀 快速开始

### 环境要求

- PHP >= 8.2
- MySQL >= 8.0
- Redis (可选，用于缓存和队列)
- Composer
- Node.js >= 18.x
- NPM >= 9.x

### 安装步骤

#### 1. 克隆项目
```bash
git clone https://gitee.com/your-repo/kp-mes.git
cd kp-mes
```

#### 2. 安装依赖
```bash
# 安装 PHP 依赖
composer install

# 安装前端依赖
npm install
```

#### 3. 配置环境变量
```bash
# 复制环境配置文件
cp .env.example .env

# 生成应用密钥
php artisan key:generate
```

编辑 `.env` 文件，配置数据库连接：
```env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=kp_mes
DB_USERNAME=root
DB_PASSWORD=
```

#### 4. 创建数据库并迁移
```bash
# 创建数据库
mysql -u root -p -e "CREATE DATABASE kp_mes CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 运行数据库迁移
php artisan migrate

# 填充初始数据（可选）
php artisan db:seed
```

#### 5. 编译前端资源
```bash
# 开发环境（监听模式）
npm run dev

# 生产环境
npm run build
```

#### 6. 启动服务
```bash
# 使用 Laravel 内置服务器
php artisan serve

# 访问应用
http://localhost:8000
```

---

## 📁 项目结构

```
kp-mes/
├── app/                      # 应用核心代码
│   ├── Http/                # HTTP 相关（控制器、请求、中间件）
│   ├── Models/              # 数据模型
│   └── Providers/           # 服务提供者
├── bootstrap/               # 应用启动文件
├── config/                  # 配置文件
├── database/                # 数据库相关
│   ├── factories/          # 模型工厂
│   ├── migrations/         # 数据库迁移
│   └── seeders/            # 数据填充
├── public/                  # 公共资源
├── resources/               # 资源文件
│   ├── css/                # 样式文件
│   ├── js/                 # JavaScript 文件
│   └── views/              # 视图文件
├── routes/                  # 路由文件
├── storage/                 # 存储文件
└── tests/                   # 测试文件
```

---

## 🗄️ 数据库设计

### 核心数据表

| 表名 | 说明 | 备注 |
|------|------|------|
| `users` | 用户表 | 系统用户、权限管理 |
| `product` | 产品表 | 产品信息、BOM 管理 |
| `product_cls` | 产品分类表 | 产品分类层级 |
| `product_material` | 产品物料表 | 产品物料清单 |
| `announce` | 公告表 | 系统公告、通知 |
| `data_collection` | 数据采集表 | 生产过程数据采集 |
| `data_report` | 数据报告表 | 数据报表、分析结果 |
| `orders` | 订单表 | 客户订单管理 |
| `order_items` | 订单明细表 | 订单产品明细 |
| `production_plans` | 生产计划表 | 生产任务计划 |
| `quality_inspections` | 质量检验表 | 质量检验记录 |
| `equipment` | 设备表 | 设备信息管理 |
| `equipment_maintenance` | 设备维护表 | 设备保养维修记录 |
| `employees` | 员工表 | 员工信息管理 |
| `attendance` | 考勤表 | 员工考勤记录 |

---

## 🔐 默认账号

系统初始化后，可使用以下默认账号登录：

| 角色 | 用户名 | 密码 | 权限 |
|------|--------|------|------|
| 超级管理员 | admin@kp-mes.com | admin123 | 所有权限 |
| 生产经理 | manager@kp-mes.com | manager123 | 生产管理权限 |
| 操作员 | operator@kp-mes.com | operator123 | 基础操作权限 |

> ⚠️ **安全提示**: 首次登录后请立即修改默认密码！

---

## 📸 系统截图

<div align="center">

### 首页看板

![Dashboard](./docs/images/dashboard.png)

### 订单管理

![Order Management](./docs/images/order.png)

### 生产计划

![Production Plan](./docs/images/plan.png)

### 质量管理

![Quality Management](./docs/images/quality.png)

</div>

---

## 🤝 贡献指南

我们欢迎各种形式的贡献：

- 🐛 报告 Bug
- 💡 提出新功能建议
- 📝 改进文档
- 🔧 提交代码修复或优化

### 贡献流程

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

---

## 📄 开源协议

本项目采用 [MIT](LICENSE) 协议开源

---

## 📞 联系方式

- **项目主页**: [Gitee 项目地址](https://gitee.com/your-repo/kp-mes)
- **问题反馈**: [Issues](https://gitee.com/your-repo/kp-mes/issues)
- **邮箱**: support@kp-mes.com

---

## 🙏 致谢

感谢以下开源项目：

- [Laravel](https://laravel.com/) - PHP Framework
- [Vue.js](https://vuejs.org/) - JavaScript Framework
- [Inertia.js](https://inertiajs.com/) - Progressive Framework
- [Tailwind CSS](https://tailwindcss.com/) - Utility-First CSS

---

<div align="center">

**如果这个项目对您有帮助，请给一个 ⭐ Star！**

Copyright © 2026 KP MES Team

</div>