EPMS
An academic full-stack web app for managing employee payroll: add staff, assign departments, calculate gross-to-net salaries, and generate daily, weekly, and monthly reports.
This is a web application called the Employee Payroll Management System, built for a fictional transportation and logistics company called PayMaster Ltd based in Rwanda. The README describes it as an academic project. Its purpose is to replace a manual payroll process with a digital one, handling employee records, department organization, salary calculations, and report generation.
The system is structured as a standard web application with a React frontend and a Node.js backend connected to a MongoDB or MySQL database. HR staff log in, add employees with details like name, address, position, and hire date, assign them to departments, and enter payroll information. The system then calculates gross salary, applies deductions, and produces a net salary figure. Reports can be generated at daily, weekly, and monthly intervals across employees, departments, and payroll totals.
The four main sections are employee management, department management, salary management, and a reporting area. Access is controlled through a login system with password encryption. The project also lists a database structure showing the fields stored for users, employees, departments, and salary records.
The README notes several features planned for future development, including emailing salary slips, generating PDF reports, a mobile app version, cloud deployment, and a more detailed analytics dashboard. Installation involves cloning the repository, running separate setup commands for the backend and frontend folders, and starting both servers locally. The project was built as a learning exercise and is offered for academic and educational use.
Where it fits
- Replace a manual payroll spreadsheet with a web dashboard that automatically calculates net salaries after deductions.
- Generate department-level or company-wide payroll reports filtered by day, week, or month from a single reporting screen.
- Study this codebase as a reference implementation of a full-stack React and Node.js CRUD app with user authentication and a relational data model.