259 lines
8.0 KiB
Markdown
259 lines
8.0 KiB
Markdown
# 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. **数据备份**：定期备份配置数据
|
||
|
||
## 技术支持
|
||
|
||
如有问题，请联系开发团队或查看相关技术文档。
|