mafralp@vbuz:~$

vBuz

Public transport operations platform designed for municipalities, school transport programs and mobility operators.

I am building vBuz as an end-to-end product ecosystem: a multi-tenant backend and operations portal, a passenger experience for digital mobility, and a purpose-built Android app for drivers and onboard monitors. The project turns field operations that are often manual, disconnected and difficult to audit into reliable digital workflows.

What I built

A Laravel REST API that centralizes identities, operator contexts, routes, vehicles, trip executions, boarding records, digital credentials and tenant-specific data boundaries.
A Next.js backoffice for municipalities and operators to manage networks, monitor active services and maintain data for field teams and passengers.
A React Native passenger app for digital passes, signed QR credentials, route access and live trip information.
A native Kotlin Android app for drivers and onboard monitors built for intermittent networks, background location, fast validation flows and QR/NFC hardware access.

Product capabilities

Digital boarding
Passengers are validated through physical or virtual QR codes and NFC credentials. The driver app returns clear approval or rejection feedback and keeps an auditable local history of boarding attempts.

Offline-first field operations
A route-specific manifest is stored locally before service begins. When connectivity drops, the onboard app validates eligible passengers from that trusted snapshot, persists the audit trail and synchronizes it when the connection returns.

Live trip operations
Drivers select the vehicle, route and schedule to start a trip. During execution, the app captures location in the background, evaluates GPS quality, batches position events and safely retries delivery after network interruptions.

Operational resilience
Trip state, boarding audits, GPS records and finish actions are persisted locally rather than discarded when the device is offline or the process is interrupted. Durable workers resume synchronization without requiring the operator to recreate work.

Multi-tenant public-sector architecture
The platform isolates municipal or operator contexts while keeping a shared product foundation. Tenant-aware authentication, scoped API requests and context recovery prevent cross-boundary data exposure.

Security and trust
Digital QR credentials are signed, mobile sessions are persisted with Android Keystore protection, passenger assets are cached privately, and the system distinguishes online validation from controlled offline fallback.

Technical decisions worth exploring

Native Android enables reliable NFC, camera scanning, foreground GPS services, device persistence and WorkManager.
The onboard application separates domain rules, remote APIs and local persistence, making boarding and trip flows testable without a UI or live connection.
Room-backed queues keep GPS and boarding data durable until the API acknowledges receipt; they are not in-memory retries.
GPS transmission is filtered by quality, elapsed time, distance and heading changes to balance tracking fidelity, device battery and network use.
Laravel Reverb provides real time; PostgreSQL/PostGIS handles geography; Redis supports asynchronous and cache-oriented workloads.

Architecture

[ Passenger App ]       [ Operations Portal ]       [ Onboard Android App ]
 React Native / Expo          Next.js / React          Kotlin / Jetpack Compose
         │                         │                         │
         └─────────────────────────┴───────────────┬─────────┘
                                                   │
                                      Laravel 11 REST API + Reverb
                                                   │
                         PostgreSQL / PostGIS · Redis · Queue workers · S3 storage

Stack

Backend
Laravel 11, PHP, PostgreSQL, PostGIS, Redis, Laravel Reverb, REST APIs, queue workers, Docker and S3-compatible object storage.

Operations portal
Next.js 14, React, TypeScript and shared design tokens/utilities.

Passenger experience
React Native, Expo, TypeScript, signed QR code flows, WebSocket-ready real-time updates and native map integrations.

Onboard operations
Kotlin, Jetpack Compose, Room, WorkManager, Android Keystore, DataStore, ML Kit barcode scanning, NFC and Google Play Services Location.

Type cd .. to return home.

mafralp@vbuz:~$