# MicroLoanFin - Microfinance Loan Management System

Starter PHP + MySQL project with role-based access and individual dashboards for:
- admin
- branch
- collection_agent

## Features
- Secure login with password hashing (`password_hash` / `password_verify`)
- Role-based redirect after login
- Admin dashboard with portfolio-level KPIs
- Branch dashboard filtered by branch
- Collection agent dashboard filtered by assigned loans
- SQL schema and seed script included

## Folder Structure
- `config/` app + DB configuration
- `includes/` shared DB/auth/layout helpers
- `dashboard/` role-specific pages
- `assets/css/` styles
- `sql/` database schema
- `scripts/` seed scripts

## Setup (XAMPP)
1. Start Apache and MySQL in XAMPP.
2. Create/import DB schema:
   - Open `http://localhost/phpmyadmin`
   - Import `sql/schema.sql`
3. Check DB config in `config/app.php`:
   - database: `microloanfin`
   - username: `root`
   - password: `` (empty by default on local XAMPP)
4. Seed demo data:
   - CLI: `php scripts/seed.php`
5. Open app:
   - `http://localhost/microloanfin`

## Demo Login
- Admin: `admin` / `admin123`
- Branch: `branch01` / `branch123`
- Collection Agent: `agent01` / `agent123`

## Notes
- This is a clean starter scaffold intended for extension (loan approval flows, repayment posting UI, reports, audit logs, etc.).