El632510/ethiopia-fi-forecast

# Ethiopia Financial Inclusion Forecasting 10 Academy KAIM Week 11 Challenge. This project builds a forecasting system that tracks Ethiopia's progress on financial inclusion, using the World Bank's Global Findex definitions of Access (Account Ownership) and Usage (Digital Payment Adoption). All five tasks are complete: data exploration and enrichment, EDA, event impact modeling, forecasting, and a dashboard. ## Project structure ``` ethiopia-fi-forecast/ ├── data/ │ ├── raw/ starter dataset, reference codes, enrichment guide │ └── processed/ enriched dataset, association matrix, refined impact │ estimates, and forecast tables (outputs of the notebooks) ├── notebooks/ │ ├── task1_data_exploration_enrichment.ipynb │ ├── task2_eda.ipynb │ ├── task3_event_impact_modeling.ipynb │ └── task4_forecasting.ipynb ├── src/ │ ├── config.py paths, valid categorical values, indicator codes │ ├── data_loader.py loads the raw Excel files │ ├── validation.py schema and data quality checks │ ├── enrichment.py functions to add new observations/events/impact_links │ ├── eda.py summary tables and calculations for Task 2 │ ├── visualization.py matplotlib plotting functions for Tasks 2-3 │ ├── event_model.py association matrix and impact scoring for Task 3 │ └── forecasting.py trend and scenario forecasting for Task 4 ├── dashboard/ │ └── app.py Streamlit dashboard for Task 5 ├── tests/ unit tests for the src modules ├── reports/ │ ├── figures/ charts saved from the notebooks │ ├── data_enrichment_log.md documents every record added in Task 1 │ ├── interim_report.md │ └── final_report.md ├── requirements.txt └── .github/workflows/unittests.yml ``` ## How to run this 1. Create a virtual environment and install dependencies: ``` pip install -r requirements.txt ``` 2. Run the no …