admin/DEVICE_FIELD_UPDATE.md
lvfengfree 7d3f98e4f0 refactor: 删除设备表type、location、manager字段
- 前端:移除设备列表、电源控制、在线设备、设备监控页面中的相关字段显示
- 后端:删除Device实体和DeviceDTO中的type、location、manager字段
- 后端:移除DeviceService中对已删除字段的查询逻辑
- 后端:移除PageRequest中的type查询参数
- 数据库:创建SQL脚本删除sys_device表中的相关字段
- 设备编号字段改为UUID显示(280px宽度,带省略号)
2026-03-01 13:24:42 +08:00

100 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 设备字段显示更新
## 修改内容
根据需求,对设备相关页面的字段显示进行了以下调整:
### 字段变更
1. **设备编号****UUID**字段名称更改宽度增加到280px以适应UUID长度
2. **移除字段**
- 设备类型type
- 所在位置location
- 负责人manager
### 修改的页面
#### 1. 设备列表页面 (`src/views/device/list/index.vue`)
- ✅ 表格列设备编号改为UUID移除设备类型、所在位置、负责人
- ✅ 搜索栏:移除设备类型筛选
- ✅ 表单UUID字段移除设备类型、所在位置、负责人输入框
- ✅ 详情弹窗显示UUID移除设备类型、所在位置、负责人信息
- ✅ 搜索参数移除type字段
- ✅ 表单数据移除type、location、manager字段
- ✅ 表单验证更新为UUID验证
#### 2. 电源控制页面 (`src/views/device/power/index.vue`)
- ✅ 表格列设备编号改为UUID280px宽度移除设备类型、所在位置、负责人
- ✅ 添加MAC地址列显示
#### 3. 在线设备页面 (`src/views/device/online/index.vue`)
- ✅ 卡片视图移除设备类型、所在位置、负责人显示保留UUID、IP、MAC
- ✅ 列表视图表格UUID列280px宽度移除设备类型、所在位置、负责人
- ✅ 详情弹窗显示UUID移除设备类型、所在位置、负责人
#### 4. 设备监控页面 (`src/views/device/monitor/index.vue`)
- ✅ 监控卡片位置信息改为显示IP地址
- ✅ 详情弹窗系统信息显示UUID移除设备类型、所在位置、负责人
## 保留的字段
所有页面保留以下字段:
- 设备名称deviceName
- UUIDdeviceCode
- 设备状态status
- IP地址ipAddress
- MAC地址macAddress
- 创建时间createTime
- 更新时间updateTime
- 备注remark
## 技术细节
### 表格列宽度调整
- UUID列280px带省略号提示
- 其他列:保持原有宽度
### 表单布局
- 使用 `n-grid` 2列布局
- UUID字段在编辑时禁用disabled
- 移除了设备类型、所在位置、负责人的表单项
### 数据模型
后端数据模型保持不变,只是前端不再显示和编辑这些字段。如果需要完全移除这些字段,需要同步修改:
1. 后端实体类Device.java
2. 数据库表结构
3. DTO类
4. API接口
## 测试建议
1. 测试设备列表页面的显示和操作
2. 测试电源控制页面的设备列表
3. 测试在线设备页面的卡片和列表视图
4. 测试设备监控页面的监控卡片和详情
5. 测试设备的新增、编辑、删除功能
6. 验证UUID字段的显示和省略号提示
7. 确认所有移除的字段不再显示
## 注意事项
1. **UUID长度**UUID通常为36个字符设置280px宽度并启用省略号提示
2. **后端兼容**后端仍然可以接收和存储type、location、manager字段只是前端不显示
3. **数据迁移**:如果需要完全移除这些字段,建议先备份数据
4. **API兼容性**现有API接口保持不变只是前端不使用这些字段
## 文件清单
修改的文件:
- `src/views/device/list/index.vue`
- `src/views/device/power/index.vue`
- `src/views/device/online/index.vue`
- `src/views/device/monitor/index.vue`
## 后续优化建议
如果确定不再需要这些字段,可以考虑:
1. 从后端实体类中移除
2. 从数据库表中删除列
3. 更新API文档
4. 清理相关的类型定义