ktg-mes 制造执行系统源码学习与架构分析

一、 项目背景与学习目的

在常规的 Web 开发学习中，接触到的多为电商、社交或内容管理类系统，这类系统的特点是注重并发处理与用户体验。而工业软件（如 MES 制造执行系统）的特点在于极高的业务复杂度和数据耦合度。

MES 系统主要用于解决制造企业车间层面的生产管理问题，包括生产计划下达、物料调度、工艺路线控制以及产品质量追溯。为了提升处理复杂业务逻辑和企业级架构设计的能力，我选择了开源的 ktg-mes 项目进行源码阅读和本地部署调试。本文将记录该项目的技术选型、核心业务逻辑以及关键代码的设计思路。

二、 技术选型与系统架构

ktg-mes 是一个面向中小型制造企业的轻量级开源 MES 项目。系统采用了标准的 Java 企业级前后端分离架构，代码结构清晰，便于二次开发。

2.1 后端架构设计

项目基于 Spring Boot 构建，并采用了 Maven 多模块聚合工程的结构，将公共基础框架、权限管理模块和具体的 MES 业务模块进行了物理隔离。

  • 数据持久层：系统选用了 MyBatis 及 MyBatis-Plus。制造系统涉及大量的多表关联查询（如工单关联物料、工艺、客户等），MyBatis 允许开发者直接编写和优化复杂的 SQL 语句，能够更好地应对工业级数据处理需求。
  • 权限与安全：基于 Spring Security 结合 JWT（JSON Web Token）实现。通过无状态的 Token 机制进行 API 鉴权，降低了服务端的 Session 存储压力，也便于后续的分布式部署。
  • 缓存机制：集成了 Redis。对于工厂配置、单位字典等读多写少的热点基础数据，系统会在启动时或首次加载时将其放入 Redis 缓存中，有效减少了数据库的访问频次。

2.2 前端架构设计

前端项目 ktg-mes-ui 是一个单页面应用（SPA），基于 Vue.js 和 Element UI 开发。Element UI 提供的复杂表格、树形控件和表单校验组件，非常适合后台管理系统中高密度数据的展示需求。系统通过 Axios 进行网络请求，并配置了统一的拦截器来处理 Token 注入和全局异常状态码。

三、 核心业务模块源码分析

在阅读源码的过程中，我主要关注了 MES 系统中最核心的三个业务模块：物料与 BOM 管理、工艺路线与排程、以及生产报工。

3.1 物料清单 (BOM) 的数据结构设计

BOM（Bill of Materials）描述了最终产品是由哪些组件和原材料构成的，是典型的树形数据结构。

在数据库设计上，ktg-mes 采用了邻接表模型（Adjacency List）。在子物料的数据表中，通过保存一个 parent_id 字段来记录其父级节点。
在后端逻辑实现上，为了避免在数据库中进行低效的递归查询（N+1 问题），代码通常会通过一次 SQL 查询获取当前产品关联的所有扁平 BOM 数据记录，随后在 Java 内存中通过遍历和组装，将 List 转换为嵌套的树形 JSON 结构。这种处理方式在保证数据完整性的同时，优化了接口的响应速度。

3.2 工艺路线与生产排程

工艺路线模块定义了产品的加工步骤，例如：切割、打磨、质检。
系统在数据库中抽象了“工作中心”和“工作站”的概念。当生产计划转化为具体的“生产工单（Work Order）”时，系统需要进行排程操作。
在排程代码中，系统会读取该产品的 BOM 和工艺路线配置，自动拆分出底层的“生产任务（Task）”，并将任务分配给对应的工作站。这一过程涉及到多张核心表的数据写入，代码中严格使用了 Spring 的 @Transactional 注解来保证数据库事务的强一致性，避免出现任务分配不完整的数据脏象。

3.3 生产报工与质量追溯机制

报工是记录车间实际生产进度的关键环节。
在报工接口的 Controller 层，代码实现了严密的业务校验逻辑：

  1. 工序校验：检查当前提交的报工请求是否符合工艺路线的顺序，防止工人跳过前置工序直接生产。
  2. 物料校验：比对实际投料数量与 BOM 规定的标准用量是否一致。
  3. 不良品记录：如果在生产中记录了次品，系统会要求必须关联对应的不良原因代码。

通过这种节点式的数据采集，系统在底层构建了一套完整的质量追溯链条。当产品出现问题时，可以通过数据库外键关联，逆向查询出该产品的生产时间、操作人员、使用的设备以及原材料批次。

四、 RBAC 权限控制的具体实现

针对制造企业复杂的组织架构，系统实现了一套细粒度的 RBAC（基于角色的访问控制）模型。其底层由用户、角色、菜单/权限、用户-角色关联、角色-权限关联等五张核心表支撑。

系统不仅控制页面级别的访问，还实现了按钮级别的权限控制：

  • 后端鉴权：系统通过自定义 Spring Security 的表达式，在 Controller 的方法上使用 @PreAuthorize("@ss.hasPermi('mes:item:remove')") 注解。请求到达时，系统会比对当前用户的权限标识集合，判断是否放行。
  • 前端控制：前端代码中封装了自定义指令 v-hasPermi。在 Vue 渲染 DOM 元素时，指令会读取当前用户的权限列表，如果不包含该按钮所需的权限标识，则直接操作 DOM 树将该按钮节点移除。这从根本上避免了越权点击。

五、 性能优化与并发处理思考

在分析和调试过程中，我也注意到了工业系统开发中需要重点考虑的性能与并发问题：

  1. 慢查询优化：在工单、工艺路线和物料的多表 LEFT JOIN 查询中，如果数据量庞大，极易产生慢 SQL。在实际生产部署时，必须对相关的外键字段建立合适的索引，并定期使用 EXPLAIN 分析执行计划。
  2. 并发报工的数据安全：在车间现场，可能会出现多名工人同时对同一份大批量工单进行扫码报工的情况。如果处理不当，会导致数据库中记录的已生产数量超过计划数量。阅读源码发现，系统在执行更新操作时，采用了乐观锁的思路，例如在 UPDATE 语句中加入 where current_count + request_count <= total_count 的条件，以此保证并发情况下的数据准确性。

六、 学习总结

通过对 ktg-mes 源码的深入学习，我不仅巩固了 Spring Boot 与 Vue 前后端分离项目的开发规范，更重要的是掌握了将复杂业务逻辑抽象为代码的能力。

工业软件的开发要求严谨的业务建模和数据一致性保障。了解 BOM 树的构建、事务控制的应用、以及细粒度权限系统的实现，对提升我个人的企业级系统架构设计能力有着显著的帮助。这些从实际业务场景中沉淀下来的代码设计经验，是非常宝贵的学习资源。