MES/yawei-mes/.tasks/2025-11-03_FIIH质量管理配置模块.md

# 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页面组件
```

## 数据库表结构

```sql
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. 部署后端

1. 将后端Java文件复制到对应目录：
   ```
   yjh-mes/src/main/java/cn/sourceplan/fiih/
   yjh-mes/src/main/resources/mapper/fiih/
   ```

2. 执行数据库建表SQL

3. 重启Spring Boot应用

### 2. 部署前端

1. 将前端文件复制到对应目录：
   ```
   mes-ui/src/api/mes/fiih/
   mes-ui/src/views/mes/fiih/
   ```

2. 配置路由（在router/index.js中添加）：
   ```javascript
   {
     path: '/fiih/config',
     component: () => import('@/views/mes/fiih/index'),
     name: 'FiihConfig',
     meta: { title: 'FIIH质量管理配置', icon: 'form' }
   }
   ```

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

### 3. 权限配置

需要在系统中配置以下权限：
- `fiih:config:list` - 查询权限
- `fiih:config:query` - 详情权限  
- `fiih:config:add` - 新增权限
- `fiih:config:edit` - 修改权限
- `fiih:config:remove` - 删除权限
- `fiih:config:export` - 导出权限

## 通道配置示例

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

## 外部系统集成

### 🔌 外部接口使用

#### 1. 无权限新增接口
```bash
POST /fiih/config/insert
Content-Type: application/json

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

#### 2. 自动菜单创建
```bash
# 为任务创建菜单
POST /fiih/config/createMenu/1001

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

### 🎯 集成场景

1. **工作流系统集成**：
   - 工作流创建任务时，自动调用`/insert`接口创建FIIH配置
   - 任务完成时，自动调用菜单创建接口生成详情页面

2. **ERP系统集成**：
   - ERP生成质量检测任务时，同步创建FIIH配置
   - 支持批量导入和状态同步

3. **移动端集成**：
   - 移动端可直接调用无权限接口进行数据录入
   - 支持二维码扫描快速创建配置

## 扩展开发

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

### 自定义验证
1. 在Service中添加验证逻辑
2. 在前端添加表单验证规则

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

## 注意事项

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

## 技术支持

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