StellarHR - Human Resources Information System (HRIS) Project

Overview

StellarHR is a comprehensive Human Resources Information System (HRIS) designed to streamline and enhance HR management processes within an organization. This project aims to provide a centralized platform for managing employee data, automating HR tasks, and improving overall efficiency in workforce management.

Features

• User Authentication and Authorization: Secure user authentication and authorization mechanisms to ensure data privacy and access control.

• Employee Management: Maintain a centralized database of employee information, including personal details, employment history, and contact information.

• Leave Management: Streamline leave requests, approvals, and tracking, ensuring accurate and efficient management of employee leave.

• Attendance Tracking: Monitor employee attendance, manage timesheets, and generate reports for payroll and performance analysis.

• Performance Evaluation: Conduct performance reviews, set goals, and track employee performance over time.

• Recruitment Module: Facilitate the hiring process with tools for posting job openings, applicant tracking, and interview scheduling.

• Training and Development: Manage employee training programs, track progress, and assess the impact on individual and team performance.

• Payroll Integration: Integrate with payroll systems to automate salary calculations, deductions, and disbursements.

Tech Used:

• python3
• django5
• postgres sql (either installed on your machine or use docker container)
• docker(if using docker)

Setting up PostgreSQL on Windows and Linux

Windows: Install PostgreSQL on Windows: Download the PostgreSQL installer for Windows from the official website. Run the installer and follow the installation instructions. During installation, set a password for the default postgres user.

Start PostgreSQL: After installation, PostgreSQL should start automatically as a Windows service. You can check the service status in the Windows Services panel.

Access PostgreSQL: You can use a graphical tool like pgAdmin or the command-line tool psql to interact with PostgreSQL. Linux: Install PostgreSQL on Linux: Use your distribution's package manager to install PostgreSQL. For example, on Ubuntu:

   sudo apt-get update
   sudo apt-get install postgresql postgresql-contrib

During installation, set a password for the default postgres user.

Start PostgreSQL:

• On most Linux distributions, PostgreSQL starts automatically after installation.
• You can check the status using:

   sudo service postgresql status

Access PostgreSQL:

• Use the psql command-line tool to interact with PostgreSQL:

   psql -U postgres

Using Docker: Run PostgreSQL with Docker Compose:

   docker-compose up -d

Stop and Remove Containers

   docker-compose down

Installation

1. Clone the repository:

   [email protected]:2Bit-Synergy/stellarhr.git

2. Navigate to directory

   cd stellarhr

3. Execute ./runserver.sh:

   [!NOTE] For Unix System make sure ./runserver.sh is set to executable, in linux "chmod +x ./runserver.sh" For Windows make you already installed python(!https://www.python.org/downloads) .\runserver.sh

   ./runserver.sh

   Access the application at http://localhost:8000/ and log in with the superuser credentials.

Usage

For detailed usage instructions, refer to the User Manual included in the docs directory.