288 lines
8.1 KiB
Markdown
288 lines
8.1 KiB
Markdown
# CHANGELOG
|
||
|
||
所有版本变更记录按时间倒序排列。
|
||
|
||
---
|
||
|
||
## [1.2.0] - 2026-02-05
|
||
|
||
### 新增功能
|
||
|
||
#### 端口与线缆管理
|
||
- 新增设备端口管理模块，支持端口类型（网口、光口）、速率、状态配置
|
||
- 新增网卡（NetworkCard）管理功能，支持网卡与端口绑定
|
||
- 新增线缆（Cable）管理模块，支持机柜间线缆连接追踪
|
||
- 端口面板可视化展示，直观管理设备端口
|
||
|
||
#### 系统功能增强
|
||
- 新增系统设置管理，支持站点名称、Logo等配置
|
||
- 新增背景配置管理，支持自定义系统背景图
|
||
- 完善用户权限管理，支持角色权限分配
|
||
|
||
### 优化
|
||
|
||
#### 3D可视化性能优化
|
||
- 优化 Scene.jsx 渲染配置，降低设备像素比至 [1, 1.2]
|
||
- 减小阴影贴图尺寸至 [1024, 1024]
|
||
- 移除 ContactShadows 组件以减少阴影计算
|
||
- 简化光源配置，移除冗余 pointLight
|
||
- 优化环境光分辨率配置
|
||
|
||
#### 设备模型优化
|
||
- 实现性能模式（PERFORMANCE_MODE）以简化设备细节
|
||
- 添加设备滑轨动画控制开关
|
||
- 设备弹出动画默认关闭，可通过界面开关启用
|
||
- 优化设备状态指示灯渲染性能
|
||
|
||
#### LOD（多级细节）系统
|
||
- 实现 LOD 管理器，根据相机距离自动切换设备细节级别
|
||
- 高细节模式：完整设备模型，包含所有端口和细节
|
||
- 中等细节模式：简化设备模型，使用 InstancedMesh 渲染端口
|
||
- 低细节模式：极简设备模型，仅保留基本轮廓和状态灯
|
||
|
||
### 修复
|
||
|
||
- 修复 AnimationManager 导入错误，移除对不存在文件的引用
|
||
- 修复设备在缩放时位置偏移的问题
|
||
- 修复 LOD 模型中状态灯位置计算错误
|
||
- 修复 LODManager 中的几何体参数错误
|
||
|
||
### 升级注意事项
|
||
|
||
- 本版本对 3D 渲染进行了优化，建议在性能较低的设备上测试后再升级生产环境
|
||
- 新增的端口管理功能需要在管理员后台配置相关字段
|
||
|
||
---
|
||
|
||
## [1.1.0] - 2026-01-26
|
||
|
||
### 新增功能
|
||
|
||
#### 盘点管理模块
|
||
- 新增盘点计划（InventoryPlan）管理，支持制定定期盘点计划
|
||
- 新增盘点任务（InventoryTask）分配，支持按机房/机柜分配盘点任务
|
||
- 新增盘点记录（InventoryRecord），记录实际盘点结果
|
||
- 支持盘点任务状态跟踪：待执行 → 执行中 → 已完成
|
||
|
||
#### 故障分类管理
|
||
- 新增故障分类（FaultCategory）管理
|
||
- 支持故障类型自定义
|
||
|
||
### 优化
|
||
|
||
#### 用户体验改进
|
||
- 优化页面加载速度，减少首屏渲染时间
|
||
- 改进数据表格分页机制，支持大数据量展示
|
||
- 优化表单验证提示，提供更友好的错误反馈
|
||
|
||
#### API性能优化
|
||
- 优化数据库查询，使用索引提升查询效率
|
||
- 增加API响应缓存，减少重复查询
|
||
|
||
### 修复
|
||
|
||
- 修复设备批量导入时字段映射错误的问题
|
||
- 修复工单分配给不存在用户时的错误处理
|
||
- 修复报表导出时日期格式不正确的问题
|
||
- 修复部分页面在移动端显示错位的问题
|
||
|
||
### 升级注意事项
|
||
|
||
- 本版本新增了盘点管理相关数据表，首次启动时会自动创建
|
||
- 如使用 MySQL 数据库，建议运行 `node scripts/migrate-v2.js` 进行数据迁移
|
||
|
||
---
|
||
|
||
## [1.0.0] - 2026-01-21
|
||
|
||
### 新增功能
|
||
|
||
#### 机房管理模块
|
||
- 机房列表查询与展示，支持分页和搜索
|
||
- 机房创建、编辑、删除功能
|
||
- 机房位置、面积、负责人等详细信息管理
|
||
|
||
#### 机柜管理模块
|
||
- 机柜增删改查操作
|
||
- 按机房分类管理机柜
|
||
- 机柜容量统计与状态展示（已用U数、剩余U数）
|
||
- 3D机柜可视化展示
|
||
|
||
#### 设备管理模块
|
||
- 设备全生命周期管理（采购 → 上线 → 运行 → 维护 → 报废）
|
||
- 设备批量导入/导出功能（支持 Excel/CSV）
|
||
- 自定义设备字段配置，满足不同业务需求
|
||
- 设备状态跟踪与筛选
|
||
- 设备详情面板，展示完整设备信息
|
||
|
||
#### 工单管理模块
|
||
- 工单创建与处理流程
|
||
- 工单分类（TicketCategory）管理
|
||
- 工单自定义字段（TicketField），灵活扩展工单属性
|
||
- 工单操作记录（TicketOperationRecord）审计
|
||
- 工单状态：待处理 → 处理中 → 已完成 → 已关闭
|
||
|
||
#### 耗材管理模块
|
||
- 耗材（Consumable）分类管理
|
||
- 耗材库存管理，支持库存预警
|
||
- 耗材领用记录（ConsumableRecord）
|
||
- 耗材使用日志（ConsumableLog）追踪
|
||
- 耗材使用统计报表
|
||
|
||
#### 用户权限模块
|
||
- 用户（User）管理，支持CRUD操作
|
||
- 角色（Role）管理
|
||
- 权限（Permission）控制
|
||
- 认证授权（JWT）机制
|
||
|
||
#### 系统配置模块
|
||
- 系统设置（SystemSetting）管理
|
||
- 背景配置管理
|
||
- 设备字段初始化配置
|
||
- 工单字段初始化配置
|
||
|
||
### 技术架构
|
||
|
||
#### 前端技术栈
|
||
- React 18.2.0 - UI框架
|
||
- Vite 4.4.9 - 构建工具
|
||
- Ant Design 5.8.6 - UI组件库
|
||
- Three.js 0.160.0 - 3D渲染引擎
|
||
- React Router 6.15.0 - 路由管理
|
||
- Axios 1.5.0 - HTTP客户端
|
||
- Day.js 1.11.19 - 日期处理
|
||
- SheetJS (xlsx) 0.18.5 - Excel处理
|
||
- PapaParse 5.5.3 - CSV解析
|
||
|
||
#### 后端技术栈
|
||
- Node.js ≥14.0.0 - 运行时环境
|
||
- Express 4.18.2 - Web框架
|
||
- Sequelize 6.32.1 - ORM框架
|
||
- SQLite 5.1.6 / MySQL 8.0+ - 数据库支持
|
||
- JWT 9.0.3 - 身份认证
|
||
- bcryptjs 3.0.3 - 密码加密
|
||
- Winston 3.19.0 - 日志管理
|
||
- Jest 30.2.0 - 测试框架
|
||
- Joi 18.0.2 - 数据验证
|
||
|
||
### 数据库模型
|
||
|
||
| 模型 | 说明 |
|
||
|------|------|
|
||
| Room | 机房 |
|
||
| Rack | 机柜 |
|
||
| Device | 设备 |
|
||
| DeviceField | 设备自定义字段 |
|
||
| DevicePort | 设备端口 |
|
||
| NetworkCard | 网卡 |
|
||
| Cable | 线缆 |
|
||
| Ticket | 工单 |
|
||
| TicketField | 工单自定义字段 |
|
||
| TicketCategory | 工单分类 |
|
||
| TicketOperationRecord | 工单操作记录 |
|
||
| Consumable | 耗材 |
|
||
| ConsumableCategory | 耗材分类 |
|
||
| ConsumableRecord | 耗材领用记录 |
|
||
| ConsumableLog | 耗材日志 |
|
||
| InventoryPlan | 盘点计划 |
|
||
| InventoryTask | 盘点任务 |
|
||
| InventoryRecord | 盘点记录 |
|
||
| User | 用户 |
|
||
| Role | 角色 |
|
||
| Permission | 权限 |
|
||
| UserRole | 用户角色关联 |
|
||
| SystemSetting | 系统设置 |
|
||
|
||
### API接口概览
|
||
|
||
| 模块 | 接口数 | 主要功能 |
|
||
|------|--------|----------|
|
||
| 认证 | 2 | 登录、注册 |
|
||
| 机房 | 4 | 增删改查 |
|
||
| 机柜 | 4 | 增删改查 |
|
||
| 设备 | 5 | 增删改查、批量导入 |
|
||
| 设备字段 | 4 | 字段管理 |
|
||
| 工单 | 4 | 工单流程管理 |
|
||
| 工单分类 | 4 | 分类管理 |
|
||
| 工单字段 | 4 | 字段管理 |
|
||
| 耗材 | 4 | 库存管理 |
|
||
| 耗材分类 | 4 | 分类管理 |
|
||
| 耗材记录 | 4 | 领用管理 |
|
||
| 用户 | 4 | 用户管理 |
|
||
| 角色 | 4 | 角色管理 |
|
||
| 系统设置 | 2 | 配置管理 |
|
||
|
||
### 升级注意事项
|
||
|
||
- 这是初始正式版本，从 Beta/Alpha 版本升级时需注意数据迁移
|
||
- 建议在升级前备份数据库
|
||
- 首次部署需要运行 `node scripts/init-database.js` 初始化数据库
|
||
|
||
---
|
||
|
||
## 版本号规范
|
||
|
||
本项目使用语义化版本号（Semantic Versioning）：
|
||
|
||
```
|
||
主版本号.次版本号.修订号
|
||
MAJOR.MINOR.PATCH
|
||
```
|
||
|
||
| 版本类型 | 变更规则 |
|
||
|----------|----------|
|
||
| **主版本 (MAJOR)** | 不兼容的API变更 |
|
||
| **次版本 (MINOR)** | 向后兼容的新功能 |
|
||
| **修订号 (PATCH)** | 向后兼容的bug修复 |
|
||
|
||
### 版本号示例
|
||
|
||
- `1.0.0` - 初始正式版本
|
||
- `1.1.0` - 新增功能，向后兼容
|
||
- `1.1.1` - Bug修复，向后兼容
|
||
- `2.0.0` - 重大变更，不兼容
|
||
|
||
---
|
||
|
||
## 格式说明
|
||
|
||
本 CHANGELOG 遵循 [Keep a Changelog](https://keepachangelog.com/) 规范：
|
||
|
||
| 类型 | 说明 |
|
||
|------|------|
|
||
| **新增 (Added)** | 新功能添加 |
|
||
| **优化 (Changed)** | 功能改进和性能优化 |
|
||
| **修复 (Fixed)** | Bug修复 |
|
||
| **废弃 (Deprecated)** | 即将移除的功能 |
|
||
| **移除 (Removed)** | 已移除的功能 |
|
||
| **安全 (Security)** | 安全相关的修复 |
|
||
|
||
---
|
||
|
||
## 更新日志格式
|
||
|
||
每个版本更新应包含：
|
||
|
||
```
|
||
## [版本号] - 发布日期
|
||
|
||
### 新增功能
|
||
- 功能描述
|
||
|
||
### 优化
|
||
- 改进内容
|
||
|
||
### 修复
|
||
- 修复的问题
|
||
|
||
### 升级注意事项
|
||
- 升级时需要注意的事项
|
||
```
|
||
|
||
---
|
||
|
||
**文档维护建议**：
|
||
- 每次发布新版本时及时更新本文件
|
||
- 在 `### 升级注意事项` 中详细说明可能导致不兼容的变更
|
||
- 使用清晰的描述，避免过于技术化的术语
|