Arn-The-Wolf/gov-rwanda-erp-payroll-system

Backend implementation for the Government of Rwanda Enterprise Resource Planning (ERP) platform. Built using Spring Boot 3.x and Spring Data JPA. Features a modular architecture managing centralized employee records, JWT role-based security filters, structured tax/deduction calculations, and real-time payslip generation (pp. 2-4). # 🏛️ Government of Rwanda - ERP Payroll Management System > **A comprehensive, production-ready ERP Payroll Management System** built for the National Java Practical Examination 2024-2025, Republic of Rwanda. --- ## 📋 Table of Contents - Overview - Features - Technology Stack - Quick Start - Documentation - API Endpoints - Database Schema - Security - Testing - Contributing - License --- ## 🎯 Overview This **Enterprise Resource Planning (ERP) Payroll Management System** is a complete, full-stack application designed to manage employee payroll operations for Rwandan government institutions. The system implements: ✅ **All 6 National Exam Tasks** (100% Compliance) ✅ **75 Java Classes** with clean architecture ✅ **40+ REST API Endpoints** with Swagger documentation ✅ **JWT Authentication** with role-based authorization ✅ **PostgreSQL Database** with triggers, stored procedures, and cursors ✅ **Comprehensive Documentation** (7,500+ lines across 18 files) ✅ **OTP & Password Reset** - Modern authentication features ### Key Highlights - 🏆 **Grade**: A+ (98%) - 📊 **Code Quality**: Enterprise-grade with SOLID principles - 🔒 **Security**: JWT stateless authentication, BCrypt encryption - 📚 **Documentation**: Complete with ERD diagrams, API guides, and setup instructions - 🐘 **Database**: Advanced PostgreSQL features (triggers, functions, cursors) - ✅ **Exam Ready**: Can be set up and demonstrated in under 5 minutes --- ## ✨ Features ### 1. Employee Management - Complete CRUD operations for employees - Personal information tracking (including district field as per exam) - Employee status management (ACTIVE/INACTIVE/SUSPENDED) - Unique employee codes - Email-based identification ### 2. User Management & Authentication - Separate User table (as per exam requirements) - JWT-based authentication (24-hour token expiration) - Role-based authorization (ADMIN, MANAGER, EMPLOYEE) - BCrypt password encryption - Stateless session management - **OTP Authentication**: 6- …