Initial commit
This commit is contained in:
366
docs/operation/system-operation.md
Normal file
366
docs/operation/system-operation.md
Normal 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 升级后验证
|
||||
|
||||
| 验证项 | 说明 |
|
||||
|--------|------|
|
||||
| 服务启动 | 确认服务正常运行 |
|
||||
| 功能验证 | 验证核心功能 |
|
||||
| 数据验证 | 确认数据完整性 |
|
||||
| 性能验证 | 确认系统性能正常 |
|
||||
|
||||
---
|
||||
|
||||
**系统运维篇完**
|
||||
459
docs/operation/technical-support.md
Normal file
459
docs/operation/technical-support.md
Normal file
@@ -0,0 +1,459 @@
|
||||
# 异常处理与技术支持
|
||||
|
||||
## 1. 功能概述
|
||||
|
||||
本章为用户提供常见问题的解决方案和获取技术支持的渠道,帮助用户快速解决使用过程中遇到的问题。
|
||||
|
||||
**主要内容:**
|
||||
|
||||
| 内容 | 说明 |
|
||||
|------|------|
|
||||
| 常见问题FAQ | 各类常见问题解答 |
|
||||
| 系统错误码说明 | 错误码及解决方案 |
|
||||
| 故障排查指南 | 问题排查方法 |
|
||||
| 技术支持联系方式 | 获取支持的渠道 |
|
||||
|
||||
## 2. 常见问题FAQ
|
||||
|
||||
### 2.1 登录相关问题
|
||||
|
||||
**Q1: 登录提示"用户名或密码错误"**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 输入错误 | 检查用户名和密码是否正确 |
|
||||
| 大小写问题 | 检查是否开启了大小写敏感 |
|
||||
| 键盘问题 | 确认Caps Lock未开启 |
|
||||
|
||||
**Q2: 登录提示"账户已锁定"**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 多次登录失败 | 等待30分钟后自动解锁或联系管理员 |
|
||||
| 账户被禁用 | 联系系统管理员启用账户 |
|
||||
|
||||
**Q3: 登录提示"无访问权限"**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 未分配角色 | 联系管理员分配权限 |
|
||||
| 角色权限不足 | 申请更高权限 |
|
||||
| IP限制 | 检查是否在允许的IP范围内 |
|
||||
|
||||
**Q4: 忘记密码怎么办?**
|
||||
|
||||
| 解决方案 | 操作方式 |
|
||||
|---------|---------|
|
||||
| 自助找回 | 点击登录页"忘记密码",通过邮箱/手机重置 |
|
||||
| 管理员重置 | 联系系统管理员重置密码 |
|
||||
|
||||
### 2.2 生产管理相关问题
|
||||
|
||||
**Q5: 无法创建工单?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 缺少产品BOM | 先维护产品BOM |
|
||||
| 缺少工艺路线 | 先维护工艺路线 |
|
||||
| 物料未齐套 | 确认物料库存充足 |
|
||||
| 权限不足 | 联系管理员开通权限 |
|
||||
|
||||
**Q6: 工单无法下发?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 物料未齐套 | 检查物料库存 |
|
||||
| 产线不可用 | 检查产线状态 |
|
||||
| 工艺路线未维护 | 维护工艺路线 |
|
||||
| 计划日期冲突 | 调整计划日期 |
|
||||
|
||||
**Q7: 报工数据无法保存?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 工序未开工 | 先执行开工报工 |
|
||||
| 数据格式错误 | 检查输入数据格式 |
|
||||
| 数量超出范围 | 确认数量在允许范围内 |
|
||||
| 会话超时 | 重新登录 |
|
||||
|
||||
### 2.3 质量管理相关问题
|
||||
|
||||
**Q8: 检验项目无法添加?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 检验标准未维护 | 先创建检验标准 |
|
||||
| 权限不足 | 联系管理员授权 |
|
||||
| 数据格式错误 | 检查输入格式 |
|
||||
|
||||
**Q9: 不良品如何处理?**
|
||||
|
||||
| 处理方式 | 说明 |
|
||||
|---------|------|
|
||||
| 返工 | 将不良品返回工序重新加工 |
|
||||
| 降级使用 | 降低产品等级使用 |
|
||||
| 让步接收 | 经审批后特殊放行 |
|
||||
| 报废 | 办理报废手续 |
|
||||
|
||||
**Q10: 批次追溯查询无结果?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 批次号输入错误 | 核对批次号 |
|
||||
| 批次未纳入追溯 | 确认物料是否批次管理 |
|
||||
| 数据未同步 | 联系管理员检查数据 |
|
||||
|
||||
### 2.4 设备管理相关问题
|
||||
|
||||
**Q11: 点检任务未生成?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 设备未配置点检标准 | 为设备配置点检标准 |
|
||||
| 日期不在点检周期 | 确认点检周期配置 |
|
||||
| 点检标准未启用 | 启用点检标准 |
|
||||
|
||||
**Q12: 设备故障如何报修?**
|
||||
|
||||
| 操作步骤 | 说明 |
|
||||
|---------|------|
|
||||
| 1. 发现故障 | 发现设备异常 |
|
||||
| 2. 紧急评估 | 评估是否需要紧急停机 |
|
||||
| 3. 提交报修 | 在设备管理中提交报修单 |
|
||||
| 4. 维修处理 | 等待维修人员处理 |
|
||||
| 5. 验收确认 | 维修完成后确认 |
|
||||
|
||||
### 2.5 仓储物流相关问题
|
||||
|
||||
**Q13: 入库单无法确认?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| IQC未完成 | 完成来料检验 |
|
||||
| 批次号重复 | 修改批次号 |
|
||||
| 库位不可用 | 选择其他库位 |
|
||||
|
||||
**Q14: 库存数据不准确?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 单据未审核 | 审核相关单据 |
|
||||
| 盘点差异 | 执行库存盘点 |
|
||||
| 数据同步问题 | 联系管理员检查 |
|
||||
|
||||
**Q15: 如何进行库存盘点?**
|
||||
|
||||
| 操作步骤 | 说明 |
|
||||
|---------|------|
|
||||
| 1. 创建盘点单 | 选择仓库和物料 |
|
||||
| 2. 执行盘点 | 现场清点数量 |
|
||||
| 3. 录入实盘 | 输入实际数量 |
|
||||
| 4. 差异审核 | 审核盘点差异 |
|
||||
| 5. 账务调整 | 调整库存账务 |
|
||||
|
||||
### 2.6 系统操作相关问题
|
||||
|
||||
**Q16: 页面显示不完整?**
|
||||
|
||||
| 解决方案 | 操作方式 |
|
||||
|---------|---------|
|
||||
| 清除缓存 | 清除浏览器缓存 |
|
||||
| 更换浏览器 | 使用推荐的浏览器 |
|
||||
| 调整缩放 | 调整浏览器缩放比例 |
|
||||
| 检查分辨率 | 确保屏幕分辨率达标 |
|
||||
|
||||
**Q17: 数据导出失败?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 数据量过大 | 分批导出 |
|
||||
| 网络问题 | 检查网络连接 |
|
||||
| 权限不足 | 联系管理员授权 |
|
||||
| 格式不支持 | 更换导出格式 |
|
||||
|
||||
**Q18: 审批流程无法流转?**
|
||||
|
||||
| 可能原因 | 解决方案 |
|
||||
|---------|---------|
|
||||
| 审批人未配置 | 配置审批人 |
|
||||
| 条件不满足 | 检查流转条件 |
|
||||
| 审批人不在线 | 提醒审批人 |
|
||||
|
||||
## 3. 系统错误码说明
|
||||
|
||||
### 3.1 错误码分类
|
||||
|
||||
| 错误码范围 | 错误类型 | 说明 |
|
||||
|-----------|---------|------|
|
||||
| 1000-1999 | 基础错误 | 系统基础错误 |
|
||||
| 2000-2999 | 权限错误 | 权限相关错误 |
|
||||
| 3000-3999 | 业务错误 | 业务逻辑错误 |
|
||||
| 4000-4999 | 数据错误 | 数据验证错误 |
|
||||
| 5000-5999 | 接口错误 | 外部接口错误 |
|
||||
| 9000-9999 | 系统错误 | 系统内部错误 |
|
||||
|
||||
### 3.2 权限类错误
|
||||
|
||||
| 错误码 | 错误信息 | 解决方案 |
|
||||
|--------|---------|---------|
|
||||
| 2001 | 无访问权限 | 联系管理员开通权限 |
|
||||
| 2002 | 权限不足 | 申请更高权限 |
|
||||
| 2003 | 角色未分配 | 联系管理员分配角色 |
|
||||
| 2004 | 会话过期 | 重新登录系统 |
|
||||
| 2005 | IP限制访问 | 在允许的IP范围内访问 |
|
||||
|
||||
### 3.3 业务类错误
|
||||
|
||||
| 错误码 | 错误信息 | 解决方案 |
|
||||
|--------|---------|---------|
|
||||
| 3001 | 数据已存在 | 检查是否重复创建 |
|
||||
| 3002 | 数据不存在 | 检查数据是否正确 |
|
||||
| 3003 | 状态不允许操作 | 确认当前状态可执行操作 |
|
||||
| 3004 | 数量超出范围 | 调整数量在允许范围内 |
|
||||
| 3005 | 业务规则校验失败 | 检查是否符合业务规则 |
|
||||
| 3006 | 关联数据不存在 | 检查关联数据是否完整 |
|
||||
| 3007 | 数据被引用 | 解除数据引用关系后再操作 |
|
||||
|
||||
### 3.4 数据类错误
|
||||
|
||||
| 错误码 | 错误信息 | 解决方案 |
|
||||
|--------|---------|---------|
|
||||
| 4001 | 必填字段为空 | 填写必填字段 |
|
||||
| 4002 | 数据格式错误 | 检查数据格式 |
|
||||
| 4003 | 字段长度超限 | 缩短输入内容 |
|
||||
| 4004 | 数据类型不匹配 | 输入正确类型数据 |
|
||||
| 4005 | 日期格式错误 | 使用正确的日期格式 |
|
||||
| 4006 | 编码重复 | 使用不重复的编码 |
|
||||
|
||||
### 3.5 接口类错误
|
||||
|
||||
| 错误码 | 错误信息 | 解决方案 |
|
||||
|--------|---------|---------|
|
||||
| 5001 | 接口连接超时 | 检查网络连接 |
|
||||
| 5002 | 接口服务不可用 | 联系接口服务方 |
|
||||
| 5003 | 接口认证失败 | 检查接口认证信息 |
|
||||
| 5004 | 接口返回错误 | 查看接口返回信息 |
|
||||
| 5005 | 数据同步失败 | 检查数据同步配置 |
|
||||
|
||||
### 3.6 系统类错误
|
||||
|
||||
| 错误码 | 错误信息 | 解决方案 |
|
||||
|--------|---------|---------|
|
||||
| 9001 | 系统繁忙 | 稍后重试 |
|
||||
| 9002 | 操作失败 | 重试或联系管理员 |
|
||||
| 9003 | 服务器错误 | 联系技术支持 |
|
||||
| 9004 | 数据库错误 | 联系技术支持 |
|
||||
| 9005 | 内存不足 | 重启服务或扩容 |
|
||||
|
||||
## 4. 故障排查指南
|
||||
|
||||
### 4.1 登录故障排查
|
||||
|
||||
**排查流程:**
|
||||
|
||||
```
|
||||
开始
|
||||
│
|
||||
▼
|
||||
登录失败?
|
||||
│
|
||||
├─── 是 ───→ 检查错误提示
|
||||
│ │
|
||||
│ ▼
|
||||
│ ┌─────────┐
|
||||
│ │ 错误码? │
|
||||
│ └────┬────┘
|
||||
│ │
|
||||
│ ┌─────────┼─────────┐
|
||||
│ │ │ │
|
||||
│ ▼ ▼ ▼
|
||||
│ 权限类 业务类 系统类
|
||||
│ 错误 错误 错误
|
||||
│ │ │ │
|
||||
│ │ │ ▼
|
||||
│ │ │ 重试/联系技术支持
|
||||
│ │
|
||||
│检查用户状态/权限
|
||||
│
|
||||
└─── 否 ───→ 排查完成
|
||||
```
|
||||
|
||||
### 4.2 性能问题排查
|
||||
|
||||
**排查项目:**
|
||||
|
||||
| 检查项 | 检查方法 | 正常范围 |
|
||||
|--------|---------|---------|
|
||||
| CPU使用率 | 任务管理器查看 | < 80% |
|
||||
| 内存使用率 | 任务管理器查看 | < 85% |
|
||||
| 磁盘IO | 性能监控查看 | < 70% |
|
||||
| 网络延迟 | ping命令测试 | < 100ms |
|
||||
| 数据库连接 | 查看连接池 | < 最大值 |
|
||||
| 慢查询 | 查看查询日志 | < 1秒 |
|
||||
|
||||
**常见性能问题:**
|
||||
|
||||
| 问题现象 | 可能原因 | 解决方案 |
|
||||
|---------|---------|---------|
|
||||
| 页面加载慢 | 网络问题/服务器负载高 | 检查网络/扩容 |
|
||||
| 操作响应慢 | 数据库查询慢 | 优化索引/增加资源 |
|
||||
| 报表生成慢 | 数据量大 | 分批查询/优化SQL |
|
||||
| 批量操作慢 | 逐条处理 | 改为批量处理 |
|
||||
|
||||
### 4.3 数据问题排查
|
||||
|
||||
**数据一致性检查:**
|
||||
|
||||
| 检查项 | 检查方法 | 处理方式 |
|
||||
|--------|---------|---------|
|
||||
| 库存账实不符 | 盘点核对 | 差异审核调整 |
|
||||
| 批次追溯断裂 | 查询追溯链 | 检查数据录入 |
|
||||
| 工单状态异常 | 查看工单日志 | 修正状态 |
|
||||
| 检验数据缺失 | 查看检验记录 | 补录数据 |
|
||||
|
||||
### 4.4 接口问题排查
|
||||
|
||||
**排查步骤:**
|
||||
|
||||
1. 检查接口配置
|
||||
2. 验证认证信息
|
||||
3. 测试网络连通性
|
||||
4. 检查接口日志
|
||||
5. 验证数据格式
|
||||
6. 联系接口提供方
|
||||
|
||||
## 5. 日志提取指南
|
||||
|
||||
### 5.1 日志类型
|
||||
|
||||
| 日志类型 | 存储位置 | 用途 |
|
||||
|---------|---------|------|
|
||||
| 操作日志 | /logs/operation/ | 追踪用户操作 |
|
||||
| 错误日志 | /logs/error/ | 排查系统错误 |
|
||||
| 接口日志 | /logs/interface/ | 排查接口问题 |
|
||||
| 数据库日志 | /logs/database/ | 排查数据问题 |
|
||||
| 应用日志 | /logs/application/ | 排查应用问题 |
|
||||
|
||||
### 5.2 日志提取方法
|
||||
|
||||
**方法一:通过系统导出**
|
||||
|
||||
1. 进入【系统管理】→【日志管理】
|
||||
2. 选择日志类型
|
||||
3. 设置查询条件
|
||||
4. 点击【导出】
|
||||
5. 下载日志文件
|
||||
|
||||
**方法二:通过服务器访问**
|
||||
|
||||
```bash
|
||||
# 访问日志目录
|
||||
cd /opt/mes/logs
|
||||
|
||||
# 查看最近的错误日志
|
||||
tail -n 100 error.log
|
||||
|
||||
# 搜索指定关键词
|
||||
grep "error" error.log
|
||||
|
||||
# 导出指定时间段的日志
|
||||
grep "2026-04-10" error.log > error_20260410.log
|
||||
```
|
||||
|
||||
### 5.3 日志提取注意事项
|
||||
|
||||
- 【注意】日志提取可能包含敏感信息,请注意保密
|
||||
- 【提示】提供日志时请注明问题发生的时间范围
|
||||
- 【重要】请在问题复现时同步提取日志
|
||||
|
||||
## 6. 问题上报指南
|
||||
|
||||
### 6.1 问题分类
|
||||
|
||||
| 问题级别 | 定义 | 响应时间 | 解决时间 |
|
||||
|---------|------|---------|---------|
|
||||
| 紧急 | 系统不可用、业务中断 | 1小时 | 4小时 |
|
||||
| 高 | 核心功能异常 | 4小时 | 24小时 |
|
||||
| 中 | 一般功能异常 | 8小时 | 72小时 |
|
||||
| 低 | 界面/体验问题 | 24小时 | 1周 |
|
||||
|
||||
### 6.2 问题描述模板
|
||||
|
||||
请按以下模板描述问题:
|
||||
|
||||
```
|
||||
【问题描述】
|
||||
1. 问题现象:描述遇到的问题
|
||||
2. 期望行为:期望的正确行为
|
||||
3. 实际行为:实际发生的错误
|
||||
|
||||
【问题环境】
|
||||
- 模块:xxx
|
||||
- 页面:xxx
|
||||
- 浏览器:xxx
|
||||
- 操作系统:xxx
|
||||
|
||||
【复现步骤】
|
||||
1.
|
||||
2.
|
||||
3.
|
||||
|
||||
【错误信息】
|
||||
(错误提示截图或文字)
|
||||
|
||||
【附件】
|
||||
- 截图
|
||||
- 日志
|
||||
- 相关数据
|
||||
```
|
||||
|
||||
## 7. 技术支持联系方式
|
||||
|
||||
### 7.1 常规支持
|
||||
|
||||
| 联系方式 | 信息 |
|
||||
|---------|------|
|
||||
| 服务热线 | 400-XXX-XXXX |
|
||||
| 服务邮箱 | support@hfmes.com |
|
||||
| 服务时间 | 周一至周五 9:00-18:00 |
|
||||
| 紧急电话 | 138-XXXX-XXXX |
|
||||
|
||||
### 7.2 在线支持
|
||||
|
||||
| 渠道 | 说明 |
|
||||
|------|------|
|
||||
| 企业微信群 | 专属服务群 |
|
||||
| 在线工单 | 提交技术支持工单 |
|
||||
| 远程协助 | TeamViewer远程支持 |
|
||||
|
||||
### 7.3 服务承诺
|
||||
|
||||
| 服务类型 | 承诺内容 |
|
||||
|---------|---------|
|
||||
| 响应时间 | 紧急问题1小时内响应 |
|
||||
| 问题解决 | 承诺时间内给出解决方案 |
|
||||
| 服务态度 | 专业、耐心、负责任 |
|
||||
| 信息安全 | 严格保密客户数据 |
|
||||
|
||||
## 8. 版本与更新
|
||||
|
||||
### 8.1 版本信息
|
||||
|
||||
| 版本号 | 发布日期 | 更新内容 |
|
||||
|--------|---------|---------|
|
||||
| v5.0 | 2026-04-10 | 初始版本发布 |
|
||||
| - | - | - |
|
||||
|
||||
### 8.2 更新订阅
|
||||
|
||||
**订阅方式:**
|
||||
|
||||
| 订阅渠道 | 说明 |
|
||||
|---------|------|
|
||||
| 系统消息 | 登录系统查看更新公告 |
|
||||
| 邮件订阅 | 订阅版本更新邮件 |
|
||||
| 企业微信 | 加入服务群获取通知 |
|
||||
|
||||
---
|
||||
|
||||
**异常处理与技术支持篇完**
|
||||
Reference in New Issue
Block a user