jerrok4-arch/FrudGard_NG

Fraud detection app for financial systems in Nigeria # 🛡️ FraudGuard NG **Real-time Fraud Detection for Nigerian Financial Systems** --- ## 🎯 What is FraudGuard NG? FraudGuard NG is a production-ready, open-source fraud detection system designed specifically for **Nigerian banks and fintechs**. It detects malicious login attempts, VPN/proxy usage, impossible travel, and behavioral anomalies in real-time. Built for the Nigerian financial ecosystem — integrated with **NIBSS**, **CBN reporting**, and **Nigerian mobile carriers** (MTN, Airtel, Glo, 9mobile). ## 🏗️ Architecture ``` ┌─────────────┐ ┌──────────────┐ ┌─────────────┐ │ Go Engine │────▶│ Kafka │────▶│ ML Server │ │ (Rule-based) │ │ login.events │ │(ML Models) │ └─────────────┘ └──────────────┘ └─────────────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ Redis │ │ ClickHouse │ │ (Cache) │ │(Analytics) │ └─────────────┘ └─────────────┘ ``` | Component | Tech | Purpose | |-----------|------|---------| | **Fraud Engine** | Go 1.22 | Real-time rule-based detection (P99 < 50ms) | | **ML Inference** | Python 3.11 + XGBoost | Deep pattern detection & anomaly scoring | | **Event Bus** | Apache Kafka | Async communication between services | | **Cache** | Redis | Session store, rate limiting, feature cache | | **Analytics** | ClickHouse | OLAP fraud analytics & dashboards | | **Monitoring** | Prometheus + Grafana | Metrics, alerts, observability | ## 🚀 Quick Start ### Prerequisites - Docker & Docker Compose - Git - MaxMind GeoIP2 database (free registration) - (Optional) IPQualityScore & AbuseIPDB API keys ### 1. Clone & Setup ```bash git clone github.com cd fraudguard-ng # Copy environment template cp .env.example .env # Edit .env with your API keys ``` ### 2. Download MaxMind Database ```b …