/backend

Primary LanguageJavaScript

Job Hunt Backend

A production-ready backend for the Job Hunt platform—connecting job seekers, interns, freelancers, and companies. Built using Node.js, Express, and MongoDB with support for file uploads, authentication, and a multi-stage application process.

Table of Contents

Project Overview

Job Hunt ek platform hai jahan job seekers, interns, aur freelancers apna account bana sakte hain, jobs ke liye apply kar sakte hain, aur companies se connect ho sakte hain. Platform par apply karne ke baad, users ko 3-4 rounds ke test aur interview dene honge. Uske baad hi unko platform ki full access milegi, jismein wo jobs search, apply, aur companies ke saath connection bana sakte hain. Companies bhi apna account bana sakti hain, job post kar sakti hain, applicants ko manage kar sakti hain, aur 5 minute ki meeting schedule kar sakti hain. Company ki team applicants ko select, reject, ya delete bhi kar sakti hai.

Features

  • User Registration & Authentication
    • Job seekers, interns, freelancers, aur companies apna account bana sakte hain.
  • Multi-Stage Application Process
    • Platform par access ke liye 3-4 rounds ke test/interview.
  • Job Search & Apply
    • Jobs search karo, apply karo, aur application status track karo.
  • Professional Connections
    • Companies aur dusre users ke saath connections banao.
  • Company Management
    • Jobs post karo, applicants dekho, 5 minute meeting schedule karo, aur applicant status manage karo.
  • Profile Management
    • Apni profile aur details update karo.
  • File Uploads
    • Resume, portfolio, ya dusre documents securely upload karo.

User Roles

  • Job Seeker / Intern / Freelancer
    • Register, tests/interviews complete karo, jobs search/apply karo, companies se connect ho.
  • Company
    • Register, jobs post karo, applicants dekho, meetings schedule karo, aur select/reject/delete karo.

Application Flow

  1. Account Creation:
    User (job seeker/intern/freelancer/company) account banata hai.

  2. Application Process:
    User 3-4 rounds ke test/interview complete karta hai.

  3. Platform Access:
    Test/interview clear karne ke baad, user ko platform ki full access milti hai.

  4. Job Search & Connections:
    User jobs search/apply kar sakta hai, companies se connect ho sakta hai.

  5. Company Actions:
    Company applicants ko dekh sakti hai, 5 minute ki meeting schedule kar sakti hai, aur select/reject/delete kar sakti hai.

Tech Stack

  • Node.js & Express (Backend Framework)
  • MongoDB & Mongoose (Database)
  • Multer & GridFS (File Uploads)
  • JWT (Authentication)
  • dotenv (Environment Variables)
  • Nodemon (Development)

Folder Structure

backend/ ├── src/ │ ├── config/ │ ├── controllers/ │ ├── middlewares/ │ ├── models/ │ ├── routes/ │ ├── services/ │ ├── utils/ │ ├── app.js │ └── server.js ├── public/ ├── tests/ ├── .env ├── .gitignore ├── package.json └── README.md

Setup & Installation

  1. Clone the Repository

  2. Install Dependencies

  3. Configure Environment Variables

  • .env file create karo: 
    PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
  1. Run the Server

API Endpoints

Note: Detailed API documentation jaldi hi /docs folder ya Swagger/Postman collection me milegi.

  • Auth: /api/auth
  • Users: /api/users
  • Companies: /api/companies
  • Jobs: /api/jobs
  • Applications: /api/applications
  • Files: /api/files
  • Connections: /api/connections

Contribution Guidelines

  • Repository fork karo aur apni branch banao.
  • Commit messages clear aur concise likho.
  • Code ko achhe se document aur test karo.
  • Pull Request raise karo review ke liye.

License

This project is licensed under the MIT License.

Developed with ❤️ by the Job Hunt Team