🎓 IIT Bhilai Student Forum

A centralized platform for IIT Bhilai students to share course feedback, contribute learning resources, and engage with peers through gamified interactions.

---

📖 Table of Contents

• About
• Features
• Screenshots
• Tech Stack
• Installation
• Contributing
• License
• Contact

---

📘 About

The IIT Bhilai Student Forum is a comprehensive and interactive platform built exclusively for the IIT Bhilai community. It enables students to:

• Share feedback and comments on courses
• Upload and explore resources
• Interact with a gamified system of badges and rewards
• View course analytics via data visualizations
• Manage their profiles
• Experience a clean role-based UI, including a special guest user view

Only IIT Bhilai students with valid institute IDs can log in through Google OAuth, ensuring a secure and private environment for authentic contributions and engagement.

---

✨ Features

• 🗣️ Course Feedback – Share ratings and thoughts on courses you've taken
• 💬 Comments Section – Open discussion for each course
• 📁 Resource Hub – Upload and access notes, books, PDFs, etc.
• 🔐 Google OAuth 2.0 – Institute-only login using IIT Bhilai email
• 👥 Role-Based Access Control – Different views for guest and student users
• 🏅 Gamification & Rewards – Earn badges for contributing resources and reviews
• 👤 Profile Management – View and manage your contributions and badges
• 📊 Visual Metrics – Graphs, charts, and speedometers showing feedback analytics
• 📈 Admin Analytics – Platform-wide stats including total users, unique courses, and total feedbacks
• 🔎 Filters & Search – Quickly find specific courses or resources
• 🌐 Fully Responsive – Optimized UI across devices

---

📸 Screenshots

---

🧰 Tech Stack

---

⚙️ Installation

Clone the repo

git clone https://github.com/ashutosh229/AcademicX.git

🚧 Backend

Navigate into the backend directory

cd AcademicX
cd backend

Create and activate virtual environment

python -m venv venv
source venv/bin/activate  # On Linux/MacOs
venv\Scripts\activate # On Windows

Install dependencies

pip install -r requirements.txt

Set up the environment variables

DB_NAME=
DB_USER=
DB_PASSWORD=
DB_HOST=
DB_PORT=
NEXTAUTH_SECRET= 

Run the migrations

python manage.py migrate 

Run the server

python manage.py runserver

💻 Frontend

Navigate to the frontend directory

cd AcademicX
cd frontend

Install dependencies

npm install 

Set up the environment variables

NEXTAUTH_URL=""
NEXTAUTH_SECRET=""
GOOGLE_CLIENT_ID=""
GOOGLE_CLIENT_SECRET=""

Run the server

npm run dev --debug 

---

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the codebase and submit the pull requests for the changes you want to contribute.

---

📄 License

This project is licensed under the MIT License.

Read the full license text here: MIT License

---

📬 Contact

If you have any questions, suggestions, or just want to connect, feel free to reach out:

• Name: Ashutosh Kumar Jha
• Email: ashutoshj@iitbhilai.ac.in
• LinkedIn: Linkedin
• GitHub: GitHub

---

💬 I’m always open to collaboration, feedback, or just a good tech conversation!