GU-CS-Final-Year-Project/Quick_Fuel_Loan_Applicaton_Backend

This repository contains the backend source code and RESTful APIs powering the QuickFuel Loan App. It serves as the core operational engine responsible for the automated verification, processing, and instant disbursement of micro-fuel loans (UGX 3,000 to UGX 10,000) for boda-boda riders within the Pece-Laroo division of Gulu, Uganda. # F-Loan Management System A comprehensive loan and fleet management system for motorcycle riders in Uganda, built with Laravel 11 and Livewire. ## Overview F-Loan is a full-featured platform for managing rider loans, bike assignments, fuel station partnerships, and mobile money payments. It includes role-based access control, QR code fuel vouchers, and integration with ioTec Pay for MTN and Airtel mobile money transactions. ## Key Features ### 🏍️ Rider Management - Complete rider profiles with photos, licenses, and documents - Credit limit tracking and balance management - Stage/location assignments - Bike assignment tracking - Guarantor linking ### 💰 Loan Management - Multi-stage loan workflow: Pending → Approved → Disbursed → Fuelled → Active → Paid - QR code generation for fuel station vouchers - Automatic interest calculation - Loan type templates with default rates - Fuel station linking - Mobile money disbursement via ioTec Pay ### 💳 Payment Processing - Manual payment recording - Mobile money collection (MTN & Airtel) via ioTec Pay - Automatic loan balance updates - Payment method tracking - Transaction reference generation ### ⛽ Fuel Station Management - Station profiles with GPS coordinates - Primary contact assignment (manager-level users only) - Commission rate tracking - Fuel pricing management - Station staff registration ### 🚗 Fleet Management - Bike inventory with make/model/year/color - Assignment tracking (active/returned/revoked) - Maintenance status - Assignment history ### 👥 User & Access Control - **System Users** — admin and back-office staff profiles - **Riders** — rider profiles with auth access - **Station Staff** — fuel station employee profiles - **User Access** — unified login management linking profiles to auth credentials - **Roles & Permissions** — granular permission system with 35+ permissions across 6 categories ### 📊 Dashboard & Analytics - Live ioTec Pay wallet balance - Loan disbursement chart (bar chart, 30 days) - P …