How yo-gerr/vcroad works
VCRoad is a cross-platform Valenzuela City road-safety app. The main citizen workflow is sign-in, viewing the map dashboard, submitting a guided incident report, and following its status; a parallel advisory workflow lets administrators plot and publish traffic updates for users. The tree shows distinct feature, provider, model, and repository layers, while the README documents capabilities and selected integrations. Source excerpts cover platform launchers rather than Dart runtime code, so feature-to-repository links are documented at a high level; other internal call relationships are not inferred.
Main entry points: advisory.dart Advisory repository · report_screen.dart Report wizard · advisory_screen.dart Advisory management · app_shell.dart App shell
Components 26
App shell
- App startup
lib/main.dart - App shell
lib/presentation/app/app_shell.dart - Role navigation
lib/core/utils/routing/role_router.dart
Citizen services
- Authentication
lib/presentation/features/auth/screens/login_screen.dart - Map dashboard
lib/presentation/features/home/screens/home_screen.dart - Incident map
lib/presentation/features/home/widgets/map.dart - Report wizard
lib/presentation/features/reports/screens/report_screen.dart - Report steps
lib/presentation/features/reports/widgets/steps - Report history
lib/presentation/features/reports/widgets/history.dart
Traffic advisories
- Advisory management
lib/presentation/features/advisories/screens/advisory_screen.dart - Advisory wizard
lib/presentation/features/advisories/widgets/create_advisory.dart - Route plotting
lib/presentation/features/advisories/widgets/steps/plot.dart - Advisory alerts
lib/presentation/shared/dialogs/advisory_alert.dart - Advisory export
lib/data/repositories/advisory_export.dart
Learning and administration
- Road safety lessons
lib/presentation/features/lesson/screens/lesson_browser_screen.dart - Account administration
lib/presentation/features/admin/screens/account_screen.dart - User profile
lib/presentation/features/profile/screens/profile_screen.dart
Data and integrations
- Report repository
lib/data/repositories/report.dart - Advisory repository
lib/data/repositories/advisory.dart - Lesson repository
lib/data/repositories/lesson.dart - Firebase
- OpenStreetMap
- OSRM
- Supabase media
Other components
- Citizen
- Administrator
Connections 21
- Citizen → Authentication: signs in
README.md - Authentication → Map dashboard: enters app
- Map dashboard → Incident map: shows incidents
README.md - Citizen → Report wizard: reports incident
README.md - Report wizard → Report steps: guides through
README.md - Report wizard → Report repository: submits report
- Report history → Report repository: tracks status
- Administrator → Advisory management: manages advisories
README.md - Advisory management → Advisory wizard: creates advisory
README.md - Advisory wizard → Route plotting: plots route
README.md - Route plotting → OSRM: snaps roads
README.md - Advisory management → Advisory repository: publishes updates
- Advisory repository → Firebase: streams updates
README.md - Advisory alerts → Advisory repository: alerts on additions
README.md - Advisory export → OpenStreetMap: renders map tiles
README.md - Advisory repository → Supabase media: removes advisory photo
README.md - Citizen → Road safety lessons: learns safety
README.md - Administrator → Account administration: manages accounts
README.md - Road safety lessons → Lesson repository: loads lessons
- App startup → App shell: starts
- App shell → Role navigation: routes by role