How abhimanyukapoor/saferoute works
SafeRoute is a mobile-first route-safety analyzer. Its documented user journey is authenticated origin/destination submission, route retrieval and segmentation, per-segment visual and geographic analysis, safety scoring with explanations, and a response for map display. README documents Flutter client behavior, while the provided mobile tree contains only platform runners—not the Dart application—and source excerpts do not show most Go call wiring. I therefore show documented relationships with README evidence and omit unsupported implementation-level edges; ML internals are represented at the service boundary.
Main entry points: analyze.go Analysis handler · saferoute Flutter app · routes.go Route registration · main.go API startup
Components 22
Mobile client
- Flutter app
mobile/saferoute
Analysis backend
- API startup
backend/cmd/api/main.go - HTTP server
backend/internal/server/server.go - Route registration
backend/internal/routes/routes.go - Token verification
backend/internal/auth/middleware.go - Analysis handler
backend/internal/handlers/analyze.go - Analysis DTO
backend/internal/dto/analyze.go - Polyline segmentation
backend/internal/utils - Route directions
backend/internal/maps/directions.go - Street View images
backend/internal/maps/streetview.go
Safety signals
- Nearby activity data
backend/internal/maps/activity.go - Road metadata
backend/internal/maps/roads.go - Activity scoring
backend/internal/safety/activity.go - Road scoring
backend/internal/safety/roads.go - Time risk
backend/internal/safety/time.go - Safety aggregation
backend/internal/safety/scoring.go - Safety explanations
backend/internal/safety/explain.go
Visual inference
- ML client
backend/internal/ml/client.go - Visual inference
ml/main.py
Other components
- Traveler
- Google Maps APIs
- Firebase Auth
Connections 29
- Traveler → Flutter app: sets locations
- Flutter app → API startup: requests analysis
- Flutter app → Firebase Auth: authenticates with
- Flutter app → API startup: sends ID token
- API startup → HTTP server: starts
- HTTP server → Route registration: registers routes
- Route registration → Token verification: protects endpoint
- Route registration → Analysis handler: dispatches analysis
- Token verification → Firebase Auth: verifies token
- Analysis handler → Analysis DTO: returns response
- Analysis handler → Route directions: fetches routes
- Route directions → Google Maps APIs: queries directions
- Analysis handler → Polyline segmentation: segments geometry
- Analysis handler → Street View images: requests images
- Street View images → Google Maps APIs: queries Street View
- Analysis handler → Nearby activity data: requests activity
- Nearby activity data → Google Maps APIs: queries Places
- Analysis handler → Road metadata: requests road context
- Road metadata → Google Maps APIs: queries road data
- Analysis handler → ML client: submits images
- ML client → Visual inference: sends inference request
- Visual inference → ML client: returns visual scores
- Analysis handler → Activity scoring: scores activity
- Analysis handler → Road scoring: scores road context
- Analysis handler → Time risk: adjusts for time
- Analysis handler → Safety aggregation: aggregates safety
- Analysis handler → Safety explanations: builds explanations
- Analysis handler → Flutter app: returns route insights
- Flutter app → Traveler: renders map results