docs: 新增和更新多个模块的文档
新增SPC模块、托盘登录、生产批次不良报表、设备监控、半成品管理、托盘管理、系统监控、批次管理、班组模型、电池工序管理、电池复投管理、批次托盘、系统助手、SPC采集模型、产品模型管理、物料模型管理、用户管理、菜单配置等文档内容 更新文档指南，添加系统功能清单
This commit is contained in:
sheng
@@ -19,7 +19,7 @@
|
||||
| 质量管理篇 | 质量追溯 | 首巡检管理、xqc管理、SPC相关| 升
|
||||
| 设备管理篇 | 设备管理 | 设备点检、设备保养、设备损耗品管理、设备状态管理、设备维修管理 | 涛
|
||||
| 报表分析篇 | 数据分析 | 基础追溯、生产报表 | 涛
|
||||
| scada管理篇 | scada管理 | edgemanager、EPS | 伟
|
||||
| scada管理篇 | scada管理 | edgemanager、EPS | 伟、叶
|
||||
| DAS篇 | DAS分析 | 设备首页、OEE推移分析、稼动分析、设备分析、品质分析 | 升 涛
|
||||
| 数据集成篇 | 系统集成 | 数据接口、系统集成方案 | 伟
|
||||
| 系统运维篇 | 系统管理 | 系统管理、系统运维 | 待定
|
||||
@@ -27,6 +27,30 @@
|
||||
| 附录篇 | 参考资料 | 术语表、流程图、更新日志 | 待定
|
||||
|
||||
|
||||
# 系统功能清单
|
||||
|
||||
| 一级模块 | 二级模块 | 三级模块 | 功能说明 | 备注 | 负责人 |
|
||||
| :--- | :--- | :--- | :--- | :--- | :--- |
|
||||
| **系统设置** | 用户管理 | 用户组 | 设置用户组别并且分配权限（增删改查用户组，以及实现权限分配功能） | | |
|
||||
| | | 管理人员 | 管理人员账号并且绑定对应的用户组 | | |
|
||||
| | 系统助手 | 操作日志 | 系统操作日志 | | |
|
||||
| | | 接口日志 | 与设备对接流程交互日志（可根据 IP 和接口名称等条件查询） | | |
|
||||
| **基础配置** | 所级模型 | 产线设置 | 管理产线（包括产线的增删改查） | | |
|
||||
| | | 所区设置 | 管理工厂（包括工厂的增删改查） | | |
|
||||
| | 工艺模型 | 工艺流程类别 | 工艺流程类别的增删改查功能 | | |
|
||||
| | | 工序单元 | 配置管理工序单元（节点），实现增删改查，对工序单元的结果参数采集预设和工艺参数预设 | | |
|
||||
| | | 工艺流程 | 设置电池生产工艺流程，实现工序卡的增删改查和流程卡的设定 | | |
|
||||
| | 产品管理 | 产品列表 | 产品管理页面实现产品的增删改查 | | |
|
||||
| | | 异常不良管理 | 设备不良信息以及产品 NG 信息的编码与描述管理，实现批量导入以及增删改查 | | |
|
||||
| | 设备类型 | 设备类别 | 管理设备种类并且实现设备种类的增删改查 | | |
|
||||
| | | 设备信息管理 | 管理每个设备信息并且实现设备的增删改查 | | |
|
||||
| | 物料模型 | 物料类别列表 | 区分原材料和半成品（固定编码） | | |
|
||||
| | | 物料信息管理 | 维护物料编码、名称、类别、单位、规格型号、BOM信息等基础属性 | | |
|
||||
| | | Bom物料清单 | 产品 BOM 管理 | | |
|
||||
| | | 计量单位 | 配置和管理计量单位，并且能够增删改查 | | |
|
||||
| | SPC采集模型 | SPC采集配置 | 配置结果参数采集参数 | | |
|
||||
|
||||
|
||||
## 3. 代码块
|
||||
|
||||
### 3.1
|
||||
|
||||
58
planning_production/batch_defect_report.md
Normal file
58
planning_production/batch_defect_report.md
Normal file
@@ -0,0 +1,58 @@
|
||||
# 生产批次不良报表
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
生产批次不良报表属于 MES 系统的质量分析模块，用于统计和分析生产批次中的不良品情况，为生产质量改进提供数据支持。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 不良统计：按批次维度统计不良品数量和不良率
|
||||
- 不良类型分析：区分电池类不良和外观类不良
|
||||
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 不良品 | Defective Item，生产过程中产生的质量异常产品 | 需要进行质量分析和处理 |
|
||||
| 不良率 | Defect Rate，不良品数量与总生产数量的比率 | 用于衡量生产质量水平 |
|
||||
|
||||
|
||||
## 3. 生产批次不良报表交互流程
|
||||
|
||||
### 3.1 不良报表列表
|
||||
|
||||
#### 3.1.1 不良报表列表说明
|
||||
|
||||
不良报表列表展示所有生产批次的的不良品统计信息，支持按多种条件查询和筛选。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 批次编号 | 生产批次的唯一标识 |
|
||||
| 产品型号 | 对应的产品型号 |
|
||||
| 总数量 | 批次总生产数量 |
|
||||
| 不良数量 | 批次中产生的不良品数量 |
|
||||
| 不良率 | 不良数量占总数量的百分比 |
|
||||
| 电池类不良数 | 电池类不良数量 |
|
||||
| 外观类不良数 | 外观类不良数量 |
|
||||
| 统计时间 | 报表统计时间 |
|
||||
|
||||
|
||||
#### 3.1.2 不良报表查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 批次编号 | 按批次编号精确查询 |
|
||||
| 生产时间 | 按统计时间范围筛选 |
|
||||
| 不良类型 | 按不良类型筛选（全部、电池类、外观类） |
|
||||
167
planning_production/batch_management.md
Normal file
167
planning_production/batch_management.md
Normal file
@@ -0,0 +1,167 @@
|
||||
# 批次管理
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
批次管理属于 MES 系统的核心模块，用于管理生产批次，实现生产任务的创建、跟踪和监控。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 批次管理：维护生产批次的新增、删除、修改、查询
|
||||
- 批次关联：关联工艺流程、产品型号、产区和产线
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 批次 | Production Batch，具有独立标识的生产单位 | 用于追踪和管理生产过程 |
|
||||
| 工艺流程 | Process Flow，生产工艺路线 | 定义产品的生产工艺步骤 |
|
||||
| 产品型号 | Product Model，产品规格型号 | 对应生产的产品种类 |
|
||||
| 计划预计完成日期 |计划完成时间 | 批次计划完成的时间 |
|
||||
| 计划预计完成数量 |计划完成数量 | 批次计划生产的数量 |
|
||||
|
||||
|
||||
|
||||
## 3. 数据模型关系说明
|
||||
|
||||
### 3.1 批次与其他实体关系
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph 批次
|
||||
B[批次]
|
||||
end
|
||||
|
||||
subgraph 基础数据
|
||||
F[工厂]
|
||||
L[产线]
|
||||
PF[工艺流程]
|
||||
PM[产品型号]
|
||||
end
|
||||
|
||||
B -->|关联| F
|
||||
B -->|关联| L
|
||||
B -->|关联| PF
|
||||
B -->|关联| PM
|
||||
```
|
||||
|
||||
**关系说明：**
|
||||
|
||||
| 关系类型 | 说明 |
|
||||
|---------|------|
|
||||
| 批次 → 工厂 | **N:1**：多个批次属于一个工厂 |
|
||||
| 批次 → 产线 | **N:1**：多个批次属于一条产线 |
|
||||
| 批次 → 工艺流程 | **N:1**：多个批次使用同一工艺流程 |
|
||||
| 批次 → 产品型号 | **N:1**：多个批次生产同一产品型号 |
|
||||
|
||||
|
||||
## 4. 批次管理交互流程
|
||||
|
||||
### 4.1 批次列表
|
||||
|
||||
#### 4.1.1 批次列表说明
|
||||
|
||||
批次列表展示所有生产批次信息，支持按多种条件查询和筛选。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 4.1.2 批次查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 批次编号 | 按批次编号精确查询 |
|
||||
| 产品型号 | 按产品型号筛选 |
|
||||
| 工厂 | 按工厂筛选 |
|
||||
| 产线 | 按产线筛选 |
|
||||
| 创建时间 | 按创建时间范围筛选 |
|
||||
|
||||
### 4.2 新增批次
|
||||
|
||||
#### 4.2.1 新增批次说明
|
||||
|
||||
创建新的生产批次，需要选择关联的基础数据和生产参数。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【批次管理】→【批次列表】
|
||||
2. 点击【新增】按钮
|
||||
3. 选择关联的工艺流程
|
||||
4. 选择产品型号
|
||||
5. 选择产区
|
||||
6. 选择产线
|
||||
7. 填写计划预计完成日期
|
||||
8. 填写计划预计完成数量
|
||||
9. 点击【确定】完成批次创建
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 批次号 | 批次的唯一标识代码，用户自定义 | 是 |
|
||||
| 工艺流程 | 批次使用的生产工艺路线 | 是 |
|
||||
| 产品型号 | 批次生产的产品规格 | 是 |
|
||||
| 产区 | 批次所属的产区 | 是 |
|
||||
| 产线 | 批次执行的产线 | 是 |
|
||||
| 预计完成日期 | 计划完成时间 | 是 |
|
||||
| 生产数量 | 计划生产数量 | 是 |
|
||||
| 批次状态 | 初始状态为"待生产" | 否 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
**【重要】** 批次编号创建后不允许修改，请在创建时仔细确认。
|
||||
**【重要】** 批次一旦开始生产，不允许删除。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
### 4.3 编辑批次
|
||||
|
||||
#### 4.3.1 编辑批次说明
|
||||
|
||||
修改批次信息，仅能编辑计划预计完成日期和计划预计完成数量。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【批次管理】→【批次列表】
|
||||
2. 在列表中找到需要编辑的批次
|
||||
3. 点击【编辑】按钮
|
||||
4. 修改需要更新的信息
|
||||
5. 点击【确定】完成修改
|
||||
|
||||
**【注意】** 已开始生产的批次不允许编辑基本信息，仅可更新备注信息。
|
||||
|
||||
### 4.4 删除批次
|
||||
|
||||
#### 4.4.1 删除批次说明
|
||||
|
||||
删除批次记录，仅未开始生产的批次可删除。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【批次管理】→【批次列表】
|
||||
2. 在列表中找到需要删除的批次
|
||||
3. 点击【删除】按钮
|
||||
4. 确认删除操作
|
||||
|
||||
**【注意】** 删除批次会将批次数据永久删除，无法恢复。
|
||||
|
||||
|
||||
|
||||
## 4.5.1. 电池批量登录
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【批次管理】→【批次列表】
|
||||
2. 点击【导入】按钮
|
||||
3. 按照模板格式填写电池数据
|
||||
4. 点击【选择文件】上传填写好的Excel文件
|
||||
5. 点击【开始导入】执行数据导入
|
||||
6. 查看导入结果报告
|
||||
|
||||
**【注意】** 导入前请确保关联的工艺流程、产品型号、工厂、产线已存在。
|
||||
|
||||
175
planning_production/batch_tray.md
Normal file
175
planning_production/batch_tray.md
Normal file
@@ -0,0 +1,175 @@
|
||||
# 批次托盘
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
批次托盘属于 MES 系统的核心模块，用于管理生产批次与托盘的关联关系，实现批次在生产过程中的物流跟踪和管理。托盘是承载物料的生产容器，批次托盘管理贯穿整个生产物流环节。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 批次托盘查询：查询批次与托盘的关联信息
|
||||
- 批次托盘详情：查看批次托盘的详细信息
|
||||
- 批次跟踪：跟踪批次在托盘上的流转状态
|
||||
- 解绑操作：解除批次与托盘的绑定关系
|
||||
- 停止操作：停止批次托盘的当前状态
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 批次托盘 | Batch Tray，批次与托盘的关联记录 | 记录批次货物所在的托盘信息 |
|
||||
| 托盘 | Tray，承载物料的容器 | 用于物料的存储和流转 |
|
||||
| 托盘激活状态 | Tray Activation Status，托盘是否激活 | 记录托盘的激活状态 |
|
||||
| 托盘编号 | Tray Number，托盘的唯一标识 | 每 个托盘都有唯一编号 |
|
||||
| 批次编号 | Batch，批次的唯一标识 | 用于追溯产品的生产信息 |
|
||||
| 解绑 | Unbind，解除批次与托盘的关联 | 当物料离开托盘时执行 |
|
||||
| 停止 | Stop，停止批次托盘的当前状态 | 暂停批次的进一步流转 |
|
||||
|
||||
|
||||
## 3. 数据模型关系说明
|
||||
|
||||
### 3.1 批次托盘电池层级关系
|
||||
|
||||
批次作为顶层实体，工序表示生产阶段，部分工序需要托盘运载电池，部分工序电池解绑后独立存在。
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph 批次
|
||||
subgraph 工序1["工序1(托盘运载)"]
|
||||
subgraph 托盘1
|
||||
Bat1[电池1]
|
||||
Bat2[电池2]
|
||||
end
|
||||
end
|
||||
subgraph 工序2["工序2（无需托盘）"]
|
||||
Bat3[电池3]
|
||||
Bat4[电池4]
|
||||
end
|
||||
end
|
||||
```
|
||||
|
||||
**关系说明：**
|
||||
|
||||
| 关系类型 | 说明 |
|
||||
|---------|------|
|
||||
| 批次 → 工序 | **1:N**：一个批次可包含多个工序 |
|
||||
| 工序 → 托盘 | **1:N**：一个工序可包含多个托盘（工序1有托盘） |
|
||||
| 托盘 → 电池 | **1:N**：一个托盘可包含多个电池 |
|
||||
| 工序 → 电池 | **1:N**：一个工序可直接包含多个电池（工序2无托盘） |
|
||||
|
||||
|
||||
### 3.2 电池托盘绑定方式
|
||||
|
||||
电池与托盘的绑定有两种方式，均可将电池和托盘绑定并登录到批次上：
|
||||
|
||||
| 绑定方式 | 接口 | 电池状态要求 | 说明 |
|
||||
|---------|------|------------|------|
|
||||
| 绑定接口 | `set_tray_binding` | 电池必须已激活 | 电池需处于激活状态，且与托盘属于同一批次 |
|
||||
| 登录接口 | `set_tray_login` | 电池无需激活 | 电池无需处于激活状态，即可绑定并登录到批次 |
|
||||
|
||||
|
||||
|
||||
## 4. 批次托盘交互流程
|
||||
|
||||
### 4.1 批次托盘列表
|
||||
|
||||
#### 4.1.1 批次托盘列表说明
|
||||
|
||||
批次托盘列表展示所有批次与托盘的关联信息，支持按多种条件查询和筛选。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 托盘编号 | 托盘的唯一标识代码 |
|
||||
| 流水号 | 批次托盘的流水号，用于唯一标识每次绑定 |
|
||||
| 托盘状态 | 当前托盘状态 |
|
||||
| 批次编号 | 关联的批次编号 |
|
||||
| 工艺流程名称 | 关联的工艺流程名称 |
|
||||
| 当前工序 | 托盘当前所在工序 |
|
||||
| 载入电池数量 | 托盘当前载入的电池数量 |
|
||||
| 登录时间 | 批次托盘登录时间 |
|
||||
|
||||
|
||||
#### 4.1.2 批次托盘查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 托盘号 | 按托盘编号精确查询 |
|
||||
| 批次号 | 按批次编号精确查询 |
|
||||
| 托盘激活状态 | 按状态筛选（激活、停止） |
|
||||
| 登录时间 | 按创建时间范围筛选 |
|
||||
|
||||
### 4.2 批次托盘详情
|
||||
|
||||
#### 4.2.1 详情查看说明
|
||||
|
||||
查看批次托盘的详细信息，包括托盘基本信息、工序的流转时间信息、工序流程设备、载入的电池数量、电池编号、电池位置、电池状态等。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【批次管理】→【批次托盘】
|
||||
2. 在列表中找到需要查看详情的批次托盘记录
|
||||
3. 点击【详情】按钮
|
||||
4. 查看批次托盘的完整信息
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 托盘编号 | 托盘的唯一标识代码 |
|
||||
| 工序开始时间 | 工序开始时间，用于记录工序开始的时间 |
|
||||
| 工序结束时间 | 工序结束时间，用于记录工序结束的时间 |
|
||||
| 当前工序 | 托盘当前所在工序 |
|
||||
| 序号 | 电池条码在托盘里的位置 |
|
||||
| 电池条码 | 电池的唯一标识代码 |
|
||||
| 电池激活状态 | 电池的当前状态，如激活、停用等 |
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
### 4.3 解绑操作
|
||||
|
||||
#### 4.3.1 解绑说明
|
||||
|
||||
解除批次与托盘的绑定关系，解绑后托盘状态会变成停止，但是电池状态不会改变。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【批次管理】→【批次托盘】
|
||||
2. 在列表中找到需要解绑的批次托盘记录
|
||||
3. 点击【解绑】按钮
|
||||
4. 点击【确定】完成解绑操作
|
||||
|
||||
**【重要】** 解绑操作不可逆，请在确认后执行。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
### 4.4 停止操作
|
||||
|
||||
#### 4.4.1 停止说明
|
||||
|
||||
停止托盘和电池的激活状态，暂停该托盘的进一步流转，用于处理异常情况。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【批次管理】→【批次托盘】
|
||||
2. 在列表中找到需要停止的批次托盘记录
|
||||
3. 点击【停止】按钮
|
||||
4. 点击【确定】完成停止操作
|
||||
|
||||
**【重要】** 停止操作不可逆，请在确认后执行。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
74
planning_production/device_monitoring.md
Normal file
74
planning_production/device_monitoring.md
Normal file
@@ -0,0 +1,74 @@
|
||||
# 设备监控
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
设备监控属于 MES 系统的生产监控模块，用于实时监控生产设备的设备状态。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 设备状态监控：实时监控设备的运行状态
|
||||
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 设备状态 | Device Status，设备的当前运行状态 | 包括运行、待机、故障等 |
|
||||
| 最后响应 | Last Response，设备的最后响应时间 | 设备上次上传设备状态的时间 |
|
||||
| 信息 | Information，设备的信息 | 设备的详细信息，如设备类型、关联产线等 |
|
||||
|
||||
|
||||
## 3. 设备监控交互流程
|
||||
|
||||
### 3.1 设备状态监控
|
||||
|
||||
#### 3.1.1 设备状态列表说明
|
||||
|
||||
设备状态列表展示所有设备的实时运行状态，支持按多种条件查询和筛选。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 设备编码 | 设备的唯一标识代码 |
|
||||
| 设备名称 | 设备的名称 |
|
||||
| 厂区 | 设备所属的厂区 |
|
||||
| 产线 | 设备所属的产线 |
|
||||
| 工作站 | 设备所属的工作站 |
|
||||
| 最后响应 | 设备的最后响应时间 |
|
||||
| 工作状态 | 设备的当前工作状态 |
|
||||
| 信息 | 异常状态下的异常信息 |
|
||||
|
||||
|
||||
#### 3.1.2 设备状态查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 设备编号 | 按设备编号精确查询 |
|
||||
| 设备名称 | 按设备名称模糊查询 |
|
||||
| 设备类型 | 按设备类型筛选 |
|
||||
| 运行状态 | 按运行状态筛选 |
|
||||
| 关联产线 | 按产线筛选 |
|
||||
|
||||
|
||||
## 3.1.3. 设备状态说明
|
||||
|
||||
| 状态 |状态编码| 说明 |
|
||||
|------|------|------|
|
||||
| 运行 | RUN | 设备正常运行中 |
|
||||
| 待机 | IDLE | 设备待机中 |
|
||||
| 异常 | TROUBLE | 设备出现异常 |
|
||||
| 手动 | MANUAL | 设备手动操作 |
|
||||
| 离线 | OFFLINE | 设备已离线 |
|
||||
| 完成 | FINISH | 设备已完成任务 |
|
||||
|
||||
**重要** 详细查看设备上传状态接口文档，了解设备状态的上传格式和内容。
|
||||
104
planning_production/material_monitoring.md
Normal file
104
planning_production/material_monitoring.md
Normal file
@@ -0,0 +1,104 @@
|
||||
# 半成品管理
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
半成品管理用于记录和查询生产过程中各工序产出的半成品信息，支持半成品的录入与追溯。
|
||||
|
||||
**主要功能：**
|
||||
|
||||
- 半成品数据录入：将各工序产出的半成品信息登记到系统中
|
||||
- 半成品列表查询：按批次号、半成品ID、工序单元、下料时间等条件检索半成品记录
|
||||
- 物料状态查看：查看半成品当前是"已完成"还是"未使用"状态
|
||||
|
||||
**对应功能截图**：
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 |
|
||||
|------|------|
|
||||
| 半成品 | 生产过程中各工序产出的中间物料 |
|
||||
| 半成品ID | 系统自动为每个半成品生成的唯一编号 |
|
||||
| 半成品编码 | 标识半成品物料类型的编码 |
|
||||
| 批次号 | 半成品所属的生产批次编号 |
|
||||
| 工序单元 | 产出该半成品的具体工序 |
|
||||
| 物料状态 | 半成品当前使用情况：已完成 / 未使用 |
|
||||
|
||||
## 3. 半成品管理交互流程
|
||||
|
||||
### 3.1 半成品列表
|
||||
|
||||
#### 3.1.1 列表说明
|
||||
|
||||
半成品列表展示所有已录入的半成品记录，默认按下料时间由近到远排列，支持分页浏览。
|
||||
|
||||
**对应功能截图**：
|
||||
|
||||
|
||||
**表格字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 批次号 | 半成品所属的生产批次编号 |
|
||||
| 半成品ID | 系统自动生成的唯一编号，格式为"工序属性-物料类别-物料编码-时间戳" |
|
||||
| 半成品编码 | 表示半成品物料类型的编码 |
|
||||
| 产出数量 | 该工序产出的半成品数量 |
|
||||
| 工序单元 | 产出该半成品的工序名称 |
|
||||
| 生产设备 | 生产该半成品所使用的设备编号 |
|
||||
| 物料状态 | 红色标签表示"已完成"，绿色标签表示"未使用" |
|
||||
| 下料时间 | 半成品产出完成的时间 |
|
||||
|
||||
#### 3.1.2 列表查询
|
||||
|
||||
可通过以下条件筛选半成品记录：
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 批次号 | 输入批次编号进行模糊搜索 |
|
||||
| 半成品ID | 输入半成品ID进行精确查找 |
|
||||
| 工序单元 | 从下拉列表中选择工序单元进行筛选 |
|
||||
| 下料时间 | 选择一个时间范围，查询该时间段内产出的半成品 |
|
||||
|
||||
### 3.2 录入半成品数据
|
||||
|
||||
#### 3.2.1 录入流程说明
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【计划生产】→【半成品管理】
|
||||
2. 点击表格上方的 **【录入半成品数据】** 按钮
|
||||
3. 在弹出的对话框中填写以下信息：
|
||||
|
||||
| 字段 | 必填 | 说明 |
|
||||
|------|------|------|
|
||||
| 生产批次 | 是 | 从下拉列表中选择关联的生产批次 |
|
||||
| 工序单元 | 是 | 从下拉列表中选择产出半成品的工序单元（选项根据所选批次自动联动） |
|
||||
| 设备编码 | 是 | 从下拉列表中选择生产设备编号 |
|
||||
| 产出数量 | 是 | 输入该工序的产出数量，最小为 1 |
|
||||
| 产出日期 | 否 | 选择半成品的产出日期 |
|
||||
|
||||
4. 填写完成后点击 **确定** 提交
|
||||
|
||||
#### 3.2.2 录入校验说明
|
||||
|
||||
| 校验项 | 规则 |
|
||||
|--------|------|
|
||||
| 生产批次 | 必填，必须从列表中选择 |
|
||||
| 工序单元 | 必填，必须从列表中选择 |
|
||||
| 产出数量 | 必填，须为大于 0 的数字 |
|
||||
|
||||
#### 3.2.3 录入处理过程
|
||||
|
||||
提交录入后，系统会自动执行以下处理：
|
||||
|
||||
1. **校验关联数据**：确认批次号存在、工序单元有效、该工序的物料产出配置已设置
|
||||
2. **生成半成品ID**：系统根据工序属性、物料类别、物料编码和当前时间自动生成唯一的半成品编号
|
||||
3. **计算后续工序**：根据工艺流程自动确定该半成品的下一个流转工序
|
||||
4. **保存数据**：将半成品信息写入系统，若任一步失败则自动回滚，保证数据一致性
|
||||
|
||||
## 4. 物料状态说明
|
||||
|
||||
| 状态 | 标签颜色 | 说明 |
|
||||
|------|---------|------|
|
||||
| 已完成 | 红色 | 该半成品已被后续工序使用 |
|
||||
| 未使用 | 绿色 | 该半成品尚未被后续工序使用 |
|
||||
142
planning_production/reject_management.md
Normal file
142
planning_production/reject_management.md
Normal file
@@ -0,0 +1,142 @@
|
||||
# 电池复投管理
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
电池复投管理用于将生产中产生的 NG（不良）电池重新激活，使其恢复正常生产状态，继续按工艺流程流转。
|
||||
|
||||
**主要功能：**
|
||||
|
||||
- 电池验证：输入电池条码，系统校验电池是否符合复投条件
|
||||
- 复投激活：将符合条件的 NG 电池重新激活，恢复为正常生产状态
|
||||
|
||||
**对应功能截图**：
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 |
|
||||
|------|------|
|
||||
| NG 电池 | 生产过程中因质量检测判定为不良的电池 |
|
||||
| 复投 | 将 NG 电池重新激活，使其恢复正常生产 |
|
||||
| 电池条码 | 电池的唯一标识编号 |
|
||||
| 激活状态 | 电池当前是否处于可流转生产的状态 |
|
||||
| 托盘 | 承载电池的生产容器 |
|
||||
| 批次 | 电池所属的生产批次 |
|
||||
|
||||
## 3. 电池复投逻辑流程
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant 用户
|
||||
participant 前端页面
|
||||
participant 后端服务
|
||||
participant Workerman
|
||||
|
||||
用户->>前端页面: 输入电池条码，点击验证数据
|
||||
前端页面->>后端服务: 请求验证电池信息
|
||||
|
||||
后端服务->>后端服务: 校验1: 电池是否存在于系统
|
||||
alt 电池不存在
|
||||
后端服务-->>前端页面: 提示电池不存在
|
||||
前端页面-->>用户: 展示异常信息
|
||||
end
|
||||
|
||||
后端服务->>后端服务: 校验2: 电池批次是否全部一致
|
||||
alt 批次不一致
|
||||
后端服务-->>前端页面: 提示批次不一致
|
||||
前端页面-->>用户: 展示异常信息
|
||||
end
|
||||
|
||||
后端服务->>后端服务: 校验3: 电池是否绑定激活中的托盘
|
||||
alt 托盘仍在激活中
|
||||
后端服务-->>前端页面: 提示托盘激活中
|
||||
前端页面-->>用户: 展示异常信息
|
||||
end
|
||||
|
||||
后端服务->>后端服务: 校验4: 电池是否为NG状态
|
||||
alt 不是NG电池
|
||||
后端服务-->>前端页面: 提示不是NG电池
|
||||
前端页面-->>用户: 展示异常信息
|
||||
end
|
||||
|
||||
后端服务->>后端服务: 校验5: 电池是否为未激活状态
|
||||
alt 电池已激活
|
||||
后端服务-->>前端页面: 提示电池已激活
|
||||
前端页面-->>用户: 展示异常信息
|
||||
end
|
||||
|
||||
后端服务-->>前端页面: 验证通过，返回电池详情
|
||||
前端页面-->>用户: 展示电池信息表格
|
||||
|
||||
用户->>前端页面: 核对信息，点击复投激活
|
||||
前端页面-->>用户: 弹出确认提示
|
||||
用户->>前端页面: 点击确定
|
||||
|
||||
前端页面->>Workerman: 发送复投激活指令
|
||||
Workerman->>Workerman: 复制电池数据生成新纪录
|
||||
Workerman->>Workerman: 清除NG标记和档位信息
|
||||
Workerman->>Workerman: 重新激活电池
|
||||
Workerman-->>前端页面: 返回激活成功
|
||||
前端页面-->>用户: 提示复投成功，电池恢复流转
|
||||
```
|
||||
|
||||
**关键验证规则：**
|
||||
|
||||
| 验证项 | 规则说明 |
|
||||
|--------|---------|
|
||||
| 电池是否存在 | 输入的每条电池条码必须在系统中存在 |
|
||||
| 批次一致性 | 所有输入的电池必须属于同一生产批次 |
|
||||
| 托盘状态 | 如果电池绑定在托盘上，托盘不能处于激活状态 |
|
||||
| NG 状态 | 电池必须带有 NG 标记，普通电池不可复投 |
|
||||
| 激活状态 | 电池当前必须处于未激活状态，已激活的电池不可复投 |
|
||||
|
||||
## 4. 操作步骤
|
||||
|
||||
### 4.1 验证电池
|
||||
|
||||
1. 进入【生产监控】→【电池复投管理】
|
||||
2. 在输入框中录入电池条码：
|
||||
- 方式一：直接在输入框中输入多个电池条码，以逗号分隔
|
||||
- 方式二：点击输入框右侧的 **📄** 按钮，在弹出的多行输入框中每行输入一个电池条码，点击确定
|
||||
3. 点击 **【验证数据】** 按钮
|
||||
4. 系统校验电池信息，校验通过后在下方表格展示电池详情
|
||||
|
||||
**表格字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 电池条码 | 电池的唯一标识编号 |
|
||||
| 批次 | 电池所属的生产批次 |
|
||||
| 托盘 | 电池绑定的托盘编号 |
|
||||
| 流水号 | 电池的生产流水号 |
|
||||
| 激活状态 | "激活"或"未激活" |
|
||||
| 档位类型 | 电池的档位分类 |
|
||||
| 档位 | 电池的档位信息 |
|
||||
| 上一工序 | 电池最近完成的工序 |
|
||||
| 当前工序 | 电池接下来要流转的工序 |
|
||||
|
||||
### 4.2 执行复投激活
|
||||
|
||||
1. 验证通过后，核对表格中的电池信息
|
||||
2. 点击 **【复投激活】** 按钮
|
||||
3. 系统弹出确认提示："确认后电池将激活，激活后只能从当前工序开始生产，不能重新做上一工序"
|
||||
4. 点击 **确定** 完成复投
|
||||
|
||||
**【重要】**：
|
||||
- 复投激活后，电池的 NG 标记会被清除，档位信息也会被清除
|
||||
- 电池激活后只能从当前工序继续流转，无法退回上一工序
|
||||
- 此操作不可逆，请在确认后执行
|
||||
|
||||
**对应功能截图**：
|
||||
|
||||
|
||||
## 5. 常见异常提示
|
||||
|
||||
| 提示信息 | 原因 | 处理建议 |
|
||||
|---------|------|---------|
|
||||
| 电池不存在 BATTERY_MAP 数据 | 电池条码输入错误或未在系统中登记 | 检查条码是否正确 |
|
||||
| 电池的批次与第一个不一致 | 输入了不同批次的电池 | 确保同一批次电池一起复投 |
|
||||
| 电池绑定的托盘仍在激活中 | 电池所在托盘还在生产中 | 等待托盘完成后再操作 |
|
||||
| 该条码必须是未激活状态且为 NG 电池 | 电池不满足复投条件 | 只有 NG 且未激活的电池才能复投 |
|
||||
| 电池在批次中是激活的，不需要重新激活 | 电池已经是激活状态 | 无需操作 |
|
||||
| 电池没有 NG 信息，不是 NG 电池 | 电池为正常品 | 正常电池无需复投 |
|
||||
208
planning_production/technology_process.md
Normal file
208
planning_production/technology_process.md
Normal file
@@ -0,0 +1,208 @@
|
||||
# 电池工序管理
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
电池工序管理属于 MES 系统的生产监控模块，用于管理电池在生产过程中的工序流转，实现工序的增加、删除、修改、查询等操作。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 工序管理：维护工序的基本信息和配置
|
||||
- 工序查询：查询电池当前所在工序及工序历史
|
||||
- 工序调整：调整电池的当前工序
|
||||
- 工序记录：记录电池的工序流转历史
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 电池工序 | Battery Process，电池在生产中的加工步骤 | 定义电池的生产加工流程 |
|
||||
| 工序顺序 | Process Sequence，工序的执行顺序 | 电池按照顺序流经各工序 |
|
||||
| 工序时间 | Process Time，电池在工序的时间节点 | 包括开始时间、结束时间 |
|
||||
|
||||
|
||||
## 3. 数据模型关系说明
|
||||
|
||||
### 3.1 电池工序管理与其他实体关系
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph 电池
|
||||
Bat[电池]
|
||||
end
|
||||
|
||||
subgraph 批次
|
||||
B[批次]
|
||||
end
|
||||
|
||||
subgraph 工序
|
||||
P[工序]
|
||||
end
|
||||
|
||||
subgraph 工序记录
|
||||
PR[工序记录]
|
||||
end
|
||||
|
||||
PR -->|关联| Bat
|
||||
PR -->|关联| B
|
||||
PR -->|属于| P
|
||||
```
|
||||
|
||||
**关系说明：**
|
||||
|
||||
| 关系类型 | 说明 |
|
||||
|---------|------|
|
||||
| 工序记录 → 电池 | **N:1**：多个工序记录对应一块电池 |
|
||||
| 工序记录 → 批次 | **N:1**：多个工序记录对应一个批次 |
|
||||
| 工序记录 → 工序 | **N:1**：多个工序记录对应同一工序 |
|
||||
|
||||
|
||||
## 4. 电池工序管理交互流程
|
||||
|
||||
### 4.1 电池工序列表
|
||||
|
||||
#### 4.1.1 电池工序列表说明
|
||||
|
||||
电池工序列表展示所有电池的工序流转信息，支持按多种条件查询和筛选。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 电池编号 | 电池的唯一标识代码 |
|
||||
| 批次编号 | 关联的批次编号 |
|
||||
| 当前工序 | 电池当前所在工序 |
|
||||
| 上一工序 | 电池上一工序 |
|
||||
| 下一工序 | 电池下一工序 |
|
||||
| 进入时间 | 电池进入当前工序的时间 |
|
||||
| 工序状态 | 当前工序的处理状态 |
|
||||
|
||||
|
||||
#### 4.1.2 电池工序查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 电池编号 | 按电池编号精确查询 |
|
||||
| 批次编号 | 按批次编号精确查询 |
|
||||
| 当前工序 | 按当前工序筛选 |
|
||||
| 工序状态 | 按工序状态筛选 |
|
||||
|
||||
|
||||
### 4.2 工序管理
|
||||
|
||||
#### 4.2.1 新增工序说明
|
||||
|
||||
为电池添加新的工序记录。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【电池工序管理】
|
||||
2. 点击【新增工序】按钮
|
||||
3. 扫描或输入电池编号
|
||||
4. 选择工序
|
||||
5. 填写工序信息
|
||||
6. 点击【确定】完成新增
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 电池编号 | 电池的唯一标识代码 | 是 |
|
||||
| 工序 | 选择要添加的工序 | 是 |
|
||||
| 开始时间 | 工序开始时间 | 是 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
|
||||
#### 4.2.2 删除工序说明
|
||||
|
||||
删除电池的工序记录。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【电池工序管理】
|
||||
2. 在列表中找到需要删除的电池工序记录
|
||||
3. 点击【删除】按钮
|
||||
4. 确认删除信息
|
||||
5. 点击【确定】完成删除
|
||||
|
||||
**【重要】** 删除操作不可逆，请在确认后执行。
|
||||
|
||||
|
||||
#### 4.2.3 修改工序说明
|
||||
|
||||
修改电池的工序信息。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【电池工序管理】
|
||||
2. 在列表中找到需要修改的电池工序记录
|
||||
3. 点击【编辑】按钮
|
||||
4. 修改工序信息
|
||||
5. 点击【确定】完成修改
|
||||
|
||||
|
||||
### 4.3 工序调整
|
||||
|
||||
#### 4.3.1 工序调整说明
|
||||
|
||||
调整电池的当前工序，实现工序间的跳转。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【电池工序管理】
|
||||
2. 在列表中找到需要调整的电池记录
|
||||
3. 点击【调整工序】按钮
|
||||
4. 选择目标工序
|
||||
5. 填写调整原因
|
||||
6. 点击【确定】完成调整
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 电池编号 | 电池的唯一标识代码 | 是 |
|
||||
| 当前工序 | 电池当前所在工序 | 是 |
|
||||
| 目标工序 | 调整后的目标工序 | 是 |
|
||||
| 调整原因 | 选择或填写调整原因 | 是 |
|
||||
|
||||
|
||||
### 4.4 工序流转历史
|
||||
|
||||
#### 4.4.1 流转历史说明
|
||||
|
||||
查看电池的完整工序流转历史记录。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【电池工序管理】
|
||||
2. 在列表中找到需要查看历史的电池记录
|
||||
3. 点击【流转历史】按钮
|
||||
4. 查看电池的完整工序流转轨迹
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 工序名称 | 工序的名称 |
|
||||
| 进入时间 | 进入该工序的时间 |
|
||||
| 离开时间 | 离开该工序的时间 |
|
||||
| 工序结果 | 该工序的处理结果 |
|
||||
| 操作人 | 执行操作的人员 |
|
||||
|
||||
|
||||
## 5. 工序状态说明
|
||||
|
||||
| 状态 | 说明 |
|
||||
|------|------|
|
||||
| 待处理 | 电池等待该工序处理 |
|
||||
| 处理中 | 电池正在该工序处理 |
|
||||
| 已完成 | 电池已完成该工序处理 |
|
||||
| 异常 | 电池在该工序出现异常 |
|
||||
54
planning_production/tray_login.md
Normal file
54
planning_production/tray_login.md
Normal file
@@ -0,0 +1,54 @@
|
||||
# 托盘登录
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
托盘登录属于 MES 系统的生产监控模块，用于将托盘和电池登录到生产线，记录托盘的登录状态并支持查询托盘的相关信息。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 托盘登录：执行托盘登录操作
|
||||
- 托盘解绑：将托盘和电池的绑定关系解绑。
|
||||
- 托盘停止：将托盘和电池的激活状态设置为停止，结束托盘和电池的流转。
|
||||
- 托盘编码格式：支持用户自定义，验证用户输入的托盘条码格式是否正确。
|
||||
- 电池编码格式：支持用户自定义，验证用户输入的电池条码格式是否正确。
|
||||
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 托盘登录 | Tray Login，托盘进入生产线 | 托盘开始在生产线上运作 |
|
||||
| 登录状态 | Login Status，托盘是否已登录 | 记录托盘的登录状态 |
|
||||
|
||||
|
||||
## 3. 托盘登录交互流程
|
||||
|
||||
### 3.1 托盘登录操作
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【托盘登录】
|
||||
2. 选择批次号
|
||||
3. 选择托盘与电池格式编码
|
||||
4. 扫描或输入托盘编号
|
||||
5. 扫描或输入电池编号
|
||||
6. 点击登录按钮
|
||||
7. 点击【确定】完成登录操作
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 通道 | 托盘登录的通道 |
|
||||
| 电池ID | 扫描或输入的电池ID |
|
||||
| 上一个批次 | 托盘上登录的批次编号 |
|
||||
| 上一个托盘 | 托盘上登录的托盘编号 |
|
||||
| 电池已完成工序 | 电池是否已完成当前工序 |
|
||||
|
||||
|
||||
|
||||
|
||||
178
planning_production/tray_management.md
Normal file
178
planning_production/tray_management.md
Normal file
@@ -0,0 +1,178 @@
|
||||
# 托盘管理
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
托盘管理属于 MES 系统的生产监控模块，用于管理生产过程中的托盘，实现托盘的工序调整、停止、状态查询以及托盘绑定的电池查询等功能。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 托盘状态查询：查询托盘的当前状态
|
||||
- 托盘工序调整：调整托盘所在的工序
|
||||
- 托盘停止操作：停止托盘的当前状态
|
||||
- 托盘电池查询：查询托盘绑定的电池信息
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 托盘 | Tray，承载物料的容器 | 用于物料的存储和流转 |
|
||||
| 托盘状态 | Tray Status，托盘的当前状态 | 包括空闲、使用中、已停止等 |
|
||||
| 托盘工序 | Tray Process，托盘所在的工序 | 托盘当前所处的生产工序 |
|
||||
|
||||
|
||||
## 3. 数据模型关系说明
|
||||
|
||||
### 3.1 托盘管理与其他实体关系
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph 托盘
|
||||
T[托盘]
|
||||
end
|
||||
|
||||
subgraph 批次
|
||||
B[批次]
|
||||
end
|
||||
|
||||
subgraph 工序
|
||||
P[工序]
|
||||
end
|
||||
|
||||
subgraph 电池
|
||||
Bat[电池]
|
||||
end
|
||||
|
||||
T -->|属于| B
|
||||
T -->|位于| P
|
||||
T -->|承载| Bat
|
||||
```
|
||||
|
||||
**关系说明：**
|
||||
|
||||
| 关系类型 | 说明 |
|
||||
|---------|------|
|
||||
| 托盘 → 批次 | **N:1**：多个托盘属于一个批次 |
|
||||
| 托盘 → 工序 | **N:1**：多个托盘位于同一工序 |
|
||||
| 托盘 → 电池 | **1:N**：一个托盘可承载多个电池 |
|
||||
|
||||
|
||||
## 4. 托盘管理交互流程
|
||||
|
||||
#### 4.1 托盘查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 托盘编号 | 按托盘编号精确查询 |
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【托盘管理】
|
||||
2. 输入托盘编号
|
||||
3. 点击【查询】按钮
|
||||
4. 查看托盘的详细信息
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 托盘编号 | 托盘的唯一标识代码 |
|
||||
| 托盘状态 | 当前托盘状态 |
|
||||
| 批次 | 关联的批次编号 |
|
||||
| LOT | 托盘流水号 |
|
||||
| 投入电池 | 托盘绑定的电池数量 |
|
||||
| 投入时间 | 托盘登录的时间 |
|
||||
| 上一工序 | 托盘上一个工序编号 |
|
||||
| 当前工序 | 托盘当前所在工序 |
|
||||
| 状态 | 托盘当前状态，激活/停止 |
|
||||
| 整盘NG | 托盘是否整盘NG |
|
||||
|
||||
|
||||
### 4.2 托盘工序调整
|
||||
|
||||
#### 4.2.1 工序调整说明
|
||||
|
||||
调整托盘所在的工序，实现托盘在工序间的转移。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【托盘管理】
|
||||
2. 输入托盘编号
|
||||
3. 点击【查询】按钮
|
||||
4. 在左侧工序列表中选择目标工序
|
||||
5. 点击【确定】完成工序调整
|
||||
|
||||
**【重要】** 工序调整可能影响生产流程，请在确认后执行。
|
||||
|
||||
|
||||
### 4.3 托盘停止
|
||||
|
||||
#### 4.3.1 托盘停止说明
|
||||
|
||||
停止托盘的当前状态，暂停托盘的进一步流转。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【托盘管理】
|
||||
2. 输入托盘编号
|
||||
3. 点击【查询】按钮
|
||||
4. 点击【停止托盘】按钮
|
||||
5. 点击【确定】完成停止操作
|
||||
|
||||
**【重要】** 停止托盘会将电池和托盘的状态改为停止状态，无法继续流转。
|
||||
|
||||
### 4.4 托盘电池查询
|
||||
|
||||
#### 4.4.1 电池查询说明
|
||||
|
||||
查询托盘上绑定的电池信息，了解托盘承载的具体电池。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【托盘管理】
|
||||
2. 输入托盘编号
|
||||
3. 点击【查询】按钮
|
||||
4. 查看托盘绑定的电池列表
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| 电池编号 | 电池的唯一标识代码 |
|
||||
| 电池位置 | 电池在托盘中的位置 |
|
||||
| 电池激活状态 | 电池的激活状态，激活/停止/NG |
|
||||
|
||||
|
||||
## 4.5 整盘NG处理
|
||||
|
||||
标记托盘为整盘NG，记录托盘的NG信息。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【托盘管理】
|
||||
2. 输入托盘编号
|
||||
3. 点击【查询】按钮
|
||||
4. 点击【标记NG盘】按钮
|
||||
5. 点击【确定】完成标记操作
|
||||
|
||||
**【重要】** 标记NG盘后，托盘的状态会改为NG状态，物流线通过接口get_process_route 获取托盘为整盘NG信息。
|
||||
|
||||
## 4.6 清除托盘NG
|
||||
|
||||
清除托盘的NG标记，将托盘里电池的NG状态恢复为正常状态。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产监控】→【托盘管理】
|
||||
2. 输入托盘编号
|
||||
3. 点击【查询】按钮
|
||||
4. 点击【清除NG盘】按钮
|
||||
5. 点击【确定】完成清除操作
|
||||
|
||||
**【重要】** 清除NG盘后，托盘里的NG电池会恢复为正常状态，但是生产日志不会被清除。
|
||||
|
||||
146
production_configuration/Organization.md
Normal file
146
production_configuration/Organization.md
Normal file
@@ -0,0 +1,146 @@
|
||||
# 班组模型
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
班组模型属于 MES 系统的基础模块，用于构建企业的生产班组、生产班次、生产成员数据，为生产排班提供组织基础数据支撑。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 班组管理：维护生产班组的新增、删除、修改、查询
|
||||
- 排班计划管理：维护生产排班的新增、删除、修改、查询
|
||||
- 排班日历：查看生产排班的时间规划和排班信息
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
| ---- | -------------------------- | ----------- |
|
||||
| 班组 | Production Team，生产作业组织单元 | 用于组织和管理生产人员 |
|
||||
| 班组成员 | Production Members，班组的组成人员 | 属于某个班组的操作人员 |
|
||||
| 排班计划 | Production Schedule，班组的排班计划 | 定义班组的工作时间和任务分配 |
|
||||
| 轮班方式 | Rotation Schedule，班组的排班方式 | 如轮班、固定排班等 |
|
||||
| 休息日选择 | Rest Day Schedule，班组的休息日选择 | 定义哪些天是休息天 |
|
||||
|
||||
|
||||
**关系说明：**
|
||||
|
||||
| 关系类型 | 说明 |
|
||||
| --------- | ------------------------ |
|
||||
| 班组 → 班次 | **1 对 N**：一个班组可以包含多个班次 |
|
||||
| 班组 → 生产成员 | **1 对 N**：一个班组可以包含多个生产成员 |
|
||||
|
||||
## 3. 班组模型交互流程
|
||||
|
||||
### 3.1 班组管理
|
||||
|
||||
#### 3.1.1 班组说明
|
||||
|
||||
班组是生产作业的基本组织单元，用于编入生产人员。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.1.2 新增班组
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【班组模型】→【班组管理】
|
||||
2. 点击【新增】按钮
|
||||
3. 填写班组基本信息
|
||||
4. 添加班组成员
|
||||
5. 点击【确定】完成班组创建
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
| ---- | ------------------- | -- |
|
||||
| 班组名称 | 班组的名称，如"包装班组" | 是 |
|
||||
| 所属厂区 | 班组所属的生产厂区，如"工厂A" | 是 |
|
||||
| 所属产线 | 班组所属的生产产线，如"包装线" | 是 |
|
||||
|
||||
|
||||
**【重要】** 班组编码创建后不允许修改，请在创建时仔细确认。
|
||||
**【重要】** 班组被工单引用后，不允许删除。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.1.3 班组查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
| ---- | --------- |
|
||||
| 班组名称 | 按班组名称模糊查询 |
|
||||
| 所属厂区 | 按班组所属厂区筛选 |
|
||||
| 所属产线 | 按班组所属产线筛选 |
|
||||
| 创建时间 | 按班组创建时间筛选 |
|
||||
|
||||
### 3.2 排班计划
|
||||
|
||||
#### 3.2.1 排班计划说明
|
||||
|
||||
排班计划是班组工作时间的基本划分，用于管理生产作业的时间安排。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.2.2 新增排班计划
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【班组模型】→【排班计划】
|
||||
2. 点击【新增】按钮
|
||||
3. 填写排班计划基本信息
|
||||
4. 点击【确定】完成排班计划创建
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
| ---- | --------------------- | -- |
|
||||
| 排班名称 | 排班计划的名称，如"早班"、"中班"、"晚班" | 是 |
|
||||
| 排班编码 | 排班计划的唯一标识代码 | 是 |
|
||||
| 排班时间范围 | 排班计划的时间范围，如"9:00-17:00" | 是 |
|
||||
| 状态 | 排班计划的状态，如"启用"、"禁用" | 否 |
|
||||
| 班组 | 排班计划里包含的班组 | 否 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
**【重要】** 排班计划编码创建后不允许修改。
|
||||
**【重要】** 排班计划被排班记录引用后，不允许删除。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
#### 3.2.3 排班计划查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
| ---- | --------- |
|
||||
| 排班编码 | 按排班编码精确查询 |
|
||||
| 排班名称 | 按排班名称模糊查询 |
|
||||
| 创建时间 | 按排班计划创建时间筛选 |
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.2.4 排班计划导入
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【班组模型】→【排班计划】
|
||||
2. 点击【导入】按钮
|
||||
3. 上传排班计划文件
|
||||
4. 点击【确定】完成排班计划导入
|
||||
|
||||
#### 3.2.4 排班计划导出
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【班组模型】→【排班计划】
|
||||
2. 点击【导出】按钮
|
||||
3. 选择导出格式（如Excel）
|
||||
4. 点击【确定】完成排班计划导出
|
||||
208
production_configuration/SPC_configuration.md
Normal file
208
production_configuration/SPC_configuration.md
Normal file
@@ -0,0 +1,208 @@
|
||||
# SPC采集模型
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
SPC采集模型属于 MES 系统的基础模块，用于配置工序单元的结果参数采集点位，实现对生产过程数据的实时采集与监控。SPC（Statistical Process Control）为统计过程控制，用于监控生产过程的稳定性。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- SCADA点位绑定：配置工序单元与采集点位的关联关系
|
||||
- 采集参数管理：管理采集点位的数据采集参数
|
||||
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| SPC | 统计过程控制 | 用于监控生产过程的稳定性 |
|
||||
| SCADA | 数据采集与监控系统 | 用于实时数据采集和监控 |
|
||||
| 数据类型 | 采集数据的类型 | 包括首巡检数据、结果数据 |
|
||||
| 结果参数 | 工序单元的结果参数 | 定义工序执行后的产出数据 |
|
||||
| 首巡检数据 | 首件检验数据 | 生产首件产品的检验数据 |
|
||||
|
||||
|
||||
## 3. 数据模型关系说明
|
||||
|
||||
### 3.1 SPC采集配置组成
|
||||
|
||||
一个完整的SPC采集配置由以下四要素组成：
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
subgraph SPC采集配置要素
|
||||
direction TB
|
||||
A[工序单元] --> B[SPC采集配置]
|
||||
C[数据类型] --> B
|
||||
D[SCADA点位] --> B
|
||||
end
|
||||
|
||||
B --> E[保存到对应数据表]
|
||||
```
|
||||
|
||||
| 要素 | 说明 | 示例 |
|
||||
|------|------|------|
|
||||
| 工序单元 | 配置针对哪个工序 | 电芯装配工序 |
|
||||
| 数据类型 | 数据的业务类型 | 首巡检数据 / 结果数据 |
|
||||
| SCADA点位 | 数据的来源点位 | TEMP_001 |
|
||||
|
||||
### 3.2 数据类型与数据表对应关系
|
||||
|
||||
数据类型决定了数据保存到哪张表：
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph 数据类型
|
||||
DT1["首巡检数据<br/>（First Inspection）"]
|
||||
DT2["结果数据<br/>（Result Data）"]
|
||||
end
|
||||
|
||||
subgraph 对应数据表
|
||||
T1["首巡检数据表<br/>保存首件检验的数据"]
|
||||
T2["结果参数表<br/>保存工序结果的数据"]
|
||||
end
|
||||
|
||||
DT1 -->|"数据类型=首巡检"| T1
|
||||
DT2 -->|"数据类型=结果"| T2
|
||||
```
|
||||
|
||||
### 3.3 采集入口说明
|
||||
|
||||
SCADA数据采集只有一个入口接口 `set_node_data`，有4个调用方：
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph SCADA采集入口
|
||||
A[set_node_data 接口]
|
||||
end
|
||||
|
||||
subgraph 调用方
|
||||
B[EdgeMange]
|
||||
C[EPS]
|
||||
D[MES内部调用]
|
||||
E[设备调用]
|
||||
end
|
||||
|
||||
B --> A
|
||||
C --> A
|
||||
D --> A
|
||||
E --> A
|
||||
|
||||
style D fill:#90EE90
|
||||
```
|
||||
|
||||
| 调用方 | 说明 | 与SPC配置关系 |
|
||||
|-------|------|--------------|
|
||||
| EdgeMange | 边缘管理器推送 | 不使用SPC配置 |
|
||||
| EPS | EPS系统推送 | 不使用SPC配置 |
|
||||
| MES内部调用 | MES内部业务调用 | **使用SPC配置** |
|
||||
| 设备调用 | 设备直接调用 | 不使用SPC配置 |
|
||||
|
||||
**本功能配置的即为"MES内部调用"的采集规则。**
|
||||
|
||||
### 3.4 MES内部调用采集流程
|
||||
|
||||
当MES内部业务调用 `set_node_data` 接口时，SPC采集配置决定数据保存位置：
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant MES业务 as MES内部业务
|
||||
participant SCADA as set_node_data 接口
|
||||
participant SPC配置 as SPC采集配置
|
||||
participant DB as 数据库
|
||||
|
||||
MES业务->>SCADA: 调用set_node_data<br/>参数：点位编码、采集值
|
||||
SCADA->>SPC配置: 根据点位编码查询配置
|
||||
SPC配置-->>SCADA: 返回：工序单元、数据类型、SCADA点位
|
||||
SCADA->>DB: 根据数据类型保存到对应数据表
|
||||
DB-->>SCADA: 保存成功
|
||||
SCADA-->>MES业务: 返回结果
|
||||
```
|
||||
|
||||
### 3.5 配置示例
|
||||
|
||||
| 配置编号 | 工序单元 | 数据类型 | 数据表 | SCADA点位 |
|
||||
|---------|---------|---------|-------|----------|
|
||||
| 配置1 | 电芯装配工序 | 首巡检数据 | 首巡检数据表 | TEMP_001 |
|
||||
| 配置2 | 电芯装配工序 | 结果数据 | 结果参数表 | PRESS_001 |
|
||||
| 配置3 | 化成工序 | 结果数据 | 结果参数表 | VOLT_001 |
|
||||
|
||||
|
||||
## 4. SPC采集模型交互流程
|
||||
|
||||
### 4.1 SCADA点位绑定
|
||||
|
||||
#### 4.1.1 点位绑定说明
|
||||
|
||||
点位绑定是建立工序单元与SCADA采集点位之间的关联关系，实现生产数据的自动采集。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 4.1.2 新增点位绑定
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【SPC采集模型】→【SCADA点位绑定】
|
||||
2. 点击【新增】按钮
|
||||
3. 选择需要绑定的工序单元
|
||||
4. 选择或配置SCADA采集点位
|
||||
5. 设置采集参数
|
||||
6. 点击【保存】完成点位绑定
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 工序单元 | 需要绑定点位的工序单元 | 是 |
|
||||
| 点位编码 | SCADA系统的点位编码 | 是 |
|
||||
| 点位名称 | 点位的描述名称 | 是 |
|
||||
| 数据类型 | 点位的数据类型，如"数值"、"开关" | 是 |
|
||||
| 采集频率 | 数据采集的频率，单位为秒 | 是 |
|
||||
| 状态 | 启用/禁用 | 否 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
**【重要】** 点位编码必须与SCADA系统中配置一致，否则无法正常采集数据。
|
||||
**【重要】** 同一工序单元不能重复绑定相同的点位编码。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 4.1.3 编辑点位绑定
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【SPC采集模型】→【SCADA点位绑定】
|
||||
2. 在列表中找到需要编辑的绑定记录
|
||||
3. 点击【编辑】按钮
|
||||
4. 修改需要更新的信息
|
||||
5. 点击【保存】完成修改
|
||||
|
||||
**【注意】** 已采集的历史数据不受影响。
|
||||
|
||||
#### 4.1.4 删除点位绑定
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【SPC采集模型】→【SCADA点位绑定】
|
||||
2. 在列表中找到需要删除的绑定记录
|
||||
3. 点击【删除】按钮
|
||||
4. 确认删除操作
|
||||
|
||||
**【注意】** 删除点位绑定后，该点位的后续数据将停止采集，已采集数据保留。
|
||||
|
||||
#### 4.1.5 点位绑定查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 工序单元 | 按工序单元筛选 |
|
||||
| 点位编码 | 按点位编码精确查询 |
|
||||
| 点位名称 | 按点位名称模糊查询 |
|
||||
| 状态 | 按启用/禁用状态筛选 |
|
||||
| 创建时间 | 按创建时间范围筛选 |
|
||||
|
||||
300
production_configuration/material_model.md
Normal file
300
production_configuration/material_model.md
Normal file
@@ -0,0 +1,300 @@
|
||||
# 物料模型管理
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
物料模型管理属于 MES 系统的基础模块，用于构建企业的物料分类、物料基本信息和 BOM 物料清单等核心数据，为生产计划、物料采购、仓库管理、成本核算等业务模块提供物料基础数据支撑。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 物料类别列表：维护物料的分类体系，按物料类型进行分类管理
|
||||
- 物料信息管理：维护物料的基本信息、物料属性、计量单位等
|
||||
- BOM物料清单：维护产品的物料构成清单，定义产品与物料的用量关系
|
||||
- 计量单位：定义物料的数量计量标准单位，如个、件、千克、米等
|
||||
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 物料类别 | Material Category，对物料进行分类管理的单元 | 用于区分不同类型的物料 |
|
||||
| 物料信息 | Material Information，物料的基本属性和特征 | 包括物料编码、名称、规格、单位等 |
|
||||
| 物料清单 | BOM，Bill of Materials，产品构成清单 | 定义产品与物料的用量关系 |
|
||||
| 计量单位 | Unit of Measure，计量物料数量的标准单位 | 如个、件、千克、米等，属于物料信息的属性 |
|
||||
| 物料编码 | Material Code，物料的唯一标识代码 | 物料管理系统中的唯一编号 |
|
||||
|
||||
**数据模型关系说明：**
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph 物料类别列表
|
||||
MCA[物料类别A]
|
||||
MCB[物料类别B]
|
||||
end
|
||||
|
||||
subgraph 物料信息管理
|
||||
MI1[物料信息1]
|
||||
MI2[物料信息2]
|
||||
MI3[物料信息3]
|
||||
end
|
||||
|
||||
subgraph BOM物料清单
|
||||
BOM1[BOM物料清单A]
|
||||
BOM2[BOM物料清单B]
|
||||
end
|
||||
|
||||
MCA -->|1:N| MI1
|
||||
MCA -->|1:N| MI2
|
||||
MCB -->|1:N| MI3
|
||||
|
||||
BOM1 ---|N:M| MI1
|
||||
BOM1 ---|N:M| MI2
|
||||
BOM2 ---|N:M| MI2
|
||||
BOM2 ---|N:M| MI3
|
||||
```
|
||||
|
||||
**关系说明：**
|
||||
|
||||
| 关系类型 | 说明 |
|
||||
|---------|------|
|
||||
| 物料类别列表 → 物料信息管理 | **1 对 N**：一个物料类别可以包含多个物料信息 |
|
||||
| BOM物料清单 ↔ 物料信息管理 | **N 对 M**：一个BOM可以引用多个物料，一个物料可被多个BOM引用 |
|
||||
| 物料信息管理 → 计量单位 | **属性**：计量单位是物料信息的属性之一 |
|
||||
|
||||
**简化关系图：**
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
A[物料类别列表] -->|1:N| B[物料信息管理]
|
||||
C[BOM物料清单] -.->|N:M| B
|
||||
|
||||
B -->|包含| D[计量单位]
|
||||
B -->|包含| E[物料规格]
|
||||
B -->|包含| F[物料属性]
|
||||
```
|
||||
|
||||
|
||||
## 3. 物料模型交互流程
|
||||
|
||||
### 3.1 物料类别列表管理
|
||||
|
||||
#### 3.1.1 物料类别说明
|
||||
|
||||
物料类别是对物料进行分类管理的单元，用于区分不同类型的物料，便于物料的检索和维护。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.1.2 新增物料类别
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【物料模型】→【物料类别列表】
|
||||
2. 点击【新增】按钮
|
||||
3. 填写基本信息
|
||||
4. 点击【保存】完成类别创建
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 物料类别编码 | 类别的唯一标识代码 | 是 |
|
||||
| 物料类别名称 | 类别的名称，如"原材料"、"半成品" | 是 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
**【重要】** 物料类别编码一旦启用不允许修改和删除，请在创建时仔细确认。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.1.3 物料类别查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 物料类别编码 | 按物料类别编码精确查询 |
|
||||
| 物料类别名称 | 按物料类别名称模糊查询 |
|
||||
| 上级类别 | 按上级类别筛选 |
|
||||
|
||||
### 3.2 物料信息管理
|
||||
|
||||
#### 3.2.1 物料信息说明
|
||||
|
||||
物料信息是描述物料基本属性和特征的核心数据，包括物料编码、名称、计量单位等，是企业物料管理的基础。
|
||||
|
||||
**物料信息特点：**
|
||||
|
||||
- 唯一性：每个物料有唯一的物料编码
|
||||
- 规范性：物料信息有统一的数据规范和标准
|
||||
- 关联性：物料信息可被BOM、工单、仓库等模块引用
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.2.2 新增物料信息
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【物料模型】→【物料信息管理】
|
||||
2. 点击【新增】按钮
|
||||
3. 填写物料基本信息
|
||||
4. 点击【保存】完成物料信息创建
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 物料编码 | 物料的唯一标识代码 | 是 |
|
||||
| 物料名称 | 物料的名称 | 是 |
|
||||
| 物料类别 | 关联的物料类别 | 是 |
|
||||
| 计量单位 | 物料的计量单位，如个、件、千克等 | 是 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
**【注意】** 物料编码创建后不允许修改，请在创建时仔细确认。
|
||||
**【重要】** 物料信息被BOM或其他单据引用后，不允许删除。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.2.3 物料信息查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 物料编码 | 按物料编码精确查询 |
|
||||
| 物料名称 | 按物料名称模糊查询 |
|
||||
| 物料类别 | 按物料类别筛选 |
|
||||
| 物料类型 | 按物料类型筛选 |
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
### 3.3 BOM物料清单管理
|
||||
|
||||
#### 3.3.1 BOM物料清单说明
|
||||
|
||||
BOM物料清单是定义产品与物料构成关系的核心数据，记录产品由哪些物料组成、各物料的用量比例关系。BOM是生产计划、物料采购、成本核算的重要依据。
|
||||
|
||||
**BOM物料清单特点：**
|
||||
|
||||
- 层级性：支持多层级BOM，体现产品的装配结构
|
||||
- 用量关系：明确各层级的物料用量和比例
|
||||
- 版本管理：支持BOM版本变更和历史追溯
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.3.2 新增BOM物料清单
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【物料模型】→【BOM物料清单】
|
||||
2. 点击【新增】按钮
|
||||
3. 填写BOM基本信息
|
||||
4. 点击【保存】完成BOM创建
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| BOM版本编码 | BOM的唯一标识代码 | 是 |
|
||||
| BOM版本名称 | BOM的名称，如"产品A的物料清单" | 是 |
|
||||
| 产品编码 | 关联的产品型号 | 是 |
|
||||
| 状态 | 状态：启用、禁用 | 是 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
**【重要】** BOM被生产工单引用后，不允许删除。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.3.3 设置BOM
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【物料模型】→【BOM物料清单】
|
||||
2. 选择要设置的BOM，点击【设置BOM】按钮
|
||||
3. 选择对应的工序，在IN/OUT中配置物料信息和投入数量
|
||||
|
||||
|
||||
**BOM子项字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| IN/OUT | 工序的投料和产出品 | 是 |
|
||||
| 物料类别 | 引用的物料类别 | 是 |
|
||||
| 物料编码 | 引用的物料编码 | 是 |
|
||||
| 物料名称 | 引用的物料名称 | 是 |
|
||||
| 投入数量 | 生产一个产品该物料的用量 | 是 |
|
||||
| 单位 | 物料用量的计量单位 | 是 |
|
||||
|
||||
**【注意】** 同一BOM中不允许出现相同的物料编码。
|
||||
**【注意】** BOM子项的用量单位应与物料信息的计量单位一致。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.3.4 BOM物料清单查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| BOM编码 | 按BOM编码精确查询 |
|
||||
| BOM名称 | 按BOM名称模糊查询 |
|
||||
| 产品型号 | 按产品型号筛选 |
|
||||
|
||||
|
||||
### 3.4 计量单位管理
|
||||
|
||||
#### 3.4.1 计量单位说明
|
||||
|
||||
计量单位是物料信息的属性之一，用于标准化工物料数量的计量。系统预置常用的计量单位，同时支持用户自定义计量单位。
|
||||
|
||||
**常用计量单位类型：**
|
||||
|
||||
- 数量单位：个、件、只、支、台、套
|
||||
- 重量单位：千克、克、吨、磅
|
||||
- 长度单位：米、厘米、毫米、英寸
|
||||
- 体积单位：升、毫升、立方米
|
||||
- 面积单位：平方米、平方厘米
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.4.2 新增计量单位
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【物料模型】→【计量单位】
|
||||
2. 点击【新增】按钮
|
||||
3. 填写计量单位基本信息
|
||||
4. 点击【保存】完成计量单位创建
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 单位编码 | 单位的唯一标识代码 | 是 |
|
||||
| 单位名称 | 单位的名称，如"个"、"千克" | 是 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
**【注意】** 系统预置的计量单位不允许修改和删除。
|
||||
**【重要】** 计量单位被物料信息引用后，不允许删除。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.4.3 计量单位查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 单位编码 | 按单位编码精确查询 |
|
||||
| 单位名称 | 按单位名称模糊查询 |
|
||||
| 单位类型 | 按单位类型筛选 |
|
||||
228
production_configuration/product_model.md
Normal file
228
production_configuration/product_model.md
Normal file
@@ -0,0 +1,228 @@
|
||||
# 产品模型管理
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
产品模型管理属于 MES 系统的基础模块，用于构建企业的产品分类、产品基本信息、异常不良类别等核心数据，为生产计划、工单执行、品质管理等业务模块提供产品基础数据支撑。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 产品列表：维护产品的基本信息，支持产品的分类管理和多层级产品结构
|
||||
- 异常不良管理：维护产品的异常不良类别，绑定设备类别，用于生产过程中的品质异常记录
|
||||
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 产品列表 | Product List，记录产品的基本信息和分类 | 用于生产执行和品质管理的基础数据 |
|
||||
| 异常不良 | Abnormal/Defect，生产过程中出现的异常情况 | 包括NG（不合格）和ERR（错误）类型 |
|
||||
| 异常不良类别 | Defect Category，对异常不良进行分类管理 | 用于区分不同类型的异常 |
|
||||
| 设备类别 | Device Category，对设备进行分类管理 | 异常不良绑定设备类别，用于特定设备的异常记录 |
|
||||
| NG | Not Good，不合格品 | 生产过程中判定为不合格的产品 |
|
||||
| ERR | Error，错误 | 系统或设备运行时出现的错误信息 |
|
||||
|
||||
**数据模型关系说明：**
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph 产品列表
|
||||
P1[产品]
|
||||
P2[产品]
|
||||
end
|
||||
|
||||
subgraph 工艺流程
|
||||
PF1[工艺流程A]
|
||||
PF2[工艺流程B]
|
||||
end
|
||||
|
||||
subgraph 异常不良管理
|
||||
D1[NG不良类别]
|
||||
D2[ERR错误类别]
|
||||
end
|
||||
|
||||
subgraph 设备类别
|
||||
DC1[设备类别]
|
||||
DC2[设备类别]
|
||||
end
|
||||
|
||||
P1 -->|1:N| PF1
|
||||
P2 -->|1:N| PF2
|
||||
|
||||
DC1 -->|1:N| D1
|
||||
DC2 -->|1:N| D2
|
||||
```
|
||||
|
||||
**关系说明：**
|
||||
|
||||
| 关系类型 | 说明 |
|
||||
|---------|------|
|
||||
| 产品列表 → 工艺流程 | **1 对 N**：一个产品可以配置多个工艺流程 |
|
||||
| 设备类别 → 异常不良管理 | **1 对 N**：一个设备类别可以配置多个异常不良类别 |
|
||||
|
||||
|
||||
## 3. 产品模型交互流程
|
||||
|
||||
### 3.1 产品列表管理
|
||||
|
||||
#### 3.1.1 产品列表说明
|
||||
|
||||
产品列表是记录产品基本信息的核心数据，包括产品型号、产品名称等，是企业生产执行和品质管理的基础。
|
||||
|
||||
**产品列表特点：**
|
||||
|
||||
- 关联性：产品信息可被工艺流程
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.1.2 新增产品
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【产品模型】→【产品列表】
|
||||
2. 点击【新增】按钮
|
||||
3. 填写产品基本信息
|
||||
4. 点击【保存】完成产品创建
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 产品型号 | 产品的唯一标识代码 | 是 |
|
||||
| 产品名称 | 产品的名称 | 是 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
**【重要】** 产品型号创建后不允许修改，请在创建时仔细确认。
|
||||
**【重要】** 产品被工艺流程或工单引用后，不允许删除。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.1.3 产品查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 产品型号 | 按产品型号精确查询 |
|
||||
| 产品名称 | 按产品名称模糊查询 |
|
||||
| 产品分类 | 按产品分类筛选 |
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
### 3.2 异常不良管理
|
||||
|
||||
#### 3.2.1 异常不良管理说明
|
||||
|
||||
异常不良管理是用于记录生产过程中出现的异常情况，包括NG（不合格品）和ERR（错误）两种类型。异常不良类别绑定设备类别，用于特定设备工序的异常记录。
|
||||
|
||||
**异常不良类型：**
|
||||
|
||||
| 类型 | 说明 |
|
||||
|------|------|
|
||||
| NG | Not Good，不合格品，生产过程中判定为不合格的产品 |
|
||||
| ERR | Error，错误，系统或设备运行时出现的错误信息 |
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.2.2 新增异常不良类别
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【产品模型】→【异常不良管理】
|
||||
2. 点击【新增】按钮
|
||||
3. 选择异常类型（NG/ERR）
|
||||
4. 填写异常不良类别信息
|
||||
5. 选择绑定的设备类别
|
||||
6. 点击【保存】完成异常不良类别创建
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 异常类别编码 | 异常类别的唯一标识代码 | 是 |
|
||||
| 异常类别名称 | 异常类别的名称，如"短路"、"开路" | 是 |
|
||||
| 异常类型 | NG（不合格）/ ERR（错误） | 是 |
|
||||
| 设备类别 | 绑定的设备类别，用于特定设备的异常记录 | 是 |
|
||||
| 备注 | 其他补充说明信息 | 否 |
|
||||
|
||||
**【重要】** 异常类别编码创建后不允许修改。
|
||||
**【重要】** 异常不良类别被使用后，不允许删除。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.2.3 异常不良类别查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 异常类别编码 | 按异常类别编码精确查询 |
|
||||
| 异常类别名称 | 按异常类别名称模糊查询 |
|
||||
| 异常类型 | 按异常类型筛选：NG / ERR |
|
||||
| 设备类别 | 按绑定的设备类别筛选 |
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.2.4 导入异常不良类别
|
||||
|
||||
导入功能支持批量导入异常不良类别数据，提高数据维护效率。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【产品模型】→【异常不良管理】
|
||||
2. 点击【导入】按钮
|
||||
3. 下载导入模板
|
||||
4. 按照模板格式填写异常不良类别数据
|
||||
5. 点击【选择文件】上传填写好的Excel文件
|
||||
6. 点击【开始导入】执行数据导入
|
||||
7. 查看导入结果报告
|
||||
|
||||
**导入模板字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 | 示例 |
|
||||
|------|------|------|------|
|
||||
| 异常类别编码 | 异常类别的唯一标识代码 | 是 | NG-001 |
|
||||
| 异常类别名称 | 异常类别的名称 | 是 | 短路 |
|
||||
| 异常类型 | NG（不合格）/ ERR（错误） | 是 | NG |
|
||||
| 设备类别编码 | 绑定的设备类别编码 | 是 | DEV-SMT |
|
||||
| 备注 | 其他补充说明信息 | 否 | - |
|
||||
|
||||
**【注意】** 导入前请确保设备类别已存在。
|
||||
**【提示】** 建议先导入少量数据进行验证，确认格式正确后再进行大批量导入。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
#### 3.2.5 批量删除异常不良类别
|
||||
|
||||
批量删除功能支持一次删除多个异常不良类别，提高数据清理效率。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【生产配置】→【产品模型】→【异常不良管理】
|
||||
2. 在列表中勾选需要删除的异常不良类别（可多选）
|
||||
3. 点击【批量删除】按钮
|
||||
4. 在弹出的确认对话框中确认删除
|
||||
5. 点击【确定】执行批量删除
|
||||
|
||||
**【注意】** 已使用的异常不良类别不允许删除。
|
||||
**【注意】** 删除操作不可恢复，请在删除前仔细确认。
|
||||
**【提示】** 建议在删除前先查询该类别是否已被工单或异常记录引用。
|
||||
|
||||
**功能对应截图** ：
|
||||
|
||||
|
||||
### 3.3 异常不良管理说明
|
||||
|
||||
异常不良管理独立于产品和工艺流程，仅与设备类别存在绑定关系。异常不良类别用于记录设备在生产过程中出现的异常情况。
|
||||
|
||||
**【重要】** 异常不良管理不与工艺流程关联，而是直接与设备类别绑定。
|
||||
**【重要】** 多个异常不良类别可以绑定同一个设备类别，实现异常分类的统一管理。
|
||||
8
quality_control/spc.md
Normal file
8
quality_control/spc.md
Normal file
@@ -0,0 +1,8 @@
|
||||
# SPC模块
|
||||
|
||||
## 1. 功能概述
|
||||
- SPC模块是 MES 系统的质量控制模块，用于对产线上的首巡检数据、过程数据、结果数据输出SPC报表。
|
||||
|
||||
|
||||
**核心功能：**
|
||||
- SPC渲染条件配置：根据不同的SPC报表类型，配置不同的渲染条件，如时间范围、产品类型等。
|
||||
219
system_settings/menu_configuration.md
Normal file
219
system_settings/menu_configuration.md
Normal file
@@ -0,0 +1,219 @@
|
||||
# 菜单管理
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
菜单管理模块用于配置系统的菜单结构，支持后台管理端和PDA端的菜单配置，实现菜单的增删改查、排序和权限关联功能。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 菜单树形结构管理：支持多层级菜单的创建、编辑和删除
|
||||
- 菜单分类管理：区分后台(admin)和PDA模块的菜单
|
||||
- 菜单状态控制：支持菜单的启用/禁用操作
|
||||
- 菜单排序：支持拖拽排序，调整菜单显示顺序
|
||||
- 菜单权限关联：新增菜单自动关联超级管理员角色
|
||||
- 菜单导航属性：控制菜单是否在导航栏显示
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
#### 2.1.1 菜单相关术语
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 顶层菜单 | 没有上级菜单的菜单节点 | 作为菜单树的根节点 |
|
||||
| 子菜单 | 有上级菜单的菜单节点 | 可多级嵌套 |
|
||||
| 模块 | 菜单所属的系统模块 | admin(后台)、pda(PDA端) |
|
||||
| 导航属性 | 菜单是否在导航栏显示 | 可见(1)或隐藏(0) |
|
||||
| 链接类型 | 菜单链接的类型 | 模块(0)或外链(1) |
|
||||
| 打开方式 | 链接的打开方式 | 当前窗口(_self)或新窗口(_blank) |
|
||||
|
||||
## 3. 菜单管理操作
|
||||
|
||||
### 3.1 菜单查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 模块 | 选择后台(admin)或PDA模块 |
|
||||
| 状态 | 筛选启用或禁用状态的菜单 |
|
||||
| 导航属性 | 筛选可见或隐藏的菜单 |
|
||||
| 菜单深度 | 控制菜单树的展开层级 |
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【系统设置】→【菜单管理】→【菜单配置】
|
||||
2. 在顶部查询区域选择查询条件
|
||||
3. 点击【查询】按钮获取菜单列表
|
||||
4. 点击【重置】按钮清空查询条件
|
||||
|
||||
### 3.2 新增菜单
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【系统设置】→【菜单管理】→【菜单配置】
|
||||
2. 点击【新增顶层菜单】按钮，或在已有菜单上点击【新增】按钮添加子菜单
|
||||
3. 填写菜单表单信息
|
||||
4. 点击【确定】完成新增
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 上级菜单 | 选择父菜单，不选择表示顶层菜单 | 否 |
|
||||
| 名称 | 菜单的显示名称 | 是 |
|
||||
| 别名 | 菜单的别名标识，API类型菜单必填 | 否 |
|
||||
| 图标 | 菜单图标，可选择或自定义 | 否 |
|
||||
| 排序 | 菜单的排序序号，数值越小越靠前 | 是 |
|
||||
| 导航 | 控制菜单是否在导航栏显示 | 是 |
|
||||
| 链接类型 | 模块(0)或外链(1) | 是 |
|
||||
| 打开方式 | 当前窗口或新窗口 | 是 |
|
||||
| URL | 菜单链接地址 | 否 |
|
||||
| 参数 | 链接参数 | 否 |
|
||||
| 备注 | 菜单的备注说明 | 否 |
|
||||
|
||||
**【提示】** 新增菜单时，系统会自动将其关联到超级管理员角色。
|
||||
|
||||
### 3.3 编辑菜单
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在菜单树中点击需要编辑的菜单节点
|
||||
2. 在右侧表单中修改菜单信息
|
||||
3. 点击【修改】按钮保存更改
|
||||
|
||||
**【注意】** 菜单名称在同一模块内不能重复。
|
||||
|
||||
### 3.4 删除菜单
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在菜单树中找到需要删除的菜单
|
||||
2. 点击菜单右侧的【删除】按钮
|
||||
3. 在确认对话框中点击【确定】
|
||||
|
||||
**【重要】** 如果该菜单或其子级菜单正在被角色使用，则无法删除。
|
||||
|
||||
### 3.5 启用/禁用菜单
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在菜单树中找到需要操作的菜单
|
||||
2. 点击菜单右侧的【禁用】或【启用】按钮
|
||||
3. 在确认对话框中点击【确定】
|
||||
|
||||
**【注意】** 状态切换会影响该菜单及其所有子级菜单。
|
||||
|
||||
### 3.6 菜单排序
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在菜单树中拖拽菜单节点到目标位置
|
||||
2. 系统自动保存排序结果
|
||||
|
||||
**支持的拖拽操作：**
|
||||
- 拖拽到同级菜单的前面或后面
|
||||
- 拖拽到其他菜单下作为子菜单
|
||||
|
||||
## 4. 后台API接口
|
||||
|
||||
### 4.1 接口列表
|
||||
|
||||
| API路径 | 方法 | 功能描述 | 所属文件 |
|
||||
|---------|------|---------|---------|
|
||||
| `/api/background/v1/system_settings/menu_configuration/menu/all` | GET | 获取用户权限内的菜单列表 | MenuService.php:58 |
|
||||
| `/api/background/v1/system_settings/menu_configuration/menu/list` | GET | 获取菜单列表(带筛选条件) | MenuService.php:124 |
|
||||
| `/api/background/v1/system_settings/menu_configuration/menu/create` | POST | 创建新菜单 | MenuService.php:186 |
|
||||
| `/api/background/v1/system_settings/menu_configuration/menu/edit` | POST | 编辑菜单信息 | MenuService.php:250 |
|
||||
| `/api/background/v1/system_settings/menu_configuration/menu/delete` | POST | 删除菜单 | MenuService.php:307 |
|
||||
| `/api/background/v1/system_settings/menu_configuration/menu/update_status` | POST | 更新菜单状态 | MenuService.php:328 |
|
||||
| `/api/background/v1/system_settings/menu_configuration/menu/update_sort` | POST | 更新菜单排序 | MenuService.php:352 |
|
||||
|
||||
### 4.2 数据模型
|
||||
|
||||
**菜单表字段：**
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| id | int | 菜单唯一标识 |
|
||||
| parent_id | int | 父菜单ID |
|
||||
| name | varchar | 菜单名称 |
|
||||
| alias | varchar | 菜单别名 |
|
||||
| icon | varchar | 菜单图标 |
|
||||
| is_navi | tinyint | 是否导航显示(0/1) |
|
||||
| module | varchar | 所属模块(admin/pda) |
|
||||
| params | varchar | 链接参数 |
|
||||
| remark | varchar | 备注说明 |
|
||||
| sort | int | 排序序号 |
|
||||
| status | tinyint | 状态(0禁用/1启用) |
|
||||
| target | varchar | 打开方式 |
|
||||
| type | tinyint | 链接类型(0模块/1外链) |
|
||||
| url | varchar | 链接地址 |
|
||||
|
||||
## 5. 前端组件结构
|
||||
|
||||
### 5.1 组件目录
|
||||
|
||||
```
|
||||
menu_configuration/
|
||||
└── menu/
|
||||
├── components/
|
||||
│ ├── PageHeader/
|
||||
│ │ └── index.vue # 查询条件头部组件
|
||||
│ └── PageMain/
|
||||
│ └── index.vue # 主内容区域组件
|
||||
└── index.vue # 页面入口组件
|
||||
```
|
||||
|
||||
### 5.2 核心组件功能
|
||||
|
||||
| 组件 | 功能 | 关键特性 |
|
||||
|------|------|---------|
|
||||
| PageHeader | 查询条件面板 | 支持模块切换、状态筛选、导航属性筛选 |
|
||||
| PageMain | 菜单树和表单 | 树形展示、拖拽排序、增删改操作 |
|
||||
|
||||
## 6. 权限控制
|
||||
|
||||
菜单管理涉及以下权限点：
|
||||
|
||||
| 权限标识 | 权限名称 | 说明 |
|
||||
|---------|---------|------|
|
||||
| `/system_settings/menu_configuration/menu/create` | 新增菜单 | 允许创建新菜单 |
|
||||
| `/system_settings/menu_configuration/menu/edit` | 编辑菜单 | 允许修改菜单信息 |
|
||||
| `/system_settings/menu_configuration/menu/delete` | 删除菜单 | 允许删除菜单 |
|
||||
| `/system_settings/menu_configuration/menu/disabled_enable` | 启用/禁用菜单 | 允许切换菜单状态 |
|
||||
|
||||
## 7. 数据流程图
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[用户请求] --> B{是否超级管理员}
|
||||
B -->|是| C[查询全部菜单]
|
||||
B -->|否| D[查询角色关联菜单]
|
||||
C --> E[返回菜单列表]
|
||||
D --> E
|
||||
E --> F[前端渲染树形结构]
|
||||
F --> G[用户操作]
|
||||
G --> H{操作类型}
|
||||
H -->|新增| I[校验名称唯一性]
|
||||
H -->|编辑| J[校验名称唯一性]
|
||||
H -->|删除| K[检查角色使用情况]
|
||||
H -->|状态切换| L[检查角色使用情况]
|
||||
I --> M[保存菜单数据]
|
||||
J --> M
|
||||
K --> N{是否被使用}
|
||||
L --> N
|
||||
N -->|是| O[提示错误信息]
|
||||
N -->|否| P[执行操作]
|
||||
M --> Q[关联超级管理员]
|
||||
Q --> R[返回结果]
|
||||
P --> R
|
||||
O --> R
|
||||
```
|
||||
|
||||
## 8. 注意事项
|
||||
|
||||
**【重要】** 删除或禁用菜单前，请确保该菜单未被任何角色使用，否则操作将失败。
|
||||
|
||||
**【提示】** 建议定期整理菜单结构，保持菜单树的清晰性和逻辑性。
|
||||
|
||||
**【注意】** 菜单排序数值越小，显示越靠前，默认值为50。
|
||||
183
system_settings/system_assistant.md
Normal file
183
system_settings/system_assistant.md
Normal file
@@ -0,0 +1,183 @@
|
||||
# 系统助手
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
系统助手模块提供系统操作日志和接口日志的查询功能，帮助管理员追踪系统操作记录和设备对接流程的交互日志。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 操作日志查询：记录用户的系统操作行为，支持按用户、IP、时间等条件查询
|
||||
- 接口日志查询：记录与设备对接的接口交互日志，支持按IP、接口名称等条件查询
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
#### 2.1.1 日志相关术语
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 操作日志 | 用户在系统中的操作记录 | 包括登录、增删改查等操作 |
|
||||
| 接口日志 | 系统与外部设备/系统的交互记录 | 包括设备对接、数据传输等 |
|
||||
| 托盘号(tray) | 设备托盘的唯一标识 | 用于设备对接追踪 |
|
||||
| 批次号(batch) | 生产批次的唯一标识 | 用于生产流程追踪 |
|
||||
| 接口状态码 | 接口调用的返回状态 | 0表示成功，4001/4002表示失败 |
|
||||
|
||||
## 3. 操作日志
|
||||
|
||||
### 3.1 操作日志查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 用户 | 按用户ID筛选操作记录 |
|
||||
| IP地址 | 按操作IP地址筛选 |
|
||||
| 路由名称 | 按访问的路由名称筛选 |
|
||||
| 托盘号 | 按托盘号筛选相关操作 |
|
||||
| 批次号 | 按批次号筛选相关操作 |
|
||||
| 时间范围 | 按操作时间范围筛选，默认最近一周 |
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【系统设置】→【系统助手】→【操作日志】
|
||||
2. 在顶部查询区域设置查询条件
|
||||
3. 点击【查询】按钮获取操作日志列表
|
||||
|
||||
### 3.2 操作日志字段说明
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| ID | 日志唯一标识 |
|
||||
| 用户名 | 执行操作的用户 |
|
||||
| 请求路径 | 访问的URL路径 |
|
||||
| 控制器方法 | 执行的控制器和方法 |
|
||||
| IP地址 | 操作来源IP |
|
||||
| 状态 | 操作状态 |
|
||||
| 请求参数 | 传入的参数 |
|
||||
| 执行结果 | 返回的结果 |
|
||||
| 操作类型 | 操作的类型 |
|
||||
| 操作名称 | 操作的中文名称 |
|
||||
| 托盘号 | 关联的托盘号 |
|
||||
| 批次号 | 关联的批次号 |
|
||||
| 操作时间 | 操作发生时间 |
|
||||
|
||||
### 3.3 日志记录内容
|
||||
|
||||
系统会自动记录以下类型的操作：
|
||||
|
||||
- 用户登录/登出
|
||||
- 数据新增、编辑、删除
|
||||
- 状态变更
|
||||
- 权限配置
|
||||
- 系统设置修改
|
||||
|
||||
## 4. 接口日志
|
||||
|
||||
### 4.1 接口日志查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 设备单元 | 按设备单元名称筛选 |
|
||||
| IP地址 | 按客户端IP地址筛选 |
|
||||
| 工序代码 | 按工序代码筛选 |
|
||||
| 托盘号 | 按托盘号筛选 |
|
||||
| 电池ID | 按电池ID筛选 |
|
||||
| 时间范围 | 按交互时间范围筛选，默认最近一周 |
|
||||
| 状态 | 筛选成功或失败的接口调用 |
|
||||
| 来源类别 | 筛选ERP/SPC来源的接口 |
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【系统设置】→【系统助手】→【接口日志】
|
||||
2. 在顶部查询区域设置查询条件
|
||||
3. 点击【查询】按钮获取接口日志列表
|
||||
|
||||
### 4.2 接口日志字段说明
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| ID | 日志唯一标识 |
|
||||
| 设备单元 | 设备单元名称 |
|
||||
| 客户端IP | 调用接口的设备IP |
|
||||
| 数据1 | 通常存储工序代码 |
|
||||
| 数据2 | 通常存储托盘号 |
|
||||
| 数据3 | 通常存储电池ID |
|
||||
| 创建时间 | 日志记录时间 |
|
||||
| 接口时间 | 接口调用时间 |
|
||||
| 状态 | 接口调用状态(0成功，4001/4002失败) |
|
||||
| 类别 | 接口类别(erp/spc等) |
|
||||
| 类型 | 接口类型 |
|
||||
| 请求参数 | 接口传入参数 |
|
||||
| 返回结果 | 接口返回结果 |
|
||||
| 数据4 | 扩展字段1 |
|
||||
| 数据5 | 扩展字段2 |
|
||||
|
||||
### 4.3 接口状态码说明
|
||||
|
||||
| 状态码 | 说明 |
|
||||
|--------|------|
|
||||
| 0 | 接口调用成功 |
|
||||
| 4001 | 接口调用失败 |
|
||||
| 4002 | 接口超时 |
|
||||
|
||||
## 5. 后台API接口
|
||||
|
||||
### 5.1 操作日志接口
|
||||
|
||||
| API路径 | 方法 | 功能描述 | 所属文件 |
|
||||
|---------|------|---------|---------|
|
||||
| `/api/background/v1/system_settings/system_assistant/operate_log/list` | GET | 获取操作日志列表 | OperateLogService.php:31 |
|
||||
|
||||
### 5.2 接口日志接口
|
||||
|
||||
| API路径 | 方法 | 功能描述 | 所属文件 |
|
||||
|---------|------|---------|---------|
|
||||
| `/api/background/v1/system_settings/system_assistant/interface_log/list` | GET | 获取接口日志列表 | InterfaceLogService.php:31 |
|
||||
|
||||
## 6. 数据模型
|
||||
|
||||
### 6.1 操作日志表
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| id | int | 日志唯一标识 |
|
||||
| user_id | int | 用户ID |
|
||||
| username | varchar | 用户名 |
|
||||
| path | varchar | 请求路径 |
|
||||
| controller_action | varchar | 控制器和方法 |
|
||||
| ip | varchar | 操作IP |
|
||||
| status | tinyint | 操作状态 |
|
||||
| params | text | 请求参数(JSON) |
|
||||
| result | text | 返回结果(JSON) |
|
||||
| action | varchar | 操作类型 |
|
||||
| action_name | varchar | 操作名称 |
|
||||
| tray | varchar | 托盘号 |
|
||||
| batch | varchar | 批次号 |
|
||||
| create_time | datetime | 创建时间 |
|
||||
|
||||
### 6.2 接口日志表
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| id | int | 日志唯一标识 |
|
||||
| unit | varchar | 设备单元 |
|
||||
| client_ip | varchar | 客户端IP |
|
||||
| data1 | varchar | 数据字段1(工序代码) |
|
||||
| data2 | varchar | 数据字段2(托盘号) |
|
||||
| data3 | varchar | 数据字段3(电池ID) |
|
||||
| data4 | varchar | 数据字段4 |
|
||||
| data5 | varchar | 数据字段5 |
|
||||
| create_time | datetime | 创建时间 |
|
||||
| insterface_time | datetime | 接口调用时间 |
|
||||
| status | int | 接口状态码 |
|
||||
| class | varchar | 接口类别 |
|
||||
| type | varchar | 接口类型 |
|
||||
| params | text | 请求参数(JSON) |
|
||||
| result | text | 返回结果(JSON) |
|
||||
|
||||
## 7. 注意事项
|
||||
|
||||
**【提示】** 操作日志和接口日志默认只保留最近一周的数据，如需查看更早的数据，请调整时间范围。
|
||||
|
||||
**【注意】** 接口日志中的数据字段(data1-data5)用途根据接口类型不同而有所差异，具体含义需要结合业务场景理解。
|
||||
119
system_settings/system_monitoring.md
Normal file
119
system_settings/system_monitoring.md
Normal file
@@ -0,0 +1,119 @@
|
||||
# 系统监控
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
系统监控模块用于配置和管理系统监控参数，实现对服务器资源的实时监控和告警设置。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 监控配置管理：创建、编辑、删除监控配置
|
||||
- 资源告警设置：配置CPU、磁盘、内存的告警阈值
|
||||
- 监控刷新设置：配置监控数据的刷新间隔
|
||||
- 监控列表查询：支持按名称和编号筛选
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
#### 2.1.1 监控相关术语
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 监控编号 | 监控配置的唯一标识 | 用于区分不同的监控目标 |
|
||||
| 刷新间隔 | 监控数据更新的时间间隔 | 单位通常为秒 |
|
||||
| CPU告警阈值 | CPU使用率的告警界限 | 超过此值触发告警 |
|
||||
| 磁盘告警阈值 | 磁盘使用率的告警界限 | 超过此值触发告警 |
|
||||
| 内存告警阈值 | 内存使用率的告警界限 | 超过此值触发告警 |
|
||||
|
||||
## 3. 监控设置管理
|
||||
|
||||
### 3.1 监控配置查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 名称 | 按监控名称模糊查询 |
|
||||
| 编号 | 按监控编号模糊查询 |
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【系统设置】→【系统监控】→【监控设置】
|
||||
2. 在顶部查询区域设置查询条件
|
||||
3. 点击【查询】按钮获取监控配置列表
|
||||
|
||||
### 3.2 新增监控配置
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 点击【新增】按钮
|
||||
2. 填写监控配置信息
|
||||
3. 点击【确定】完成新增
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 监控编号 | 监控的唯一标识代码 | 是 |
|
||||
| 监控名称 | 监控的中文名称 | 是 |
|
||||
| IP地址 | 被监控服务器的IP地址 | 是 |
|
||||
| 端口 | 监控服务端口 | 是 |
|
||||
| 刷新间隔 | 数据刷新间隔(秒) | 是 |
|
||||
| CPU告警阈值 | CPU使用率告警阈值(%) | 是 |
|
||||
| 磁盘告警阈值 | 磁盘使用率告警阈值(%) | 是 |
|
||||
| 内存告警阈值 | 内存使用率告警阈值(%) | 是 |
|
||||
| 版本 | 监控服务版本号 | 否 |
|
||||
|
||||
**【提示】** 监控编号和监控名称不能重复。
|
||||
|
||||
### 3.3 编辑监控配置
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在监控列表中点击需要编辑的配置
|
||||
2. 修改配置信息
|
||||
3. 点击【确定】保存更改
|
||||
|
||||
### 3.4 删除监控配置
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在监控列表中选择需要删除的配置
|
||||
2. 点击【删除】按钮
|
||||
3. 在确认对话框中点击【确定】
|
||||
|
||||
**【提示】** 支持批量删除多个监控配置。
|
||||
|
||||
## 4. 后台API接口
|
||||
|
||||
| API路径 | 方法 | 功能描述 | 所属文件 |
|
||||
|---------|------|---------|---------|
|
||||
| `/api/background/v1/system_settings/system_monitoring/monitoring_setting/list` | GET | 获取监控配置列表 | MonitoringSettingService.php:31 |
|
||||
| `/api/background/v1/system_settings/system_monitoring/monitoring_setting/create` | POST | 创建监控配置 | MonitoringSettingService.php:84 |
|
||||
| `/api/background/v1/system_settings/system_monitoring/monitoring_setting/edit` | POST | 编辑监控配置 | MonitoringSettingService.php:145 |
|
||||
| `/api/background/v1/system_settings/system_monitoring/monitoring_setting/delete` | POST | 删除监控配置 | MonitoringSettingService.php:201 |
|
||||
|
||||
## 5. 数据模型
|
||||
|
||||
### 5.1 监控配置表
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| id | int | 配置唯一标识 |
|
||||
| code | varchar | 监控编号 |
|
||||
| name | varchar | 监控名称 |
|
||||
| port | int | 监控端口 |
|
||||
| ip | varchar | 服务器IP地址 |
|
||||
| refresh_interval | int | 刷新间隔(秒) |
|
||||
| cpu_warning | int | CPU告警阈值(%) |
|
||||
| disk_warning | int | 磁盘告警阈值(%) |
|
||||
| mem_warning | int | 内存告警阈值(%) |
|
||||
| version | varchar | 版本号 |
|
||||
| sort | int | 排序序号 |
|
||||
| create_time | datetime | 创建时间 |
|
||||
|
||||
## 6. 注意事项
|
||||
|
||||
**【提示】** 告警阈值建议设置在合理范围，避免过于频繁的告警通知。
|
||||
|
||||
**【注意】** 监控配置删除后无法恢复，请谨慎操作。
|
||||
|
||||
**【重要】** 确保配置的IP地址和端口可以正常访问，否则监控数据无法获取。
|
||||
316
system_settings/user_management.md
Normal file
316
system_settings/user_management.md
Normal file
@@ -0,0 +1,316 @@
|
||||
# 用户管理
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
用户管理模块用于管理系统用户账号和角色权限，实现用户的增删改查、角色分配、密码管理以及权限配置功能。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
- 用户账号管理：创建、编辑、删除用户账号
|
||||
- 用户状态控制：启用/禁用用户账号
|
||||
- 角色管理：创建、编辑、删除角色（用户组）
|
||||
- 权限分配：为角色分配菜单和API权限
|
||||
- 密码管理：修改密码、重置密码
|
||||
- 用户数据导入导出：支持批量导入和导出用户数据
|
||||
|
||||
## 2. 术语说明
|
||||
|
||||
#### 2.1.1 用户管理术语
|
||||
|
||||
| 术语 | 定义 | 说明 |
|
||||
|------|------|------|
|
||||
| 用户组/角色 | 用户所属的权限分组 | 同一角色的用户拥有相同权限 |
|
||||
| 出入证编号 | 用户的证件编号 | 用于门禁等场景 |
|
||||
| 超级管理员 | 系统最高权限角色 | 默认拥有所有菜单权限 |
|
||||
| is_all_menu | 是否拥有全部菜单权限 | 1表示拥有全部权限 |
|
||||
|
||||
## 3. 角色管理
|
||||
|
||||
### 3.1 角色列表查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 状态 | 筛选启用或禁用状态的角色 |
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入【系统设置】→【用户管理】→【角色】
|
||||
2. 在顶部查询区域选择状态条件
|
||||
3. 点击【查询】按钮获取角色列表
|
||||
|
||||
### 3.2 新增角色
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 点击【新增角色】按钮
|
||||
2. 填写角色名称和描述
|
||||
3. 设置角色状态
|
||||
4. 点击【确定】完成新增
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 名称 | 角色名称，如"管理员"、"普通用户" | 是 |
|
||||
| 描述 | 角色的详细说明 | 否 |
|
||||
| 状态 | 启用或禁用 | 是 |
|
||||
|
||||
**【提示】** 角色名称不能重复。
|
||||
|
||||
### 3.3 编辑角色
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在角色列表中点击需要编辑的角色
|
||||
2. 修改角色信息
|
||||
3. 点击【确定】保存更改
|
||||
|
||||
### 3.4 删除角色
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在角色列表中找到需要删除的角色
|
||||
2. 点击【删除】按钮
|
||||
3. 在确认对话框中点击【确定】
|
||||
|
||||
**【重要】** 如果角色下存在用户，无法删除该角色。
|
||||
|
||||
### 3.5 权限分配
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在角色列表中点击【权限配置】按钮
|
||||
2. 在权限配置页面选择需要分配的菜单和API
|
||||
3. 点击【确定】保存权限配置
|
||||
|
||||
**【提示】** 权限配置会覆盖角色原有的所有权限。
|
||||
|
||||
## 4. 用户管理
|
||||
|
||||
### 4.1 用户列表查询
|
||||
|
||||
**查询条件：**
|
||||
|
||||
| 查询条件 | 说明 |
|
||||
|---------|------|
|
||||
| 账号 | 按用户名模糊查询 |
|
||||
| 姓名 | 按昵称模糊查询 |
|
||||
| 用户组 | 按角色筛选 |
|
||||
| 状态 | 筛选启用或禁用状态的用户 |
|
||||
|
||||
### 4.2 新增用户
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 点击【新增用户】按钮
|
||||
2. 填写用户信息
|
||||
3. 设置用户组和状态
|
||||
4. 点击【确定】完成新增
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 账号 | 用户登录账号 | 是 |
|
||||
| 姓名 | 用户昵称或真实姓名 | 是 |
|
||||
| 出入证编号 | 用户的证件编号 | 否 |
|
||||
| 密码 | 用户登录密码 | 是 |
|
||||
| 确认密码 | 再次输入密码确认 | 是 |
|
||||
| 用户组 | 选择用户所属角色 | 是 |
|
||||
| 状态 | 启用或禁用 | 是 |
|
||||
|
||||
**【注意】** 两次输入的密码必须一致，已删除或禁用的用户组无法选择。
|
||||
|
||||
### 4.3 编辑用户
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在用户列表中点击需要编辑的用户
|
||||
2. 修改用户信息
|
||||
3. 点击【确定】保存更改
|
||||
|
||||
**【注意】** 不能禁用自己的账号。
|
||||
|
||||
### 4.4 删除用户
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在用户列表中找到需要删除的用户
|
||||
2. 点击【删除】按钮
|
||||
3. 在确认对话框中点击【确定】
|
||||
|
||||
**【重要】** 不能删除自己的账号。
|
||||
|
||||
### 4.5 批量操作
|
||||
|
||||
**支持的批量操作：**
|
||||
|
||||
- 批量删除：选择多个用户后点击【批量删除】
|
||||
- 批量启用/禁用：选择多个用户后点击【批量启用】或【批量禁用】
|
||||
|
||||
### 4.6 密码管理
|
||||
|
||||
#### 修改密码
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在用户列表中点击【修改密码】按钮
|
||||
2. 输入旧密码和新密码
|
||||
3. 点击【确定】完成修改
|
||||
|
||||
#### 重置密码
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 在用户列表中点击【重置密码】按钮
|
||||
2. 在确认对话框中点击【确定】
|
||||
3. 密码将被重置为默认密码"123456"
|
||||
|
||||
### 4.7 用户数据导入导出
|
||||
|
||||
#### 导入用户数据
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 点击【下载导入模板】获取导入模板文件
|
||||
2. 按照模板格式填写用户数据
|
||||
3. 上传填写好的Excel文件
|
||||
4. 点击【导入】完成批量导入
|
||||
|
||||
**导入模板字段：**
|
||||
|
||||
| 字段 | 说明 | 必填 |
|
||||
|------|------|------|
|
||||
| 账号 | 用户登录账号 | 是 |
|
||||
| 姓名 | 用户昵称 | 是 |
|
||||
| 出入证编号 | 用户证件编号 | 否 |
|
||||
| 密码 | 用户密码 | 是 |
|
||||
| 状态 | 启用或禁用 | 是 |
|
||||
| 用户组 | 用户所属角色名称 | 是 |
|
||||
|
||||
#### 导出用户数据
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 设置查询条件筛选需要导出的用户
|
||||
2. 点击【导出】按钮
|
||||
3. 系统后台生成导出任务
|
||||
4. 在下载管理中获取导出文件
|
||||
|
||||
## 5. 后台API接口
|
||||
|
||||
### 5.1 用户管理接口
|
||||
|
||||
| API路径 | 方法 | 功能描述 | 所属文件 |
|
||||
|---------|------|---------|---------|
|
||||
| `/api/background/v1/system_settings/user_management/user/all` | GET | 获取启用状态的用户列表 | UserService.php:44 |
|
||||
| `/api/background/v1/system_settings/user_management/user/list` | GET | 获取用户列表(分页) | UserService.php:77 |
|
||||
| `/api/background/v1/system_settings/user_management/user/create` | POST | 创建用户 | UserService.php:144 |
|
||||
| `/api/background/v1/system_settings/user_management/user/edit` | POST | 编辑用户 | UserService.php:192 |
|
||||
| `/api/background/v1/system_settings/user_management/user/delete` | POST | 删除用户 | UserService.php:239 |
|
||||
| `/api/background/v1/system_settings/user_management/user/batch_delete` | POST | 批量删除用户 | UserService.php:269 |
|
||||
| `/api/background/v1/system_settings/user_management/user/enable` | POST | 启用用户 | UserService.php:302 |
|
||||
| `/api/background/v1/system_settings/user_management/user/disable` | POST | 禁用用户 | UserService.php:321 |
|
||||
| `/api/background/v1/system_settings/user_management/user/update_pwd` | POST | 修改密码 | UserService.php:346 |
|
||||
| `/api/background/v1/system_settings/user_management/user/reset_pwd` | POST | 重置密码 | UserService.php:372 |
|
||||
| `/api/background/v1/system_settings/user_management/user/get_import_template` | GET | 获取导入模板 | UserService.php:392 |
|
||||
| `/api/background/v1/system_settings/user_management/user/user_data_import` | POST | 导入用户数据 | UserService.php:458 |
|
||||
| `/api/background/v1/system_settings/user_management/user/user_data_export_task` | POST | 创建导出任务 | UserService.php:515 |
|
||||
|
||||
### 5.2 角色管理接口
|
||||
|
||||
| API路径 | 方法 | 功能描述 | 所属文件 |
|
||||
|---------|------|---------|---------|
|
||||
| `/api/background/v1/system_settings/user_management/role/all` | GET | 获取启用状态的角色列表 | RoleService.php:55 |
|
||||
| `/api/background/v1/system_settings/user_management/role/list` | GET | 获取角色列表(分页) | RoleService.php:81 |
|
||||
| `/api/background/v1/system_settings/user_management/role/create` | POST | 创建角色 | RoleService.php:154 |
|
||||
| `/api/background/v1/system_settings/user_management/role/edit` | POST | 编辑角色 | RoleService.php:185 |
|
||||
| `/api/background/v1/system_settings/user_management/role/delete` | POST | 删除角色 | RoleService.php:218 |
|
||||
| `/api/background/v1/system_settings/user_management/role/update_status` | POST | 更新角色状态 | RoleService.php:243 |
|
||||
| `/api/background/v1/system_settings/user_management/role/get_role_menu` | GET | 获取角色权限 | RoleService.php:257 |
|
||||
| `/api/background/v1/system_settings/user_management/role/give_role_menu` | POST | 分配角色权限 | RoleService.php:300 |
|
||||
|
||||
## 6. 数据模型
|
||||
|
||||
### 6.1 用户表
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| id | int | 用户唯一标识 |
|
||||
| username | varchar | 登录账号 |
|
||||
| password | varchar | 加密后的密码 |
|
||||
| nickname | varchar | 用户昵称 |
|
||||
| role_id | int | 所属角色ID |
|
||||
| head_pic | varchar | 头像URL |
|
||||
| pass_number | varchar | 出入证编号 |
|
||||
| last_login | datetime | 最后登录时间 |
|
||||
| last_ip | varchar | 最后登录IP |
|
||||
| is_all_menu | tinyint | 是否拥有全部菜单权限 |
|
||||
| status | tinyint | 状态(0禁用/1启用) |
|
||||
| sort | int | 排序序号 |
|
||||
| create_time | datetime | 创建时间 |
|
||||
| update_time | datetime | 更新时间 |
|
||||
|
||||
### 6.2 角色表
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| id | int | 角色唯一标识 |
|
||||
| name | varchar | 角色名称 |
|
||||
| description | varchar | 角色描述 |
|
||||
| system | tinyint | 是否系统内置角色 |
|
||||
| status | tinyint | 状态(0禁用/1启用) |
|
||||
| sort | int | 排序序号 |
|
||||
|
||||
### 6.3 角色菜单关联表
|
||||
|
||||
| 字段名 | 类型 | 说明 |
|
||||
|--------|------|------|
|
||||
| id | int | 关联ID |
|
||||
| role_id | int | 角色ID |
|
||||
| menu_id | int | 菜单ID |
|
||||
| module | varchar | 模块(admin/pda/api) |
|
||||
|
||||
## 7. 数据流程图
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[用户管理] --> B[新增用户]
|
||||
A --> C[编辑用户]
|
||||
A --> D[删除用户]
|
||||
A --> E[修改密码]
|
||||
|
||||
B --> F{验证用户名唯一性}
|
||||
F -->|已存在| G[提示错误]
|
||||
F -->|不存在| H{验证密码一致性}
|
||||
H -->|不一致| I[提示错误]
|
||||
H -->|一致| J{验证角色有效性}
|
||||
J -->|无效| K[提示错误]
|
||||
J -->|有效| L[保存用户数据]
|
||||
|
||||
C --> M{验证用户名唯一性}
|
||||
M -->|重复| N[提示错误]
|
||||
M -->|唯一| O{是否禁用自己}
|
||||
O -->|是| P[提示错误]
|
||||
O -->|否| Q[更新用户数据]
|
||||
|
||||
D --> R{是否删除自己}
|
||||
R -->|是| S[提示错误]
|
||||
R -->|否| T[删除用户并重新排序]
|
||||
|
||||
E --> U{验证密码一致性}
|
||||
U -->|不一致| V[提示错误]
|
||||
U -->|一致| W{新旧密码是否相同}
|
||||
W -->|相同| X[提示错误]
|
||||
W -->|不同| Y[更新密码]
|
||||
```
|
||||
|
||||
## 8. 注意事项
|
||||
|
||||
**【重要】** 用户在进行删除或禁用操作时，不能操作自己的账号。
|
||||
|
||||
**【注意】** 删除或禁用角色前，请确保该角色下没有关联的用户。
|
||||
|
||||
**【提示】** 导入用户数据时，如果用户名已存在，该行数据将被跳过。
|
||||
59
后台Webman功能模型代码.md
Normal file
59
后台Webman功能模型代码.md
Normal file
@@ -0,0 +1,59 @@
|
||||
# 系统功能清单
|
||||
|
||||
| 一级模块 | 二级模块 | 三级模块 | 功能说明 | 备注 | 文档完成情况 | 文档情况备注 | 文档位置
|
||||
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
||||
| **系统设置(System Settings)** | 用户管理(User Management) | 角色(Role) | 设置用户组别并且分配权限（增删改查用户组，以及实现权限分配功能） | | 完成 | | | |
|
||||
| | | 用户(User) | 管理人员账号并且绑定对应的用户组 | | 完成 | | | |
|
||||
| | 菜单管理(Menu Configuration) | 菜单配置(Menu) | 系统菜单配置 | | 完成 | | | |
|
||||
| | 系统助手(System Assistant) | 操作日志(Operation Log) | 系统操作日志 | | 完成 | | | |
|
||||
| | | 接口日志(Interface Log) | 与设备对接流程交互日志（可根据 IP 和接口名称等条件查询） | | 完成 | | | |
|
||||
| | 系统监控(System Monitoring) | 监控设置(Monitoring Setting) | 系统监控设置 | | 完成 | | | |
|
||||
| **基础配置(production_configuration)** | 所级模型(Factory Model) | 产线设置(Factory Line) | 管理产线（包括产线的增删改查） | | 完成 |
|
||||
| | | 所区设置(Factory Area) | 管理工厂（包括工厂的增删改查） | | 完成 |
|
||||
| | | 生产车间(Workshop) | 管理生产车间（包括车间的增删改查） | | 完成 |
|
||||
| | 工艺模型(Technology Model) | 工艺流程类别(Technology Flow Category) | 工艺流程类别的增删改查功能 | | 完成 |
|
||||
| | | 工序单元(Technology Process) | 配置管理工序单元（节点），实现增删改查，对工序单元的结果参数采集预设和工艺参数预设 | | 完成 |
|
||||
| | | 工艺流程(Technology Flow) | 设置电池生产工艺流程，实现工序卡的增删改查和流程卡的设定 | | 完成 |
|
||||
| | 产品管理(Product Management) | 产品列表(Product Battery) | 产品管理页面实现产品的增删改查 | | 完成 |
|
||||
| | | 异常不良管理(Product NG Info) | 设备不良信息以及产品 NG 信息的编码与描述管理，实现批量导入以及增删改查 | | 完成 |
|
||||
| | 物料模型(Material Model) | 物料类别列表(Material Category) | 区分原材料和半成品（固定编码） | | 完成 |
|
||||
| | | 物料信息管理(Material Management) | 维护物料编码、名称、类别、单位、规格型号、BOM信息等基础属性 | | 完成 |
|
||||
| | | BOM物料清单(BOM) | 产品 BOM 管理 | | 完成 |
|
||||
| | | 计量单位(Unit) | 配置和管理计量单位，并且能够增删改查 | | 完成 |
|
||||
| | SPC采集模型(SPC Configuration) | SPC采集配置(SCADA Node Binding) | 配置结果参数采集参数 | | 进行中 |
|
||||
| | 班组模型(Organization) | 班组管理(Production Team) | 管理生产班组（包括班组的增删改查） | | 完成 |
|
||||
| | | 班次管理(Production Shift) | 管理生产班次（包括班次的增删改查） | | 完成 |
|
||||
| | | 生产成员管理(Production Members) | 管理生产成员（包括成员的增删改查） | | 完成 |
|
||||
| **设备模型(device_management)** | 设备类别(Device Category) | 设备类别(Device Category) | 管理设备种类并且实现设备种类的增删改查 | | 完成 |
|
||||
| | 设备信息(Device Management) | 设备信息(Device Management) | 管理每个设备信息并且实现设备的增删改查 | | 完成 |
|
||||
| | 设备点检(Device Check) | 设备点检项目(Device Check Items) | 设备点检项目的增删改查 | | 完成 |
|
||||
| | | 设备点检记录(Device Check Record) | 设备点检记录的增删改查 | | 完成 |
|
||||
| | | 设备点检日志(Device Check Items Log) | 设备点检日志的查询 | | 完成 |
|
||||
| | | 设备点检日志(Device Check Items Log) | 设备点检日志的查询 | | 完成 |
|
||||
| | 设备保养(Device Maintain) | 设备保养项目(Device Maintain Items) | 设备保养项目的增删改查 | | 完成 |
|
||||
| | | 设备保养详情(Device Maintain Items Details) | 设备保养详情的增删改查 | | 完成 |
|
||||
| | | 设备保养日志(Device Maintain Items Log) | 设备保养日志的查询 | | 完成 |
|
||||
| | 设备维修(Device Repair) | 设备维修管理(Device Repair Management) | 设备维修管理的增删改查 | | 完成 |
|
||||
| | | 设备维修日志(Device Repair Log) | 设备维修日志的查询 | | 完成 |
|
||||
| | 设备损耗品(Device Consumables) | 设备损耗品类别(Device Consumables Category) | 设备损耗品类别的增删改查 | | 完成 |
|
||||
| | | 设备损耗品项目(Device Consumables Items) | 设备损耗品项目的增删改查 | | 完成 |
|
||||
| | | 设备损耗品寿命管理(Device Consumables Lifetime Management) | 设备损耗品寿命管理的增删改查 | | 完成 |
|
||||
| | | 设备损耗品更换日志(Device Consumables Replace Log) | 设备损耗品更换日志的查询 | | 完成 |
|
||||
| | 设备故障(Device Fault) | 设备故障项目(Device Fault Items) | 设备故障项目的增删改查 | | 完成 |
|
||||
| 计划与生产(Planning production) | 生产批次管理(Production batch management) | 批次列表(batch management) | 生产批次的增删改查 | | 进行中 | |
|
||||
| | 生产批次管理(Production batch management) | 批次托盘(batch management) | 批次托盘的增删改查 | | 完成 | |
|
||||
| | | 批次托盘(batch tray) | 批次托盘的查询详情、跟踪、解绑、停止 | | 完成 | |
|
||||
| | | 生产批次不良报表(batch_def report) | 生产批次不良报表的增删改查 | | 完成 | |
|
||||
| | 预警中心(Warning Center) | 预警中心(Warning Center) | 预警中心| | 进行中 | |
|
||||
| | 生产监控(Production Monitoring) | 物料监控(Production Monitoring) | 物料监控| | 进行中 | |
|
||||
| | | 电池复投管理(reject management)| 电池复投管理的增删改查 | | 完成 | |
|
||||
| | | 托盘管理(tray management)| 托盘调整工序、停止托盘、查询托盘状态、查询托盘绑定的电池 | | 完成 | |
|
||||
| | | 托盘登录(tray login)| 托盘登录、查询托盘状态 | | 完成 | |
|
||||
| | | 设备监控(device monitoring)| 设备状态监控 | | 完成 | |
|
||||
| | | 电池工序管理(technology process management)| 电池工序管理的增删改查 | | | 进行中 | |
|
||||
| 质量管理(Quality Management) | 过程控制 | 检验类别管理 | | | 完成 | |
|
||||
| | | 首巡检项目配置(Product Quality Record) | | | 完成 | |
|
||||
| | | 首巡检录入(Product Quality Record) | | | 完成 | |
|
||||
| | | 首巡检报表(Product Quality Record) | | | 完成 | |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user