Suzzane-Nhyira/Ghana-Outage-Tracker

# ⚡ Ghana Power Outage Tracker > A Python tool that monitors, stores, and visualises electricity outage patterns across Ghana. --- **🌐 Live Dashboard** ## The problem Ghana experiences frequent load-shedding — locally known as *dumsor* — where electricity is cut to different regions on a rotating schedule. For students, small businesses, and everyday households, this is more than an inconvenience. It means lost work, interrupted study sessions, and wasted food. ECG (Electricity Company of Ghana) publishes outage notices, but there's no easy way to track patterns over time: which regions are hit most, how many hours are lost per week, or whether things are getting better or worse. This project exists to answer those questions. --- ## What it does - Fetches outage data from ECG and saves it to a local SQLite database - Tracks duration, region, area, and reason for every outage - CLI tool for quick terminal queries - Web dashboard with charts and region filtering - Grows smarter the longer you run it — patterns emerge over weeks --- ## Project structure ``` ghana-outage-tracker/ ├── fetcher.py # Pulls and parses outage data from ECG ├── database.py # SQLite storage, queries, and stats ├── tracker.py # CLI interface ├── app.py # Flask web dashboard ├── templates/ │ └── index.html # Dashboard UI └── data/ ├── outages.csv # Raw data backup └── outages.db # SQLite database ``` --- ## Getting started **1. Clone the repo** ```bash git clone github.com cd ghana-outage-tracker ``` **2. Install dependencies** ```bash pip install requests beautifulsoup4 rich flask ``` **3. Fetch data and set up the database** ```bash python fetcher.py python database.py ``` **4. Use the CLI** ```bash python tracker.py # Summary stats python tracker.py --region Accra # Filter by region python tracker.py --all # All records python tracker.py --fetch …