Black-opps/mpesa-analytics-api

FastAPI-based analytics platform for MPesa transaction data with Docker MPesa Analytics API A production-ready FastAPI service for transforming MPesa transaction data into actionable business intelligence. --- ## 👋 **Overview** The **MPesa Analytics API** is a secure, scalable, and feature-rich backend solution built with **FastAPI**. It goes beyond simple transaction logging, providing a robust platform for businesses to gain deep insights from their financial data. With built-in role-based access control, it's perfect for both individual users and enterprise-level management. This API serves as the powerful engine for a modern fintech dashboard, enabling data-driven decisions through comprehensive analytics endpoints. ## ✨ **Key Features** * **🔐 Role-Based Access Control (RBAC)** * **Regular Users**: Experience complete data isolation, viewing and analyzing only their own transactions. * **Administrators**: Gain a holistic view with the ability to manage all users, view system-wide analytics, and oversee platform operations. * **📊 Comprehensive Analytics Endpoints** * Generate key business metrics instantly: `total_sent`, `total_received`, `transaction_count`, and `unique_customers`. * Analyze trends with daily, weekly, or monthly aggregates. * Break down transactions by type for a clear picture of business activity. * **🔒 Enterprise-Grade Security** * **JWT Authentication**: Secure, token-based user sessions. * **Row-Level Security**: Enforced at the database query level, guaranteeing that users can only access their own data. * **Password Hashing**: Industry-standard bcrypt for credential safety. * **👑 Powerful Admin Capabilities** * Dedicated admin routes for user management (create, view, toggle status, delete). * System-wide analytics endpoint to monitor the entire platform's health and performance. * **🚀 Production-Ready Architecture** * **Fully Dockerized**: Easy setup and deployment with Docker Compose. * **SQLite Persistent Storage**: Simple, file-based database perfect for MVP …