What Next - Job Portal

This project is under development and not yet final; ongoing testing, feature additions, templates design and code adjustments are in progress 📈

What Next is a job portal web application built with Django. It facilitates connections between employers and job seekers, allowing employers to post jobs and employees to apply for them.

Features

• User authentication (Employee and Employer signup/login)
• Employee and Employer dashboard
• Job posting and management for employers
• Job search and application for employees
• Profile management for both employers and employees

Installation

1. Clone the repository:

   git clone https://github.com/your-username/WhatNext-JobPortal.git
   cd WhatNext-JobPortal
   

2. Create a virtual environment and activate it:

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

3. Install the requirements:

   pip install -r requirements.txt
   

4. Run migrations:

   python manage.py migrate
   

5. Create a superuser:

   python manage.py createsuperuser
   

6. Run the development server:

   python manage.py runserver
   

Project Structure

The project consists of two main Django apps:

1. jobs: Handles job-related functionality
2. accounts: Manages user authentication and profiles

API Endpoints

Main URLs

• /admin/: Django admin interface
• All other routes are included from the jobs and accounts apps

Accounts App

• /employer/register: Register a new employer account
• /candidate/register: Register a new candidate account
• /candidate/profile: View candidate profile
• /candidate/profile/edit: Edit candidate profile
• /candidate/applications: View candidate's job applications
• /candidate/applications/delete/<int:pk>/: Delete a specific job application
• /logout: Log out the current user
• /login: Log in a user

Jobs App

• /: Home page
• /search: Search for jobs
• /employer/dashboard/: Employer dashboard
• /employer/dashboard/all-applicants: View all applicants
• /employer/dashboard/applicants/<int:job_id>: View applicants for a specific job
• /employer/dashboard/edit/<int:pk>: Edit a job posting
• /employer/dashboard/delete/<int:pk>: Delete a job posting
• /employer/dashboard/job/<int:job_id>/applicant/<int:applicant_id>/update-status/: Update application status
• /apply-job/<int:job_id>: Apply for a job
• /jobs: List all jobs
• /jobs/<int:id>: View details of a specific job
• /employer/jobs/create: Create a new job posting
• /employer/profile/: View employer profile
• /employer/edit-profile/: Edit employer profile

Usage

1. Employers can register and create job listings.
2. Job seekers can register as employees and browse job listings.
3. Employees can apply for jobs.
4. Employers can view applicants and manage their job postings.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Screenshots

License