diff --git a/guide/document-guide.md b/guide/document-guide.md new file mode 100644 index 0000000..5f386a9 --- /dev/null +++ b/guide/document-guide.md @@ -0,0 +1,120 @@ +# 文档说明 + +## 1. 文档简介 + +本文档为 HF-MES v5.0 制造执行系统的完整使用指南，旨在帮助用户快速掌握系统的各项功能，顺利完成日常生产管理任务。 + +**文档版本：** v1.0 +**发布日期：** 2026-04-10 +**适用版本：** HF-MES v5.0 + +## 2. 文档结构 + +| 章节 | 名称 | 主要内容 | +|------|------|---------| +| 文档说明篇 | 文档管理 | 文档说明、系统概述 | +| 快速入门篇 | 新手入门 | 系统登录、快速入门指南 | +| 基础配置篇 | 基础配置 | 基础数据管理、设备基础信息 | +| 生产管理篇 | 生产执行 | 生产计划、工单管理、报工管理 | +| 质量管理篇 | 质量追溯 | 质量检验、质量控制、追溯管理 | +| 仓储物流篇 | 仓储管理 | 入库管理、出库管理、库存管理 | +| 数据集成篇 | 系统集成 | 数据接口、系统集成方案 | +| 报表分析篇 | 数据分析 | 生产报表、质量报表、设备报表 | +| 系统运维篇 | 系统管理 | 系统管理、系统运维 | +| 技术支持篇 | 技术支持 | 异常处理、技术支持 | +| 附录篇 | 参考资料 | 术语表、流程图、更新日志 | + +## 3. 文档约定 + +### 3.1 菜单路径表示 + +本文档使用【】表示菜单路径，例如： + +- 【系统管理】→【用户管理】表示：点击"系统管理"菜单，然后点击"用户管理"子菜单 + +### 3.2 界面元素表示 + +| 表示方式 | 含义 | 示例 | +|---------|------|------| +| 【按钮】 | 操作按钮 | 【保存】、【取消】 | +| 「输入框」 | 输入控件 | 「工单编号」 | +| 「下拉框」 | 选择控件 | 「工单状态」 | +| ☐ | 复选框 | ☐ 启用 | +| ○ | 单选按钮 | ○ 新增 | + +### 3.3 操作步骤表示 + +**操作步骤格式：** + +1. 第一步操作 +2. 第二步操作 +3. 第三步操作 + +### 3.4 注意事项 + +| 标记 | 含义 | +|------|------| +| 【注意】 | 需要特别注意的事项 | +| 【提示】 | 有助于操作的提示信息 | +| 【重要】 | 必须遵守的重要规则 | + +## 4. 符号说明 + +| 符号 | 说明 | 示例 | +|------|------|------| +| → | 操作流向 | 工单创建 → 工单审核 | +| ───▶ | 流程跳转 | 提交 ───▶ 审批 | +| │ | 分支判断 | 是 │ 否 | +| □ | 可选项 | □ 启用 | +| ■ | 已选项 | ■ 启用 | +| - | 列表项 | - 列表内容 | + +## 5. 排版规范 + +### 5.1 标题层级 + +使用 # 符号表示标题层级： + +- # 一级标题 +- ## 二级标题 +- ### 三级标题 +- #### 四级标题 + +### 5.2 表格格式 + +| 列头1 | 列头2 | 列头3 | +|-------|-------|-------| +| 内容1 | 内容2 | 内容3 | +| 内容4 | 内容5 | 内容6 | + +### 5.3 代码块 + +使用 ``` 包裹代码块，例如： + +```bash +# 示例命令 +cd /opt/mes +./start.sh +``` + +## 6. 文档维护 + +### 6.1 更新频率 + +- 常规更新：每月一次 +- 紧急更新：随时发布 + +### 6.2 反馈渠道 + +如果您发现文档内容有误或需要补充，请通过以下方式反馈： + +- 邮箱：docs-feedback@hfmes.com +- 服务热线：400-XXX-XXXX + +## 7. 版权声明 + +本文档版权归 HF-MES 所属公司所有，未经许可不得擅自复制、传播或修改。 + +--- + +**文档说明篇完** diff --git a/guide/system-overview.md b/guide/system-overview.md new file mode 100644 index 0000000..5413de7 --- /dev/null +++ b/guide/system-overview.md @@ -0,0 +1,376 @@ +# 文档说明 +## 系统概述 + +## 1. 系统简介 + +HF-MES v5.0（Manufacturing Execution System）是一套面向制造企业的生产执行管理系统，旨在实现生产过程的数字化、智能化管理，提高生产效率、保证产品质量、降低运营成本。 + +### 1.1 系统定位 + +``` +┌─────────────────────────────────────────────────────────┐ +│ 企业信息化金字塔 │ +├─────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────┐ │ +│ │ ERP │ 企业资源计划 │ +│ │ 企业管理层 │ │ +│ └──────┬──────┘ │ +│ │ │ +│ ┌──────▼──────┐ │ +│ │ MES │ 制造执行系统 │ +│ │ 生产执行层 │ ← 我们的系统 │ +│ └──────┬──────┘ │ +│ │ │ +│ ┌──────▼──────┐ │ +│ │ SCADA │ 数据采集与监控系统 │ +│ │ 设备控制层 │ │ +│ └─────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────┘ +``` + +### 1.2 核心价值 + +| 核心价值 | 说明 | 客户收益 | +|---------|------|---------| +| 生产透明化 | 实时监控生产进度 | 掌握实时生产状态 | +| 过程可追溯 | 全流程数据追溯 | 质量问题快速定位 | +| 质量可控 | 全过程质量控制 | 产品质量有保障 | +| 效率提升 | 优化生产流程 | 生产效率提升 | +| 成本降低 | 减少浪费损耗 | 生产成本下降 | + +## 2. 系统架构 + +### 2.1 技术架构 + +**系统采用前后端分离架构：** + +| 层级 | 技术栈 | 说明 | +|------|--------|------| +| 前端展示层 | Vue.js + Element UI | 用户界面交互 | +| 后端服务层 | Java Spring Boot | 业务逻辑处理 | +| 数据存储层 | MySQL + Redis | 数据存储与缓存 | +| 消息中间件 | RabbitMQ | 异步消息处理 | +| 文件存储 | MinIO/OSS | 文件与附件存储 | + +### 2.2 系统部署架构 + +``` +┌────────────────────────────────────────────────────────────┐ +│ 客户端层 │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Web浏览器 │ │ 移动端 │ │ 大屏展示 │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└────────────────────────────────────────────────────────────┘ + │ + ▼ +┌────────────────────────────────────────────────────────────┐ +│ 应用服务层 │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Web服务 │ │ API服务 │ │ 定时服务 │ │ +│ │ (Nginx) │ │ (Gateway) │ │ (Scheduler) │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└────────────────────────────────────────────────────────────┘ + │ + ▼ +┌────────────────────────────────────────────────────────────┐ +│ 数据服务层 │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ 数据库 │ │ 缓存 │ │ 消息队列 │ │ +│ │ (MySQL) │ │ (Redis) │ │ (RabbitMQ) │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└────────────────────────────────────────────────────────────┘ + │ + ▼ +┌────────────────────────────────────────────────────────────┐ +│ 设备集成层 │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ PLC/SCADA │ │ RFID │ │ 条码枪 │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└────────────────────────────────────────────────────────────┘ +``` + +### 2.3 系统网络架构 + +``` + ┌─────────────────┐ + │ 互联网用户 │ + └────────┬────────┘ + │ + ▼ +┌────────────────────────────────────────────────────────────┐ +│ 企业内网 │ +│ │ +│ ┌────────────────────┐ ┌────────────────────┐ │ +│ │ MES应用服务器 │◀────▶│ ERP服务器 │ │ +│ │ (应用集群) │ │ (SAP/用友/金蝶) │ │ +│ └─────────┬──────────┘ └────────────────────┘ │ +│ │ │ +│ ├──────────┬──────────┬──────────┐ │ +│ │ │ │ │ │ +│ ▼ ▼ ▼ ▼ │ +│ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ +│ │ 车间1 │ │ 车间2 │ │ 车间3 │ │ 仓库 │ │ +│ │ 客户端 │ │ 客户端 │ │ 客户端 │ │ 客户端 │ │ +│ └────────┘ └────────┘ └────────┘ └────────┘ │ +│ │ │ │ │ │ +│ └──────────┴──────────┴──────────┘ │ +│ │ │ +│ ▼ │ +│ ┌────────────┐ │ +│ │ 数据库服务器 │ │ +│ │ (主备集群) │ │ +│ └────────────┘ │ +└────────────────────────────────────────────────────────────┘ +``` + +## 3. 功能模块 + +### 3.1 功能模块总览 + +``` +┌─────────────────────────────────────────────────────────┐ +│ HF-MES v5.0 功能架构 │ +├─────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────────────────────────────────────────────┐ │ +│ │ 系统管理层 │ │ +│ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │ +│ │ │ 用户管理 │ │ 角色管理 │ │ 权限管理 │ │ 参数配置 │ │ │ +│ │ └────────┘ └────────┘ └────────┘ └────────┘ │ │ +│ └─────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────┐ │ +│ │ 生产管理层 │ │ +│ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │ +│ │ │ 生产计划 │ │ 工单管理 │ │ 报工管理 │ │ 生产调度 │ │ │ +│ │ └────────┘ └────────┘ └────────┘ └────────┘ │ │ +│ └─────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────┐ │ +│ │ 质量管理层 │ │ +│ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │ +│ │ │ 来料检验 │ │ 过程检验 │ │ 成品检验 │ │ 质量追溯 │ │ │ +│ │ └────────┘ └────────┘ └────────┘ └────────┘ │ │ +│ └─────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────┐ │ +│ │ 仓储管理层 │ │ +│ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │ +│ │ │ 入库管理 │ │ 出库管理 │ │ 库存管理 │ │ 库位管理 │ │ │ +│ │ └────────┘ └────────┘ └────────┘ └────────┘ │ │ +│ └─────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────┐ │ +│ │ 设备管理层 │ │ +│ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │ +│ │ │ 设备台账 │ │ 点检保养 │ │ 故障维修 │ │ OEE分析 │ │ │ +│ │ └────────┘ └────────┘ └────────┘ └────────┘ │ │ +│ └─────────────────────────────────────────────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────┐ │ +│ │ 报表管理层 │ │ +│ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │ +│ │ │ 生产报表 │ │ 质量报表 │ │ 设备报表 │ │ 库存报表 │ │ │ +│ │ └────────┘ └────────┘ └────────┘ └────────┘ │ │ +│ └─────────────────────────────────────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────┘ +``` + +### 3.2 模块详细介绍 + +#### 3.2.1 生产管理模块 + +**核心功能：** + +| 功能 | 说明 | +|------|------| +| 生产计划 | 根据销售订单生成生产计划 | +| 工单管理 | 工单的创建、审核、下发、变更 | +| 报工管理 | 生产报工、完工确认 | +| 生产监控 | 实时监控生产进度、状态 | +| 工序管理 | 工艺路线、工序定义 | +| 物料流转 | 投料、领料、半成品流转 | + +#### 3.2.2 质量管理模块 + +**核心功能：** + +| 功能 | 说明 | +|------|------| +| 检验标准 | 检验项目、检验标准定义 | +| IQC检验 | 来料质量控制 | +| IPQC检验 | 过程质量控制 | +| FQC/OQC | 成品/出货检验 | +| 质量异常 | 不良品处理、MRB管理 | +| 质量追溯 | 正向/逆向追溯 | + +#### 3.2.3 仓储管理模块 + +**核心功能：** + +| 功能 | 说明 | +|------|------| +| 入库管理 | 采购入库、生产入库、其他入库 | +| 出库管理 | 生产领料、销售出库、其他出库 | +| 库存管理 | 库存查询、库存预警、库存盘点 | +| 库位管理 | 库位定义、库位分配 | +| 批次管理 | 批次定义、批次追溯 | +| 齐套检查 | 物料齐套性检查 | + +#### 3.2.4 设备管理模块 + +**核心功能：** + +| 功能 | 说明 | +|------|------| +| 设备台账 | 设备信息、分类管理 | +| 点检管理 | 日常点检、点检标准 | +| 保养管理 | 计划保养、保养标准 | +| 故障管理 | 故障报修、维修记录 | +| OEE分析 | 设备综合效率分析 | +| 备件管理 | 备件库存、备件领用 | + +### 3.3 功能矩阵 + +| 功能模块 | 基础版 | 标准版 | 高级版 | 旗舰版 | +|---------|--------|--------|--------|--------| +| 生产管理 | ✓ | ✓ | ✓ | ✓ | +| 质量管理 | ✓ | ✓ | ✓ | ✓ | +| 仓储管理 | ✓ | ✓ | ✓ | ✓ | +| 设备管理 | - | ✓ | ✓ | ✓ | +| 报表分析 | 基础 | 基础 | 高级 | 高级 | +| 系统集成 | - | 基础 | 高级 | 高级 | +| 二次开发 | - | - | ✓ | ✓ | +| 私有化部署 | - | - | ✓ | ✓ | + +## 4. 适用行业 + +### 4.1 典型行业应用 + +| 行业 | 典型场景 | +|------|---------| +| 电子制造 | SMT贴片、组装测试、包装出货 | +| 汽车零部件 | 冲压、焊接、涂装、总装 | +| 机械加工 | CNC加工、装配、检测 | +| 食品饮料 | 配方生产、灌装包装、质量追溯 | +| 医药化工 | 制剂生产、包装、批次追溯 | +| 新能源 | 电池生产、光伏组件 | + +### 4.2 行业解决方案 + +针对不同行业，我们提供定制化的解决方案，包括： + +- 行业专用功能模块 +- 行业最佳实践流程 +- 行业特色报表模板 +- 行业集成接口方案 + +## 5. 性能指标 + +### 5.1 系统性能 + +| 指标 | 标准值 | 说明 | +|------|--------|------| +| 系统响应时间 | < 3秒 | 页面加载时间 | +| 接口响应时间 | < 1秒 | API调用响应 | +| 并发用户数 | 500+ | 同时在线用户 | +| 数据处理能力 | 10万+/日 | 日处理单据量 | +| 系统可用性 | 99.9% | 系统正常运行时间 | +| 数据备份 | 每日增量 | 自动备份机制 | + +### 5.2 运行环境 + +| 环境要求 | 配置 | +|---------|------| +| 浏览器 | Chrome、Firefox、Edge、360等 | +| 最低分辨率 | 1280×720 | +| 网络要求 | 局域网≥100M | +| 服务器配置 | CPU 8核+，内存 16G+，硬盘 500G+ | + +## 6. 安全特性 + +### 6.1 安全保障体系 + +| 安全维度 | 保障措施 | +|---------|---------| +| 身份认证 | 用户名密码、LDAP集成 | +| 权限控制 | RBAC权限模型 | +| 数据安全 | 传输加密、敏感字段加密 | +| 操作审计 | 完整操作日志记录 | +| 安全策略 | 密码策略、会话管理 | +| 数据备份 | 自动备份、异地备份 | + +### 6.2 权限模型 + +``` +┌─────────────────────────────────────────────────────────┐ +│ 权限模型 │ +├─────────────────────────────────────────────────────────┤ +│ │ +│ ┌─────────┐ │ +│ │ 用户 │ ←────────────┐ │ +│ └────┬────┘ │ │ +│ │ │ 归属 │ +│ ▼ │ │ +│ ┌─────────┐ │ │ +│ │ 角色 │──────────────┼──────────┐ │ +│ └────┬────┘ │ │ │ +│ │ │ 拥有 │ │ +│ ▼ │ ▼ │ +│ ┌─────────┐ │ ┌───────────┐ │ +│ │ 权限点 │◀─────────────┘ │ 功能菜单 │ │ +│ └─────────┘ └───────────┘ │ +│ │ +│ ┌─────────────────────────────────────────────────┐ │ +│ │ 数据权限 │ │ +│ │ 工厂级 ─ 车间级 ─ 产线级 ─ 个人数据 │ │ +│ └─────────────────────────────────────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────┘ +``` + +## 7. 与其他系统集成 + +### 7.1 系统集成架构 + +``` +┌─────────────────────────────────────────────────────────┐ +│ 系统集成架构 │ +├─────────────────────────────────────────────────────────┤ +│ │ +│ ┌───────────┐ │ +│ │ ERP │ ←──→ 物料主数据、工单、采购订单 │ +│ │ (SAP) │ │ +│ └─────┬─────┘ │ +│ │ │ +│ ▼ │ +│ ┌───────────┐ │ +│ │ MES │ ←──→ 生产执行、质量数据、设备数据 │ +│ │ (自身) │ │ +│ └─────┬─────┘ │ +│ │ │ +│ ▼ │ +│ ┌───────────┐ │ +│ │ SCADA │ ←──→ 设备数据、实时状态 │ +│ │ (设备层) │ │ +│ └───────────┘ │ +│ │ +└─────────────────────────────────────────────────────────┘ +``` + +### 7.2 集成方式 + +| 集成方式 | 说明 | 适用场景 | +|---------|------|---------| +| API接口 | RESTful API | 实时数据交换 | +| 中间库 | 数据库直连 | 批量数据同步 | +| 文件导入 | Excel/CSV导入 | 周期性数据交换 | +| 消息队列 | 事件驱动 | 异步消息通知 | +| WebService | SOAP接口 | 传统系统集成 | + +--- + +**系统概述篇完**