How v1zd0n/safetycar works
SafetyCar is a prototype for assessing risk on Bulgaria’s national-road routes. Visitors can explore a scroll-driven 3D landing story and sample hotspot heatmap, then open the route demo to choose places and a vehicle, view a route and its risk segments, and use location/navigation features. With the supplied backend configured, route requests use Mapbox Directions and return baseline risk estimates with recent road reports where available; otherwise the demo uses sample routes. Backend and analysis links are limited to the README and SOURCE INDEX evidence shown.
Main entry points: App.tsx App routing · route.mjs Route API · MapDashboard.tsx Route dashboard · demoRoute.ts Route data client
Components 23
Landing story
- App routing
src/App.tsx - Story timeline
src/scroll/useStory.ts - Story state
src/scroll/store.ts - 3D scene
src/three/Experience.tsx - Cockpit display
src/cockpit/Cockpit.tsx - Landing heatmap
src/map/MapView.tsx - Language context
src/i18n/LangContext.tsx
Route demo
- Route dashboard
src/MapDashboard.tsx - Route data client
src/data/demoRoute.ts - Route map
src/map/RouteMap.tsx - Live stations layer
src/map/stationsLayer.ts - Geolocation
src/demo/useGeolocation.ts
Route services
- API server
backend/src/server.mjs - Route API
backend/src/route.mjs - Live feed polling
backend/src/live/poll.mjs - PostgreSQL / PostGIS
backend/src/db.mjs
Risk assessment
- Assessment data access
analysis/db.py - Baseline assessment
analysis/explain.py - Reactive risk
analysis/reactive.py - Risk weights
analysis/weights.py - Proactive risk
analysis/proactive.py
Other components
- Visitor
- Mapbox Directions
Connections 26
- Visitor → App routing: opens app
src/App.tsx - App routing → Story timeline: starts story
src/App.tsx - App routing → 3D scene: loads scene
src/App.tsx - App routing → Cockpit display: renders cockpit
src/App.tsx - App routing → Landing heatmap: loads map
src/App.tsx - App routing → Route dashboard: routes demo
src/App.tsx - Story timeline → Story state: updates state
src/scroll/useStory.ts - 3D scene → Story state: reads rig
src/three/Experience.tsx - App routing → Language context: provides language
src/App.tsx - Route dashboard → Route data client: loads routes
src/MapDashboard.tsx - Route dashboard → Route map: renders route
src/MapDashboard.tsx - Route dashboard → Geolocation: gets position
src/MapDashboard.tsx - Route map → Live stations layer: uses station layer
src/map/RouteMap.tsx - Route data client → Mapbox Directions: requests directions
README.md - Route data client → API server: requests route
src/data/demoRoute.ts - API server → Route API: routes requests
backend/src/server.mjs - API server → Live feed polling: polls live data
backend/src/server.mjs - Route API → PostgreSQL / PostGIS: queries risk data
backend/src/route.mjs - Route API → Mapbox Directions: gets route geometry
README.md - Route API → Baseline assessment: evaluates route risk
README.md - Route API → Reactive risk: uses road reports
README.md - Live feed polling → PostgreSQL / PostGIS: stores feed data
backend/src/live/poll.mjs - Baseline assessment → Assessment data access: uses data access
analysis/explain.py - Reactive risk → Assessment data access: uses data access
analysis/reactive.py - Risk weights → Assessment data access: uses data access
analysis/weights.py - Risk weights → Proactive risk: imports assessment
analysis/weights.py