shenlu/MES

Fork 0

Files

hhh aed67ce1fd 初始代码

2026-04-02 10:39:03 +08:00

8.0 KiB

Raw Permalink Blame History

FIIH质量管理配置模块

概述

FIIH质量管理配置模块是一个完整的前后端分离的质量管理系统，支持任务配置、通道管理、文件上传、二维码生成等功能。

功能特性

🎯 核心功能

任务管理：支持任务创建、编辑、状态跟踪
环节配置：细粒度的环节管理和配置
通道配置：24通道JSON配置，支持格式化和验证
文件管理：支持5个附件上传
二维码生成：自动生成任务二维码
批量操作：支持批量状态更新

🔧 技术特性

前后端分离：Vue.js + Spring Boot
响应式设计：Element UI组件库
JSON配置：智能JSON编辑器，支持格式化和验证
多租户支持：完整的租户隔离
权限控制：基于角色的访问控制

文件结构

fiih/
├── README.md                           # 说明文档
├── 后端文件/
│   ├── domain/
│   │   └── FiihConfig.java            # 实体类
│   ├── mapper/
│   │   └── FiihConfigMapper.java      # Mapper接口
│   ├── service/
│   │   ├── IFiihConfigService.java    # Service接口
│   │   └── impl/
│   │       └── FiihConfigServiceImpl.java # Service实现
│   ├── controller/
│   │   └── FiihConfigController.java  # 控制器
│   └── resources/mapper/fiih/
│       └── FiihConfigMapper.xml       # MyBatis映射文件
└── 前端文件/
    ├── api/mes/fiih/
    │   └── fiihConfig.js              # API接口
    └── views/mes/fiih/
        └── index.vue                  # Vue页面组件

数据库表结构

CREATE TABLE `ymes_fiih_config` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `fiih_object_name` varchar(50) NOT NULL COMMENT '对象体名称',
  `fiih_link_id` bigint NOT NULL COMMENT '环节ID(单次环节)',
  `fiih_link_name` varchar(100) NOT NULL COMMENT '环节名称',
  `fiih_task_id` bigint NOT NULL COMMENT '任务ID(总体)',
  `fiih_task_name` varchar(100) NOT NULL COMMENT '任务名称',
  `fiih_version` varchar(50) DEFAULT NULL COMMENT '任务版本号',
  `fiih_process` varchar(50) DEFAULT NULL COMMENT '任务流程记录',
  `fiih_status` int NOT NULL DEFAULT '1' COMMENT '任务状态（1进行中 2完成 3作废）',
  `fiih_start_time` datetime DEFAULT NULL COMMENT '开始时间',
  `fiih_end_time` datetime DEFAULT NULL COMMENT '结束时间',
  `fiih_leader_id` bigint NOT NULL COMMENT '负责人ID',
  `fiih_leader_name` varchar(50) NOT NULL COMMENT '负责人姓名',
  `fiih_qr_file` varchar(255) DEFAULT NULL COMMENT '二维码路径',
  `fiih_rich_text` text COMMENT '说明富文本',
  `fiih_info_json` text COMMENT '以上信息属性JSON',
  `fiih_query_json` text COMMENT '以上信息查询属性JSON',
  `fiih_config_ch0` text COMMENT '数据0属性（JSON）',
  -- ... 24个通道配置字段 ...
  `fiih_config_ch23` text COMMENT '数据23属性（JSON）',
  `fiih_file1` varchar(255) DEFAULT NULL COMMENT '附件1路径',
  -- ... 5个附件字段 ...
  `fiih_file5` varchar(255) DEFAULT NULL COMMENT '附件5路径',
  `create_by` varchar(64) DEFAULT NULL COMMENT '创建人',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT NULL COMMENT '更新人',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '更新时间',
  `tenant_id` bigint NOT NULL COMMENT '租户ID',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FIIH质量管理配置表';

API接口

基础CRUD接口

GET /fiih/config/list - 查询配置列表
GET /fiih/config/{id} - 获取配置详情
POST /fiih/config - 新增配置
PUT /fiih/config - 修改配置
DELETE /fiih/config/{ids} - 删除配置

