SegunAdewola/remittrack

Remittance intelligence API for African currency corridors # Remittrack - Remittance Intelligence API > A comprehensive exchange rate comparison and intelligence platform serving both consumers and businesses in the African remittance market. ## 🚀 Overview Remittrack addresses the gap in African-focused remittance comparison services by providing real-time rate aggregation from 20+ Money Transfer Providers (MTPs) with intelligent alerting and competitive analysis capabilities. ## 🏗️ Architecture - **Backend**: Java Spring Boot 3.2 with Maven - **Database**: PostgreSQL with TimescaleDB extension for time-series optimization - **Caching**: Redis for high-performance API responses - **Validation**: Professional libraries (libphonenumber, Apache Commons) - **Documentation**: OpenAPI 3.0 with Swagger UI ## 🎯 Key Features ### B2C Features - Real-time rate comparison across multiple MTPs - Flexible filtering by delivery method, payment type, user tier - Event-driven alert system with multi-channel notifications - Accurate fee calculations for both additive and subtractive fee structures ### B2B Features - Competitive analysis API for fintech clients - Historical rate trends and volatility analytics - Arbitrage opportunity detection - API key-based authentication with tiered rate limiting ## 📊 Technical Highlights - **Flexible Data Model**: JSON attributes support dynamic MTP onboarding - **Time-Series Optimization**: TimescaleDB for efficient rate data storage - **Event-Driven Alerts**: Real-time notifications triggered by rate updates - **Professional Validation**: Industry-standard phone/email handling - **Enterprise Patterns**: Circuit breakers, rate limiting, comprehensive monitoring ## 🛠️ Technology Stack **Backend Framework**: Java 17, Spring Boot 3.2, Spring Data JPA **Database**: PostgreSQL 15, TimescaleDB, Redis **Build Tool**: Maven 3.9 **Validation**: libphonenumber, Apache Commons Validator **Documentation**: SpringDoc OpenAPI 3.0 **Testing**: JUnit 5, TestContainers **Deployment**: Railway, Docker ## 🚀 Ge …