Skip to main content

Minimal human resource management app for Django

Project description

small-small-hr

Build Status

small-small-hr is a really really small and light-weight Django application that helps you (yes you!) to manage certain aspects of HR (human resource) in your small or large business/organization/whatever.

Installation

pip install small-small-hr

Features

At this time, small-small-hr supports the following:

Employee records

You can keep track of all your employee's details. This is achieved through a custom StaffProfile model attached to your User model via a one-to-one relationship. Some of the available fields on this model are:

  • first name
  • last name
  • gender
  • birth day
  • photo
  • number of allowed leave days per year
  • whether or not overtime is allowed for the employee
  • data - a JSON field that allows you to store any extra information

Employee Documents

You can keep track of an unlimited number of employee documents (think employment contracts, performance reviews, scans of identification documents, etc). This is achieved by an StaffDocument model that has a one-to-many relationship with the StaffProfile model (above).

The fields on this model are

  • staffprofile_id
  • name of document
  • description of document
  • dcoument file

Leave management

All employees can log in and make a request for leave. To achieve this, there exists a LeaveRequest model with these fields:

  • staffprofile_id
  • request date
  • start date
  • end date
  • reason for leave
  • status (pending approval/approved/rejected)
  • comments (made by the admin, e.g. reasons for refusal)

Once a LeaveRequest object is created, an administrator should review it and approve/reject it.

Overtime hours tracking

Employees who are allowed overtime can log in and record overtime hours. This is done by an OvertimeHour model with these fields:

  • staffprofile_id
  • date
  • start time
  • end time
  • reason for overtime
  • status (pending approval/approved/rejected)
  • comments (made by the admin, e.g. reasons for refusal)

Admins can download overtime hours reports for a particular period.

Contribution

All contributions are welcome.

To set up the project:

  1. Clone this repo
  2. pipenv sync --dev
  3. pre-commit install

Testing

pip install -U tox

tox

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for small-small-hr, version 0.1.9
Filename, size File type Python version Upload date Hashes
Filename, size small_small_hr-0.1.9-py3-none-any.whl (21.4 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size small-small-hr-0.1.9.tar.gz (18.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page