go-faustino / sentrifugo

Sentrifugo is a FREE and powerful Human Resource Management System(HRMS) that can be easily configured to meet your organizational needs.

About this fork

This is a fork of Sentrifugo v3.2 with the following changes:

• Allow timesheets for future dates
• Zipped patches folder (if upgrading from previous versions, unzip the folder before upgrading)
• Several custom field labels and validations
• Disabled some non-essential menu items and tabs
• More restrictive access control rules for non-management roles
• Always send emails from do not reply address, instead of the super admin address
• Save install date as application constant for validations
• Employee timesheet 'All' option always shows complete employee list for management group (note: this allows management group members to approve their own timesheets, make sure that's acceptable in your case)
• Management can see all projects
• Always use date of joining, instead of employee creation date, for validations
• Corrected a bug, where tasks with less than one hour per day would not appear on weekly timesheet view (for both employee and manager)
• New on call module, to register on call shifts
• Validate that leave and on call requests are contained within a single month, to simplify counting in billing report
• Allow half day leave requests for multiple days
• Configurable project types
• Alert user when submitting hours for default overtime task
• Allow sending timesheet missing email every day
• Consider current week timesheet missing starting Friday
• Don't send timesheet missing emails for employees with work status 'Deputation'
• Send all timesheet missing employees to management group
• Configurable work schedules (working hours per day)
• Billing report in Analytics
• Erase week button made available for rejected and enabled days
• Allow special characters and ensure correct encoding on all pages and emails
• Remove double slashes from time management URLs to avoid problems with servers that rewrite them out (that's you IIS...)
• Corrected a bug which didn't allow approving / rejecting / enabling timesheet for the first week of a year that didn't start on a Sunday (2017, you kept this hidden for a whole year, thanks)
• Corrected leave detection for timesheet cronjob

Docker

This fork includes a Dockerfile, to run Sentrifugo in a container. Visit my Docker Hub repository at https://hub.docker.com/r/gofaustino/sentrifugo

This Docker image needs an instance of MySQL or MariaDB available. The Apache server is available on port 80 inside the container. The Sentrifugo application folder is located at var/www/html.

To get your container running, use the following run command as a guideline. If you don't need persistence for your settings / uploads / logs leave out the -v parameters:

docker run -d --name sentrifugo -p 80:80 -v /local_path_for_persistent_data:/var/www/html/public -v /local_path_for_logs:/var/www/html/logs --link mariadb:mysql gofaustino/sentrifugo

Original README.MD

Sentrifugo

Sentrifugo is a free and powerful new-age Human Resource Management System that can be easily configured to adapt to your organizational processes.

Installing Sentrifugo Version 3.1.1

Sentrifugo comes with its own web-installer to help guide you through the installation process.

Note: You can also find these steps in http://www.sentrifugo.com/home/installationguide

Table of Contents:

1. What server Sentrifugo works on?

2. Windows installation Guide

3. Linux installation Guide

4. MAC installation Guide

5. Upgrading your application code with patches

   1. What server does Sentrifugo work on? ======================================= Sentrifugo works only on Apache Server

   2. Windows Installation Guide ============================= AMP stack for Windows

      • The recommended AMP stack for Windows is XAMPP (Download the installer from basic package)
      • The system installer for XAMPP will guide you through the installation process

      Copying files

      • Move Sentrifugo zip file into the document root of Apache HTTP server.
      • If you used XAMPP for windows, document root is \htdocs\
      • For example: C:\xampp\htdocs\

      Extracting

      • Extract the Sentrifugo zip file in the document root of Apache HTTP server

      Web Installer

      • XAMPP users; the AMP stack for Windows needs to be started manually.
      • Using a JavaScript enabled browser go to http:///sentrifugo/; Where is localhost if it is installed in the machine you are currently working on, IP address if it is remotely hosted

      Pre-requisites

      The system requirements for installing Sentrifugo are described below. Make sure your system meets these requirements.

      a. PHP 5.3 or later You can download PHP 5.3 or later by visiting http://windows.php.net/download/

      b. PDO MySQL (for MySQL connection) To install Sentrifugo on windows, you need to enable the PDO and PDO_MYSQL extensions in your php.ini file. You can add the following lines in your php.ini file:

       1. extension=php_pdo.dll
       2. extension=php_pdo_mysql.dll
      

      c. Rewrite module (for working of MVC architecture) To activate the module, the following line in httpd.conf needs to be uncommented:

       1. LoadModule rewrite_module modules/mod_rewrite.so
       To see whether it is already active, try putting a .htaccess file into a web directory containing the line
      
       2. RewriteEngine on
       If this works without throwing a 500 internal server error, and the .htaccess file gets parsed, URL rewriting works.
      
       You also need to make sure that in your httpd.conf, AllowOverrides is enabled:
      
       3. AllowOverride all
       This is important as many httpd.conf ship by default with allowoverride none
      

      d. GD library (for images) You can add the following lines in your php.ini file:

       1. extension = php_gd2.dll
      

      e. Open SSL (For SSL and TSL Protocols) Download the installer for OpenSSL 1.0.1e from http://www.openssl.org/related/binaries.html

       If OpenSSL is already installed in your system, to enable this extension in your php.ini file, you can add the following line in your php.ini
       file:
      
       1. extension=php_openssl.dll
      

   3. Linux Installation Guide =========================== AMP stack for Linux

      • The recommended AMP stack for Linux is XAMPP Linux 1.6 (Download the complete stack and not the upgrades)
      • The system installer for XAMPP in the XAMPP site will guide you through the installation process
      • Start the stack manually every time you reboot.
      • Change the ownership of Sentrifugo files (Ex: /opt/xampp/htdocs/sentrifugo/ $ chown -R nobody.nobody)

      Copying files

      • Move Sentrifugo zip file into the document root of Apache HTTP server.
      • If you used XAMPP for windows, document root is \htdocs\
      • For example: C:\xampp\htdocs\

      Extracting

      • Extract the Sentrifugo zip file in the document root of Apache HTTP server

      Web Installer

      • XAMPP users; the AMP stack for Linux needs to be started manually.
      • Using a JavaScript enabled browser go to http:///sentrifugo/; Where is localhost if it is installed in the machine you are currently working on, IP address if it is remotely hosted

      Pre-requisites

      The system requirements for installing Sentrifugo are described below. Make sure your system meets these requirements.

      a. PHP 5.3 or later To install PHP 5.3 on Linux, please follow the below links:

       For Ubuntu: https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mysql-php-lamp-stack-on-ubuntu
       For Redhat and CentOS: http://www.thetechnicalstuff.com/install-php5-3-in-centos-and-redhat/
      

      b. PDO MySQL (for MySQL connection) To install Sentrifugo on Linux, you can compile php with --with-pdo-mysql in your php.ini, and add the following lines:

       1. extension=pdo.so
       2. extension=pdo_mysql.so
      

      c. Rewrite module (for working of MVC architecture) activate mod_rewrite in linux, open the terminal and add the below line:

       1. sudo a2enmod rewrite
       
       You also need to make sure that in your httpd.conf, AllowOverride is enabled:
       2. AllowOverride All
      

      d. GD library (for images) To install GD library in Linux, open the terminal and add the below lines:

       1. #apt-get install php5-gd
      

      e. Open SSL (For SSL and TSL Protocols) Download the OpenSSL 1.0.1c tarball archive from the OpenSSL web site at http://www.openssl.org/source/

   4. MAC Installation Guide ========================= AMP stack for MAC

      • The recommended AMP stack for MAC is MAMP
      • The system installer for XAMPP will guide you through the installation process
      • If MAMP is previously installed, the installer will rename the MAMP folder to MAMP_current_date.
      • An existing folder will be moved to your new /Applications/MAMP folder.
      • Your /Applications/MAMP_current_date folder can now be deleted. You can keep it if you wish to fall back to your original setup.

      Copying files

      • Move Sentrifugo zip file into the document root of Apache HTTP server.
      • If you used XAMPP for windows, document root is \htdocs\
      • For example: C:\xampp\htdocs\

      Extracting

      • Extract the Sentrifugo zip file in the document root of Apache HTTP server

      Web Installer

      • MAMP users; the AMP stack for MAC needs to be started manually.
      • Using a JavaScript enabled browser go to http:///sentrifugo/; Where is localhost if it is installed in the machine you are currently working on, IP address if it is remotely hosted

      Pre-requisites

      The system requirements for installing Sentrifugo are described below. Make sure your system meets these requirements.

      a. PHP 5.3 or later You can download PHP 5.3 or later by visiting http://php.net/downloads.php

      b. PDO MySQL (for MySQL connection) To install Sentrifugo on MAC, you need to enable the PDO and PDO_MYSQL extensions in your php.ini file. You can add the following lines in your php.ini file:

       1. extension=php_mysqli.so
       2. extension=php_pdo_mysql.so
      

      c. Rewrite module (for working of MVC architecture) To activate mod_rewrite module in MAC, add the below line to httpd.conf file

       1. LoadModule rewrite_module libexec/apache2/mod_rewrite.so
       2. LoadModule php5_module libexec/apache2/libphp5.so
       
       Also, make sure that AllowOverride is set to All within the <Directory "/Library/WebServer/Documents"> section.
      

      d. GD library (for images) You can add the following lines in your php.ini file:

       1. extension = gd.so
      

      e. Open SSL (For SSL and TSL Protocols) Download the installer for OpenSSL from http://www.openssl.org/source/

   5. Upgrading your application code with patches =====================================================

   MANUAL

   1. Download Sentrifugo.zip
   2. Extract the zip file
   3. Check for patches folder in the extracted Sentrifugo folder
   4. Check your application code version in index.php Ex: defined('CODEVERSION')|| define('CODEVERSION', '3.1');
   5. If your code version is not 3.1, take patches till patches 3.1.1
      Eg: If CODEVERSION is 3.0, take patches from 3.0 to patches 3.1.1
   6. If your code version is 3.1, consider patches_3.1.1 folder

   AUTOMATION

   1. Login into your application as 'Super Admin'
   2. Click on Profile pop-up on the right hand-side
   3. Select Upgrade application
   4. Current application version will be displayed. Choose version to upgrade as 3.1.1
   5. On clicking 'Upgrade' button, patches_3.1.1 will be downloaded

   To install patch 3.1.1

   1. Extract the patches_3.1.1 .zip file
   2. Copy and replace the files to your current application folder
   3. Execute the queries in sql/queries.txt file, if any (commands are mentioned at the bottom of this document)

   NOTE: Once you login to the application, update any role in Human Resources -> User Management -> Roles and Privileges page.

   Refer UPGRADE document for a detailed description of the installation process of patches.