JEE Dashboard 安装与配置指南

JEE Dashboard 安装与配置指南

jee-dashboard Dashboard for past years' IITs and NITs opening-closing ranks, to help aspirants make an optimal decision for choice filling rounds based on their JEE Adv./Mains rank 项目地址: https://gitcode.com/gh_mirrors/je/jee-dashboard

1. 项目基础介绍

JEE Dashboard 是一个开源项目，用于展示过去几年 IITs 和 NITs 开放-关闭排名的数据。该项目旨在帮助 JEE 考生在咨询过程中基于自己的排名做出更明智和优化的选择。该项目使用多种编程语言和框架开发，主要包括以下两种语言：

• Python
• JavaScript

2. 项目使用的关键技术和框架

JEE Dashboard 项目使用以下关键技术和框架：

• 后端框架：Django（Python）
• 前端框架：React.js (JavaScript)
• 数据库：PostgreSQL
• 其他：Django REST framework, Docker

3. 项目安装和配置的准备工作

在开始安装和配置项目之前，请确保您的系统已经安装以下软件：

• Python 3.x
• Node.js 和 npm
• PostgreSQL
• Docker
• Git

详细安装步骤

步骤 1：克隆项目

首先，您需要从 GitHub 上克隆项目到本地计算机。打开终端（或命令提示符），然后执行以下命令：

git clone https://github.com/nisarg73/jee-dashboard.git
cd jee-dashboard

步骤 2：安装依赖

项目使用 pip 管理 Python 依赖，使用 npm 管理前端依赖。首先安装 Python 依赖：

pip install -r requirements.txt

然后安装前端依赖：

cd frontend
npm install

步骤 3：配置数据库

您需要配置 PostgreSQL 数据库。首先，创建一个新的数据库，然后编辑 backend/settings.py 文件，将数据库配置更新为您的数据库信息：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_db_name',
        'USER': 'your_db_user',
        'PASSWORD': 'your_db_password',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

步骤 4：迁移数据库

在项目根目录下运行以下命令，以迁移数据库：

python manage.py makemigrations
python manage.py migrate

步骤 5：启动项目

首先，启动 Django 开发服务器：

python manage.py runserver

然后，启动前端开发服务器：

cd frontend
npm start

现在，您应该能够通过浏览器访问 http://localhost:8000 来查看项目。

步骤 6：使用 Docker（可选）

如果您希望使用 Docker 来运行项目，请执行以下步骤：

1. 创建 .env 文件并添加数据库配置。
2. 在项目根目录下运行 docker-compose up。

这将启动所有服务，包括 Django 后端和 React 前端。

以上就是 JEE Dashboard 的安装和配置指南。按照上述步骤操作，您应该能够成功运行该项目。

jee-dashboard Dashboard for past years' IITs and NITs opening-closing ranks, to help aspirants make an optimal decision for choice filling rounds based on their JEE Adv./Mains rank 项目地址: https://gitcode.com/gh_mirrors/je/jee-dashboard