Galle, LK--:--5/6 sites live
Enterprise

Intocare EPF & Workforce Roster Management System

Next.js App Router operational platform managing EPF statutory contributions, shift rosters, employee groups, and monthly payroll.

Read the deep dive Private repository
Intocare EPF & Workforce Roster Management System

Overview

Intocare is a mission-critical human resource and operational management platform built to streamline employee roster planning and Employee Provident Fund (EPF) statutory contribution compliance. Designed for multi-shift enterprises, the platform enables operations managers to schedule staff monthly rosters, track work hours, manage department groups, and compute legal statutory deductions with automated report seeding.

Design decisions

The choices that shaped the system, and why.

  1. 1

    Deterministic EPF/ETF Statutory Rules Engine

    Hardcoded exact Sri Lankan statutory contribution formulas (Employee 8%, Employer 12% EPF, Employer 3% ETF) to prevent rounding errors across large workforce rosters.

  2. 2

    Interactive Calendar Roster Matrix

    Built a grid matrix that allows dragging and toggling day/night shifts across hundreds of staff members with real-time coverage gap warnings.

Architecture

Next.js API Routing Engine

Full RESTful API endpoints (`/api/months/[id]/roster`, `/api/workspace`, `/api/groups`) powering CRUD operations.

Roster Matrix State Machine

Interactive monthly calendar grid for assigning employee shifts, handling leave, and flagging coverage gaps.

EPF Statutory Calculation Subsystem

Deterministic computation of employee (8%) and employer (12%) provident fund contributions.

Database Seeding & Workspace Reset

Administrative endpoints for populating demo workspaces and backing up historical rosters.

DevOps & deployment

Deployed on Vercel or as a containerized Next.js service on AWS ECS / GCP Cloud Run.

Features

  • Interactive monthly roster scheduler with shift status indicators.
  • Automated EPF/ETF statutory calculation tables ready for government filing.
  • Employee grouping by department, facility location, and seniority tier.
  • One-click workspace database seeding and reset utilities.

Screenshots

Fig 1 · Intocare roster and EPF dashboard

Related writing