# SeqForge MES

**Repository Path**: zhouliqqcom/seqforge-mes

## Basic Information

- **Project Name**: SeqForge MES
- **Description**: AI 驱动的柔性生产执行系统
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: feature/quality-traceability-aps
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-03
- **Last Updated**: 2026-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SeqForge MES

**AI 驱动的柔性生产执行系统**

![React](https://img.shields.io/badge/React-18-61DAFB?style=flat-square&logo=react)
![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?style=flat-square&logo=typescript)
![Vite](https://img.shields.io/badge/Vite-5-646CFF?style=flat-square&logo=vite)
![Ant Design](https://img.shields.io/badge/Ant%20Design-6-0170FE?style=flat-square&logo=antdesign)
![FastAPI](https://img.shields.io/badge/FastAPI-0.115-009688?style=flat-square&logo=fastapi)
![Python](https://img.shields.io/badge/Python-3.11-3776AB?style=flat-square&logo=python)
![PostgreSQL](https://img.shields.io/badge/PostgreSQL-15-336791?style=flat-square&logo=postgresql)
![License](https://img.shields.io/badge/License-Apache--2.0-blue?style=flat-square)

SeqForge MES 是一套面向中小型离散制造企业的开源生产执行系统，将车间纸质台账和分散的 Excel 流程搬到线上，统一管理生产计划、工单、报工、物料库存、质量追溯、设备和生产报表。项目重点解决记录易丢失、生产进度不透明、质量难追溯、商业 MES 成本高以及工厂 IT 人员不足等问题。

## 适用场景

- 10 至 200 人左右的中小型离散制造企业
- 多品种、小批量、按单生产或按单与备库混合生产
- 希望先上线工单、报工和库存，再逐步完善质量、设备与排程能力的工厂
- 缺少专职 IT 团队，需要可自主部署和持续扩展的生产管理系统

## 解决的问题

| 现场问题 | SeqForge MES 的处理方式 |
| --- | --- |
| 纸质记录易丢、Excel 数据分散 | 统一保存工单、报工、库存、质量和设备记录 |
| 生产进度依赖口头询问 | 汇总计划、工单执行和生产报表，方便跟踪进度 |
| 质量问题难以定位来源和去向 | 基于批次、序列号和业务单据逐步完善追溯关系 |
| 商业 MES 采购和实施成本高 | 以开源 PC Web 与后端 API 支持自主部署和二次开发 |
| 工厂 IT 人员少、系统落地难 | 提供统一部署入口、开发模式和分阶段上线方式 |

## 当前能力

以下能力已存在于当前公开代码中：

| 业务域 | 主要能力 |
| --- | --- |
| 生产计划 | 需求管理、需求计算、生产计划、滚动排程、甘特展示和缺料预警 |
| 生产执行 | 工单、报工、返工、委外、装箱绑定、生产异常及相关审批 |
| 仓储库存 | 入库、出库、盘点、调拨、批次、序列号、组装拆卸和库存预警 |
| 质量管理 | 来料、过程、成品和出货检验，检验方案、不合格台账、8D 与 SPC |
| 设备资材 | 设备台账、点检、巡检、故障、维修、保养，以及模具和工装管理 |
| 报表看板 | 生产、质量、仓储和设备业务数据查询、汇总与可视化 |
| 平台基础 | 多租户、RBAC 权限、数据范围、审批、消息、编码规则、自定义字段、打印和审计 |

## 正在增强

以下能力已经完成方案设计，仍在实现和验收过程中，不作为当前稳定功能承诺：

### 批次全链路追溯

- 串联采购入库、领料、生产投入、工序报工、质检、成品入库和销售出库
- 支持按原料批次、生产批次、序列号和成品批次正向或反向查询
- 记录批次拆分、合并、替代和返工关系，形成可审计的批次谱系

### 约束优化排程

- 综合人员班次与技能、物料齐套、设备产能、工艺路线和交期约束
- 以 OR-Tools CP-SAT 为候选求解器，生成可解释的工单排序和资源分配提案
- 采用“系统生成提案、计划员人工确认、确认后下发”的工作方式
- 面向多品种、小批量和插单频繁的柔性生产场景持续优化

详细设计见 [质量追溯与 APS 设计](docs/superpowers/specs/2026-09-03-quality-traceability-aps-design.md)。

## 后续规划

### 设备自动采集

- 建设统一设备接入层，逐步支持 MQTT、OPC UA、Modbus TCP 等协议
- 接入传感器、PLC 和设备控制器，自动采集状态、产量、节拍、能耗和告警
- 将设备事件与工单、工序、班次关联，减少人工填报并提高数据实时性

### AI 异常识别

- 基于设备时序数据、质量结果和生产节拍识别异常趋势
- 为停机、质量偏差和交期风险生成告警及处置建议
- 保留人工确认和反馈机制，避免模型结果直接改变生产执行状态

### 自然语言报表

- 支持用中文描述查询目标并生成报表草案
- 将自然语言转换为受权限约束的数据查询、指标和图表配置
- 报表发布前由用户预览并确认，降低非技术人员的配置门槛

> “AI 驱动”代表 SeqForge MES 的持续演进方向，不表示当前版本已经交付完整的 AI 能力。

## 技术架构

| 模块 | 技术栈 | 目录 |
| --- | --- | --- |
| PC Web | React 18、TypeScript 5、Vite 5、Ant Design 6 / Pro Components | `riveredge-frontend` |
| 后端 API | FastAPI 0.115、Pydantic 2、Tortoise ORM、Taskiq | `riveredge-backend` |
| 数据存储 | PostgreSQL 15，Taskiq 使用 PostgreSQL 作为任务队列后端 | `riveredge-backend` |
| 部署工具 | Shell、PowerShell、Caddy | `fast-deploy` |

当前公开仓库提供 PC Web 和后端 API 源码，不包含移动 App、H5、触屏工位机或 TV 看板客户端源码。

```text
seqforge-mes/
├── riveredge-frontend/   # PC Web 前端
├── riveredge-backend/    # FastAPI 后端与业务应用
├── fast-deploy/          # 安装、配置、迁移、构建与运行脚本
├── docs/                 # 部署、设计和项目文档
├── LICENSE               # Apache License 2.0
└── README.md             # 项目入口说明
```

## 快速开始

### 环境要求

- Node.js 22+、npm 10+
- 系统 Python 3.12+，后端运行环境由 uv 锁定为 Python 3.11
- PostgreSQL 15+
- 生产部署使用 Caddy；Taskiq 默认使用 PostgreSQL，无需 Redis
- 部署脚本需在 Linux、WSL 或 Git Bash 等兼容 Shell 环境中运行

### 获取代码

```bash
git clone https://gitee.com/zhouliqqcom/seqforge-mes.git
cd seqforge-mes
```

### 启动部署

```bash
./fast-deploy/deploy.sh       # 生产模式，进入部署向导
./fast-deploy/deploy.sh dev   # 开发模式，启用 Vite 热更新
```

| 模式 | Web | API |
| --- | --- | --- |
| 生产 | `http://<服务器IP>:8080` | `/api`，经 Caddy 转发 |
| 开发 | `http://<服务器IP>:8100` | `http://<服务器IP>:8200` |

> [!CAUTION]
> 建议先在独立空白服务器或虚拟机中安装和升级。若必须在已有业务的服务器上执行部署、更新或数据库迁移，请先完整备份 PostgreSQL 数据库、后端环境文件、部署配置和上传目录，并验证备份可以恢复。

## 文档

- [部署指南](docs/部署指南.md)：环境准备、安装更新、备份恢复和运维排查
- [部署脚本说明](fast-deploy/README.md)：部署命令、运行模式和参数速查
- [README 改写设计](docs/superpowers/specs/2026-09-03-readme-rebrand-design.md)：品牌与内容边界
- [质量追溯与 APS 设计](docs/superpowers/specs/2026-09-03-quality-traceability-aps-design.md)：追溯和高级排程方案

## 上游致谢

SeqForge MES 基于快格云制造公开版演进。感谢上游项目及其贡献者提供的基础代码；本项目在遵守原许可证和署名要求的前提下进行独立改造与维护。

## 许可证

本项目依据 [Apache-2.0](LICENSE) 开源。使用、修改和分发时请遵守许可证及仓库内保留的版权与商标声明。