HRMS
A comprehensive HRMS platform for managing employees, attendance, payroll, recruitment, and organizational workflows with real-time updates.
Key Challenges
- Implementing AES-256-GCM encryption for sensitive employee data including salaries, bank details, and bonus information with secure key derivation using PBKDF2
- Building a complex payroll calculation system that handles working days, holidays, leave deductions, salary adjustments, and supports multiple employment types (Full-Time, Part-Time, Intern, Freelance)
- Designing a real-time notification system using Socket.IO for instant updates on leave approvals, attendance corrections, and payroll generation across multiple user roles
- Creating a flexible leave management system with multi-level approval workflows, retroactive leave auto-approval, and dynamic leave balance tracking with minimum balance limits
- Implementing role-based access control (RBAC) with hierarchical permissions for Admin, HR, Manager, and Employee roles with protected routes and API middleware
Key Learnings
- Mastered field-level encryption strategies for protecting sensitive data at rest while maintaining query capabilities through MongoDB aggregation pipelines
- Gained expertise in building cron job schedulers for automated tasks like attendance marking, leave expiration, and holiday management using node-cron
- Learned to implement Google OAuth 2.0 authentication with Passport.js alongside traditional JWT-based authentication for flexible login options
- Developed skills in building interactive org chart visualizations with React Flow for displaying organizational hierarchy and reporting structures
- Understood the importance of proper date handling across timezones using Luxon and Moment.js for accurate attendance and payroll calculations
Overview
HRMS is a comprehensive Human Resource Management System designed to streamline HR operations for organizations. Built with a modern tech stack featuring React and Express, it provides a complete solution for managing employees, attendance, payroll, recruitment, and organizational workflows. The platform features role-based dashboards with real-time updates powered by Socket.IO.
Key Features
Employee Management
Complete employee profiles with document storage, performance evaluations, designation history tracking, and Google Drive integration for secure file management.
Real-time Attendance Tracking
Automated attendance system with clock-in/out functionality, break management, attendance correction requests, and comprehensive reporting with cron-based automation.
Payroll Management
Automated payroll processing with configurable salary adjustments, bonus tracking, LOP calculations, and PDF report generation using PDFKit.
Leave Management
Comprehensive leave system with multi-level approval workflows, multiple leave types, retroactive applications, and dynamic balance tracking.
Recruitment Pipeline
Job posting management, applicant tracking system, public job application portal, and candidate evaluation workflow for streamlined hiring.
Interactive Org Chart
Visual organizational hierarchy using React Flow for displaying reporting structures, department relationships, and team compositions.
Real-time Notifications
Socket.IO powered instant notifications for leave approvals, attendance updates, payroll generation, and system alerts with persistent storage.
Technical Implementation
The application follows a clean architecture pattern with separate layers for controllers, services, models, and validations. The backend implements comprehensive input validation using Joi schemas, while the frontend uses Zod with React Hook Form for form validation.
- State Management: Redux Toolkit with RTK Query for efficient server state caching and automatic refetching
- Authentication: Dual authentication system supporting JWT tokens and Google OAuth 2.0 via Passport.js
- Data Security: Field-level AES-256-GCM encryption with PBKDF2 key derivation for sensitive employee data
- UI Components: Radix UI primitives with Tailwind CSS for accessible, customizable component library
- Background Jobs: Node-cron scheduled tasks for attendance marking, leave expiration, and holiday management
- Org Visualization: React Flow integration for interactive organizational chart with drag-and-drop capabilities
- Real-time Updates: Socket.IO for bidirectional communication enabling instant notifications across all connected clients