# MES

**Repository Path**: MerlinRong/mes

## Basic Information

- **Project Name**: MES
- **Description**: MES 制造执行系统
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-08
- **Last Updated**: 2026-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="https://img.shields.io/badge/Python-3.12+-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python" />
  <img src="https://img.shields.io/badge/FastAPI-0.115-009688?style=for-the-badge&logo=fastapi&logoColor=white" alt="FastAPI" />
  <img src="https://img.shields.io/badge/Vue-3.5-4FC08D?style=for-the-badge&logo=vuedotjs&logoColor=white" alt="Vue" />
  <img src="https://img.shields.io/badge/TypeScript-5.6-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript" />
  <br />
  <img src="https://img.shields.io/badge/tests-92%20passed-success?style=flat-square&logo=pytest" alt="Tests" />
  <img src="https://img.shields.io/badge/coverage-76%25-yellowgreen?style=flat-square" alt="Coverage" />
  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License" />
</p>

<h1 align="center">🏭 MES 制造执行系统</h1>

<p align="center">
  <b>面向中小型制造企业的轻量级车间执行管理系统</b><br />
  实现车间生产过程的数字化、可视化、可追溯
</p>

---

## ✨ 功能特性

- 📋 **工单管理** — 工单全生命周期（草稿 → 下达 → 生产 → 完工 → 结案），支持派工、报工、进度实时追踪
- 🗺️ **工艺路线** — 工序库 + 工艺路线编排（拖拽排序）、版本管理、路线复制
- 📅 **车间调度** — 排产甘特图、冲突检测、产能日历、WebSocket 实时看板
- 🔍 **质量追溯** — 来料/过程/成品检验，批次号正向/反向双向追溯
- ⚙️ **设备管理** — 设备台账、状态机、故障报修、维保、OEE 计算
- 📦 **物料管理** — 领料/退料、报工自动扣减库存、安全库存预警、流水追溯
- 📊 **报表中心** — 产量/良率/效率/交期/物料/OEE 六类报表 + 生产驾驶舱

## 🧱 技术栈

| 层 | 技术 |
|----|------|
| 后端 | Python 3.12+ · FastAPI · SQLAlchemy 2.0 (async) · Alembic · Pydantic v2 |
| 前端 | Vue 3 · TypeScript · Element Plus · Pinia · ECharts · Vite |
| 数据库 | SQLite（开发）· PostgreSQL（生产） |
| 实时通信 | WebSocket（车间看板实时推送） |
| 测试 | pytest · pytest-asyncio · httpx |

## 📂 目录结构

```
.
├── backend/              # FastAPI 后端
│   ├── app/              # api / services / models / schemas
│   ├── alembic/          # 数据库迁移
│   ├── scripts/          # 种子数据脚本
│   └── tests/            # 92 个测试
├── frontend/             # Vue3 前端
├── docker-compose.yml    # 生产编排
└── README.md
```

## 🚀 快速开始

### 前置要求

- Python 3.12+
- Node.js 18+

### 后端

```bash
cd backend
python -m venv .venv
source .venv/bin/activate      # Windows: .venv\Scripts\activate
pip install -r requirements.txt

alembic upgrade head           # 数据库迁移
python -m scripts.seed         # 初始化种子数据
uvicorn app.main:app --reload  # 启动服务
```

> 📖 API 文档: http://localhost:8000/docs

### 前端

```bash
cd frontend
npm install
npm run dev                    # http://localhost:5173
```

### 默认账号

| 账号 | 密码 | 角色 |
|------|------|------|
| `admin` | `admin123` | 系统管理员 |
| `supervisor` | `admin123` | 生产主管 |
| `operator` | `admin123` | 操作员 |
| `inspector` | `admin123` | 质检员 |
| `equip_mgr` | `admin123` | 设备管理员 |

## 🧪 运行测试

```bash
cd backend
pytest -q              # 92 个测试
pytest --cov=app       # 覆盖率报告（当前 76%）
```

## 🐳 Docker 部署

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

| 服务 | 地址 |
|------|------|
| 前端 | http://localhost |
| 后端 API | http://localhost:8000/docs |
| 数据库 | PostgreSQL 16 |

## 🔑 核心业务规则

系统实现了完整的车间业务规则（详见 `.codebuddy/docs/` 需求规格说明书）：

- 工单状态机：`draft → released → in_progress → completed → closed`（支持取消）
- 报工联动：报工自动回写工单进度，按 BOM 扣减物料库存
- 领料上限：`BOM 用量 × 计划数量 × 110%`
- 工艺路线版本管理：同产品唯一生效版本
- 排产冲突检测：同设备时段重叠校验
- 质量双向追溯：批次号正向 / 反向
- 设备状态机与 OEE 计算

## 📚 文档

完整的需求规格说明书（SRS）、系统设计文档（SDS）、编码实现方案与部署文档见 `.codebuddy/docs/`。

## 📄 License

[MIT](LICENSE)