T

zhang1106 8c9e82c8a7 refactor(server, init-db): 调整数据库模型同步逻辑与顺序

- 补充新增的业务模型同步配置
- 按依赖层级重构初始化脚本的同步顺序
- 调整server.js中业务模型同步的调用时机
- 更新同步完成的日志信息

2026-05-15 16:52:38 +08:00

backend

refactor(server, init-db): 调整数据库模型同步逻辑与顺序

2026-05-15 16:52:38 +08:00

docs

docs: 删除过时的文档文件

2026-05-09 13:19:30 +08:00

frontend

style(rack): 移除冗余的进度条状态判断逻辑

2026-05-15 15:25:29 +08:00

install

fix(nginx): 适配宝塔面板Nginx部署环境

2026-05-15 16:29:46 +08:00

scripts

fix: 优化生产环境前端端口显示逻辑

2026-02-05 11:00:42 +08:00

.gitignore

feat(install): 新增安装脚本模块化重构

2026-05-09 15:54:43 +08:00

.nvmrc

feat: 添加操作日志、危险操作确认和业务关联功能

2026-03-20 17:15:14 +08:00

.prettierignore

chore: 统一代码风格并配置ESLint和Prettier

2026-02-10 11:04:01 +08:00

.prettierrc

chore: 统一代码风格并配置ESLint和Prettier

2026-02-10 11:04:01 +08:00

.vercelignore

feat: 优化3D可视化性能并更新文档

2026-01-26 17:21:20 +08:00

CHANGELOG.md

feat(机柜管理): 优化机柜导入导出功能

2026-05-06 15:12:57 +08:00

CODE_WIKI.md

feat(log): 增强日志系统功能与追踪能力

2026-05-07 17:14:54 +08:00

install.js

feat(install): 新增安装脚本模块化重构

2026-05-09 15:54:43 +08:00

install.sh

style(install.sh): 优化安装脚本banner排版和分隔符调用

2026-05-11 15:47:08 +08:00

LICENSE

add LICENSE.

2025-12-18 05:10:58 +00:00

package-lock.json

feat: 分析当前仓库

2026-04-30 15:36:08 +00:00

package.json

chore: 更新项目版本号至2.0.0

2026-04-30 16:28:04 +08:00

README.md

docs(readme): 重构README目录结构

2026-05-13 17:14:48 +08:00

uninstall.js

refactor(nginx): 重构卸载脚本的Nginx清理逻辑

2026-05-12 10:05:17 +08:00

update.js

fix(nginx): 适配宝塔面板Nginx部署环境

2026-05-15 16:29:46 +08:00

README.md

IDC设备资产管理系统

现代化数据中心（IDC）设备管理系统，提供机房、机柜、设备的全生命周期管理，具备 3D 可视化展示功能。

GitHub: https://github.com/gituib/idc_assest Gitee: https://gitee.com/zhang96110/idc_assest

功能特性

模块	描述
机房管理	多机房管理，平面图可视化
机柜管理	机柜增删改查，3D 可视化，批量导入导出
设备管理	全生命周期管理，自定义字段，批量导入导出
端口管理	设备端口配置，网卡绑定，批量管理
线缆管理	线缆连接管理，可视化追踪
网络拓扑	拓扑可视化展示（ReactFlow）
工单管理	故障报修，维护工单全流程
耗材管理	库存管理，SN 序列号追踪，日志归档
盘点管理	盘点计划与执行，待审核设备
空闲设备	空闲设备转入/激活
数据看板	实时监控，功率监控，趋势图表
3D 可视化	三维机柜展示，LOD 优化
机房平面图	Canvas 渲染，拖拽编辑
操作日志	审计追踪，统计分析
备份管理	本地/远程备份，自动定时
系统配置	自定义字段，背景配置
用户权限	RBAC 角色控制
API 文档	Swagger 交互式文档

项目截图

点击展开查看截图

数据看板 - 实时监控数据中心运行状态

