How andrea-salvatore/matera_tour works
Matera Tour is a Flutter mobile audio guide whose main workflow is to show mapped Matera points of interest, monitor the visitor’s proximity, prompt them to hear a monument’s history, and read descriptions aloud. The README also documents custom map tracking, far-away navigation handoff, background audio introductions, and a welcome notification. The graph uses those documented relationships; Dart implementation excerpts were not provided, so finer call ownership and the wiring of auth/admin features cannot be verified.
Main entry points: navigation_offer_sheet.dart Navigation Offer · proximity_dialog.dart Proximity Prompt · map_screen.dart Map Screen · map_view.dart Custom Map View
Components 27
Map and Monuments
- Map Screen
lib/features/map/presentation/screens/map_screen.dart - Custom Map View
lib/features/map/presentation/widgets/map_view.dart - Monument Markers
lib/features/map/presentation/widgets/monument_marker_widget.dart - Monument Preview
lib/features/map/presentation/widgets/monument_preview_sheet.dart - Monuments Provider
lib/features/map/presentation/providers/monuments_provider.dart - Monument Repository
lib/features/map/data/repositories/mock_monument_repository.dart - Monument Data
lib/features/map/data/mock_monuments.dart
Location and Proximity
- Location Service
lib/features/geofencing/data/location_service.dart - Geofencing Service
lib/features/geofencing/data/geofencing_service.dart - Geofencing Provider
lib/features/geofencing/presentation/providers/geofencing_provider.dart - Location Provider
lib/features/geofencing/presentation/providers/location_provider.dart - Proximity Prompt
lib/shared/widgets/proximity_dialog.dart
Audio Guide
- Monument Details
lib/features/monument_details/presentation/screens/monument_details_screen.dart - TTS Provider
lib/features/monument_details/presentation/providers/tts_provider.dart - Text to Speech
lib/core/services/tts_service.dart - Audio Player Provider
lib/features/monument_details/presentation/providers/audio_player_provider.dart - Audio Player
lib/features/monument_details/presentation/widgets/audio_player_bar.dart
Navigation Handoff
- Map App Launcher
lib/core/services/map_launcher_service.dart - Navigation Offer
lib/features/monument_details/presentation/widgets/navigation_offer_sheet.dart - Native Map App
- Welcome Notification
lib/core/services/notification_service.dart
App and Access
- App Router
lib/core/router/app_router.dart - Auth Provider
lib/features/auth/presentation/providers/auth_provider.dart - Mock Auth Repository
lib/features/auth/data/mock_auth_repository.dart - Admin Monument Entry
lib/features/admin/presentation/admin_insert_screen.dart - Admin Map Picker
lib/features/admin/presentation/admin_map_picker_screen.dart
Other components
- Visitor
Connections 16
- Visitor → Map Screen: explores map
README.md - Map Screen → Custom Map View: displays map
README.md - Custom Map View → Monument Markers: shows markers
README.md - Visitor → Location Service: shares GPS location
README.md - Location Service → Geofencing Service: provides coordinates
README.md - Geofencing Service → Proximity Prompt: triggers nearby prompt
README.md - Visitor → Proximity Prompt: approaches point
README.md - Proximity Prompt → Monument Details: invites listening
README.md - Monument Details → TTS Provider: requests narration
README.md - TTS Provider → Text to Speech: speaks description
README.md - Visitor → Navigation Offer: requests directions
README.md - Navigation Offer → Map App Launcher: hands off route
README.md - Map App Launcher → Native Map App: opens directions
README.md - Navigation Offer → Audio Player Provider: starts introduction
README.md - Audio Player Provider → Audio Player: provides playback
- Navigation Offer → Welcome Notification: schedules welcome
README.md