水利工程项目资料收集系统

一个用于水利工程项目资料管理的Web应用，支持资料上传、分类管理、检索与预览、权限管理和资料归档等功能。

系统架构

• 前端：React, Ant Design, Axios
• 后端：Node.js, Express.js
• 数据库：MongoDB

系统要求

• Node.js 14.0+
• MongoDB 4.0+
• 浏览器：Chrome, Firefox, Edge等现代浏览器

快速启动

1. 安装MongoDB

首先需要安装MongoDB数据库。有以下两种方式：

• 方式一：下载MongoDB社区版并安装
• 方式二：使用Docker运行MongoDB

  docker run -d -p 27017:27017 -v ./database/data:/data/db --name mongodb mongo:latest
  

2. 启动系统

Windows系统

右键点击start_system.ps1脚本，选择"使用PowerShell运行"即可一键启动系统。

或在PowerShell中执行:

.\start_system.ps1

手动启动

如果需要手动启动系统，请按以下步骤操作：

1. 启动后端服务

   cd backend
   npm install  # 首次运行需执行
   npm start
   

2. 在新终端中启动前端服务

   cd frontend
   npm install  # 首次运行需执行
   npm start
   

3. 访问系统

• 前端地址：http://localhost:3000
• 后端API地址：http://localhost:5000
• 默认管理员账号：admin / admin123

目录结构

/
├── frontend/           # 前端代码
├── backend/            # 后端代码
├── database/           # 数据库文件
├── start_system.ps1    # 启动脚本(Windows)
└── README.md           # 项目说明文件

问题排查

1. MongoDB连接失败

   • 确保MongoDB服务正在运行
   • 检查连接字符串是否正确
   • 默认连接地址：mongodb://localhost:27017/water_project_data_system

2. 前端启动失败

   • 检查Node.js版本是否兼容
   • 确保已执行npm install安装依赖

3. 后端启动失败

   • 检查MongoDB连接是否正常
   • 确保端口5000未被占用

技术支持

如有问题，请提交Issue或联系系统管理员。