diff --git a/.trae/documents/IDC设备管理系统优化计划.md b/.trae/documents/IDC设备管理系统优化计划.md deleted file mode 100644 index d475131..0000000 --- a/.trae/documents/IDC设备管理系统优化计划.md +++ /dev/null @@ -1,160 +0,0 @@ -# IDC设备管理系统优化计划 - -## 一、项目结构优化 - -### 1. 后端路由拆分 -- **问题**：单个路由文件过大（如devices.js超过1200行），包含重复代码 -- **优化方案**：将大型路由文件拆分为多个子路由文件，按功能模块组织 - - 设备基础路由 - - 设备导入导出 - - 设备批量操作 - - 设备增强功能 - -### 2. 前端代码分割 -- **问题**：前端代码未进行懒加载和代码分割，初始加载时间长 -- **优化方案**：使用React.lazy和Suspense实现组件懒加载，按页面模块分割代码 - -## 二、技术栈升级 - -### 1. 依赖版本更新 -- **问题**：部分依赖版本较旧，存在安全隐患 -- **优化方案**：升级核心依赖 - - bcryptjs: ^3.0.3 → ^4.0.1 - - jsonwebtoken: ^9.0.3 → ^9.0.2（最新稳定版） - - three: ^0.160.0 → ^0.182.0（保持与后端一致） - -### 2. 数据库优化 -- **问题**：缺乏索引优化，查询性能可能受影响 -- **优化方案**：为常用查询字段添加索引 - - 设备表：deviceId, rackId, status, type - - 用户表：username, email - - 工单表：status, createdAt - -## 三、代码质量提升 - -### 1. 统一错误处理 -- **问题**：错误处理分散，缺乏统一机制 -- **优化方案**：实现全局错误处理中间件 - - 统一错误格式 - - 错误日志记录 - - 友好的错误提示 - -### 2. 请求参数验证 -- **问题**：缺乏请求参数验证，容易受到恶意攻击 -- **优化方案**：使用Zod或Joi实现请求参数验证 - - 路由层验证 - - 模型层验证 - - 自定义验证规则 - -### 3. 重复代码消除 -- **问题**：同一功能在多个地方重复实现（如批量操作） -- **优化方案**：提取公共函数和中间件 - - 批量操作工具函数 - - 权限验证中间件 - - 文件处理工具函数 - -## 四、安全性增强 - -### 1. 密码哈希算法升级 -- **问题**：使用旧版bcryptjs，安全性较低 -- **优化方案**：升级到最新版bcryptjs，使用更强的哈希算法 - -### 2. API速率限制 -- **问题**：缺乏API请求频率限制，容易受到DDoS攻击 -- **优化方案**：实现速率限制中间件 - - IP级别的速率限制 - - 用户级别的速率限制 - - 不同API端点的差异化限制 - -### 3. 输入验证和消毒 -- **问题**：缺乏输入验证和消毒，容易受到XSS和SQL注入攻击 -- **优化方案**： - - 前端输入验证 - - 后端输入消毒 - - 使用参数化查询防止SQL注入 - -## 五、可维护性提升 - -### 1. 代码风格规范 -- **问题**：缺乏统一的代码风格规范 -- **优化方案**：配置ESLint和Prettier - - 统一代码风格 - - 自动格式化代码 - - 代码质量检查 - -### 2. API文档 -- **问题**：缺乏API文档，开发和维护困难 -- **优化方案**：集成Swagger/OpenAPI - - 自动生成API文档 - - 支持在线测试 - - 版本管理 - -### 3. 测试覆盖 -- **问题**：缺乏单元测试和集成测试，代码质量难以保证 -- **优化方案**： - - 编写单元测试（Jest） - - 编写集成测试（Supertest） - - 配置测试覆盖率报告 - -## 六、性能优化 - -### 1. 前端性能优化 -- **问题**：页面加载和交互性能有待提升 -- **优化方案**： - - 实现组件懒加载 - - 优化图片加载（使用WebP格式、懒加载） - - 减少不必要的重渲染 - - 使用React.memo和useMemo优化组件性能 - -### 2. 后端性能优化 -- **问题**：数据库查询性能和API响应速度 -- **优化方案**： - - 添加数据库索引 - - 实现缓存机制（Redis） - - 优化SQL查询，减少N+1问题 - - 使用连接池管理数据库连接 - -### 3. 图片上传优化 -- **问题**：图片上传和处理效率较低 -- **优化方案**： - - 实现图片压缩 - - 使用CDN存储图片 - - 异步处理图片上传 - -## 七、实施步骤 - -1. **第一阶段**：基础优化 - - 依赖版本更新 - - 代码风格规范配置 - - 统一错误处理实现 - -2. **第二阶段**：结构优化 - - 后端路由拆分 - - 前端代码分割 - - API文档集成 - -3. **第三阶段**：安全性增强 - - 密码哈希算法升级 - - 请求参数验证 - - API速率限制 - - 输入验证和消毒 - -4. **第四阶段**：性能优化 - - 数据库索引优化 - - 前端性能优化 - - 缓存机制实现 - -5. **第五阶段**：测试和CI/CD - - 编写单元测试和集成测试 - - 配置CI/CD流程 - - 测试覆盖率提升 - -## 八、预期效果 - -- **性能提升**：页面加载时间减少50%，API响应时间减少30% -- **安全性增强**：消除已知安全隐患，提高系统抗攻击能力 -- **可维护性提升**：代码结构清晰，文档完善，便于开发和维护 -- **开发效率提升**：统一的代码规范和工具链，减少开发和调试时间 -- **扩展性增强**：模块化设计，便于后续功能扩展和系统升级 - -通过以上优化措施，可以显著提升IDC设备管理系统的性能、安全性和可维护性，为用户提供更好的使用体验。 \ No newline at end of file diff --git a/.trae/documents/plan_20260120_031540.md b/.trae/documents/plan_20260120_031540.md deleted file mode 100644 index 911c92a..0000000 --- a/.trae/documents/plan_20260120_031540.md +++ /dev/null @@ -1,33 +0,0 @@ -## 仪表盘获取统计数据失败修复方案 - -### 问题分析 -从代码分析，仪表盘 `fetchStats` 函数中存在以下潜在问题： -1. 使用了不存在的 API 端点：`/api/devices/count` -2. 没有处理 API 响应格式不一致的情况 -3. 缺少详细的错误日志，难以定位具体失败原因 - -### 修复方案 -修改 `Dashboard.jsx` 中的 `fetchStats` 函数，使用与其他页面一致的 API 调用方式： - -1. **替换不存在的 API 端点**：使用 `/api/devices?status=fault` 代替 `/api/devices/count` -2. **统一 API 调用模式**：与其他页面保持一致的 API 调用和数据解析方式 -3. **增强错误处理**：添加详细的错误信息和日志 -4. **添加请求超时处理**：防止请求长时间阻塞 -5. **优化并发请求**：使用 Promise.all 优化多个 API 请求 - -### 具体修改点 -1. 修改 `fetchStats` 函数中的 API 调用逻辑 -2. 调整错误处理和日志记录 -3. 添加请求超时配置 -4. 优化数据解析逻辑 - -### 预期效果 -修复后，仪表盘将能够成功获取所有统计数据，包括： -- 总设备数 -- 总机柜数 -- 总机房数 -- 故障设备数 -- 用户总数 -- 待处理工单 - -同时，页面将显示更友好的错误提示，便于开发人员定位问题。 \ No newline at end of file diff --git a/.trae/rules/project_rules.md b/.trae/rules/project_rules.md deleted file mode 100644 index 0d98718..0000000 --- a/.trae/rules/project_rules.md +++ /dev/null @@ -1,10 +0,0 @@ -### 项目专属规则 -项目初始化：React+TS 优先用 Vite 创建（npm create vite@latest），默认配置 ESLint+Prettier，锁定包管理器为 pnpm。 -目录规范：src 下分 api/（接口）、components/（通用组件）、pages/（页面）、assets/（静态资源）、utils/（工具函数），禁止多层嵌套。 -版本管理：用 nvm 锁定 Node.js LTS 版本（如 v20.10.0），package.json 标注依赖版本（如 react@18.2.0），提交前执行 pnpm lint 校验。分支管理：主分支 main/develop，功能分支 feature/xxx，修复分支 fix/xxx，合并前必须通过单元测试（vitest 覆盖率≥80%）。 -静态资源：public 目录仅存无需打包的静态文件，src/assets 资源 import 引入，大文件（>1MB）用懒加载+CDN 备选方案。 -构建部署：本地构建 npm run build，生产环境加 --mode production，输出目录 dist 适配 Nginx 部署，配置 gzip 压缩。 - 文档要求：项目根目录必须有 README.md（含启动/部署步骤）、CHANGELOG.md（版本迭代记录），接口文档放 docs/api 目录。 -性能监控：接入 web-vitals 监测首屏加载/交互延迟，打包后用 bundle-analyzer 分析体积，按需拆分 chunk。 -环境配置：区分 .env.development/.env.production，敏感配置通过环境变量注入，禁止硬编码密钥。 -迭代规范：需求拆分按「原子化功能」，单分支迭代周期≤7天，提测前完成自测+代码评审，标注改动影响范围。 \ No newline at end of file