GitHunt
KI

kishore2006-ai/payroll-module-2

Module 2 of a Payroll Management System implementing Statutory & Compliance Configuration using MERN Stack (PF, ESI, Professional Tax).

Payroll Management System โ€“ Module 2

Statutory & Compliance Configuration

๐Ÿ“Œ Project Overview

This project implements Module 2 of a Payroll Management System inspired by Zoho Payroll.
The module focuses on configuring statutory rules required for payroll processing such as
Provident Fund (PF), Employee State Insurance (ESI), Professional Tax, and Tax Slabs.

The system allows administrators to dynamically configure compliance rules without
changing source code, making the application scalable and future-ready.


๐ŸŽฏ Objectives

  • Configure statutory payroll rules
  • Store compliance data securely
  • Provide dynamic rule management
  • Support future payroll automation

๐Ÿ› ๏ธ Technologies Used

Frontend

  • React (Vite)
  • JavaScript (ES6+)
  • Tailwind CSS

Backend

  • Node.js
  • Express.js

Database

  • MongoDB (Mongoose)

โš™๏ธ Features

  • Country-based statutory configuration
  • PF, ESI, and Professional Tax setup
  • Dynamic data storage using MongoDB
  • REST API integration
  • Scalable payroll rule engine

๐Ÿ’ก Innovation

Traditional payroll systems use hard-coded statutory values.
This module introduces a dynamic compliance engine, where statutory rules can be
updated anytime through the admin interface without code changes.


๐Ÿ“ Project Structure

backend/
 โ”œโ”€โ”€ config/
 โ”‚   โ””โ”€โ”€ db.js
 โ”œโ”€โ”€ models/
 โ”‚   โ””โ”€โ”€ StatutoryRule.js
 โ”œโ”€โ”€ routes/
 โ”‚   โ””โ”€โ”€ statutoryRoutes.js
 โ””โ”€โ”€ server.js

frontend/
 โ”œโ”€โ”€ src/
 โ”‚   โ”œโ”€โ”€ pages/
 โ”‚   โ”‚   โ””โ”€โ”€ StatutoryConfig.jsx
 โ”‚   โ”œโ”€โ”€ services/
 โ”‚   โ”‚   โ””โ”€โ”€ api.js
 โ”‚   โ”œโ”€โ”€ App.jsx
 โ”‚   โ””โ”€โ”€ main.jsx