jacque-sudo/payswift-ghana-analysis

# PaySwift Ghana Data Analysis Pipeline ## Project Overview The PaySwift Ghana Data Analysis Pipeline is a robust, modular Python application designed to extract actionable insights from customer data. [cite_start]PaySwift Ghana is a small fintech company [cite: 37] that provides: * [cite_start]Mobile payment solutions for businesses[cite: 38]. * [cite_start]Micro-loans and credit scoring services[cite: 39]. * [cite_start]Personal finance management tools[cite: 39]. This project directly addresses three key business challenges: 1. [cite_start]**Low adoption rates for new features:** Users are not engaging with certain digital services[cite: 41]. 2. [cite_start]**High loan default rates:** Many customers are struggling to repay micro-loans[cite: 42]. 3. [cite_start]**Customer churn:** A significant number of users sign up but stop using the service after a few months[cite: 43]. [cite_start]The pipeline processes transactional and behavioral data to answer the core business question: *"How can we use data to increase feature adoption, reduce loan defaults, and improve customer retention?"*[cite: 45]. [cite_start]It generates high-impact visual presentations designed to defend product, marketing, and UX/UI recommendations with data and logic[cite: 58]. ## Documentation Directory To maintain a strict separation of concerns, detailed documentation is segmented into the following modules: * 1. Setup & Installation Guide: Instructions for environment configuration using `uv` and PEP 621 standards. * 2. System Architecture: Overview of the Single Responsibility Principle (SRP) application design and data flow. * 3. API & Module Reference: Technical documentation for internal Python modules (Context 7 compliant). ## Key Technical Features * **Strict Tooling:** Project and dependency management handled exclusively via `uv` for high-performance environment resolution. * **Robust Data Handling:** Strict parsing and sanitization of Excel data with comprehensive PEP …