Lambert-01/rwanda-trade-analysis-system

# 🇷🇼 TradeScope - Rwanda Export Analysis Platform **🏆 NISR HACKATHON 2025 - Team Codabytes** A comprehensive full-stack web platform for analyzing Rwanda's trade data, built with modern technologies and AI integration for the National Institute of Statistics of Rwanda (NISR) Hackathon 2025. ## 📋 Project Overview ### 🚀 Our Solution A production-ready trade analysis platform that transforms **NISR's official Rwanda trade dataset** into actionable insights through: - **Advanced Data Processing**: Automated ETL pipeline for Excel data ingestion - **Machine Learning Integration**: Predictive analytics using Random Forest and XGBoost models - **Interactive Visualizations**: Real-time dashboards with Chart.js and Leaflet.js - **AI-Powered Insights**: Natural language processing with OpenRouter API integration - **Scalable Architecture**: Microservices design with MongoDB backend ## 🏗️ Technical Architecture ### Multi-Tier System Design ``` ┌─────────────────────────────────────────────────────────────────┐ │ 🌐 FRONTEND LAYER │ ├─────────────────────────────────────────────────────────────────┤ │ 📱 Presentation Layer (Port 8080) │ │ • Vanilla JavaScript ES6+ with modular architecture │ │ • Chart.js v4.4.0 for interactive data visualization │ │ • Leaflet.js v1.9.4 for geographic mapping │ │ • Bootstrap 5.3.0 for responsive UI components │ │ • Service Worker (PWA) for offline capabilities │ └─────────────────┬───────────────────────────────────────────────┘ │ HTTP/REST API ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 🚀 BACKEND LAYER │ ├─────────────────────────────────────────────────────────────────┤ │ ⚙️ API Gateway (Port 3000) │ │ • Express.js v4.18.2 server with CORS middleware │ │ • MongoDB v6.20.0 wit …