3D 机柜可视化 - 三维展示机柜设备布局

机房管理 - 多机房分类管理

设备管理 - 设备全生命周期管理

工单管理 - 故障报修与维护工单处理

数据备份 - 数据库备份与恢复管理

快速开始

Linux 一键部署

# 克隆项目
git clone https://gitee.com/zhang96110/idc_assest.git
cd idc_assest

# 运行安装脚本（自动安装 Node.js）
./install.sh

# 或一键安装（无需克隆）
curl -fsSL https://gitee.com/zhang96110/idc_assest/raw/main/install.sh | bash

install.sh 自动完成：

自动检测 Linux 发行版（Ubuntu/Debian/CentOS/Arch）
自动安装 Node.js 20.x
自动安装系统依赖（git、curl）
调用 install.js 完成后续安装

Windows 部署

# 克隆项目
git clone https://gitee.com/zhang96110/idc_assest.git
cd idc_assest

# 运行安装脚本（需要先安装 Node.js）
node install.js

# 或使用 npm
npm run deploy

手动安装

# 1. 克隆项目
git clone https://gitee.com/zhang96110/idc_assest.git
cd idc_assest

# 2. 安装依赖
npm run install:all

# 3. 配置环境变量
cp backend/.env.example backend/.env

# 4. 配置 JWT 密钥（必填）
# 编辑 backend/.env，设置 JWT_SECRET 为强随机字符串
# 生成命令：openssl rand -hex 64（Linux/macOS）
# 或：node -e "console.log(require('crypto').randomBytes(64).toString('hex'))"

# 5. 初始化数据库
cd backend && node scripts/init-database.js

# 6. 启动服务
cd .. && npm start

访问地址：http://localhost:3000 默认账号：首次注册自动成为管理员

环境要求

项目	最低要求	推荐配置
操作系统	Windows 10+、macOS 12+、Linux	同最低
Node.js	≥14.0.0	20.x LTS
npm	≥6.0.0	10.x
内存	4GB	8GB+
磁盘	2GB	10GB+

生产环境额外要求：

项目	要求
数据库	MySQL 8.0+（推荐）或 SQLite
Web 服务器	Nginx 1.18+
进程管理	PM2 5.x+

脚本命令参考

install.js - 安装脚本

# 交互式安装
node install.js

# 非交互式安装
node install.js -y

# 指定数据库类型
node install.js -y --db=mysql    # 使用 MySQL
node install.js -y --db=sqlite    # 使用 SQLite（默认）

# 指定端口
node install.js -y --port=8000   # 后端端口

# 跳过前端构建
node install.js -y --skip-build

# 跳过 Nginx 配置
node install.js -y --skip-nginx

# 查看帮助
node install.js --help

update.js - 更新脚本

# 交互式更新
node update.js

# 模拟运行（不执行实际操作）
node update.js --dry-run

# 跳过某些步骤
node update.js --skip-git        # 跳过 Git 拉取
node update.js --skip-backup     # 跳过数据库备份
node update.js --skip-migrate    # 跳过数据库迁移
node update.js --skip-build       # 跳过前端构建
node update.js --skip-deps       # 跳过依赖安装
node update.js --skip-restart    # 跳过服务重启

# 强制执行（忽略锁文件）
node update.js --force

# 查看帮助
node update.js --help

智能检测功能：

依赖安装智能跳过（检测 package.json 变化）
前端构建智能跳过（检测源码变化）
数据库自动备份（支持回滚）
健康检查验证
日志持久化保存到 logs/update_*.log
锁机制防止重复运行

uninstall.js - 卸载脚本

# 交互式卸载
node uninstall.js

# 强制卸载（无需确认）
node uninstall.js --force

# 卸载前自动备份数据库
node uninstall.js --backup

# 跳过某些步骤
node uninstall.js --skip-db       # 跳过数据库删除
node uninstall.js --skip-deps     # 跳过依赖删除
node uninstall.js --skip-uploads  # 跳过上传文件删除

