About

Time clock software that runs on a tablet, meant for employees to walk up to and type in their employee ID number to punch in or out. Managers can then log into the admin area and see total hours between dates.

Client: is a web app that you type in your employee ID number. Recommended to place on a tablet and mount on the wall. Also contains the admin area where management can view hours worked.

Server: is a server that sends a Rest API and receives data to communicate with MongoDB.

Local Development Setup

Install NodeJS and MongoDB [Windows] Run win_dev.bat. [MacOS] Open Terminal.app in this directory, type chmod +x ./mac_dev.sh then ./mac_dev.sh.

Setup Client

Client should be hosted with HTTPS. This will allow you to use PWA to install the app on a tablet or PC. You should use a Chromium based web browser to install it on a PC. For Android devices, visit the web app, tap the three-dot overflow menu in the top-right corner and then select Add to home screen. For iOS devices, open Safari, browse to the web app, tap the Share button, scroll down and tap Add to Home Screen.

Setup Server for Windows

1. Install IISNode and NodeJS on the server.
2. Run %programfiles%/iisnode/setupsamples.bat.
3. Place timeclock folder (located in server directory) into the %programfiles%/iisnode/www directory.
4. Navigate to the message directory, right click on WINDOWS INSTALL SERVICE.bat and select Run as administrator.
5. Check Services for node timeclock server to ensure it's running.

Setup Server for Linux

1. Install node - https://nodejs.org/en/download/package-manager/
2. Open terminal, type commands:

npm install node-linux
npm install pm2 -g

3. Place timeclock folder (located in server directory) into a directory.
4. Navigate to the timeclock directory, type commands:

node install-linux-service.js
sudo service timeclock start
sudo chkconfig timeclock on
pm2 start main.js
pm2 startup
pm2 save