# MES系统-iMES工厂管家 **Repository Path**: JsuneCloud/imes ## Basic Information - **Project Name**: MES系统-iMES工厂管家 - **Description**: MES系统，iMES工厂管家——您的新一代工厂管理助手【MES管理系统】。演示地址：https://imes.625sc.com。 一款基于.NetCore3.1和Vue3的MES管理系统。项目亮点：模版打印，Excel模版导出，自定义实体扩展，移动端精美设计，大屏设计等功能。 - **Primary Language**: C# - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://imes.625sc.com - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 766 - **Created**: 2025-10-23 - **Last Updated**: 2026-03-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## iMES工厂管家——您的新一代工厂助手【MES/MOM管理系统】 ## 功能模块 - 基础数据【工艺路线，绩效工资配置，产品定义，物料清单，单位管理，不良品项，工序，通知管理，车间设置】 - 自定义配置【自定义编号规则】 - 库存管理【出库单，入库单，库存收发明细，库存余额】 - 生产管理【销售订单，生产计划，装配工单，工单，任务，报工】 - 系统管理【用户管理，部门管理，消息推送，权限管理，角色管理，菜单设置，数据字典，系统日志，角色管理（tree），版本发布记录，用户管理（tree）】 - 报表管理【员工绩效，工资报表，不良品项分部，不良品项汇总，生产报表，产量统计】 - 定时任务【任务配置，执行记录】 - 流程管理【审批流程，我的任务】 - 开发管理【表单设计，表单配置，数据采集，代码生成】 - 质量管理【常见缺陷，检测项管理，检测模版，来料检验单，过程检验单，出货检验单】 - 排班管理【班组管理，排班计划，节假日设置，排班日历】 - 工具管理【工具领用，工具归还，工装夹具类型，工装夹具台账】 - 设备管理【设备类型设置，设备台账，点检保养项目，点检保养计划，维修单，点检保养工单】 - 看板管理【车间生产管控看板，工单执行进度看板】 ## 商业版亮点： - 生产管理，模版打印，Excel模版导出，自定义实体扩展，移动端精美设计，大屏设计等功能。并且提供技术支持 ## 框架预览 - 框架内置了大量的通用组件可直接使用,并内置了基于本框架定制开发的代码生成器，尽量避免重复性代码编写。 - 框架不仅仅是快速开发，更多的是倾向于业务代码扩展的编写与代码规范。 - 如果有什么问题或建议，提issue或加作者QQ/微信：514224717 - QQ群：724346134 - 官方网站：https://www.625sc.com - 介绍视频：https://www.bilibili.com/video/BV1KY4y1d7EC/ - 文档介绍：https://www.625sc.com/imes/324.html - 商业版演示地址：https://imes.625sc.com - Java版演示地址：https://java.625sc.com:8443/imes 演示帐号：admin 密码：admin。如有采购需求，请联系QQ/微信：514224717 - 开源版演示地址：https://imesopen.625sc.com - 帐号：admin密码：123456 - gitee码云：https://gitee.com/ZM-Rid/imes - github地址：https://github.com/zmrid/imes-factory ## 框架核心 - 快速开发(基础功能全部由代码生成器生成) - 支持前端、后台自定义业务代码扩展,后台提供了大量常用扩展与通用类 - 前端、后台提供了近300个扩展方法与属性,开发人员可在此功能上编写扩展自定义业务代码 - 代码生成(代码生成器可直接生成主/从表前后端业务代码,有30多种属性可在线配置生成的代码) - 前端table自动转换key/value - 前端表单select/checkbox自动绑定数据源,不需要写任何代码 - 支持(主从表)一对一前后端代码全自动生成、并支持数据源自动绑定与业务代码扩展,不需要写任何代码 - 支持一对多从表自定义扩展(不限从表类型与从表数量) , 一对多从表使用扩展可轻松实现 - 如果能上手框架，可以体会到不用996,更不用掉头发的感觉^_^ ## 框架开发依赖环境 - 后台：VS2019、vs2022 、.NetCore3.1 、EFCore3.1、JWT、Dapper、SignalR、Quartz.Net、Autofac、SqlServer2016[MySQL]、Redis - 前端：VsCode、vue3（需要安装nodejs)、vuex、axios、promise、element ui、element plus ## 开源版和商业版区别 - 商业版提供【生产管理】模块 - 商业版支持自定义实体扩展 - 商业版提供【工作台管理】模块，并支持自定义桌面工作台 - 商业版支持打印模版设计 - 商业版支持模版打印 - 商业版支持Excel模版导出 - 商业版拥有移动端，可以一套代码导出H5,Android,iOS端。并且提供桌面端 - 商业版提供可视化看板设计功能 - 商业版提供技术支持，开源版只有开源交流QQ群 - Java版演示地址：https://java.625sc.com:8443/imes 演示帐号：admin 密码：admin。如有采购需求，请联系QQ/微信：514224717 ## 图片预览 ![输入图片说明](Image/1.jpg) ![输入图片说明](Image/2.jpg) ![输入图片说明](Image/3.jpg) ![输入图片说明](Image/4.jpg) ![输入图片说明](Image/5.jpg) ![输入图片说明](Image/6.png) ![输入图片说明](Image/7.png) ![输入图片说明](Image/8.jpg) ![输入图片说明](Image/9.png) ## 项目启动与上手 - 运行前先看后台appsettings.json配置属性说明；(注意修改DbType属性，修改为自己使用的数据库,数据库脚本在DB文件夹下) - 1、启动后台项目：后端项目路径 ../iMES.WebApi，找到dev_run.bat命令点击启动。后台启动 默认端口是9991。 (dev_run.bat如果闪退，请使用cmd切换至 ../iMES.WebApi目录下执行dotnet run看异常信息) 如从没执行过npm install命令，使用cmd命令切换至前端Vue项目../iMES.Vue3路径下,执行npm install命令 - 2、启动前端项目：前端Vue项目路径 ../iMES.Vue3 ， 找到 run.bat命令点击启动 。 - （1）(run.bat如果闪退,说明环境没配置好，请使用cmd切换至 ../iMES.Vue3目录下执行npm run serve看异常信息) - （2）使用cmd命令切换到../iMES.Vue3目录下执行npm cache clear --force或者安装node.js版本16.17.1+ - （3）输入http://localhost:9990访问（本地超级管理员帐号：admin 密码:123456） ## 功能新增与优化开发手册 ### 1. 环境搭建 #### 1.1 后端环境 - **.NET SDK**: v10.0 - **IDE**: Visual Studio 2022+ - **数据库**: MySQL 8.0+ / SQL Server 2019+ / PostgreSQL 13+ - **依赖管理**: NuGet #### 1.2 前端环境 - **Node.js**: v24.11.0（已配置兼容模式） - **包管理器**: npm 11.6.1+ - **IDE**: VS Code - **Vue CLI**: 4.5.0 ### 2. 项目结构 #### 2.1 后端结构 ``` iMES.Net/ ├── iMES.Core/ # 核心框架 ├── iMES.Entity/ # 实体模型 ├── iMES.Custom/ # 自定义业务逻辑 ├── iMES.Equip/ # 设备管理模块 ├── iMES.Quality/ # 质量管理模块 ├── iMES.Calendar/ # 日历管理模块 ├── iMES.Report/ # 报表模块 ├── iMES.System/ # 系统管理模块 ├── iMES.Tools/ # 工具管理模块 ├── iMES.Warehouse/ # 仓库管理模块 ├── iMES.WebApi/ # API接口 └── iMES.Builder/ # 构建工具 ``` #### 2.2 前端结构 ``` iMES.Vue3/ ├── public/ # 静态资源 ├── src/ # 源代码 │ ├── assets/ # 资源文件 │ ├── components/ # 组件 │ ├── views/ # 页面 │ ├── router/ # 路由 │ ├── store/ # 状态管理 │ └── main.js # 入口文件 ├── package.json # 依赖配置 └── vue.config.js # 构建配置 ``` ### 3. 开发流程 #### 3.1 分支管理 1. **master**: 主分支，用于生产环境 2. **develop**: 开发分支，用于集成测试 3. **feature/xxx**: 功能分支，用于开发新功能 4. **bugfix/xxx**: 修复分支，用于修复bug #### 3.2 开发步骤 1. 从 develop 分支创建 feature 分支 2. 实现功能 3. 提交代码 4. 合并到 develop 分支 5. 进行测试 6. 合并到 master 分支 ### 4. 后端开发规范 #### 4.1 代码结构 - **控制器**: 继承 ApiBaseController，处理 HTTP 请求 - **服务层**: 实现业务逻辑，继承 ServiceBase - **数据访问层**: 使用 EF Core 或 Dapper - **实体模型**: 放在 iMES.Entity 项目中 #### 4.2 新增功能步骤 1. 在 iMES.Entity 中添加实体模型 2. 在对应模块中添加服务接口和实现 3. 在 WebApi 中添加控制器和路由 4. 更新数据库迁移 #### 4.3 性能优化 - 使用异步方法（async/await） - 合理使用缓存 - 优化数据库查询 - 避免 N+1 查询问题 ### 5. 前端开发规范 #### 5.1 组件开发 - 使用 Vue 3 Composition API - 组件命名采用 PascalCase - 样式使用 scoped 或 CSS Modules #### 5.2 新增功能步骤 1. 在 views 目录创建页面组件 2. 在 router 中添加路由 3. 在 store 中添加状态管理 4. 实现页面逻辑和样式 #### 5.3 性能优化 - 使用虚拟列表处理大量数据 - 组件懒加载 - 合理使用 computed 和 watch - 优化网络请求 ### 6. 测试流程 #### 6.1 后端测试 - 单元测试：使用 MSTest - 集成测试：测试 API 接口 - 数据库测试：测试数据访问 #### 6.2 前端测试 - 单元测试：使用 Mocha - E2E 测试：使用 Cypress - 性能测试：使用 Lighthouse ### 7. 部署流程 #### 7.1 后端部署 1. 构建发布版本 2. 部署到 IIS 或 Docker 3. 配置数据库连接 4. 启动服务 #### 7.2 前端部署 1. 执行 `npm run build` 2. 将 dist 目录部署到 Web 服务器 3. 配置 Nginx 或 IIS ### 8. 常见问题解决 #### 8.1 后端问题 - **数据库连接失败**: 检查连接字符串和数据库服务状态 - **依赖冲突**: 使用 nuget 包管理器解决 - **API 超时**: 检查网络连接和服务器性能 #### 8.2 前端问题 - **Node.js 版本兼容**: 使用 `cross-env NODE_OPTIONS=--openssl-legacy-provider` - **依赖安装失败**: 清理 npm 缓存后重新安装 - **构建失败**: 检查代码语法和依赖版本 ### 9. 代码规范 #### 9.1 后端规范 - 命名：PascalCase（类名）、camelCase（方法名）、_camelCase（私有字段） - 注释：为公共方法和类添加 XML 注释 - 异常处理：使用 try-catch 捕获异常，记录日志 #### 9.2 前端规范 - 命名：kebab-case（文件名）、PascalCase（组件名）、camelCase（变量名） - 注释：为复杂逻辑添加注释 - 代码风格：使用 ESLint 检查代码风格 ### 10. 版本控制 - 使用 git 进行版本控制 - 提交信息格式：`[类型] 描述`，例如 `[feature] 添加用户管理功能` - 定期拉取和推送代码 - 避免提交二进制文件和生成文件 ### 11. 安全注意事项 - 后端：使用 HTTPS，验证用户权限，防止 SQL 注入 - 前端：防止 XSS 攻击，验证输入数据，使用 CSRF 令牌 ### 12. 文档管理 - 代码注释：为关键代码添加注释 - API 文档：使用 Swagger 生成 API 文档 - 技术文档：记录架构设计和关键实现 ## 捐赠支持 ``` 如果对您有帮助，请点击右上角⭐Star关注或扫码捐赠，感谢支持开源！ ``` ![输入图片说明](Image/pay.png) ## 特别声明 iMES工厂管家 项目已加入 [dotNET China](https://gitee.com/dotnetchina) 组织。
![dotnetchina](https://gitee.com/dotnetchina/home/raw/master/assets/dotnetchina-raw.png "dotNET China LOGO")