yunrui_asset/.work/项目整体分析报告.md

《项目整体分析报告》

核心功能

本项目是一个 IDC 设备管理系统，主要提供机房、机柜、设备、端口、线缆等资产的精细化管理功能，支持工单系统、耗材管理、盘点任务以及 3D 可视化展示。

技术栈

• 编程语言：JavaScript (Node.js v20+)
• 后端框架：Express 4.19.2
• 前端框架：React 18.2.0 (Vite 构建)
• 数据库：SQLite (默认) / MySQL
• 中间件：Swagger (API 文档), Sequelize (ORM), Three.js (3D 可视化)

服务架构

业务服务

• 后端服务 (Backend)：端口 8000，负责 API 接口、数据库交互、文件上传及系统逻辑。
• 前端服务 (Frontend)：端口 3000，负责用户界面交互及 3D 模型展示。

外部依赖

• 数据库 (SQLite)：本地文件 idc_management.db。
• 数据库 (MySQL)：可选，外部连接。

服务依赖关系

1. 数据库：后端启动时自动连接 SQLite 文件或 MySQL 实例。
2. 后端服务：执行数据库同步、字段初始化后启动。
3. 前端服务：依赖后端提供的 API 接口进行数据展示。

部署策略判断

• 是否适合 Docker 部署：是
• 判断依据：项目采用前后端分离架构，已提供 Dockerfile 及 docker-compose 配置，环境依赖明确（Node.js, SQLite/MySQL）。
• 项目类型：Web 应用