From 2d0c34d36e443cad0c3caa86eb632369f0353211 Mon Sep 17 00:00:00 2001 From: sheng <905537351@qq.com> Date: Wed, 29 Apr 2026 17:59:31 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=E5=92=8C=E6=9B=B4?= =?UTF-8?q?=E6=96=B0=E5=A4=9A=E4=B8=AA=E6=A8=A1=E5=9D=97=E7=9A=84=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增SPC模块、托盘登录、生产批次不良报表、设备监控、半成品管理、托盘管理、系统监控、批次管理、班组模型、电池工序管理、电池复投管理、批次托盘、系统助手、SPC采集模型、产品模型管理、物料模型管理、用户管理、菜单配置等文档内容 更新文档指南,添加系统功能清单 --- guide/document-guide.md | 26 +- planning_production/batch_defect_report.md | 58 ++++ planning_production/batch_management.md | 167 +++++++++ planning_production/batch_tray.md | 175 ++++++++++ planning_production/device_monitoring.md | 74 ++++ planning_production/material_monitoring.md | 104 ++++++ planning_production/reject_management.md | 142 ++++++++ planning_production/technology_process.md | 208 ++++++++++++ planning_production/tray_login.md | 54 +++ planning_production/tray_management.md | 178 ++++++++++ production_configuration/Organization.md | 146 ++++++++ production_configuration/SPC_configuration.md | 208 ++++++++++++ production_configuration/material_model.md | 300 +++++++++++++++++ production_configuration/product_model.md | 228 +++++++++++++ quality_control/spc.md | 8 + system_settings/menu_configuration.md | 219 ++++++++++++ system_settings/system_assistant.md | 183 ++++++++++ system_settings/system_monitoring.md | 119 +++++++ system_settings/user_management.md | 316 ++++++++++++++++++ 后台Webman功能模型代码.md | 59 ++++ 20 files changed, 2971 insertions(+), 1 deletion(-) create mode 100644 planning_production/batch_defect_report.md create mode 100644 planning_production/batch_management.md create mode 100644 planning_production/batch_tray.md create mode 100644 planning_production/device_monitoring.md create mode 100644 planning_production/material_monitoring.md create mode 100644 planning_production/reject_management.md create mode 100644 planning_production/technology_process.md create mode 100644 planning_production/tray_login.md create mode 100644 planning_production/tray_management.md create mode 100644 production_configuration/Organization.md create mode 100644 production_configuration/SPC_configuration.md create mode 100644 production_configuration/material_model.md create mode 100644 production_configuration/product_model.md create mode 100644 quality_control/spc.md create mode 100644 system_settings/menu_configuration.md create mode 100644 system_settings/system_assistant.md create mode 100644 system_settings/system_monitoring.md create mode 100644 system_settings/user_management.md create mode 100644 后台Webman功能模型代码.md diff --git a/guide/document-guide.md b/guide/document-guide.md index 42251df..fcfd338 100644 --- a/guide/document-guide.md +++ b/guide/document-guide.md @@ -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 diff --git a/planning_production/batch_defect_report.md b/planning_production/batch_defect_report.md new file mode 100644 index 0000000..8f9f634 --- /dev/null +++ b/planning_production/batch_defect_report.md @@ -0,0 +1,58 @@ +# 生产批次不良报表 + +## 1. 功能概述 + +生产批次不良报表属于 MES 系统的质量分析模块,用于统计和分析生产批次中的不良品情况,为生产质量改进提供数据支持。 + +**核心功能:** + +- 不良统计:按批次维度统计不良品数量和不良率 +- 不良类型分析:区分电池类不良和外观类不良 + + +**功能对应截图** : +![图片:生产批次不良报表功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + + +## 2. 术语说明 + +| 术语 | 定义 | 说明 | +|------|------|------| +| 不良品 | Defective Item,生产过程中产生的质量异常产品 | 需要进行质量分析和处理 | +| 不良率 | Defect Rate,不良品数量与总生产数量的比率 | 用于衡量生产质量水平 | + + +## 3. 生产批次不良报表交互流程 + +### 3.1 不良报表列表 + +#### 3.1.1 不良报表列表说明 + +不良报表列表展示所有生产批次的的不良品统计信息,支持按多种条件查询和筛选。 + +**功能对应截图** : +![图片:不良报表列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +**字段说明:** + +| 字段 | 说明 | +|------|------| +| 批次编号 | 生产批次的唯一标识 | +| 产品型号 | 对应的产品型号 | +| 总数量 | 批次总生产数量 | +| 不良数量 | 批次中产生的不良品数量 | +| 不良率 | 不良数量占总数量的百分比 | +| 电池类不良数 | 电池类不良数量 | +| 外观类不良数 | 外观类不良数量 | +| 统计时间 | 报表统计时间 | + + +#### 3.1.2 不良报表查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 批次编号 | 按批次编号精确查询 | +| 生产时间 | 按统计时间范围筛选 | +| 不良类型 | 按不良类型筛选(全部、电池类、外观类) | diff --git a/planning_production/batch_management.md b/planning_production/batch_management.md new file mode 100644 index 0000000..4b319b4 --- /dev/null +++ b/planning_production/batch_management.md @@ -0,0 +1,167 @@ +# 批次管理 + +## 1. 功能概述 + +批次管理属于 MES 系统的核心模块,用于管理生产批次,实现生产任务的创建、跟踪和监控。 + +**核心功能:** + +- 批次管理:维护生产批次的新增、删除、修改、查询 +- 批次关联:关联工艺流程、产品型号、产区和产线 + +**功能对应截图** : +![图片:批次管理功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + + +## 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 批次列表说明 + +批次列表展示所有生产批次信息,支持按多种条件查询和筛选。 + +**功能对应截图** : +![图片:批次列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +#### 4.1.2 批次查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 批次编号 | 按批次编号精确查询 | +| 产品型号 | 按产品型号筛选 | +| 工厂 | 按工厂筛选 | +| 产线 | 按产线筛选 | +| 创建时间 | 按创建时间范围筛选 | + +### 4.2 新增批次 + +#### 4.2.1 新增批次说明 + +创建新的生产批次,需要选择关联的基础数据和生产参数。 + +**操作步骤:** + +1. 进入【生产配置】→【批次管理】→【批次列表】 +2. 点击【新增】按钮 +3. 选择关联的工艺流程 +4. 选择产品型号 +5. 选择产区 +6. 选择产线 +7. 填写计划预计完成日期 +8. 填写计划预计完成数量 +9. 点击【确定】完成批次创建 + +**字段说明:** + +| 字段 | 说明 | 必填 | +|------|------|------| +| 批次号 | 批次的唯一标识代码,用户自定义 | 是 | +| 工艺流程 | 批次使用的生产工艺路线 | 是 | +| 产品型号 | 批次生产的产品规格 | 是 | +| 产区 | 批次所属的产区 | 是 | +| 产线 | 批次执行的产线 | 是 | +| 预计完成日期 | 计划完成时间 | 是 | +| 生产数量 | 计划生产数量 | 是 | +| 批次状态 | 初始状态为"待生产" | 否 | +| 备注 | 其他补充说明信息 | 否 | + +**【重要】** 批次编号创建后不允许修改,请在创建时仔细确认。 +**【重要】** 批次一旦开始生产,不允许删除。 + +**功能对应截图** : +![图片:新增批次截图](/public/image/process_model/图片:新增工序单元截图.png) + +### 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. 查看导入结果报告 + +**【注意】** 导入前请确保关联的工艺流程、产品型号、工厂、产线已存在。 + diff --git a/planning_production/batch_tray.md b/planning_production/batch_tray.md new file mode 100644 index 0000000..ad89b4d --- /dev/null +++ b/planning_production/batch_tray.md @@ -0,0 +1,175 @@ +# 批次托盘 + +## 1. 功能概述 + +批次托盘属于 MES 系统的核心模块,用于管理生产批次与托盘的关联关系,实现批次在生产过程中的物流跟踪和管理。托盘是承载物料的生产容器,批次托盘管理贯穿整个生产物流环节。 + +**核心功能:** + +- 批次托盘查询:查询批次与托盘的关联信息 +- 批次托盘详情:查看批次托盘的详细信息 +- 批次跟踪:跟踪批次在托盘上的流转状态 +- 解绑操作:解除批次与托盘的绑定关系 +- 停止操作:停止批次托盘的当前状态 + +**功能对应截图** : +![图片:批次托盘功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + + +## 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 批次托盘列表说明 + +批次托盘列表展示所有批次与托盘的关联信息,支持按多种条件查询和筛选。 + +**功能对应截图** : +![图片:批次托盘列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +**字段说明:** + +| 字段 | 说明 | +|------|------| +| 托盘编号 | 托盘的唯一标识代码 | +| 流水号 | 批次托盘的流水号,用于唯一标识每次绑定 | +| 托盘状态 | 当前托盘状态 | +| 批次编号 | 关联的批次编号 | +| 工艺流程名称 | 关联的工艺流程名称 | +| 当前工序 | 托盘当前所在工序 | +| 载入电池数量 | 托盘当前载入的电池数量 | +| 登录时间 | 批次托盘登录时间 | + + +#### 4.1.2 批次托盘查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 托盘号 | 按托盘编号精确查询 | +| 批次号 | 按批次编号精确查询 | +| 托盘激活状态 | 按状态筛选(激活、停止) | +| 登录时间 | 按创建时间范围筛选 | + +### 4.2 批次托盘详情 + +#### 4.2.1 详情查看说明 + +查看批次托盘的详细信息,包括托盘基本信息、工序的流转时间信息、工序流程设备、载入的电池数量、电池编号、电池位置、电池状态等。 + +**操作步骤:** + +1. 进入【生产配置】→【批次管理】→【批次托盘】 +2. 在列表中找到需要查看详情的批次托盘记录 +3. 点击【详情】按钮 +4. 查看批次托盘的完整信息 + +**字段说明:** + +| 字段 | 说明 | +|------|------| +| 托盘编号 | 托盘的唯一标识代码 | +| 工序开始时间 | 工序开始时间,用于记录工序开始的时间 | +| 工序结束时间 | 工序结束时间,用于记录工序结束的时间 | +| 当前工序 | 托盘当前所在工序 | +| 序号 | 电池条码在托盘里的位置 | +| 电池条码 | 电池的唯一标识代码 | +| 电池激活状态 | 电池的当前状态,如激活、停用等 | + +**功能对应截图** : +![图片:批次托盘详情截图](/public/image/process_model/图片:新增工序单元截图.png) + + +### 4.3 解绑操作 + +#### 4.3.1 解绑说明 + +解除批次与托盘的绑定关系,解绑后托盘状态会变成停止,但是电池状态不会改变。 + +**操作步骤:** + +1. 进入【生产配置】→【批次管理】→【批次托盘】 +2. 在列表中找到需要解绑的批次托盘记录 +3. 点击【解绑】按钮 +4. 点击【确定】完成解绑操作 + +**【重要】** 解绑操作不可逆,请在确认后执行。 + +**功能对应截图** : +![图片:解绑操作截图](/public/image/process_model/图片:新增工序单元截图.png) + +### 4.4 停止操作 + +#### 4.4.1 停止说明 + +停止托盘和电池的激活状态,暂停该托盘的进一步流转,用于处理异常情况。 + +**操作步骤:** + +1. 进入【生产配置】→【批次管理】→【批次托盘】 +2. 在列表中找到需要停止的批次托盘记录 +3. 点击【停止】按钮 +4. 点击【确定】完成停止操作 + +**【重要】** 停止操作不可逆,请在确认后执行。 + +**功能对应截图** : +![图片:停止操作截图](/public/image/process_model/图片:新增工序单元截图.png) + diff --git a/planning_production/device_monitoring.md b/planning_production/device_monitoring.md new file mode 100644 index 0000000..373fa3e --- /dev/null +++ b/planning_production/device_monitoring.md @@ -0,0 +1,74 @@ +# 设备监控 + +## 1. 功能概述 + +设备监控属于 MES 系统的生产监控模块,用于实时监控生产设备的设备状态。 + +**核心功能:** + +- 设备状态监控:实时监控设备的运行状态 + + +**功能对应截图** : +![图片:设备监控功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + + +## 2. 术语说明 + +| 术语 | 定义 | 说明 | +|------|------|------| +| 设备状态 | Device Status,设备的当前运行状态 | 包括运行、待机、故障等 | +| 最后响应 | Last Response,设备的最后响应时间 | 设备上次上传设备状态的时间 | +| 信息 | Information,设备的信息 | 设备的详细信息,如设备类型、关联产线等 | + + +## 3. 设备监控交互流程 + +### 3.1 设备状态监控 + +#### 3.1.1 设备状态列表说明 + +设备状态列表展示所有设备的实时运行状态,支持按多种条件查询和筛选。 + +**功能对应截图** : +![图片:设备状态列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +**字段说明:** + +| 字段 | 说明 | +|------|------| +| 设备编码 | 设备的唯一标识代码 | +| 设备名称 | 设备的名称 | +| 厂区 | 设备所属的厂区 | +| 产线 | 设备所属的产线 | +| 工作站 | 设备所属的工作站 | +| 最后响应 | 设备的最后响应时间 | +| 工作状态 | 设备的当前工作状态 | +| 信息 | 异常状态下的异常信息 | + + +#### 3.1.2 设备状态查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 设备编号 | 按设备编号精确查询 | +| 设备名称 | 按设备名称模糊查询 | +| 设备类型 | 按设备类型筛选 | +| 运行状态 | 按运行状态筛选 | +| 关联产线 | 按产线筛选 | + + +## 3.1.3. 设备状态说明 + +| 状态 |状态编码| 说明 | +|------|------|------| +| 运行 | RUN | 设备正常运行中 | +| 待机 | IDLE | 设备待机中 | +| 异常 | TROUBLE | 设备出现异常 | +| 手动 | MANUAL | 设备手动操作 | +| 离线 | OFFLINE | 设备已离线 | +| 完成 | FINISH | 设备已完成任务 | + +**重要** 详细查看设备上传状态接口文档,了解设备状态的上传格式和内容。 \ No newline at end of file diff --git a/planning_production/material_monitoring.md b/planning_production/material_monitoring.md new file mode 100644 index 0000000..980921e --- /dev/null +++ b/planning_production/material_monitoring.md @@ -0,0 +1,104 @@ +# 半成品管理 + +## 1. 功能概述 + +半成品管理用于记录和查询生产过程中各工序产出的半成品信息,支持半成品的录入与追溯。 + +**主要功能:** + +- 半成品数据录入:将各工序产出的半成品信息登记到系统中 +- 半成品列表查询:按批次号、半成品ID、工序单元、下料时间等条件检索半成品记录 +- 物料状态查看:查看半成品当前是"已完成"还是"未使用"状态 + +**对应功能截图**: +![图片:半成品管理功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + +## 2. 术语说明 + +| 术语 | 定义 | +|------|------| +| 半成品 | 生产过程中各工序产出的中间物料 | +| 半成品ID | 系统自动为每个半成品生成的唯一编号 | +| 半成品编码 | 标识半成品物料类型的编码 | +| 批次号 | 半成品所属的生产批次编号 | +| 工序单元 | 产出该半成品的具体工序 | +| 物料状态 | 半成品当前使用情况:已完成 / 未使用 | + +## 3. 半成品管理交互流程 + +### 3.1 半成品列表 + +#### 3.1.1 列表说明 + +半成品列表展示所有已录入的半成品记录,默认按下料时间由近到远排列,支持分页浏览。 + +**对应功能截图**: +![图片:半成品列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +**表格字段说明:** + +| 字段 | 说明 | +|------|------| +| 批次号 | 半成品所属的生产批次编号 | +| 半成品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. 物料状态说明 + +| 状态 | 标签颜色 | 说明 | +|------|---------|------| +| 已完成 | 红色 | 该半成品已被后续工序使用 | +| 未使用 | 绿色 | 该半成品尚未被后续工序使用 | diff --git a/planning_production/reject_management.md b/planning_production/reject_management.md new file mode 100644 index 0000000..fdfe522 --- /dev/null +++ b/planning_production/reject_management.md @@ -0,0 +1,142 @@ +# 电池复投管理 + +## 1. 功能概述 + +电池复投管理用于将生产中产生的 NG(不良)电池重新激活,使其恢复正常生产状态,继续按工艺流程流转。 + +**主要功能:** + +- 电池验证:输入电池条码,系统校验电池是否符合复投条件 +- 复投激活:将符合条件的 NG 电池重新激活,恢复为正常生产状态 + +**对应功能截图**: +![图片:电池复投管理功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + +## 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 标记会被清除,档位信息也会被清除 +- 电池激活后只能从当前工序继续流转,无法退回上一工序 +- 此操作不可逆,请在确认后执行 + +**对应功能截图**: +![图片:复投激活截图](/public/image/process_model/图片:工序单元列表截图.png) + +## 5. 常见异常提示 + +| 提示信息 | 原因 | 处理建议 | +|---------|------|---------| +| 电池不存在 BATTERY_MAP 数据 | 电池条码输入错误或未在系统中登记 | 检查条码是否正确 | +| 电池的批次与第一个不一致 | 输入了不同批次的电池 | 确保同一批次电池一起复投 | +| 电池绑定的托盘仍在激活中 | 电池所在托盘还在生产中 | 等待托盘完成后再操作 | +| 该条码必须是未激活状态且为 NG 电池 | 电池不满足复投条件 | 只有 NG 且未激活的电池才能复投 | +| 电池在批次中是激活的,不需要重新激活 | 电池已经是激活状态 | 无需操作 | +| 电池没有 NG 信息,不是 NG 电池 | 电池为正常品 | 正常电池无需复投 | diff --git a/planning_production/technology_process.md b/planning_production/technology_process.md new file mode 100644 index 0000000..908ac62 --- /dev/null +++ b/planning_production/technology_process.md @@ -0,0 +1,208 @@ +# 电池工序管理 + +## 1. 功能概述 + +电池工序管理属于 MES 系统的生产监控模块,用于管理电池在生产过程中的工序流转,实现工序的增加、删除、修改、查询等操作。 + +**核心功能:** + +- 工序管理:维护工序的基本信息和配置 +- 工序查询:查询电池当前所在工序及工序历史 +- 工序调整:调整电池的当前工序 +- 工序记录:记录电池的工序流转历史 + +**功能对应截图** : +![图片:电池工序管理功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + + +## 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 电池工序列表说明 + +电池工序列表展示所有电池的工序流转信息,支持按多种条件查询和筛选。 + +**功能对应截图** : +![图片:电池工序列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +**字段说明:** + +| 字段 | 说明 | +|------|------| +| 电池编号 | 电池的唯一标识代码 | +| 批次编号 | 关联的批次编号 | +| 当前工序 | 电池当前所在工序 | +| 上一工序 | 电池上一工序 | +| 下一工序 | 电池下一工序 | +| 进入时间 | 电池进入当前工序的时间 | +| 工序状态 | 当前工序的处理状态 | + + +#### 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. 工序状态说明 + +| 状态 | 说明 | +|------|------| +| 待处理 | 电池等待该工序处理 | +| 处理中 | 电池正在该工序处理 | +| 已完成 | 电池已完成该工序处理 | +| 异常 | 电池在该工序出现异常 | \ No newline at end of file diff --git a/planning_production/tray_login.md b/planning_production/tray_login.md new file mode 100644 index 0000000..71fcdb5 --- /dev/null +++ b/planning_production/tray_login.md @@ -0,0 +1,54 @@ +# 托盘登录 + +## 1. 功能概述 + +托盘登录属于 MES 系统的生产监控模块,用于将托盘和电池登录到生产线,记录托盘的登录状态并支持查询托盘的相关信息。 + +**核心功能:** + +- 托盘登录:执行托盘登录操作 +- 托盘解绑:将托盘和电池的绑定关系解绑。 +- 托盘停止:将托盘和电池的激活状态设置为停止,结束托盘和电池的流转。 +- 托盘编码格式:支持用户自定义,验证用户输入的托盘条码格式是否正确。 +- 电池编码格式:支持用户自定义,验证用户输入的电池条码格式是否正确。 + + +**功能对应截图** : +![图片:托盘登录功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + + +## 2. 术语说明 + +| 术语 | 定义 | 说明 | +|------|------|------| +| 托盘登录 | Tray Login,托盘进入生产线 | 托盘开始在生产线上运作 | +| 登录状态 | Login Status,托盘是否已登录 | 记录托盘的登录状态 | + + +## 3. 托盘登录交互流程 + +### 3.1 托盘登录操作 + +**操作步骤:** + +1. 进入【生产监控】→【托盘登录】 +2. 选择批次号 +3. 选择托盘与电池格式编码 +4. 扫描或输入托盘编号 +5. 扫描或输入电池编号 +6. 点击登录按钮 +7. 点击【确定】完成登录操作 + +**字段说明:** + +| 字段 | 说明 | +|------|------| +| 通道 | 托盘登录的通道 | +| 电池ID | 扫描或输入的电池ID | +| 上一个批次 | 托盘上登录的批次编号 | +| 上一个托盘 | 托盘上登录的托盘编号 | +| 电池已完成工序 | 电池是否已完成当前工序 | + + + + diff --git a/planning_production/tray_management.md b/planning_production/tray_management.md new file mode 100644 index 0000000..55f6253 --- /dev/null +++ b/planning_production/tray_management.md @@ -0,0 +1,178 @@ +# 托盘管理 + +## 1. 功能概述 + +托盘管理属于 MES 系统的生产监控模块,用于管理生产过程中的托盘,实现托盘的工序调整、停止、状态查询以及托盘绑定的电池查询等功能。 + +**核心功能:** + +- 托盘状态查询:查询托盘的当前状态 +- 托盘工序调整:调整托盘所在的工序 +- 托盘停止操作:停止托盘的当前状态 +- 托盘电池查询:查询托盘绑定的电池信息 + +**功能对应截图** : +![图片:托盘管理功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + + +## 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电池会恢复为正常状态,但是生产日志不会被清除。 + diff --git a/production_configuration/Organization.md b/production_configuration/Organization.md new file mode 100644 index 0000000..490816e --- /dev/null +++ b/production_configuration/Organization.md @@ -0,0 +1,146 @@ +# 班组模型 + +## 1. 功能概述 + +班组模型属于 MES 系统的基础模块,用于构建企业的生产班组、生产班次、生产成员数据,为生产排班提供组织基础数据支撑。 + +**核心功能:** + +- 班组管理:维护生产班组的新增、删除、修改、查询 +- 排班计划管理:维护生产排班的新增、删除、修改、查询 +- 排班日历:查看生产排班的时间规划和排班信息 + +**功能对应截图** : +![图片:班组模型功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + +## 2. 术语说明 + +| 术语 | 定义 | 说明 | +| ---- | -------------------------- | ----------- | +| 班组 | Production Team,生产作业组织单元 | 用于组织和管理生产人员 | +| 班组成员 | Production Members,班组的组成人员 | 属于某个班组的操作人员 | +| 排班计划 | Production Schedule,班组的排班计划 | 定义班组的工作时间和任务分配 | +| 轮班方式 | Rotation Schedule,班组的排班方式 | 如轮班、固定排班等 | +| 休息日选择 | Rest Day Schedule,班组的休息日选择 | 定义哪些天是休息天 | + + +**关系说明:** + +| 关系类型 | 说明 | +| --------- | ------------------------ | +| 班组 → 班次 | **1 对 N**:一个班组可以包含多个班次 | +| 班组 → 生产成员 | **1 对 N**:一个班组可以包含多个生产成员 | + +## 3. 班组模型交互流程 + +### 3.1 班组管理 + +#### 3.1.1 班组说明 + +班组是生产作业的基本组织单元,用于编入生产人员。 + +**功能对应截图** : +![图片:班组列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +#### 3.1.2 新增班组 + +**操作步骤:** + +1. 进入【生产配置】→【班组模型】→【班组管理】 +2. 点击【新增】按钮 +3. 填写班组基本信息 +4. 添加班组成员 +5. 点击【确定】完成班组创建 + +**字段说明:** + +| 字段 | 说明 | 必填 | +| ---- | ------------------- | -- | +| 班组名称 | 班组的名称,如"包装班组" | 是 | +| 所属厂区 | 班组所属的生产厂区,如"工厂A" | 是 | +| 所属产线 | 班组所属的生产产线,如"包装线" | 是 | + + +**【重要】** 班组编码创建后不允许修改,请在创建时仔细确认。 +**【重要】** 班组被工单引用后,不允许删除。 + +**功能对应截图** : +![图片:新增班组截图](/public/image/process_model/图片:新增工序单元截图.png) + +#### 3.1.3 班组查询 + +**查询条件:** + +| 查询条件 | 说明 | +| ---- | --------- | +| 班组名称 | 按班组名称模糊查询 | +| 所属厂区 | 按班组所属厂区筛选 | +| 所属产线 | 按班组所属产线筛选 | +| 创建时间 | 按班组创建时间筛选 | + +### 3.2 排班计划 + +#### 3.2.1 排班计划说明 + +排班计划是班组工作时间的基本划分,用于管理生产作业的时间安排。 + +**功能对应截图** : +![图片:班次列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +#### 3.2.2 新增排班计划 + +**操作步骤:** + +1. 进入【生产配置】→【班组模型】→【排班计划】 +2. 点击【新增】按钮 +3. 填写排班计划基本信息 +4. 点击【确定】完成排班计划创建 + +**字段说明:** + +| 字段 | 说明 | 必填 | +| ---- | --------------------- | -- | +| 排班名称 | 排班计划的名称,如"早班"、"中班"、"晚班" | 是 | +| 排班编码 | 排班计划的唯一标识代码 | 是 | +| 排班时间范围 | 排班计划的时间范围,如"9:00-17:00" | 是 | +| 状态 | 排班计划的状态,如"启用"、"禁用" | 否 | +| 班组 | 排班计划里包含的班组 | 否 | +| 备注 | 其他补充说明信息 | 否 | + +**【重要】** 排班计划编码创建后不允许修改。 +**【重要】** 排班计划被排班记录引用后,不允许删除。 + +**功能对应截图** : +![图片:新增排班计划截图](/public/image/process_model/图片:新增工序单元截图.png) + + +#### 3.2.3 排班计划查询 + +**查询条件:** + +| 查询条件 | 说明 | +| ---- | --------- | +| 排班编码 | 按排班编码精确查询 | +| 排班名称 | 按排班名称模糊查询 | +| 创建时间 | 按排班计划创建时间筛选 | + +**功能对应截图** : +![图片:排班计划查询截图](/public/image/process_model/图片:工序单元查询列表截图.png) + +#### 3.2.4 排班计划导入 + +**操作步骤:** + +1. 进入【生产配置】→【班组模型】→【排班计划】 +2. 点击【导入】按钮 +3. 上传排班计划文件 +4. 点击【确定】完成排班计划导入 + +#### 3.2.4 排班计划导出 + +**操作步骤:** + +1. 进入【生产配置】→【班组模型】→【排班计划】 +2. 点击【导出】按钮 +3. 选择导出格式(如Excel) +4. 点击【确定】完成排班计划导出 \ No newline at end of file diff --git a/production_configuration/SPC_configuration.md b/production_configuration/SPC_configuration.md new file mode 100644 index 0000000..88fcd11 --- /dev/null +++ b/production_configuration/SPC_configuration.md @@ -0,0 +1,208 @@ +# SPC采集模型 + +## 1. 功能概述 + +SPC采集模型属于 MES 系统的基础模块,用于配置工序单元的结果参数采集点位,实现对生产过程数据的实时采集与监控。SPC(Statistical Process Control)为统计过程控制,用于监控生产过程的稳定性。 + +**核心功能:** + +- SCADA点位绑定:配置工序单元与采集点位的关联关系 +- 采集参数管理:管理采集点位的数据采集参数 + + +**功能对应截图** : +![图片:SPC采集模型功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + + +## 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["首巡检数据
(First Inspection)"] + DT2["结果数据
(Result Data)"] + end + + subgraph 对应数据表 + T1["首巡检数据表
保存首件检验的数据"] + T2["结果参数表
保存工序结果的数据"] + 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
参数:点位编码、采集值 + 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采集点位之间的关联关系,实现生产数据的自动采集。 + +**功能对应截图** : +![图片:SCADA点位绑定列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +#### 4.1.2 新增点位绑定 + +**操作步骤:** + +1. 进入【生产配置】→【SPC采集模型】→【SCADA点位绑定】 +2. 点击【新增】按钮 +3. 选择需要绑定的工序单元 +4. 选择或配置SCADA采集点位 +5. 设置采集参数 +6. 点击【保存】完成点位绑定 + +**字段说明:** + +| 字段 | 说明 | 必填 | +|------|------|------| +| 工序单元 | 需要绑定点位的工序单元 | 是 | +| 点位编码 | SCADA系统的点位编码 | 是 | +| 点位名称 | 点位的描述名称 | 是 | +| 数据类型 | 点位的数据类型,如"数值"、"开关" | 是 | +| 采集频率 | 数据采集的频率,单位为秒 | 是 | +| 状态 | 启用/禁用 | 否 | +| 备注 | 其他补充说明信息 | 否 | + +**【重要】** 点位编码必须与SCADA系统中配置一致,否则无法正常采集数据。 +**【重要】** 同一工序单元不能重复绑定相同的点位编码。 + +**功能对应截图** : +![图片:新增点位绑定截图](/public/image/process_model/图片:新增工序单元截图.png) + +#### 4.1.3 编辑点位绑定 + +**操作步骤:** + +1. 进入【生产配置】→【SPC采集模型】→【SCADA点位绑定】 +2. 在列表中找到需要编辑的绑定记录 +3. 点击【编辑】按钮 +4. 修改需要更新的信息 +5. 点击【保存】完成修改 + +**【注意】** 已采集的历史数据不受影响。 + +#### 4.1.4 删除点位绑定 + +**操作步骤:** + +1. 进入【生产配置】→【SPC采集模型】→【SCADA点位绑定】 +2. 在列表中找到需要删除的绑定记录 +3. 点击【删除】按钮 +4. 确认删除操作 + +**【注意】** 删除点位绑定后,该点位的后续数据将停止采集,已采集数据保留。 + +#### 4.1.5 点位绑定查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 工序单元 | 按工序单元筛选 | +| 点位编码 | 按点位编码精确查询 | +| 点位名称 | 按点位名称模糊查询 | +| 状态 | 按启用/禁用状态筛选 | +| 创建时间 | 按创建时间范围筛选 | + diff --git a/production_configuration/material_model.md b/production_configuration/material_model.md new file mode 100644 index 0000000..e8ed6ed --- /dev/null +++ b/production_configuration/material_model.md @@ -0,0 +1,300 @@ +# 物料模型管理 + +## 1. 功能概述 + +物料模型管理属于 MES 系统的基础模块,用于构建企业的物料分类、物料基本信息和 BOM 物料清单等核心数据,为生产计划、物料采购、仓库管理、成本核算等业务模块提供物料基础数据支撑。 + +**核心功能:** + +- 物料类别列表:维护物料的分类体系,按物料类型进行分类管理 +- 物料信息管理:维护物料的基本信息、物料属性、计量单位等 +- BOM物料清单:维护产品的物料构成清单,定义产品与物料的用量关系 +- 计量单位:定义物料的数量计量标准单位,如个、件、千克、米等 + + +**功能对应截图** : +![图片:物料模型功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + +## 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 物料类别说明 + +物料类别是对物料进行分类管理的单元,用于区分不同类型的物料,便于物料的检索和维护。 + +**功能对应截图** : +![图片:物料类别列表截图](/public/image/process_model/图片:工艺流程类别列表截图.png) + +#### 3.1.2 新增物料类别 + +**操作步骤:** + +1. 进入【生产配置】→【物料模型】→【物料类别列表】 +2. 点击【新增】按钮 +3. 填写基本信息 +4. 点击【保存】完成类别创建 + +**字段说明:** + +| 字段 | 说明 | 必填 | +|------|------|------| +| 物料类别编码 | 类别的唯一标识代码 | 是 | +| 物料类别名称 | 类别的名称,如"原材料"、"半成品" | 是 | +| 备注 | 其他补充说明信息 | 否 | + +**【重要】** 物料类别编码一旦启用不允许修改和删除,请在创建时仔细确认。 + +**功能对应截图** : +![图片:物料类别设置截图](/public/image/process_model/图片:工艺流程类别设置截图.png) + +#### 3.1.3 物料类别查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 物料类别编码 | 按物料类别编码精确查询 | +| 物料类别名称 | 按物料类别名称模糊查询 | +| 上级类别 | 按上级类别筛选 | + +### 3.2 物料信息管理 + +#### 3.2.1 物料信息说明 + +物料信息是描述物料基本属性和特征的核心数据,包括物料编码、名称、计量单位等,是企业物料管理的基础。 + +**物料信息特点:** + +- 唯一性:每个物料有唯一的物料编码 +- 规范性:物料信息有统一的数据规范和标准 +- 关联性:物料信息可被BOM、工单、仓库等模块引用 + +**功能对应截图** : +![图片:物料信息列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +#### 3.2.2 新增物料信息 + +**操作步骤:** + +1. 进入【生产配置】→【物料模型】→【物料信息管理】 +2. 点击【新增】按钮 +3. 填写物料基本信息 +4. 点击【保存】完成物料信息创建 + +**字段说明:** + +| 字段 | 说明 | 必填 | +|------|------|------| +| 物料编码 | 物料的唯一标识代码 | 是 | +| 物料名称 | 物料的名称 | 是 | +| 物料类别 | 关联的物料类别 | 是 | +| 计量单位 | 物料的计量单位,如个、件、千克等 | 是 | +| 备注 | 其他补充说明信息 | 否 | + +**【注意】** 物料编码创建后不允许修改,请在创建时仔细确认。 +**【重要】** 物料信息被BOM或其他单据引用后,不允许删除。 + +**功能对应截图** : +![图片:新增物料信息截图](/public/image/process_model/图片:新增工序单元截图.png) + +#### 3.2.3 物料信息查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 物料编码 | 按物料编码精确查询 | +| 物料名称 | 按物料名称模糊查询 | +| 物料类别 | 按物料类别筛选 | +| 物料类型 | 按物料类型筛选 | + +**功能对应截图** : +![图片:物料信息查询列表截图](/public/image/process_model/图片:工序单元查询列表截图.png) + +### 3.3 BOM物料清单管理 + +#### 3.3.1 BOM物料清单说明 + +BOM物料清单是定义产品与物料构成关系的核心数据,记录产品由哪些物料组成、各物料的用量比例关系。BOM是生产计划、物料采购、成本核算的重要依据。 + +**BOM物料清单特点:** + +- 层级性:支持多层级BOM,体现产品的装配结构 +- 用量关系:明确各层级的物料用量和比例 +- 版本管理:支持BOM版本变更和历史追溯 + +**功能对应截图** : +![图片:BOM物料清单列表截图](/public/image/process_model/图片:工艺流程列表截图.png) + +#### 3.3.2 新增BOM物料清单 + +**操作步骤:** + +1. 进入【生产配置】→【物料模型】→【BOM物料清单】 +2. 点击【新增】按钮 +3. 填写BOM基本信息 +4. 点击【保存】完成BOM创建 + +**字段说明:** + +| 字段 | 说明 | 必填 | +|------|------|------| +| BOM版本编码 | BOM的唯一标识代码 | 是 | +| BOM版本名称 | BOM的名称,如"产品A的物料清单" | 是 | +| 产品编码 | 关联的产品型号 | 是 | +| 状态 | 状态:启用、禁用 | 是 | +| 备注 | 其他补充说明信息 | 否 | + +**【重要】** BOM被生产工单引用后,不允许删除。 + +**功能对应截图** : +![图片:新增BOM物料清单截图](/public/image/process_model/图片:新增工艺流程截图.png) + +#### 3.3.3 设置BOM + +**操作步骤:** + +1. 进入【生产配置】→【物料模型】→【BOM物料清单】 +2. 选择要设置的BOM,点击【设置BOM】按钮 +3. 选择对应的工序,在IN/OUT中配置物料信息和投入数量 + + +**BOM子项字段说明:** + +| 字段 | 说明 | 必填 | +|------|------|------| +| IN/OUT | 工序的投料和产出品 | 是 | +| 物料类别 | 引用的物料类别 | 是 | +| 物料编码 | 引用的物料编码 | 是 | +| 物料名称 | 引用的物料名称 | 是 | +| 投入数量 | 生产一个产品该物料的用量 | 是 | +| 单位 | 物料用量的计量单位 | 是 | + +**【注意】** 同一BOM中不允许出现相同的物料编码。 +**【注意】** BOM子项的用量单位应与物料信息的计量单位一致。 + +**功能对应截图** : +![图片:BOM子项物料配置截图](/public/image/process_model/图片:工艺详情页面截图.png) + +#### 3.3.4 BOM物料清单查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| BOM编码 | 按BOM编码精确查询 | +| BOM名称 | 按BOM名称模糊查询 | +| 产品型号 | 按产品型号筛选 | + + +### 3.4 计量单位管理 + +#### 3.4.1 计量单位说明 + +计量单位是物料信息的属性之一,用于标准化工物料数量的计量。系统预置常用的计量单位,同时支持用户自定义计量单位。 + +**常用计量单位类型:** + +- 数量单位:个、件、只、支、台、套 +- 重量单位:千克、克、吨、磅 +- 长度单位:米、厘米、毫米、英寸 +- 体积单位:升、毫升、立方米 +- 面积单位:平方米、平方厘米 + +**功能对应截图** : +![图片:计量单位列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +#### 3.4.2 新增计量单位 + +**操作步骤:** + +1. 进入【生产配置】→【物料模型】→【计量单位】 +2. 点击【新增】按钮 +3. 填写计量单位基本信息 +4. 点击【保存】完成计量单位创建 + +**字段说明:** + +| 字段 | 说明 | 必填 | +|------|------|------| +| 单位编码 | 单位的唯一标识代码 | 是 | +| 单位名称 | 单位的名称,如"个"、"千克" | 是 | +| 备注 | 其他补充说明信息 | 否 | + +**【注意】** 系统预置的计量单位不允许修改和删除。 +**【重要】** 计量单位被物料信息引用后,不允许删除。 + +**功能对应截图** : +![图片:新增计量单位截图](/public/image/process_model/图片:新增工序单元截图.png) + +#### 3.4.3 计量单位查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 单位编码 | 按单位编码精确查询 | +| 单位名称 | 按单位名称模糊查询 | +| 单位类型 | 按单位类型筛选 | diff --git a/production_configuration/product_model.md b/production_configuration/product_model.md new file mode 100644 index 0000000..0e7e41b --- /dev/null +++ b/production_configuration/product_model.md @@ -0,0 +1,228 @@ +# 产品模型管理 + +## 1. 功能概述 + +产品模型管理属于 MES 系统的基础模块,用于构建企业的产品分类、产品基本信息、异常不良类别等核心数据,为生产计划、工单执行、品质管理等业务模块提供产品基础数据支撑。 + +**核心功能:** + +- 产品列表:维护产品的基本信息,支持产品的分类管理和多层级产品结构 +- 异常不良管理:维护产品的异常不良类别,绑定设备类别,用于生产过程中的品质异常记录 + + +**功能对应截图** : +![图片:产品模型功能截图](/public/image/process_model/图片:工艺模型功能截图.png) + +## 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 产品列表说明 + +产品列表是记录产品基本信息的核心数据,包括产品型号、产品名称等,是企业生产执行和品质管理的基础。 + +**产品列表特点:** + +- 关联性:产品信息可被工艺流程 + +**功能对应截图** : +![图片:产品列表截图](/public/image/process_model/图片:工序单元列表截图.png) + +#### 3.1.2 新增产品 + +**操作步骤:** + +1. 进入【生产配置】→【产品模型】→【产品列表】 +2. 点击【新增】按钮 +3. 填写产品基本信息 +4. 点击【保存】完成产品创建 + +**字段说明:** + +| 字段 | 说明 | 必填 | +|------|------|------| +| 产品型号 | 产品的唯一标识代码 | 是 | +| 产品名称 | 产品的名称 | 是 | +| 备注 | 其他补充说明信息 | 否 | + +**【重要】** 产品型号创建后不允许修改,请在创建时仔细确认。 +**【重要】** 产品被工艺流程或工单引用后,不允许删除。 + +**功能对应截图** : +![图片:新增产品截图](/public/image/process_model/图片:新增工序单元截图.png) + +#### 3.1.3 产品查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 产品型号 | 按产品型号精确查询 | +| 产品名称 | 按产品名称模糊查询 | +| 产品分类 | 按产品分类筛选 | + +**功能对应截图** : +![图片:产品查询列表截图](/public/image/process_model/图片:工序单元查询列表截图.png) + +### 3.2 异常不良管理 + +#### 3.2.1 异常不良管理说明 + +异常不良管理是用于记录生产过程中出现的异常情况,包括NG(不合格品)和ERR(错误)两种类型。异常不良类别绑定设备类别,用于特定设备工序的异常记录。 + +**异常不良类型:** + +| 类型 | 说明 | +|------|------| +| NG | Not Good,不合格品,生产过程中判定为不合格的产品 | +| ERR | Error,错误,系统或设备运行时出现的错误信息 | + +**功能对应截图** : +![图片:异常不良管理列表截图](/public/image/process_model/图片:工艺流程列表截图.png) + +#### 3.2.2 新增异常不良类别 + +**操作步骤:** + +1. 进入【生产配置】→【产品模型】→【异常不良管理】 +2. 点击【新增】按钮 +3. 选择异常类型(NG/ERR) +4. 填写异常不良类别信息 +5. 选择绑定的设备类别 +6. 点击【保存】完成异常不良类别创建 + +**字段说明:** + +| 字段 | 说明 | 必填 | +|------|------|------| +| 异常类别编码 | 异常类别的唯一标识代码 | 是 | +| 异常类别名称 | 异常类别的名称,如"短路"、"开路" | 是 | +| 异常类型 | NG(不合格)/ ERR(错误) | 是 | +| 设备类别 | 绑定的设备类别,用于特定设备的异常记录 | 是 | +| 备注 | 其他补充说明信息 | 否 | + +**【重要】** 异常类别编码创建后不允许修改。 +**【重要】** 异常不良类别被使用后,不允许删除。 + +**功能对应截图** : +![图片:新增异常不良类别截图](/public/image/process_model/图片:新增工艺流程截图.png) + +#### 3.2.3 异常不良类别查询 + +**查询条件:** + +| 查询条件 | 说明 | +|---------|------| +| 异常类别编码 | 按异常类别编码精确查询 | +| 异常类别名称 | 按异常类别名称模糊查询 | +| 异常类型 | 按异常类型筛选:NG / ERR | +| 设备类别 | 按绑定的设备类别筛选 | + +**功能对应截图** : +![图片:异常不良类别查询列表截图](/public/image/process_model/图片:工艺详情页面截图.png) + +#### 3.2.4 导入异常不良类别 + +导入功能支持批量导入异常不良类别数据,提高数据维护效率。 + +**操作步骤:** + +1. 进入【生产配置】→【产品模型】→【异常不良管理】 +2. 点击【导入】按钮 +3. 下载导入模板 +4. 按照模板格式填写异常不良类别数据 +5. 点击【选择文件】上传填写好的Excel文件 +6. 点击【开始导入】执行数据导入 +7. 查看导入结果报告 + +**导入模板字段说明:** + +| 字段 | 说明 | 必填 | 示例 | +|------|------|------|------| +| 异常类别编码 | 异常类别的唯一标识代码 | 是 | NG-001 | +| 异常类别名称 | 异常类别的名称 | 是 | 短路 | +| 异常类型 | NG(不合格)/ ERR(错误) | 是 | NG | +| 设备类别编码 | 绑定的设备类别编码 | 是 | DEV-SMT | +| 备注 | 其他补充说明信息 | 否 | - | + +**【注意】** 导入前请确保设备类别已存在。 +**【提示】** 建议先导入少量数据进行验证,确认格式正确后再进行大批量导入。 + +**功能对应截图** : +![图片:导入异常不良类别对话框截图](/public/image/process_model/图片:导入结果参数的按钮和文件对话框截图.png) + +#### 3.2.5 批量删除异常不良类别 + +批量删除功能支持一次删除多个异常不良类别,提高数据清理效率。 + +**操作步骤:** + +1. 进入【生产配置】→【产品模型】→【异常不良管理】 +2. 在列表中勾选需要删除的异常不良类别(可多选) +3. 点击【批量删除】按钮 +4. 在弹出的确认对话框中确认删除 +5. 点击【确定】执行批量删除 + +**【注意】** 已使用的异常不良类别不允许删除。 +**【注意】** 删除操作不可恢复,请在删除前仔细确认。 +**【提示】** 建议在删除前先查询该类别是否已被工单或异常记录引用。 + +**功能对应截图** : +![图片:批量删除确认对话框截图](/public/image/process_model/图片:查看日志对话框截图.png) + +### 3.3 异常不良管理说明 + +异常不良管理独立于产品和工艺流程,仅与设备类别存在绑定关系。异常不良类别用于记录设备在生产过程中出现的异常情况。 + +**【重要】** 异常不良管理不与工艺流程关联,而是直接与设备类别绑定。 +**【重要】** 多个异常不良类别可以绑定同一个设备类别,实现异常分类的统一管理。 diff --git a/quality_control/spc.md b/quality_control/spc.md new file mode 100644 index 0000000..7214fcc --- /dev/null +++ b/quality_control/spc.md @@ -0,0 +1,8 @@ +# SPC模块 + +## 1. 功能概述 +- SPC模块是 MES 系统的质量控制模块,用于对产线上的首巡检数据、过程数据、结果数据输出SPC报表。 + + +**核心功能:** +- SPC渲染条件配置:根据不同的SPC报表类型,配置不同的渲染条件,如时间范围、产品类型等。 diff --git a/system_settings/menu_configuration.md b/system_settings/menu_configuration.md new file mode 100644 index 0000000..a21bba0 --- /dev/null +++ b/system_settings/menu_configuration.md @@ -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。 \ No newline at end of file diff --git a/system_settings/system_assistant.md b/system_settings/system_assistant.md new file mode 100644 index 0000000..3ca461c --- /dev/null +++ b/system_settings/system_assistant.md @@ -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)用途根据接口类型不同而有所差异,具体含义需要结合业务场景理解。 \ No newline at end of file diff --git a/system_settings/system_monitoring.md b/system_settings/system_monitoring.md new file mode 100644 index 0000000..10cc0ef --- /dev/null +++ b/system_settings/system_monitoring.md @@ -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地址和端口可以正常访问,否则监控数据无法获取。 \ No newline at end of file diff --git a/system_settings/user_management.md b/system_settings/user_management.md new file mode 100644 index 0000000..29bd126 --- /dev/null +++ b/system_settings/user_management.md @@ -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. 注意事项 + +**【重要】** 用户在进行删除或禁用操作时,不能操作自己的账号。 + +**【注意】** 删除或禁用角色前,请确保该角色下没有关联的用户。 + +**【提示】** 导入用户数据时,如果用户名已存在,该行数据将被跳过。 \ No newline at end of file diff --git a/后台Webman功能模型代码.md b/后台Webman功能模型代码.md new file mode 100644 index 0000000..1053e72 --- /dev/null +++ b/后台Webman功能模型代码.md @@ -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) | | | 完成 | | + +