Prime-HR/Ghana_Payroll_HR_System

Ghana Hospital Management System - React + Vite + Supabase # 🇬🇭 Ghana Payroll & HR Management System A complete, production-grade Payroll and HR Management System built specifically for Ghanaian businesses. ## ✅ Features ### Core Modules - **Dashboard** — Real-time stats, charts, payroll trends - **Employee Management** — Full CRUD, export to Excel, multi-filter search - **Payroll Processing** — Auto-calculate PAYE, SSNIT, net pay for all employees - **Leave Management** — Apply, approve/reject annual, sick, maternity leave - **Overtime & Loans** — Record overtime, manage loan deductions - **Reports & Calculator** — GRA PAYE live calculator, SSNIT report, GRA tax report, bank payment list ### Ghana-Specific Features - ✅ GRA 2024 PAYE Tax Bands (accurate 6-band calculation) - ✅ SSNIT Tier 1 (13% employer + 5.5% employee) - ✅ SSNIT Tier 2 (5% employer to private pension) - ✅ Ghana Cedis (GHS) currency throughout - ✅ Ghana bank list (GCB, Ecobank, Stanbic, etc.) - ✅ Ghana regions list - ✅ Mobile Money (MTN Momo, AirtelTigo, Vodafone) - ✅ Permanent, Contract, Casual, Internship employee types - ✅ GRA PAYE monthly report PDF - ✅ SSNIT monthly schedule PDF - ✅ Bank payment list (Excel) - ✅ Individual payslip PDF per employee ## 🚀 Quick Start ### Requirements - Node.js 18+ installed - npm or yarn ### Steps ```bash # 1. Open terminal and go to this folder cd ghana-payroll # 2. Install dependencies npm install # 3. Start the development server npm run dev # 4. Open your browser at: # localhost ``` ### Build for Production ```bash npm run build # Files will be in the /dist folder — deploy to any web host ``` ## 📁 Project Structure ``` ghana-payroll/ ├── src/ │ ├── components/ │ │ ├── Dashboard.jsx # Overview stats & charts │ │ ├── Employees.jsx # Employee management │ │ ├── PayrollProcessing.jsx # Run & view payroll │ │ ├── LeaveManagement.jsx # Leave requests │ │ ├── OvertimeLoans.jsx # Overtime & loans │ │ └── Reports.jsx # Reports & calculator │ …