Skip to content

A HR system to manage employees from on-boarding to off-boarding. Created using Next.js, and Django and PostgresSql.

License

Notifications You must be signed in to change notification settings

adhirajcs/HR-System

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HR System

A comprehensive Human Resource Management System with Django Ninja backend and Next.js frontend.

Features

  • HR Management

    • HR Registration and Authentication
    • HR Profile Management
  • Employee Management

    • Complete Employee CRUD Operations
    • Employee Profile Management
    • Employee Leave Tracking
  • Project Manager Management

    • Project Manager CRUD Operations
    • Project Manager Profile Management
  • Leave & Holiday Management

    • Holiday Calendar Management
    • Leave Request Management
    • Leave Status Tracking

Project Snapshots

Dashboard

[Coming Soon]

Employee Management

[Coming Soon]

Leave Management

[Coming Soon]

Tech Stack

  • Backend: Django 5.1.3 + Django Ninja 1.3.0
  • Frontend: Next.js 14.2
  • Database: PostgreSQL
  • UI: TailwindCSS 3.4
  • Authentication: Django Session + CSRF
  • Runtime: Bun

Prerequisites

  • Python 3.11+
  • Bun 1.0+
  • PostgreSQL 14+

Setup

Backend Setup

  1. Clone the repository
git clone https://github.com/adhirajcs/HR-System.git
cd hr-system/backend
  1. Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate  # Windows
  1. Install backend dependencies
pip install -r requirements.txt
  1. Configure environment variables
cp .env.example .env
# Required variables:
# DATABASE_URL=postgresql://user:password@localhost:5432/dbname
# SECRET_KEY=your-secret-key
# DEBUG=True
  1. Run migrations
python manage.py makemigrations
python manage.py migrate
  1. Start the Django development server
python manage.py runserver

Frontend Setup

  1. Navigate to frontend directory
cd frontend
  1. Install frontend dependencies
bun install
  1. Configure frontend environment
cp .env.example .env.local
# Required variables:
# NEXT_PUBLIC_API_URL=http://localhost:8000/api
  1. Run development server
bun dev

The application will be available at:

License

This project is licensed under the Apache License, Version 2.0 - see the LICENSE file for details.

About

A HR system to manage employees from on-boarding to off-boarding. Created using Next.js, and Django and PostgresSql.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published