Skip to content

Latest commit

 

History

History
138 lines (94 loc) · 2.18 KB

README.md

File metadata and controls

138 lines (94 loc) · 2.18 KB

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.