外部集成接口

POST /fiih/config/insert - 新增配置(给外部使用，无权限验证)
POST /fiih/config/createMenu/{fiihTaskId} - 为任务创建菜单

前端功能

🔍 查询功能

支持对象体名称、任务名称、环节名称、负责人、状态等多条件查询
实时搜索，支持回车快速查询

📝 表单功能

基础信息：任务信息、环节信息、负责人信息
时间管理：开始时间、结束时间选择
状态管理：进行中、完成、作废三种状态
富文本编辑：支持说明文本编辑

🔧 通道配置

24通道管理：每个通道独立配置
JSON编辑器：语法高亮、格式化、验证
可视化状态：配置状态徽章提示
批量操作：清空、格式化功能

📎 文件管理

多文件上传：支持5个附件上传
文件类型限制：支持doc、docx、pdf、txt、图片等格式
文件大小限制：单文件最大50MB

🔲 二维码功能

自动生成：基于配置信息生成二维码
在线预览：弹窗查看二维码
信息展示：显示配置ID和任务信息

使用说明

1. 部署后端

将后端Java文件复制到对应目录：

yjh-mes/src/main/java/cn/sourceplan/fiih/
yjh-mes/src/main/resources/mapper/fiih/

执行数据库建表SQL
重启Spring Boot应用

2. 部署前端

将前端文件复制到对应目录：

mes-ui/src/api/mes/fiih/
mes-ui/src/views/mes/fiih/

配置路由（在router/index.js中添加）：

{
  path: '/fiih/config',
  component: () => import('@/views/mes/fiih/index'),
  name: 'FiihConfig',
  meta: { title: 'FIIH质量管理配置', icon: 'form' }
}

配置权限（在系统管理中添加菜单和权限）

3. 权限配置

需要在系统中配置以下权限：

fiih:config:list - 查询权限
fiih:config:query - 详情权限
fiih:config:add - 新增权限
fiih:config:edit - 修改权限
fiih:config:remove - 删除权限
fiih:config:export - 导出权限

通道配置示例

{
  "name": "温度传感器",
  "type": "temperature",
  "unit": "℃",
  "range": [0, 100],
  "precision": 0.1,
  "alarm": {
    "high": 80,
    "low": 10
  },
  "description": "环境温度监测"
}

外部系统集成

🔌 外部接口使用

1. 无权限新增接口

POST /fiih/config/insert
Content-Type: application/json

{
  "fiihObjectName": "质量检测任务",
  "fiihTaskId": 1001,
  "fiihTaskName": "产品质量检测",
  "fiihLinkId": 2001,
  "fiihLinkName": "初检环节",
  "fiihLeaderId": 3001,
  "fiihLeaderName": "张三",
  "fiihStatus": 1,
  "tenantId": 1
}

2. 自动菜单创建

# 为任务创建菜单
POST /fiih/config/createMenu/1001

# 为环节创建菜单  
POST /fiih/config/createMenu/link/2001

🎯 集成场景

工作流系统集成：
- 工作流创建任务时，自动调用/insert接口创建FIIH配置
- 任务完成时，自动调用菜单创建接口生成详情页面
ERP系统集成：
- ERP生成质量检测任务时，同步创建FIIH配置
- 支持批量导入和状态同步
移动端集成：
- 移动端可直接调用无权限接口进行数据录入
- 支持二维码扫描快速创建配置

扩展开发

添加新字段

在实体类中添加属性
在Mapper.xml中添加字段映射
在Vue组件中添加表单项

自定义验证

在Service中添加验证逻辑
在前端添加表单验证规则

集成其他模块

可以与用户管理模块集成，实现负责人选择
可以与工作流模块集成，实现任务流程管理
可以与报表模块集成，实现数据统计分析

注意事项

JSON格式：通道配置必须是有效的JSON格式
文件上传：需要配置文件上传路径和权限
二维码生成：需要集成二维码生成库（如Google ZXing）
权限控制：确保正确配置用户权限
数据备份：定期备份配置数据

技术支持

如有问题，请联系开发团队或查看相关技术文档。

8.0 KiB Raw Permalink Blame History Unescape Escape