kaksv/BOU-Sentinel-v1.0.1

"BOU Sentinel is an AI-powered platform that blocks consumer fraud at the transaction level while giving the Bank of Uganda a live, unified dashboard of the entire national payment system. # 🛡️ BOU Sentinel **Real-Time Fraud Detection & Regulatory Oversight Platform for the Bank of Uganda** A dual-layered financial platform that combines an AI-powered fraud detection engine (micro-layer) with a real-time regulatory oversight dashboard (macro-layer). Built for the Bank of Uganda Hackathon. --- ## 🔍 What It Does ### Micro-Layer: Real-Time AI Fraud Detection - **Incoming transactions** are scored by an Isolation Forest anomaly detection model - **Risk scores** (0.0 – 1.0) are assigned in milliseconds - **Fraud flags** trigger real-time alerts on the dashboard - **Live WebSocket streaming** pushes scored transactions to all connected dashboards instantly ### Macro-Layer: Regulatory Oversight Dashboard - **Transaction Volume vs Fraud Volume** chart (Recharts) - **Live Transaction Feed** with color-coded risk indicators - **AI Risk Score Gauge** with animated needle - **Fraud Activity Heatmap** showing concentration of risk - **System Status Bar** showing backend health (WebSocket, Model) ### Institutional Compliance Monitoring - **Sector Summary** with KPI cards: total institutions, compliance rate, non-compliance rate, avg risk score - **Compliance Breakdown Pie Chart**: compliant / warning / under_review / non_compliant / suspended - **Tier Breakdown Bar Chart**: compliance % by regulatory tier (Tier I–IV, Forex Bureaus, Money Remitters, etc.) - **Institution Registry**: searchable, filterable table of all BOU-regulated entities - **At-Risk Institutions view**: prioritized list of non-compliant / warning / under-review entities - **Institution Detail Panel**: full compliance profile with risk flags, regulatory thresholds, AML/CFT scores, and compliance checklist - **Real-time Metrics Refresh**: simulate live BOU data pulls with one click --- ## 🏗️ Architecture ``` ┌──────────────────────────────────────────────────────────────────┐ │ BOU Sentinel │ ├──────────────────────────────────────────── …