How lianeheidemann/cirioapp_v2 works
CírioApp is a Flutter guide to the Círio de Nazaré. The main user flow runs from feature screens through providers to data access and results; major branches cover events, map and places, news, notifications, favorites, and the AI assistant. The README documents these capabilities and the broad provider/repository/service architecture; source excerpts were limited to Android build files, so uncertain internal call wiring is omitted.
Main entry points: app.dart Flutter app · map_provider.dart Map state · ai_assistant_repository.dart Assistant data access · favorites_provider.dart Favorites
Components 28
App experience
- Flutter app
lib/app.dart - Home
lib/features/home/home_screen.dart - Language settings
lib/core/localization/app_language.dart - Favorites
lib/features/favorites/favorites_provider.dart - Favorites storage
lib/data/local/favorites_local_storage.dart
Event and place content
- Event schedule
lib/features/events/events_screen.dart - Event state
lib/features/events/events_provider.dart - Event data access
lib/data/repositories/event_repository.dart - Map and places
lib/features/map/map_screen.dart - Map state
lib/features/map/map_provider.dart - Place state
lib/features/places/places_provider.dart - Place data access
lib/data/repositories/place_repository.dart - Location service
lib/data/services/location_service.dart
News and notifications
- Editorial news
lib/features/news/news_screen.dart - News state
lib/features/news/news_provider.dart - News data access
lib/data/repositories/news_repository.dart - Notification history
lib/features/notifications/notifications_provider.dart - Push notification service
lib/data/services/firebase_notifications_service.dart
AI assistant
- AI assistant
lib/features/ai_assistant/ai_assistant_screen.dart - Assistant state
lib/features/ai_assistant/ai_assistant_provider.dart - Assistant data access
lib/data/repositories/ai_assistant_repository.dart - Semantic retrieval
lib/data/services/semantic_search_service.dart - Gemini service
lib/data/services/gemini_service.dart
Other components
- Resident or pilgrim
- OpenStreetMap
- Cloud Firestore
- Firebase Cloud Messaging
- Gemini API
Connections 27
- Resident or pilgrim → Flutter app: opens
- Flutter app → Home: shows
- Resident or pilgrim → Event schedule: browses
- Event schedule → Event state: requests events
- Event state → Event data access: loads schedule
- Resident or pilgrim → Map and places: explores places
- Map and places → Map state: requests map data
- Map state → Location service: gets location
- Location service → OpenStreetMap: uses map data
- Map state → Place state: loads places
- Place state → Place data access: loads places
- Resident or pilgrim → Editorial news: reads news
- Editorial news → News state: requests articles
- News state → News data access: loads articles
- News data access → Cloud Firestore: reads news
- Resident or pilgrim → Notification history: views alerts
- Notification history → Push notification service: manages push
- Push notification service → Firebase Cloud Messaging: receives updates
- Resident or pilgrim → Favorites: saves items
- Favorites → Favorites storage: persists favorites
- Resident or pilgrim → AI assistant: asks question
- AI assistant → Assistant state: submits question
- Assistant state → Assistant data access: requests answer
- Assistant data access → Semantic retrieval: retrieves context
- Assistant data access → Gemini service: requests response
- Gemini service → Gemini API: generates answer
- Flutter app → Language settings: uses language