b-aragu/Mdaftari

Track Every Shilling # 📘 Mdaftari **Track Every Shilling** *Web-Based Mobile Payment Tracking for Kenya 🇰🇪* Demo • Features • Tech Stack • Installation • User Guide --- ## 🎯 Executive Summary **Mdaftari** (Swahili: *Ledger / Account Book*) is a **Progressive Web App** that solves a critical pain point in Kenya's informal economy: **tracking partial payments and outstanding balances from M-Pesa transactions**. ### The Market Opportunity - **50M+** M-Pesa users in Kenya - **$73B+** annual transaction volume - **Zero** dedicated tools for tracking partial payments - Small businesses, contractors, and freelancers rely on notebooks and memory ### Our Solution A beautiful, offline-first web app that: - ✅ Imports M-Pesa statements automatically - ✅ Tracks partial payments and running balances - ✅ Works without internet (PWA) - ✅ Groups transactions by person intelligently - ✅ Provides collection AND payment tracking modes --- ## 🧠 The Problem & Solution ### The John & David Scenario **John is a contractor** who completed a KES 50,000 job for David. | What Happened | Traditional Tracking | With Mdaftari | |--------------|---------------------|---------------| | David pays KES 30,000 | John writes in notebook: "David - 30K" | Auto-imported from M-Pesa statement | | 2 weeks later, David pays KES 15,000 | John forgets to update notebook | Automatically added, balance updates to KES 5,000 | | 1 month later, dispute arises | "I paid you everything!" vs "No you didn't!" | Clear transaction history: 3 payments, KES 5,000 still owed | **The Problem:** - M-Pesa moves money but **doesn't track debt** - Partial payments are common but **impossible to track** - Disputes damage business relationships **Our Solution:** Mdaftari connects to your M-Pesa history and automatically calculates: - What you've collected - What's still outstanding - Running balance per person --- ## ✨ Features ### 📊 Three Operating Modes | Mode | Use Case | What It Shows | |------|----------|-------------- …