Ismaventures/kwali-revenue-portal

# Kwali Smart Revenue Platform (KSRP) A unified revenue collection and compliance platform for **Kwali Area Council, FCT Abuja**. It digitises how the council registers taxpayers, issues bills and daily tickets, collects levies, verifies payments, and enforces compliance — across every revenue stream the council controls. Built for the realities of Nigerian local-government revenue: ward-based records, NIN/CAC/RC identity references, tenement rates and property assessment, market daily tolls, keke/okada daily tickets, QR-coded receipts and ID cards, field marshals, officer approval queues, and a no-login self-service payment channel for traders with basic phones. --- ## What the platform does ### Revenue streams - **Properties** — annual tenement rates, property assessment, GPS-tagged addresses, arrears and demand notices. - **Businesses** — annual business premises permits for shops, offices, hospitality, POS agents, and CAC/LLC-registered companies. - **Markets** — registered market traders and stalls, daily market tolls, stall rent, sanitation levy. - **Transport** — keke (tricycle), okada (motorcycle) and commercial vehicles, daily ₦100/₦500 route tickets with QR stickers. - **Sanitation / POS / Hospitality** — subscriptions, operator permits and establishment fees. ### Who uses it (roles) | Role | What they see | |------|---------------| | **Taxpayer** | Their own registrations, bills, payments, receipts, and digital ID cards. | | **Marshal** | Field operations — onboard traders/operators, record collections, verify tickets/QR, log enforcement incidents, reprint issued ID cards. | | **Revenue Officer** | Approval queue for self-registered taxpayers, collections ledger, business/property registries, record payments. | | **Chairman / Executive** | Read-only executive dashboard — revenue performance, ward comparison, compliance, markets, transport, enforcement, reports. | | **Admin / Super Admin** | Everything, plus staff account creation, revenue records, a …