# 预览模式（不实际执行）
node uninstall.js --dry-run

# 查看帮助
node uninstall.js --help

部署指南

生产环境

生产环境部署只需运行 ./install.sh 或 node install.js，脚本会自动完成所有配置。

仅需提前准备 MySQL 数据库（如使用 MySQL）：

-- 创建数据库
CREATE DATABASE idc_management CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 创建用户
CREATE USER 'idc_user'@'localhost' IDENTIFIED BY 'YourStrongPassword';
GRANT ALL PRIVILEGES ON idc_management.* TO 'idc_user'@'localhost';
FLUSH PRIVILEGES;

服务器要求参考：

规模	CPU	内存	磁盘
小型（<100 设备）	2 核心	4GB	40GB
中型（100-500 设备）	4 核心	8GB	80GB
大型（>500 设备）	8 核心+	16GB+	100GB+

Nginx 配置

install.js 会自动配置 Nginx。配置文件位于 deploy/nginx-idc.conf，核心配置如下：

server {
    listen 80;
    server_name your-domain.com;

    client_max_body_size 100M;

    root "/var/www/idc";
    index index.html;

    # Gzip 压缩
    gzip on;
    gzip_vary on;
    gzip_min_length 1024;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_types text/plain text/css text/xml text/javascript application/javascript application/xml+rss application/json application/x-javascript image/svg+xml;

    # 静态资源缓存（1年）
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot|hdr)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
        try_files $uri =404;
    }

    # API 代理
    location /api/ {
        proxy_pass http://127.0.0.1:8000/api/;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 300s;
        proxy_buffering off;
    }

    # 文件上传代理
    location /uploads/ {
        proxy_pass http://127.0.0.1:8000/uploads/;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        client_max_body_size 100M;
    }

    # 前端路由（SPA）
    location / {
        try_files $uri $uri/ /index.html =404;
    }
}

启用配置：

# Ubuntu/Debian
sudo cp deploy/nginx-idc.conf /etc/nginx/sites-available/idc
sudo ln -sf /etc/nginx/sites-available/idc /etc/nginx/sites-enabled/idc
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo nginx -s reload

系统维护

服务管理

# PM2 服务
pm2 status                    # 查看状态
pm2 logs idc-backend          # 查看日志
pm2 restart idc-backend         # 重启服务
pm2 stop idc-backend           # 停止服务
pm2 delete idc-backend         # 删除服务
pm2 save                       # 保存配置
pm2 startup                    # 开机自启

# Nginx
sudo nginx -t                 # 测试配置
sudo nginx -s reload          # 重载配置
sudo systemctl restart nginx   # 重启服务

日志查看

# PM2 日志
pm2 logs idc-backend
pm2 logs idc-backend --err    # 仅错误日志

# Nginx 日志
sudo tail -f /var/log/nginx/error.log

