How elpiratilla/bus-tracker works
go503 is a live San Salvador bus tracker with passenger arrival estimates and alerts, a fleet-owner management panel, driver GPS tracking, and ESP32 telemetry. The main flow is bus location reporting into server-side tracking, route status and ETA calculation, then passenger map/arrival information; fleet management and family tracking are additional product branches. The README documents product capabilities, while some frontend and family-link wiring is not shown in the sampled source, so those connections are marked unverified.
Main entry points: server.js Express server · tracking.js Trip tracking · empresa.js Fleet API · telemetry.js Telemetry API
Components 28
User experiences
- Live map
public/js/mapa.js - Fleet panel
public/js/panel.js - Company access
public/js/acceso.js - Push worker
public/sw.js - Sensor inquiry
public/js/landing.js - Private school tracking
public/js/mapa.js
Server API
- Express server
src/server.js - Telemetry API
src/routes/telemetry.js - Routes API
src/routes/rutas.js - Alerts API
src/routes/alertas.js - Fleet API
src/routes/empresa.js - Lead API
src/routes/clientes.js - Driver API
src/routes/motorista.js - Sensor auth
src/middleware/auth.js - Company auth
src/middleware/empresa.js
Transit processing
- ETA engine
src/eta.js - Trip tracking
src/tracking.js - Route geometry
src/trazos.js - Geo calculations
src/geo.js - Transit state
src/store.js - Supabase
src/db.js - Arrival alerts
src/alerts.js
Location sources
- ESP32 sensor
firmware/go503_sensor - Driver app
public/js/motorista.js
Other components
- Passenger
- Fleet owner
- Family
- Driver
Connections 37
- Passenger → Live map: views buses
README.md - Live map → Routes API: requests route status
- Routes API → ETA engine: calculates arrivals
src/routes/rutas.js - ETA engine → Transit state: reads transit state
src/eta.js - ETA engine → Geo calculations: measures distance
src/eta.js - Passenger → Push worker: receives arrival alerts
README.md - Push worker → Alerts API: subscribes
- Alerts API → Arrival alerts: manages alerts
src/routes/alertas.js - Arrival alerts → ETA engine: estimates arrivals
src/alerts.js - Arrival alerts → Transit state: reads alert state
src/alerts.js - Fleet owner → Company access: signs in
README.md - Fleet owner → Fleet panel: manages fleet
README.md - Fleet panel → Fleet API: manages units
- Fleet panel → Routes API: views route data
- Fleet API → Company auth: checks company session
src/routes/empresa.js - Fleet API → Route geometry: edits route shapes
src/routes/empresa.js - Fleet API → Supabase: reads and writes fleet data
src/routes/empresa.js - Driver → Driver app: starts bus tracking
README.md - Driver app → Driver API: reports trip
- ESP32 sensor → Telemetry API: sends bus data
README.md - Telemetry API → Sensor auth: checks sensor key
src/routes/telemetry.js - Telemetry API → Trip tracking: updates trip tracking
src/routes/telemetry.js - Driver API → Trip tracking: controls trips
src/routes/motorista.js - Trip tracking → Route geometry: records GPS traces
src/tracking.js - Trip tracking → Geo calculations: finds nearby stops
src/tracking.js - Trip tracking → Supabase: persists trip data
src/tracking.js - Trip tracking → Transit state: updates trip state
src/tracking.js - Express server → Telemetry API: mounts endpoint
src/server.js - Express server → Routes API: mounts endpoint
src/server.js - Express server → Alerts API: mounts endpoint
src/server.js - Express server → Fleet API: mounts endpoint
src/server.js - Express server → Lead API: mounts endpoint
src/server.js - Express server → Driver API: mounts endpoint
src/server.js - Express server → Supabase: loads saved state
src/server.js - Fleet owner → Sensor inquiry: requests sensor
README.md - Sensor inquiry → Lead API: submits inquiry
- Family → Private school tracking: views private location
README.md