# 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)** | 安全相关的修复 |

---

## 更新日志格式

每个版本更新应包含：

```
## [版本号] - 发布日期

### 新增功能
- 功能描述

### 优化
- 改进内容

### 修复
- 修复的问题

### 升级注意事项
- 升级时需要注意的事项
```

---

**文档维护建议**：
- 每次发布新版本时及时更新本文件
- 在 `### 升级注意事项` 中详细说明可能导致不兼容的变更
- 使用清晰的描述，避免过于技术化的术语