# 应用日志
tail -f backend/logs/*.log

数据备份

# 内置备份
# 系统管理 → 备份管理 → 创建备份

# 命令行备份
cd backend && node scripts/backup.js

# 还原
cd backend && node scripts/restore.js <backup-file>

常见问题

1. 端口冲突（8000、3000、80）

# 检查端口占用（Linux）
netstat -tulpn | grep :8000

# Windows
netstat -ano | findstr :8000

# 方案1：修改端口（编辑 backend/.env）
PORT=8001

# 方案2：停止占用进程
sudo kill $(lsof -t -i:8000)

2. 502 Bad Gateway

检查后端服务：pm2 status
检查端口监听：netstat -tulpn | grep 8000
检查 Nginx 配置：nginx -t
查看错误日志：tail /var/log/nginx/error.log

3. 前端构建失败

# 检查 Node.js 版本
node -v  # 需要 ≥18.x

# 清理并重试
cd frontend
rm -rf node_modules dist
npm install
npm run build

4. 数据库连接失败

MySQL：

检查服务状态：sudo systemctl status mysql
验证连接参数（主机、端口、用户名、密码）
确认数据库已创建：SHOW DATABASES;
检查用户权限：SHOW GRANTS FOR 'idc_user'@'localhost';

5. 权限问题

# 修复文件权限
sudo chown -R $(whoami):$(whoami) /path/to/idc_assest

# 上传目录权限
sudo chmod -R 777 backend/uploads

6. 内存不足

# 增加内存限制（编辑 ecosystem.config.js）
node_args: "--max-old-space-size=4096"

# 或命令行
pm2 restart idc-backend --update-env

7. npm 安装失败

# 清理缓存
npm cache clean --force

# 删除后重装
rm -rf node_modules package-lock.json
npm install

8. PM2 服务消失

# 重新启动
pm2 start ecosystem.config.js
pm2 save
pm2 startup

项目结构

idc_assest/
├── frontend/               # 前端项目
│   ├── src/
│   │   ├── api/          # API 接口
│   │   ├── components/   # 组件（3d/、dashboard/、device/、floorplan/）
│   │   ├── pages/       # 页面
│   │   ├── hooks/       # 自定义 Hooks
│   │   ├── stores/      # 状态管理
│   │   └── utils/       # 工具函数
│   └── package.json
├── backend/               # 后端项目
│   ├── models/          # Sequelize 数据模型
│   ├── routes/          # API 路由
│   ├── middleware/      # 中间件
│   ├── scripts/         # 数据库脚本（init-database.js、migrate-all.js）
│   ├── utils/          # 工具函数
│   ├── uploads/        # 上传文件目录
│   ├── server.js       # 服务入口
│   └── package.json
├── deploy/               # 部署配置
│   ├── ecosystem.config.js   # PM2 配置
│   └── nginx-idc.conf        # Nginx 配置
├── install/              # 安装脚本模块
├── docs/                # 项目文档
├── install.sh           # Linux 安装引导脚本
├── install.js           # 安装脚本入口
├── update.js            # 更新脚本
├── uninstall.js         # 卸载脚本
└── README.md            # 本文件

API 文档

完整交互式 API 文档访问：http://localhost:8000/api-docs

基于 Swagger/OpenAPI 3.0 标准，支持在线认证测试和 API 调试。

贡献指南

欢迎提交 Issue 或 Pull Request！

# 1. Fork 本项目

# 2. 克隆你的 Fork
git clone https://github.com/YOUR_USERNAME/idc_assest.git
cd idc_assest

# 3. 创建分支
git checkout -b feature/your-feature   # 功能开发
git checkout -b fix/your-fix          # Bug 修复

# 4. 开发并提交
git commit -m 'feat: 添加新功能'
git commit -m 'fix: 修复问题'

# 5. 推送并创建 PR
git push origin feature/your-feature

提交信息规范：

类型	说明
feat	新功能
fix	Bug 修复
docs	文档更新
style	代码格式
refactor	重构
perf	性能优化
test	测试
chore	构建/工具

开发规范：

使用 ES6+ 语法
遵循 React Hooks 规范
使用 async/await 处理异步
遵循 ESLint + Prettier 代码规范

许可证

本项目基于 MIT 许可证开源。

⭐ 如果这个项目对您有帮助，请给我们一个 Star！

Gitee Issues: https://gitee.com/zhang96110/idc_assest/issues
GitHub Issues: https://github.com/gituib/idc_assest/issues
QQ 群：1081123775

README.md Unescape Escape

IDC设备资产管理系统

目录

功能特性

项目截图

快速开始

Linux 一键部署

Windows 部署

手动安装

环境要求

脚本命令参考

install.js - 安装脚本

update.js - 更新脚本

uninstall.js - 卸载脚本

部署指南

生产环境

Nginx 配置

系统维护

服务管理

日志查看

数据备份

常见问题

项目结构

API 文档

贡献指南

许可证

README.md