ZhuaTech MES｜知华科技制造执行系统社区源码版

本次升级：首检合格与返工恢复数量平衡

将投入量分解为首检合格、返工恢复、报废和待处理数量，计算首检良率及最终合格产出，避免把返工当首检合格。

新增已认证的结构化录入工作台（/operations.html），支持批量核算、逐条结果依据、分级复核和CSV/完整JSON导出。结果由真实后端算法计算，不是预置演示数字。所有数值精确传递，不调用外部模型。

这是只读核算：不写库、不审批、不自动执行财务、签署、销毁或设备控制。输入条件满足不是执行授权。算法、输入边界与接口说明。

2026-10-23 功能更新：原始生产记录OEE核算

从计划时长、停机区间、理想节拍和实际产量核算可用率、性能率、质量率及OEE；停机重叠按并集合计并提示异常节拍。

登录真实后端后，点击右下角“业务计算工具”，可输入结构化数据、执行计算和导出完整结果。该功能已实现后端算法，并非静态示例响应。

接口：POST /api/workbench/evidence-oee（沿用当前登录 JWT）。计算仅处理本次输入，不读取其他用户记录，不写入业务单据、不自动审批、不调用外部模型。算法口径、输入示例、边界和测试方法见本次更新说明。

简体中文 | English

企业级增强：不合格品处置治理

新增隔离、遏制、追溯、材料评审、客户让步、返工/报废/退货授权、库存移动和电子签名检查，详见企业级不合格品处置治理。

企业级增强：生产工单变更治理

新增 BOM/工艺版本、WIP、追溯、工程质量审批、EHS、电子签名、现场通知和回滚治理，详见生产工单变更治理。

企业级增强：生产工单投产治理

新增 BOM、工艺、物料、设备、人员、检验、工程变更和关键工序安全许可联合门禁，详见投产治理。

把生产计划变成现场动作，把每次报工、检验与异常沉淀为可以追溯的制造事实。

ZhuaTech MES 是 知华科技（上海如静知华信息科技有限公司） 面向离散制造场景推出的制造执行系统社区源码版。项目采用 Java + Vue 前后端分离架构，包含适合车间触屏与手机浏览器的生产执行端，以及面向计划、质量和设备人员的管理端。

官方网站：https://www.zhuatech.cn/
技术关键词：MES、制造执行系统、生产工单、工序报工、质量追溯、设备管理、生产看板
许可边界：仅限个人、非商业学习研究和技术交流；商用必须取得书面授权

一条工单如何在系统里流转

ERP/计划订单
     ↓
生产工单 → 工艺路线 → 工作中心派工 → 工位执行/报工
                                      ↓
                               首检/巡检/异常呼叫
                                      ↓
                           完工检验 → 批次追溯 → 入库

工作中心瓶颈识别

POST /api/mes/insights/bottleneck 比较标准周期与实际周期，并结合排队工单、停机时长和资源利用率生成瓶颈分数。接口区分正常、关注和严重等级，输出节拍校准、工序分流、维护工单或产能扩充建议，适合用于车间看板的异常排序。

社区版本重点呈现“计划下达到现场反馈”的完整闭环。接口层保留清晰的领域边界，便于在取得商业授权后继续集成 ERP、WMS、QMS、PLC、边缘网关或条码设备。

产品界面

生产驾驶舱

知华科技 MES 生产驾驶舱

管理端将小时产出、工作中心负荷、在制工单与现场异常放在同一屏。计划主管可以先判断当天能否按期完成，再下钻到设备报警、首件不合格和缺料事件。

生产工单

知华科技 MES 生产工单管理

工单列表同时呈现产品、批次、工作中心、计划数量、完工数量、不良数、执行进度与交期。紧急、关注和暂停状态使用克制的业务色标记，适合长时间办公使用。

车间执行端

知华科技 MES 车间班组工作台

执行端围绕当前工单设计：工单达成、工序节点、工位节拍、设备 OEE 和后续任务均可快速读取。页面响应式适配桌面、车间触屏和 H5 浏览器。

工序报工

知华科技 MES 工序报工页面

报工页面减少现场输入项，突出合格数、不良数和关键工艺参数。后端接口会校验剩余数量并同步更新工单实绩，形成可继续扩展的生产记录。

社区版能力清单

业务域	已提供	可继续扩展方向
生产计划	工单下达、优先级、交期、工作中心	APS 排程、齐套校验、插单与拆并单
车间执行	班次任务、工序流转、合格/不良报工	扫码防错、电子作业指导书、多人协作
质量管理	首检、巡检、完工检验、检验结果	SPC、缺陷代码、返工返修、质量放行
设备管理	运行/待机/报警、OEE、心跳时间	点检保养、Andon、IoT/PLC 实时采集
物料追溯	产品批次与工单关联模型	上料校验、正反向追溯、序列号管理
生产分析	计划达成、小时产出、负荷、异常	停机损失、绩效班报、能源与成本分析
安全权限	JWT、操作工/计划/质量/管理员角色	组织权限、数据范围、审计日志、SSO

工程结构

