A serverless AWS application that allows Nigerian citizens to report, track, and receive alerts about power outages across all 774 LGAs in Nigeria.
Epileptic power supply is a daily reality for millions of Nigerians. No reliable system exists to report or track outages in real time. This project solves that.
Built entirely on AWS serverless services:
| Service | Role |
|---|---|
| API Gateway | Receives outage reports from citizens |
| Lambda (Ingest) | Validates and stores reports |
| Lambda (Query) | Fetches reports for the dashboard |
| Lambda (Aggregator) | Counts reports per LGA and checks threshold |
| Lambda (Alert) | Sends SNS email alerts to subscribers |
| DynamoDB | Stores all outage reports with 90-day TTL |
| SNS | Delivers email alerts to subscribers |
| EventBridge | Monitors DynamoDB streams |
| Method | Endpoint | Description |
|---|---|---|
| POST | /reports |
Submit an outage report |
| GET | /reports |
Get all active outages |
| GET | /reports?lga=Ikeja |
Get outages by LGA |
| POST | /alert |
Send an alert to subscribers |
{
"lga": "Ikeja",
"state": "Lagos",
"outage_type": "total",
"notes": "No light since 6am, no EKEDC notice"
}- AWS CLI configured
- SAM CLI installed
- Python 3.12
- Docker
sam build
sam deploy --guidedSubmit a report:
curl -X POST <API_URL>/reports \
-H "Content-Type: application/json" \
-d '{"lga": "Ikeja", "state": "Lagos", "outage_type": "total"}'Fetch all active outages:
curl <API_URL>/reportsRuns on AWS free tier and pay-per-use pricing. At civic app scale, costs under $2/month.
A full Terraform IaC version is available in the terraform/ folder — same architecture, different deployment approach.
terraform/
├── modules/
│ ├── api/ # API Gateway HTTP API
│ ├── compute/ # Lambda functions + IAM roles
│ ├── messaging/ # SQS queue, DLQ, SNS topic
│ ├── observability/ # CloudWatch logs, alarms, dashboard
│ └── storage/ # DynamoDB table with GSI and TTL
├── functions/ # Python Lambda handlers
└── environments/
└── dev/ # Root module wiring everything together
cd terraform/environments/dev
export TF_VAR_alert_email="your@email.com"
terraform init
terraform plan
terraform apply| Feature | SAM | Terraform |
|---|---|---|
| IaC tool | AWS SAM | Terraform |
| State management | CloudFormation | S3 backend with native locking |
| Module structure | Single template | 5 independent reusable modules |
| CloudWatch dashboard | No | Yes |
| Dead Letter Queue | No | Yes |
| Alert threshold | Hardcoded | Configurable variable |
Emmanuel Ulu — DevOps/Cloud Engineer | AWS Community Builder 2026
- GitHub: Emmanuel-DevOps-Portfolio
- LinkedIn: linkedin.com/in/emmanuelulu
MIT
