How brojass05/ecoalert works
Purpose and runtime
This is a single-module Android application (app) centered on location-aware weather and air-quality monitoring, with an alerting path for particulate matter (PM). It runs as a Kotlin/Android app built with Gradle.
• Module: app/build.gradle.kts
• Android app declaration and component registration: app/src/main/AndroidManifest.xml
Entry points and application shell
MainActivity is the primary UI entry point, backed by an XML activity layout. A separate Android service exists for work that may need to continue outside the activity lifecycle.
• Activity: app/src/main/java/com/example/pruebasubicacion/MainActivity.kt
• Layout: app/src/main/res/layout/activity_main.xml
• Service: app/src/main/java/com/example/pruebasubicacion/MyService.kt
Presentation and state coordination
The presentation layer contains screens for location and eco alerts. UbicacionViewModel is the likely boundary between UI state/actions and repository-backed location, weather, or air-quality operations.
• View model: app/src/main/java/com/example/pruebasubicacion/presentation/viewmodel/UbicacionViewModel.kt
• Location UI: app/src/main/java/com/example/pruebasubicacion/presentation/view/UbicacionView.kt
• Alert UI: app/src/main/java/com/example/pruebasubicacion/presentation/view/EcoAlertScreen.kt
Data and external API boundary
ClimaRepository centralizes climate-related retrieval, separating callers from API models. The model package identifies integrations for Nominatim geocoding and both complete and PM-only air-quality services; exact endpoints and client implementations are not visible in the tree.
• Repository: app/src/main/java/com/example/pruebasubicacion/data/ClimaRepository.kt
• Nominatim contract/model: app/src/main/java/com/example/pruebasubicacion/data/model/NominatimServicioAPI.kt
• Air-quality service contracts: app/src/main/java/com/example/pruebasubicacion/data/model/ServicioAPICalidadAireCompleta.kt, app/src/main/java/com/example/pruebasubicacion/data/model/ServicioAPISoloPM.kt
Domain state and local persistence
Climate and geocoding payloads are represented as dedicated models, while ClimaEstado appears to model application-facing climate state. DataStoreRepository is the local persistence boundary, likely retaining preferences or app state independently of remote fetches.
• State and payload models: app/src/main/java/com/example/pruebasubicacion/data/model/ClimaEstado.kt, app/src/main/java/com/example/pruebasubicacion/data/model/ClimaModel.kt, app/src/main/java/com/example/pruebasubicacion/data/model/NominatimModel.kt
• Persistence: app/src/main/java/com/example/pruebasubicacion/data/DataStoreRepository.kt
Background monitoring and notification flow
PmCheckerWorker defines a scheduled/background PM-checking stage. On a relevant PM result, it can cross the notification boundary through the presentation notification manager; MyService may provide an additional lifecycle mechanism for ongoing work.
• Background worker: app/src/main/java/com/example/pruebasubicacion/workers/PmCheckerWorker.kt
• Notification boundary: app/src/main/java/com/example/pruebasubicacion/presentation/ui/notifications/NotificationManager.kt
• Service component: app/src/main/java/com/example/pruebasubicacion/MyService.kt
Primary control flow
User activity flows from MainActivity into location/alert views and UbicacionViewModel. The view model accesses repositories, which read persisted state and call climate, geocoding, and air-quality services. Separately, PM background checks retrieve PM data and produce Android notifications when alert criteria are met. The main architectural boundaries are UI/view-model, repository/persistence, remote API contracts, and Android background/notification infrastructure.
Components 14
Android app
- App manifest · Registers Android components.
app/src/main/AndroidManifest.xml - MainActivity · Primary application entry point.
app/src/main/java/com/example/pruebasubicacion/MainActivity.kt - Activity layout
app/src/main/res/layout/activity_main.xml
Presentation
- Location view
app/src/main/java/com/example/pruebasubicacion/presentation/view/UbicacionView.kt - Eco alert screen
app/src/main/java/com/example/pruebasubicacion/presentation/view/EcoAlertScreen.kt - UbicacionViewModel · Coordinates UI actions and location/climate state.
app/src/main/java/com/example/pruebasubicacion/presentation/viewmodel/UbicacionViewModel.kt
Data & state
- ClimaRepository · Central boundary for climate retrieval.
app/src/main/java/com/example/pruebasubicacion/data/ClimaRepository.kt - DataStoreRepository · Stores app preferences or state.
app/src/main/java/com/example/pruebasubicacion/data/DataStoreRepository.kt - Climate state & payloads · Application climate state plus climate and geocoding payloads.
app/src/main/java/com/example/pruebasubicacion/data/model/ClimaEstado.kt
Remote integrations
- Nominatim API contract
app/src/main/java/com/example/pruebasubicacion/data/model/NominatimServicioAPI.kt - Air-quality API contracts · Complete and PM-only service contracts.
app/src/main/java/com/example/pruebasubicacion/data/model/ServicioAPICalidadAireCompleta.kt
Background alerts
- PmCheckerWorker · Scheduled PM monitoring stage.
app/src/main/java/com/example/pruebasubicacion/workers/PmCheckerWorker.kt - MyService · Supports work outside the activity lifecycle.
app/src/main/java/com/example/pruebasubicacion/MyService.kt - NotificationManager · Publishes PM alerts through Android notifications.
app/src/main/java/com/example/pruebasubicacion/presentation/ui/notifications/NotificationManager.kt
Connections 15
- App manifest → MainActivity: registers
- App manifest → MyService: registers
- MainActivity → Activity layout: uses
- MainActivity → Location view: hosts
- MainActivity → Eco alert screen: hosts
- Location view → UbicacionViewModel: UI actions/state
- Eco alert screen → UbicacionViewModel: UI actions/state
- UbicacionViewModel → ClimaRepository: retrieves climate data
- UbicacionViewModel → DataStoreRepository: reads/saves state
- ClimaRepository → Climate state & payloads: maps to state
- ClimaRepository → Nominatim API contract: geocodes location
- ClimaRepository → Air-quality API contracts: fetches air quality
- PmCheckerWorker → Air-quality API contracts: checks PM
- PmCheckerWorker → NotificationManager: PM alert
- MyService → PmCheckerWorker: may support ongoing work