muhindovicent/Fuel-Monitoring-System-Uganda

Due to the rising fuel and gas prices across the world, many fuel stations in Uganda have taken matters into their hands to exploit Ugandans leaving them out of options. Some have over priced the costs of these commodities and the common man is facing it hard to cope with life, especially the boda professions this has hit them severely. # MafutaWatch Uganda — National Fuel Price Transparency Platform **Ministry of Energy and Mineral Development (MEMD)** | **Republic of Uganda** --- ## Repository Structure ``` D:\FUEL SYSTEM UGANDA\ │ ├── README.md # This file — project overview ├── index.html # Project documentation entry page ├── MAFUTAWATCH_UGANDA_FULL_SYSTEM.md # Full system implementation reference (1490 lines) │ ├── app\ │ ├── index.html # PWA shell — gov.za directory layout │ ├── css\ │ │ └── style.css # Institutional government design system │ ├── js\ │ │ ├── app.js # All application logic (~2300 lines) │ │ └── data.js # Station, operator, seed data │ ├── manifest.json # PWA manifest │ └── service-worker.js # Offline cache strategy │ ├── docs\ │ ├── 01_SYSTEM_TOPOGRAPHY.md # Cloud infra diagram, data flows, scaling │ ├── 02_PRICE_VERIFICATION.md # (placeholder) Verification pipeline spec │ ├── 03_USSD_SESSION_FLOW.md # Redis state machine, menu handlers, i18n │ ├── 04_SECURITY_FRAMEWORK.md # 5-layer Sybil defense, trust engine, rate limiting │ ├── 05_SITE_MAP.md # App navigation tree, component hierarchy │ ├── 06_ERD.md # Entity Relationship Diagram — data model │ └── 07_UI_WIREFRAME.md # gov.za directory layout wireframe blueprint │ └── sql\ └── 001_schema_ddl.sql # Full PostgreSQL DDL: PostGIS, partitioning, RLS ``` ## Deliverables Summary | # | Deliverable | File | Key Highlights | |---|---|---|---| | **1** | System Topography Mapping | `docs/01_SYSTEM_TOPOGRAPHY.md` | Cloud-infra Mermaid diagram; Kafka event bus; 7 worker microservices; CDN→API Gateway→Queue→Worker→DB pipeline | | **2** | Database Schema DDL | `sql/001_schem …