James/docker-vitepress
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Initial commit

Browse Source
This commit is contained in:
james
2026-05-19 22:27:43 +08:00
commit 2ee120f756
33 changed files with 11949 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

366
docs/operation/system-operation.md Normal file
View File

@@ -0,0 +1,366 @@
# 系统运维
## 1. 功能概述
系统管理与运维模块为系统管理员提供系统的配置、管理和运维功能，确保系统的稳定运行。
**核心功能：**
| 功能 | 说明 |
|------|------|
| 系统参数配置 | 通用参数、业务参数 |
| 审批流程配置 | 审批流程定义 |
| 消息通知配置 | 通知渠道、模板 |
| 日志管理与审计 | 操作日志、安全日志 |
| 数据备份与恢复 | 备份策略、数据恢复 |
| 权限安全策略 | 密码策略、登录安全 |
## 2. 系统参数配置
### 2.1 通用参数
**系统信息配置：**
| 参数项 | 说明 | 默认值 |
|--------|------|--------|
| 系统名称 | 显示在系统标题 | HF-MES |
| 系统Logo | 登录页面Logo | - |
| 公司名称 | 系统所属公司 | - |
| 工作开始时间 | 默认上班时间 | 08:00 |
| 工作结束时间 | 默认下班时间 | 18:00 |
| 日期格式 | 日期显示格式 | YYYY-MM-DD |
| 时间格式 | 时间显示格式 | HH:mm:ss |
### 2.2 业务参数
**生产参数配置：**
| 参数项 | 说明 | 默认值 |
|--------|------|--------|
| 工序流转规则 | 顺序/并行 | 顺序 |
| 报工允许提前时间 | 报工可提前分钟数 | 10分钟 |
| 工单超期预警 | 提前预警天数 | 3天 |
| 报工允许滞后时间 | 报工可滞后分钟数 | 30分钟 |
**质量参数配置：**
| 参数项 | 说明 | 默认值 |
|--------|------|--------|
| 检验标准默认值 | 默认检验标准 | - |
| 批次号编码规则 | 批次号格式 | LOT-YYYYMMDD-XXX |
| 允收质量水平(AQL) | 默认AQL值 | 1.0 |
**设备参数配置：**
| 参数项 | 说明 | 默认值 |
|--------|------|--------|
| 点检提醒时间 | 提前提醒分钟数 | 30分钟 |
| 保养提醒时间 | 提前提醒天数 | 7天 |
| 设备OEE计算周期 | OEE统计周期 | 日/月 |
**【注意】** 修改系统参数可能影响业务运行，请谨慎操作。
## 3. 审批流程配置
### 3.1 审批流程定义
**流程要素：**
| 要素 | 说明 |
|------|------|
| 流程编码 | 流程唯一标识 |
| 流程名称 | 流程显示名称 |
| 流程类型 | 审批的业务类型 |
| 流程节点 | 审批环节 |
| 审批人 | 各环节审批人 |
| 流转规则 | 条件判断 |
### 3.2 流程类型
| 流程类型 | 说明 | 示例 |
|---------|------|------|
| 工单变更 | 工单信息变更审批 | 数量调整、延期 |
| 物料放行 | 物料特殊放行审批 | 让步接收 |
| 设备报损 | 设备报废审批 | 设备报废 |
| 不良处理 | 不良品处置审批 | MRB处理 |
| 补料审批 | 生产补料审批 | 物料追加 |
### 3.3 审批节点配置
**节点配置项：**
| 配置项 | 说明 |
|--------|------|
| 节点名称 | 审批环节名称 |
| 审批角色 | 审批人角色 |
| 审批人 | 具体审批人员 |
| 审批方式 | 会签/或签 |
| 时限要求 | 审批时限 |
| 超时处理 | 超时后处理方式 |
**审批方式：**
| 方式 | 说明 |
|------|------|
| 会签 | 所有审批人必须全部通过 |
| 或签 | 任意一个审批人通过即可 |
## 4. 消息通知配置
### 4.1 通知渠道
| 渠道类型 | 说明 | 配置要求 |
|---------|------|---------|
| 系统消息 | 系统内消息通知 | 内置 |
| 邮件通知 | 发送至邮箱 | 配置SMTP |
| 短信通知 | 发送至手机 | 配置短信网关 |
| 钉钉通知 | 钉钉企业消息 | 钉钉应用配置 |
| 企业微信 | 企业微信消息 | 企业微信配置 |
### 4.2 通知类型配置
| 业务事件 | 通知类型 | 接收人 |
|---------|---------|--------|
| 工单下發 | 系统消息/邮件 | 车间主管 |
| 工单完工 | 系统消息 | 计划员 |
| 质量异常 | 系统消息/短信 | 质量工程师 |
| 设备故障 | 系统消息/短信 | 设备工程师 |
| 库存不足 | 系统消息/邮件 | 仓管员 |
| 审批待办 | 系统消息/邮件 | 审批人 |
### 4.3 通知模板
**模板配置项：**
| 配置项 | 说明 |
|--------|------|
| 模板编码 | 模板唯一标识 |
| 模板名称 | 模板名称 |
| 通知渠道 | 发送渠道 |
| 标题模板 | 消息标题 |
| 内容模板 | 消息内容 |
**模板变量：**
| 变量 | 说明 |
|------|------|
| ${工单编号} | 工单编号 |
| ${产品名称} | 产品名称 |
| ${数量} | 数量 |
| ${时间} | 时间 |
| ${审批人} | 审批人姓名 |
## 5. 日志管理与审计
### 5.1 日志类型
| 日志类型 | 说明 | 保留时间 |
|---------|------|---------|
| 操作日志 | 用户操作记录 | 6个月 |
| 系统日志 | 系统运行日志 | 3个月 |
| 接口日志 | 接口调用日志 | 6个月 |
| 异常日志 | 异常错误日志 | 12个月 |
| 安全日志 | 登录安全日志 | 12个月 |
### 5.2 操作日志内容
| 记录项 | 说明 |
|--------|------|
| 操作时间 | 操作发生时间 |
| 用户账号 | 执行操作的用户 |
| 用户姓名 | 用户姓名 |
| 操作类型 | 操作类别 |
| 操作内容 | 具体操作描述 |
| 操作对象 | 操作的数据对象 |
| IP地址 | 操作人IP地址 |
| 结果 | 成功/失败 |
### 5.3 日志查询
**查询条件：**
| 查询维度 | 可选条件 |
|---------|---------|
| 时间范围 | 开始时间-结束时间 |
| 用户 | 操作人员 |
| 操作类型 | 新增/修改/删除等 |
| 操作模块 | 功能模块 |
| 操作结果 | 成功/失败 |
### 5.4 审计报表
| 报表类型 | 说明 |
|---------|------|
| 用户操作统计 | 各用户操作频次 |
| 模块操作统计 | 各模块操作统计 |
| 异常操作统计 | 失败操作统计 |
| 登录审计 | 登录情况审计 |
## 6. 数据备份与恢复
### 6.1 备份策略
| 备份类型 | 执行频率 | 保留份数 | 说明 |
|---------|---------|---------|------|
| 全量备份 | 每周 | 4份 | 每周一次完整备份 |
| 增量备份 | 每日 | 7份 | 每日备份增量数据 |
| 实时备份 | 实时 | - | 数据库日志备份 |
### 6.2 备份配置
**备份任务配置：**
| 配置项 | 说明 |
|--------|------|
| 任务名称 | 备份任务名称 |
| 备份类型 | 全量/增量 |
| 执行时间 | 备份执行时间 |
| 存储位置 | 备份文件存放位置 |
| 保留策略 | 备份保留份数 |
| 压缩方式 | 是否压缩 |
### 6.3 手动备份
**操作步骤：**
1. 进入【系统管理】→【数据备份】
2. 点击【手动备份】
3. 选择备份类型
4. 点击【开始备份】
5. 系统执行备份
6. 完成后显示备份文件
### 6.4 数据恢复
**恢复操作步骤：**
1. 进入【系统管理】→【数据恢复】
2. 选择恢复时间点
3. 选择备份文件
4. 确认恢复信息
5. 确认恢复（需输入确认码）
6. 系统执行恢复
7. 恢复完成后重启服务
**【重要】** 数据恢复会覆盖当前数据，请确保已做好当前数据备份！
## 7. 权限安全策略
### 7.1 密码策略
| 策略项 | 配置值 | 说明 |
|--------|--------|------|
| 最小长度 | 8位 | 密码最少位数 |
| 复杂度要求 | 必须包含字母和数字 | 复杂度规则 |
| 有效期 | 90天 | 密码有效天数 |
| 过期提醒 | 7天 | 过期前提醒 |
| 历史密码 | 5个 | 不能重复使用 |
| 尝试次数 | 5次 | 错误次数限制 |
| 锁定时间 | 30分钟 | 账户锁定时间 |
### 7.2 登录安全
| 配置项 | 说明 |
|--------|------|
| 允许同时登录 | 是/否 |
| 会话超时时间 | 30分钟 |
| IP白名单 | 允许登录的IP |
| IP黑名单 | 禁止登录的IP |
| 异地登录提醒 | 是/否 |
### 7.3 数据权限
**数据权限级别：**
| 权限级别 | 说明 |
|---------|------|
| 全部数据 | 可查看所有数据 |
| 工厂级 | 只能查看所属工厂数据 |
| 车间级 | 只能查看所属车间数据 |
| 产线级 | 只能查看所属产线数据 |
| 个人数据 | 只能查看自己的数据 |
## 8. 系统性能监控
### 8.1 监控指标
| 指标类别 | 具体指标 | 正常范围 |
|---------|---------|---------|
| 服务器性能 | CPU使用率 | < 80% |
| 服务器性能 | 内存使用率 | < 85% |
| 服务器性能 | 磁盘使用率 | < 90% |
| 数据库性能 | 连接数 | < 连接池上限 |
| 数据库性能 | 查询响应时间 | < 1秒 |
| 应用性能 | API响应时间 | < 3秒 |
| 应用性能 | 并发用户数 | < 许可数量 |
### 8.2 监控面板
**监控面板展示：**
```
┌─────────────────────────────────────────────────────────────┐
│ 系统监控面板 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 服务器状态 │
│ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │
│ │ CPU │ │ 内存 │ │ 磁盘 │ │
│ │ 45.2% │ │ 68.5% │ │ 52.3% │ │
│ └───────────────┘ └───────────────┘ └───────────────┘ │
│ │
│ 应用服务状态 │
│ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │
│ │ Web服务 │ │ API服务 │ │ 定时服务 │ │
│ │ 正常 │ │ 正常 │ │ 正常 │ │
│ └───────────────┘ └───────────────┘ └───────────────┘ │
│ │
│ 数据库状态 │
│ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │
│ │ 连接数 │ │ 活跃会话 │ │ 查询响应 │ │
│ │ 45/200 │ │ 12 │ │ 0.5秒 │ │
│ └───────────────┘ └───────────────┘ └───────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
```
### 8.3 告警配置
| 告警项 | 告警条件 | 告警方式 |
|--------|---------|---------|
| CPU过高 | > 90% | 短信/邮件 |
| 内存过高 | > 95% | 短信/邮件 |
| 磁盘空间不足 | < 10% | 短信/邮件 |
| 服务宕机 | 服务停止 | 短信/电话 |
| 数据库连接满 | 100% | 短信/电话 |
## 9. 版本升级
### 9.1 升级流程
```
备份数据 → 下载升级 → 执行升级 → 验证功能 → 发布上线
```
### 9.2 升级前检查
| 检查项 | 说明 |
|--------|------|
| 数据备份 | 确认数据已备份 |
| 环境检查 | 服务器环境符合要求 |
| 兼容性检查 | 确认升级包兼容 |
| 停机通知 | 通知相关人员 |
| 回滚方案 | 准备回滚方案 |
### 9.3 升级后验证
| 验证项 | 说明 |
|--------|------|
| 服务启动 | 确认服务正常运行 |
| 功能验证 | 验证核心功能 |
| 数据验证 | 确认数据完整性 |
| 性能验证 | 确认系统性能正常 |
---
**系统运维篇完**