zhuatech-mes/
├── frontend/                       Vue 3 + Vite，管理端与车间 H5
│   └── src/views/
│       ├── admin/                  生产计划与运营管理页面
│       └── shopfloor/              班组工作台和工序报工页面
├── backend/                        Java 21 + Spring Boot
│   └── src/main/java/cn/zhuatech/mes
│       ├── controller/             REST 接口与角色权限
│       ├── service/                工单、报工与看板业务规则
│       ├── model/                  制造领域实体
│       └── repository/             JPA 数据访问
├── docs/                           架构、数据库、接口与页面图片
├── deploy/                         生产部署注意事项
└── compose.yaml                    MySQL、后端和前端编排

数据库表统一使用 mes_ 前缀，Flyway 负责版本化建表。后端使用 Controller → Service → Repository 分层；前端通过角色进入 /shopfloor 或 /admin，演示模式不依赖后端即可查看完整样式。

快速体验

Docker Compose

cp .env.example .env
docker compose up --build

启动后访问 http://localhost:8090。示例密码仅供本地体验，上线前必须更换数据库密码、JWT 密钥并删除演示账号。

本地开发

环境要求：Java 21、Maven 3.9+、Node.js 20+、MySQL 8.x。

# 后端
cd backend
mvn spring-boot:run

# 新终端启动前端
cd frontend
npm install
npm run dev

无需 MySQL、仅查看页面：

cd frontend
npm install
npm run dev:demo

演示账号

入口	账号	密码	角色
车间执行端	`operator`	`Demo@2026`	总装一线操作工
生产管理端	`planner`	`Demo@2026`	生产计划主管
生产管理端	`quality`	`Demo@2026`	质量工程师
系统管理	`admin`	`ZhuaTech@2026`	系统管理员

部署前必须检查

将 .env.example 复制为本地 .env，不要提交真实配置；
使用至少 32 字节的随机 JWT 密钥并定期轮换；
删除或禁用全部演示账号，限制 CORS 来源并启用 HTTPS；
生产网络与办公网络分区，设备接入应通过受控边缘网关；
对工艺参数、追溯数据、导出权限和操作日志进行专项安全评审；
配置数据库备份、恢复演练、监控告警和依赖漏洞扫描。

详细说明见部署指南、系统架构、接口文档与数据库说明。

使用许可

本工程仅允许个人用于非商业性的学习、研究与技术交流，不得用于任何直接或间接商业用途。企业内部使用、生产部署、SaaS、客户交付、投标、咨询实施、培训收费、品牌替换等均属于商业使用，必须事先获得上海如静知华信息科技有限公司的书面授权。

完整条款以 LICENSE 为准。该许可含非商业限制，因此本项目是公开可见的社区源码项目（source-available），不是 OSI 定义的开源软件。

深度定制与商业授权

如果需要多工厂、多组织、APS 排程、ERP/WMS/QMS 集成、PLC/IoT 数据采集、条码追溯、电子作业指导书、国产化适配或生产级部署，请联系 知华科技（上海如静知华信息科技有限公司）。

官网：https://www.zhuatech.cn/
咨询内容建议包含：行业、工厂规模、主要产品、现有系统、设备协议和预期上线范围

也可以扫描以下任一微信二维码咨询：

知华科技微信咨询二维码一知华科技微信咨询二维码二

参与改进

提交 Issue 或 Pull Request 前请阅读 CONTRIBUTING.md 与 CODE_OF_CONDUCT.md。请勿提交真实工艺参数、生产订单、设备地址、追溯数据、账号密钥或个人信息。

节拍偏差在线分析

新增车间接口 POST /api/shopfloor/takt-analysis，基于需求量、可用生产时间、实际周期和停机时间计算目标节拍、有效节拍与偏差率，并输出 ON_TRACK / AT_RISK / BEHIND 状态。出现落后时，返回停机复盘和瓶颈工序改善建议。

该接口沿用操作员权限，600 件班次需求与 60 分钟停机的落后场景已通过集成测试。

OEE 损失分析

新增 POST /api/mes/insights/oee-loss-analysis，按可动率、性能效率和质量率计算 OEE，定位 AVAILABILITY / PERFORMANCE / QUALITY 最大损失项，并估算达到 85% 目标所需追回的生产分钟数。结果会按停机、降速或质量损失给出针对性改善动作。

制程质量漂移

POST /api/mes/insights/quality-drift 比较基线与当前合格率，并结合连续偏差、刀具寿命、工艺参数偏离和样本量输出继续、复核或停机检查决策，让质量趋势在形成批量不良前进入处置队列。

AI 缺陷根因分析

新增 POST /api/mes/ai/defect-root-cause，把缺陷率漂移、温度、振动、工装寿命、人员切换和物料批次切换关联成风险分、候选根因和围堵动作。无模型时按可解释规则运行；部署方配置 DeepSeek 或 OpenAI 兼容大模型后，可按“人、机、料、法、环、测”生成验证假设与排查步骤。

检索关键词：AI MES、智能制造系统、AI 质量分析、缺陷根因分析、制造异常诊断、DeepSeek MES、工业 AI、知华科技 MES。

生产批次谱系与正反向追溯

新增 POST /api/enterprise/mes/production-genealogy，在成品批次入账前核对工单、BOM、工艺路线、设备、操作员、质量放行和电子签名，并逐项校验投入物料批次的质量状态、有效期、工单发料、追溯码、BOM 超耗及关键物料供应商批次。接口返回 RECORD / REVIEW / BLOCKED，可作为报工入库和 WMS 标签同步的前置门禁。