How mohamedmahmouddorah/cairo-metro works
Metro Cairo is a Flutter app for finding Cairo Metro routes and stations. The main user flow is to choose stations or a place, optionally use the device location, calculate a route or nearest station, and inspect the result; search history supports repeating and deleting trips. The README also documents an interactive metro map and routing preferences. The graph reflects these documented capabilities, but Dart implementation excerpts were not provided, so unverified calls between app components are shown as dashed links without evidence paths.
Main entry points: home_view.dart Home and results · home_controller.dart Trip controller · graph_service.dart Route optimizer · metro_controller.dart Nearest station screen
Components 18
User experience
- App entry
lib/main.dart - Home and results
lib/features/home/views/home_view.dart - Trip controller
lib/features/home/controllers/home_controller.dart - Station picker
lib/features/home/views/widgets/station_search_dialog.dart - Route results
lib/features/home/views/result_view.dart - Metro map
lib/features/nearest_station/views/metro_view.dart
Metro routing
- Route optimizer
lib/core/services/graph_service.dart - Metro network data
lib/data/metro_data.dart - Route models
lib/data/models/route_result.dart - Route preferences
lib/data/models/route_preference.dart
Location and places
- Nearest station logic
lib/core/services/nearest_station_service.dart - Device location
lib/core/services/location_service.dart - Nearest station screen
lib/features/nearest_station/controllers/metro_controller.dart - Place search
lib/features/places/controllers/place_search_controller.dart - Map place picker
lib/features/places/views/map_picker_view.dart
Local state
- Trip history
lib/core/services/history_service.dart - Recent trips
lib/core/services/recent_trip_service.dart
Other components
- App user
Connections 18
- App user → Home and results: opens
README.md - App entry → Home and results: starts
- Home and results → Trip controller: delegates trips
- Home and results → Station picker: selects stations
README.md - Trip controller → Route optimizer: requests route
- Route optimizer → Metro network data: uses network
README.md - Route optimizer → Route models: produces route
- Home and results → Route results: shows results
- Trip controller → Route preferences: uses preferences
README.md - App user → Nearest station screen: requests nearby
README.md - Nearest station screen → Device location: gets coordinates
README.md - Nearest station screen → Nearest station logic: finds nearest
- Nearest station logic → Metro network data: checks stations
README.md - App user → Place search: searches places
- App user → Map place picker: picks location
README.md - Metro map → Trip controller: sets stations
README.md - Trip controller → Trip history: records searches
README.md - Trip history → Recent trips: serializes trips
README.md