# ❤️ Love in the Time of Mobile Money
### Valentine’s Day Spending Behaviour Using Synthetic M-Pesa Transactions (Kenya)
---
## 📌 Project Overview
This project explores **Valentine’s Day–driven spending behaviour** in Kenya using a **fully synthetic M-Pesa transaction dataset**.
The objective is not to reproduce real transaction data, but to **simulate realistic behavioural patterns** based on:
- Publicly reported M-Pesa usage statistics
- Documented Valentine’s spending trends
- Academic and behavioural research on mobile money usage in Kenya
The resulting dataset enables rigorous **before–during–after analysis** of how emotionally driven financial behaviour manifests in transaction volume, timing, value, demographics, and recovery dynamics.
---
## 🎯 Objectives
- Demonstrate how **event-driven behaviours** can be modeled using synthetic data
- Explore **temporal, demographic, and behavioural shifts** during Valentine’s period
- Provide a **reproducible framework** for behavioural analytics, storytelling, and dashboard prototyping
- Serve as a **portfolio-quality analytical case study**
---
## 🧪 Data & Methodology Summary
- **Data Type:** Fully synthetic M-Pesa P2P transactions
- **Simulation Period:** February 2025
- **Population Size:** 50,000 simulated users
- **Data Generation:** Python-based probabilistic simulation
- **Grounding Sources (Conceptual):**
- Safaricom PLC annual usage averages (2024–2025)
- Mastercard Love Index (2017–2020 sentiments & trends)
- Academic and practitioner studies (Busara x CGAP, TIFA, fintech literature)
> ⚠️ No real user data is used. No affiliation with Safaricom or M-Pesa is implied.
---
## 📂 Project Structure
```text
├── notebook/
│ └── love_in_the_time_of_mobile_money.ipynb
├── data/
│ └── synthetic_mpesa_valentine_transactions.csv
├── docs/
│ ├── Data_dictionary.md
│ └── Valentine_synthetic_dataset_logic.md
├── visuals/
│ └── Insights visuals/images of analysis
├── README.md
```
---
## ⏱️ Analytical …