Fuel Pass Pro: Real-Time Fraud-Proof Rationing

Manual fuel rationing breeds fraud and chaos. Fuel Pass Pro replaces it with real-time cloud validation, unique vehicle identities, and instant quota enforcement at every pump.

Comment

Inspiration

In Bangladesh and across emerging economies, fuel rationing still runs on paper logbooks — handwritten quota sheets that are easy to forge, impossible to audit at scale, and reset by hand every week. The same vehicle can refuel across multiple stations in a single day with zero detection. Supervisors learn about fraud days late — long after the fuel and the evidence are gone. I built Fuel Pass Pro to replace paper, trust, and guesswork with a real-time cloud ledger.

What it does

Fuel Pass Pro is a 100% serverless digital fuel passport system with three portals:

User Portal — Register with Owner Name + Vehicle ID. A Firestore document is created with a default 60L quota. Activate your pass, generate a live QR code, and see remaining liters anytime.

Pump Terminal — Operator scans the QR, Firestore validates quota in real-time, server-side subtraction locks the balance. Over-quota? Transaction blocked instantly. Zero double-spend possible.

Admin Command Center — Live feed of all registered vehicles, anomaly detection, one-click weekly batch reset of 60L quotas across thousands of vehicles in milliseconds.

How I built it

  • Frontend: HTML5 + CSS3 with Tailwind CSS (responsive, futuristic UI)
  • Cloud & Database: Firebase Firestore (real-time NoSQL, serverless)
  • Logic: JavaScript ES6+ for core quota arithmetic and DB interactions
  • Architecture: 100% serverless, decentralized modular — no servers to provision, globally accessible by default
  • Live: kazi1990.github.io/fuel-pass-rationing

Challenges I ran into

The biggest challenge was fixing the undefined/null quota display bug — users were seeing "undefined / 0L" instead of their actual remaining balance. Solving the Firestore data mapping to render "54.5L Remaining" correctly was a key breakthrough. Also ensuring server-side arithmetic blocks over-quota dispenses even on slow mobile networks required careful edge verification design.

Accomplishments that I'm proud of

Every dispense is recorded, attributed, and auditable in milliseconds. The innovation isn't a feature — it's the removal of the human factor from quota tracking entirely. One-click weekly reset replaces hours of manual paperwork. Financial-grade precision at the fuel pump, built with zero backend servers.

What I learned

Firebase Firestore's real-time sync is powerful enough to replace an entire on-premise server infrastructure at a fuel station. A cloud-native architecture can solve real governance problems in emerging economies — fairer, more transparent, more auditable. Serverless truly scales: one pump or ten thousand, the cloud doesn't care.

What's next for Fuel Pass Pro: Real-Time Fraud-Proof Rationing

Phase 2 — Operations:

  • Firebase Authentication layer
  • Super-admin & multi-user access
  • Dedicated pump-operator portal
  • Enhanced QR with signed payloads
  • Role-based permissions

Phase 3 — Intelligence:

  • ANPR (Automatic Number Plate Recognition)
  • AI-driven consumption forecasting
  • Real-time anomaly alerts
  • National-scale rollout
  • Public auditing dashboards
  • Cross-agency data interchange

Built With

Share this project:

Updates