admin/yunrui_asset
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(资产盘点): 新增暂存设备管理功能

Browse Source
This commit is contained in:
zhang1106
2026-03-10 09:20:31 +08:00
parent ad7c45d453
commit 686089c21a
9 changed files with 3125 additions and 282 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/USER_GUIDE.md
+816
View File
@@ -0,0 +1,816 @@
# IDC设备资产系统 - 用户使用指南
## 目录
- [系统概述](#系统概述)
- [快速入门](#快速入门)
- [功能模块详解](#功能模块详解)
- [仪表盘](#仪表盘)
- [机房管理](#机房管理)
- [资产管理](#资产管理)
- [耗材管理](#耗材管理)
- [工单管理](#工单管理)
- [资产盘点](#资产盘点)
- [系统管理](#系统管理)
- [常见问题](#常见问题)
- [快捷操作参考](#快捷操作参考)
---
## 系统概述
### 系统简介
IDC设备资产系统是一款现代化的数据中心（IDC）设备管理平台，提供机房、机柜、设备的全生命周期管理，具备3D可视化展示功能。系统采用前后端分离架构，前端基于React + Ant Design构建，后端使用Node.js + Express开发。
### 核心功能
| 功能模块 | 主要功能 |
|---------|---------|
| **仪表盘** | 数据中心运行状态实时监控，关键指标可视化展示 |
| **机房管理** | 机房信息管理、机柜管理、3D可视化展示 |
| **资产管理** | 设备管理、端口管理、线缆管理、字段配置 |
| **耗材管理** | 耗材库存管理、分类管理、操作日志、统计报表 |
| **工单管理** | 故障报修、维护工单、工单分类、统计报表 |
| **资产盘点** | 盘点计划、盘点任务、暂存设备管理 |
| **系统管理** | 用户管理、角色权限、系统设置 |
### 系统特点
- **全生命周期管理**：设备从采购、安装、运行、维护到报废的全流程跟踪
- **3D可视化**：三维机柜展示，直观呈现设备布局
- **灵活扩展**：支持自定义设备字段和工单字段
- **批量操作**：支持Excel/CSV批量导入导出设备
- **权限控制**：基于角色的访问控制（RBAC）
---
## 快速入门
### 首次登录
系统采用**首次注册自动成为管理员**的机制：
1. 打开浏览器，访问系统地址（如：`http://localhost:3000`）
2. 在登录页面点击「注册账号」链接
3. 填写注册信息：
- 用户名（必填，用于登录）
- 密码（必填，建议8位以上）
- 邮箱（选填）
4. 点击「注册」按钮完成注册
5. 系统自动登录，第一个注册的用户自动获得管理员权限
> ⚠️ **安全提示**：首次登录后请立即修改密码，确保账号安全。
### 界面导航
系统采用左侧菜单导航结构：
```
├── 仪表盘 # 数据概览
├── 机房管理
│ ├── 机房管理 # 机房信息管理
│ ├── 机柜管理 # 机柜信息管理
│ └── 3D机柜可视化 # 三维展示
├── 资产管理
│ ├── 设备管理 # 设备CRUD操作
│ ├── 字段管理 # 自定义字段配置
│ ├── 接线管理 # 线缆连接管理
│ └── 端口管理 # 设备端口配置
├── 耗材管理
│ ├── 耗材统计 # 库存统计报表
│ ├── 耗材列表 # 耗材库存管理
│ ├── 分类管理 # 耗材分类配置
│ └── 操作日志 # 领用记录追踪
├── 工单管理
│ ├── 工单列表 # 工单处理
│ ├── 故障分类 # 故障类型配置
│ ├── 统计报表 # 工单统计分析
│ └── 字段管理 # 自定义字段
├── 资产盘点
│ ├── 盘点计划 # 盘点任务管理
│ └── 暂存设备 # 待确认设备
└── 系统管理
├── 用户管理 # 用户账号管理
└── 系统设置 # 系统参数配置
```
### 基本操作流程
```
1. 创建机房 → 2. 添加机柜 → 3. 录入设备 → 4. 配置端口/线缆 → 5. 日常维护
```
---
## 功能模块详解
### 仪表盘
仪表盘是系统的首页，提供数据中心整体运行状态的可视化展示。
#### 功能说明
| 区域 | 内容 |
|------|------|
| **统计卡片** | 机房数量、机柜数量、设备总数、运行中设备、维护中设备、已报废设备 |
| **设备状态分布** | 各状态设备占比图表 |
| **机柜容量概览** | 各机房机柜使用率 |
| **待处理工单** | 未完成工单列表 |
| **库存预警** | 低库存耗材提醒 |
#### 操作说明
- **刷新数据**：点击右上角「刷新」按钮获取最新数据
- **快速跳转**：点击统计卡片可跳转到对应管理页面
---
### 机房管理
#### 机房管理
机房管理用于维护数据中心的基础信息。
##### 新增机房
1. 进入「机房管理」页面
2. 点击「新增机房」按钮
3. 填写机房信息：
- **机房名称**（必填）：如「北京一号机房」
- **机房位置**：详细地址
- **机房面积**：单位平方米
- **负责人**：机房管理员
- **联系电话**：紧急联系方式
- **备注**：其他说明
- **机房图片**：上传机房照片
4. 点击「确定」保存
##### 编辑机房
1. 在机房列表中找到目标机房
2. 点击操作列的「编辑」按钮
3. 修改需要更新的信息
4. 点击「确定」保存
##### 删除机房
> ⚠️ **注意**：删除机房前需确保该机房下没有机柜和设备。
1. 点击操作列的「删除」按钮
2. 确认删除操作
#### 机柜管理
机柜管理用于维护机柜信息和查看容量状态。
##### 新增机柜
1. 进入「机柜管理」页面
2. 点击「新增机柜」按钮
3. 填写机柜信息：
- **机柜名称**（必填）：如「A01」
- **所属机房**（必填）：选择已有机房
- **机柜高度**：U数（如42U）
- **机柜位置**：在机房中的位置
- **备注**：其他说明
4. 点击「确定」保存
##### 容量查看
机柜列表显示：
- **总U数**：机柜总容量
- **已用U数**：已安装设备占用
- **剩余U数**：可用空间
- **使用率**：可视化进度条
#### 3D机柜可视化
3D可视化提供直观的机柜设备布局展示。
##### 操作方式
| 操作 | 方法 |
|------|------|
| **旋转视角** | 鼠标左键拖拽 |
| **缩放视图** | 鼠标滚轮 |
| **平移视图** | 鼠标右键拖拽 |
| **查看设备** | 鼠标悬停显示设备信息 |
| **设备详情** | 点击设备弹出详情面板 |
##### 功能说明
- **机柜选择**：左侧列表选择要查看的机柜
- **设备状态**：不同颜色表示不同状态
- 🟢 绿色：运行中
- 🟡 黄色：维护中
- 🔴 红色：故障
- ⚪ 灰色：已停用
---
### 资产管理
#### 设备管理
设备管理是系统的核心功能，提供设备全生命周期管理。
##### 设备状态流转
```
采购中 → 待安装 → 运行中 ⇄ 维护中 → 已报废
```
| 状态 | 说明 |
|------|------|
| **采购中** | 设备已采购，尚未到货 |
| **待安装** | 设备到货，等待安装 |
| **运行中** | 设备正常运行 |
| **维护中** | 设备正在维护 |
| **已报废** | 设备已报废处理 |
##### 新增设备
1. 进入「设备管理」页面
2. 点击「新增设备」按钮
3. 填写设备信息：
- **基本信息**：
- 设备名称（必填）
- 设备类型：服务器/网络设备/存储设备/其他
- 设备型号
- 序列号
- 品牌
- **位置信息**：
- 所属机房
- 所属机柜
- 起始U位
- 占用U数
- **状态信息**：
- 设备状态
- 购买日期
- 过保日期
- **自定义字段**：根据系统配置显示
4. 点击「确定」保存
##### 批量导入设备
1. 点击「导入」按钮
2. 下载导入模板（Excel/CSV格式）
3. 按模板格式填写设备信息
4. 选择填写好的文件上传
5. 系统自动解析并导入
> 💡 **提示**：导入前请确保机房和机柜信息已创建。
##### 设备导出
1. 选择需要导出的设备（可多选）
2. 点击「导出」按钮
3. 选择导出格式（Excel/CSV）
4. 文件自动下载
##### 设备详情
点击设备名称或「详情」按钮，可查看：
- 设备完整信息
- 关联端口
- 网卡信息
- 操作历史
#### 端口管理
端口管理用于配置设备的网络端口信息。
##### 端口类型
| 类型 | 说明 |
|------|------|
| **网口** | 以太网接口（RJ45） |
| **光口** | 光纤接口（SFP/SFP+） |
| **管理口** | 带外管理接口 |
| **其他** | 其他类型接口 |
##### 配置端口
1. 进入「端口管理」页面
2. 选择设备
3. 点击「添加端口」
4. 填写端口信息：
- 端口名称（如 eth0、ens192）
- 端口类型
- 端口速率（如 1Gbps、10Gbps）
- IP地址
- MAC地址
- 关联网卡
- 状态
#### 接线管理
接线管理用于记录机柜间的线缆连接关系。
##### 新增线缆
1. 进入「接线管理」页面
2. 点击「新增线缆」
3. 填写线缆信息：
- **线缆名称**：如「A01-B01-光纤-01」
- **线缆类型**：光纤/网线/电源线
- **起始端**：
- 源机房/机柜
- 源设备
- 源端口
- **终止端**：
- 目标机房/机柜
- 目标设备
- 目标端口
- **线缆长度**：单位米
- **备注**
##### 线缆追踪
通过线缆列表可以：
- 查看线缆连接路径
- 追踪设备间连接关系
- 导出线缆清单
#### 字段管理
字段管理用于自定义设备属性，满足不同业务需求。
##### 字段类型
| 类型 | 说明 | 示例 |
|------|------|------|
| **文本** | 单行文本输入 | 资产编号 |
| **数字** | 数值输入 | 功率（W） |
| **日期** | 日期选择 | 维保到期日 |
| **下拉选择** | 固定选项 | 设备等级 |
| **多行文本** | 长文本输入 | 备注说明 |
##### 添加字段
1. 进入「字段管理」页面
2. 点击「新增字段」
3. 配置字段属性：
- 字段名称
- 字段标识（英文，用于系统识别）
- 字段类型
- 是否必填
- 默认值
- 排序权重
4. 保存后，设备表单将自动显示该字段
---
### 耗材管理
#### 耗材统计
耗材统计页面提供库存数据的可视化分析。
##### 统计内容
- **库存总览**：总数量、总种类、预警数量
- **分类统计**：各分类耗材数量分布
- **库存预警**：低于安全库存的耗材列表
- **领用趋势**：近期耗材领用统计
#### 耗材列表
耗材列表用于管理耗材库存信息。
##### 新增耗材
1. 进入「耗材列表」页面
2. 点击「新增耗材」
3. 填写耗材信息：
- **耗材名称**（必填）
- **耗材分类**
- **规格型号**
- **计量单位**：个/条/盒等
- **当前库存**
- **安全库存**：低于此值触发预警
- **最大库存**
- **存放位置**
- **备注**
4. 保存
##### 库存操作
| 操作 | 说明 |
|------|------|
| **入库** | 增加库存数量 |
| **出库/领用** | 减少库存数量，记录领用人 |
| **盘点** | 更新实际库存数量 |
##### 入库操作
1. 点击耗材的「入库」按钮
2. 填写入库信息：
- 入库数量
- 入库类型（采购入库/归还入库）
- 备注
3. 确认入库
##### 出库操作
1. 点击耗材的「出库」按钮
2. 填写出库信息：
- 出库数量
- 领用人
- 用途
- 备注
3. 确认出库
#### 分类管理
分类管理用于维护耗材的分类体系。
##### 新增分类
1. 进入「分类管理」页面
2. 点击「新增分类」
3. 填写分类名称和描述
4. 保存
##### 分类示例
```
├── 网络耗材
│ ├── 网线
│ ├── 光纤
│ └── 跳线
├── 存储耗材
│ ├── 硬盘
│ └── 磁带
└── 通用耗材
├── 扎带
└── 标签
```
#### 操作日志
操作日志记录所有耗材的出入库操作历史。
##### 日志内容
- 操作时间
- 操作类型（入库/出库/盘点）
- 耗材名称
- 操作数量
- 操作人
- 领用人（出库时）
- 备注
##### 日志查询
- 按时间范围筛选
- 按耗材名称搜索
- 按操作类型筛选
---
### 工单管理
#### 工单列表
工单列表用于处理故障报修和维护工单。
##### 工单状态
```
待处理 → 处理中 → 已完成 → 已关闭
```
| 状态 | 说明 |
|------|------|
| **待处理** | 新建工单，等待分配 |
| **处理中** | 正在处理 |
| **已完成** | 问题已解决 |
| **已关闭** | 工单关闭 |
##### 工单优先级
| 优先级 | 说明 | 响应时间 |
|--------|------|----------|
| **紧急** | 严重影响业务 | 立即响应 |
| **高** | 重要问题 | 2小时内 |
| **中** | 一般问题 | 24小时内 |
| **低** | 优化建议 | 一周内 |
##### 创建工单
1. 进入「工单列表」页面
2. 点击「新建工单」
3. 填写工单信息：
- **工单标题**：简要描述问题
- **故障分类**：选择故障类型
- **优先级**：紧急/高/中/低
- **关联设备**：选择相关设备（可选）
- **问题描述**：详细说明问题
- **附件**：上传截图或日志
- **自定义字段**：根据系统配置填写
4. 提交工单
##### 处理工单
1. 点击工单进入详情页
2. 点击「接单」分配给自己
3. 更新工单状态为「处理中」
4. 记录处理过程：
- 点击「添加记录」
- 填写处理内容
- 更新工单状态
5. 问题解决后，点击「完成」
6. 填写解决方案
#### 故障分类
故障分类用于标准化故障类型，便于统计分析。
##### 新增分类
1. 进入「故障分类」页面
2. 点击「新增分类」
3. 填写分类名称和描述
4. 保存
##### 分类示例
```
├── 硬件故障
│ ├── 硬盘故障
│ ├── 电源故障
│ └── 风扇故障
├── 网络故障
│ ├── 网络中断
│ └── 配置错误
└── 系统故障
├── 系统崩溃
└── 服务异常
```
#### 统计报表
统计报表提供工单数据的分析视图。
##### 报表内容
- **工单数量趋势**：按时间统计工单数量
- **分类统计**：各类型工单占比
- **处理效率**：平均响应时间、解决时间
- **人员统计**：各处理人工单数量
#### 字段管理
工单字段管理用于自定义工单属性。
操作方式与设备字段管理相同，参见[字段管理](#字段管理)。
---
### 资产盘点
#### 盘点计划
盘点计划用于制定和管理资产盘点任务。
##### 创建盘点计划
1. 进入「盘点计划」页面
2. 点击「新建计划」
3. 填写计划信息：
- **计划名称**：如「2024年第一季度盘点」
- **盘点范围**：
- 全部资产
- 指定机房
- 指定机柜
- **计划时间**：盘点开始和结束时间
- **负责人**：盘点负责人
- **参与人员**：选择盘点人员
- **备注**
4. 保存计划
##### 盘点任务状态
| 状态 | 说明 |
|------|------|
| **待执行** | 计划已创建，等待开始 |
| **执行中** | 盘点进行中 |
| **已完成** | 盘点结束 |
##### 执行盘点
1. 在盘点计划列表点击「执行」
2. 进入盘点执行页面
3. 逐个确认设备：
- 确认设备存在
- 核对设备信息
- 标记异常设备
4. 提交盘点结果
##### 盘点结果
- 正常设备数量
- 异常设备列表
- 盘点完成率
- 差异报告
#### 暂存设备
暂存设备用于管理盘点中发现的新设备或信息不完整的设备。
##### 功能说明
- 存放未在系统中登记的设备
- 记录设备基本信息
- 等待确认后转为正式设备
##### 操作流程
1. 盘点时发现新设备
2. 将设备添加到暂存区
3. 核实设备信息
4. 确认后转为正式设备
---
### 系统管理
#### 用户管理
用户管理用于管理系统用户账号和权限。
##### 用户状态
| 状态 | 说明 |
|------|------|
| **正常** | 用户可正常登录 |
| **待审核** | 新注册用户，等待管理员审核 |
| **已禁用** | 账号被禁用，无法登录 |
##### 新增用户
1. 进入「用户管理」页面
2. 点击「新增用户」
3. 填写用户信息：
- 用户名（必填，唯一）
- 密码
- 邮箱
- 手机号
- 角色
- 状态
4. 保存
##### 用户审核
新注册用户默认为「待审核」状态：
1. 在用户列表筛选「待审核」用户
2. 点击「审核」按钮
3. 选择「通过」或「拒绝」
4. 通过后用户状态变为「正常」
##### 角色权限
系统采用RBAC权限模型：
| 角色 | 权限范围 |
|------|----------|
| **管理员** | 全部功能 |
| **运维人员** | 设备管理、工单处理 |
| **普通用户** | 查看权限 |
#### 系统设置
系统设置用于配置系统参数。
##### 可配置项
| 设置项 | 说明 |
|--------|------|
| **站点名称** | 系统显示名称 |
| **Logo** | 系统Logo图片 |
| **空闲超时** | 无操作自动退出时间 |
| **背景图片** | 登录页背景 |
##### 修改设置
1. 进入「系统设置」页面
2. 修改需要更新的配置
3. 点击「保存」
---
## 常见问题
### 登录相关
**Q: 忘记密码怎么办？**
A: 请联系管理员重置密码。管理员可在「用户管理」中为用户重置密码。
**Q: 账号被锁定怎么办？**
A: 多次密码错误会导致账号临时锁定，请等待30分钟后重试，或联系管理员解锁。
**Q: 为什么注册后无法登录？**
A: 新注册用户需要管理员审核后才能激活。请联系管理员进行审核。
### 设备管理
**Q: 如何批量修改设备信息？**
A: 目前支持批量导入更新。导出设备列表，修改后重新导入即可。
**Q: 设备删除后能恢复吗？**
A: 设备删除是软删除，数据仍保留在数据库中。如需恢复，请联系管理员。
**Q: 为什么导入失败？**
A: 请检查：
1. 文件格式是否正确（Excel/CSV）
2. 必填字段是否完整
3. 机房/机柜名称是否匹配
4. 数据格式是否符合要求
### 3D可视化
**Q: 3D页面加载很慢怎么办？**
A: 可能原因：
1. 设备数量较多，建议分机房查看
2. 浏览器性能限制，建议使用Chrome最新版
3. 网络带宽限制
**Q: 设备位置显示不正确？**
A: 请检查设备的起始U位和占用U数设置是否正确。
### 耗材管理
**Q: 库存预警如何设置？**
A: 在耗材编辑页面设置「安全库存」值，当库存低于此值时系统会自动预警。
**Q: 出库后可以撤销吗？**
A: 出库操作记录在日志中，如需撤销可执行入库操作，并在备注中说明原因。
### 工单管理
**Q: 如何分配工单？**
A: 工单创建后，处理人可以在工单详情页点击「接单」自行分配，或由管理员指定。
**Q: 工单关闭后还能重新打开吗？**
A: 已关闭的工单无法重新打开，如有新问题请新建工单。
---
## 快捷操作参考
### 键盘快捷键
| 快捷键 | 功能 |
|--------|------|
| `Ctrl + S` | 保存当前表单 |
| `Esc` | 关闭弹窗/抽屉 |
| `Enter` | 确认操作 |
### 表格操作
| 操作 | 方法 |
|------|------|
| **多选** | 勾选复选框 |
| **全选** | 勾选表头复选框 |
| **排序** | 点击列标题 |
| **筛选** | 使用列筛选器 |
| **分页** | 底部分页器 |
### 搜索技巧
- 支持模糊搜索
- 可组合多个条件筛选
- 时间范围选择器快速筛选
---
## 技术支持
如遇到问题，请通过以下方式获取帮助：
- **问题反馈**：提交 Issue 到代码仓库
- **功能建议**：提交 Issue 并标注 `feature-request`
**代码仓库：**
- Gitee: https://gitee.com/zhang96110/idc_assest
- GitHub: https://github.com/gituib/idc_assest
---
**文档版本**：v1.0.0
**最后更新**：2026年3月