IYAMPAYE/pulsegrid-rwanda

AI-powered electricity outage reporting platform for Rwanda --- output: pdf_document: default html_document: default --- # PulseGrid — Rwanda Electricity Outage Portal **A full-stack outage reporting and field operations platform built for Rwanda Energy Group (REG).** Live demo: psz5gu-iyampaye-ribert.shin… Report form (public): n8n outage form ## Overview PulseGrid is an end-to-end system that lets citizens report electricity outages, automatically scores urgency with AI, routes tickets to regional technicians, and gives admins and field staff real-time operational dashboards. The project combines: - **R Shiny** — responsive web app (public landing page + authenticated dashboards) - **Supabase (PostgreSQL)** — centralized ticket and user database - **n8n** — workflow automation (intake, AI scoring, email notifications, status updates) - **Google Gemini** — multilingual urgency classification (Kinyarwanda, French, English) --- ## Problem Statement Utility companies receive outage reports through phone calls, social media, and walk-ins — often with incomplete location data and inconsistent priority. PulseGrid addresses this by: 1. Giving the public a structured reporting channel 2. Using AI to triage urgency and flag safety risks 3. Detecting regional outage clusters (multiple reports in a short window) 4. Assigning technicians by region automatically 5. Providing live dashboards for operations teams --- ## Architecture ```mermaid flowchart TB subgraph Public A[Citizen] -->|Report outage| B[n8n Web Form] end subgraph Automation["n8n Automation"] B --> C[Gemini AI Urgency Scoring] C --> D[Keyword Fallback] D --> E[Regional Clustering] E --> F[Technician Routing] F --> G[(Supabase Postgres)] G --> H[Email: Customer confirmation] G --> I[Email: Technician assignment] J[Technician status form] --> G K[Scheduled job] -->|Status change emails| A end subgraph App["R Shiny App — PulseGrid"] L[Public landing page] M[Admin dashboard] N[Technician portal] G --> M G --> N end ``` --- # …