# brojass05/ecoalert architecture

> Architecture diagram of the GitHub repository brojass05/ecoalert, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/brojass05/ecoalert
- Repository: https://github.com/brojass05/ecoalert

## Overview

#### 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.

Main entry points: [`app/src/main/java/com/example/pruebasubicacion/MainActivity.kt`](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/MainActivity.kt) (MainActivity), [`app/src/main/java/com/example/pruebasubicacion/data/ClimaRepository.kt`](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/ClimaRepository.kt) (ClimaRepository), [`app/src/main/java/com/example/pruebasubicacion/presentation/viewmodel/UbicacionViewModel.kt`](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/presentation/viewmodel/UbicacionViewModel.kt) (UbicacionViewModel), [`app/src/main/java/com/example/pruebasubicacion/workers/PmCheckerWorker.kt`](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/workers/PmCheckerWorker.kt) (PmCheckerWorker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_manifest["App manifest<br/>Android declaration"]
  node_activity["MainActivity<br/>[MainActivity.kt]"]
  node_layout["Activity layout<br/>XML layout<br/>[activity_main.xml]"]
end

subgraph group_presentation["Presentation"]
  node_location_ui["Location view<br/>screen<br/>[UbicacionView.kt]"]
  node_alert_ui["Eco alert screen<br/>[EcoAlertScreen.kt]"]
  node_viewmodel["UbicacionViewModel<br/>view model"]
end

subgraph group_data["Data &amp; state"]
  node_clima_repo["ClimaRepository<br/>data repository<br/>[ClimaRepository.kt]"]
  node_datastore[("DataStoreRepository<br/>local persistence")]
  node_climate_models["Climate state &amp; payloads<br/>models<br/>[ClimaEstado.kt]"]
end

subgraph group_remote["Remote integrations"]
  node_geocoding_api{{"Nominatim API contract<br/>geocoding API"}}
  node_air_api{{"Air-quality API contracts<br/>air-quality APIs"}}
end

subgraph group_background["Background alerts"]
  node_pm_worker["PmCheckerWorker<br/>background worker<br/>[PmCheckerWorker.kt]"]
  node_service["MyService<br/>Android service<br/>[MyService.kt]"]
  node_notifications["NotificationManager<br/>notification boundary"]
end

node_manifest -->|"registers"| node_activity
node_manifest -->|"registers"| node_service
node_activity -->|"uses"| node_layout
node_activity -->|"hosts"| node_location_ui
node_activity -->|"hosts"| node_alert_ui
node_location_ui -->|"UI actions/state"| node_viewmodel
node_alert_ui -->|"UI actions/state"| node_viewmodel
node_viewmodel -->|"retrieves climate data"| node_clima_repo
node_viewmodel -->|"reads/saves state"| node_datastore
node_clima_repo -->|"maps to state"| node_climate_models
node_clima_repo -->|"geocodes location"| node_geocoding_api
node_clima_repo -->|"fetches air quality"| node_air_api
node_pm_worker -->|"checks PM"| node_air_api
node_pm_worker -->|"PM alert"| node_notifications
node_service -.->|"may support ongoing work"| node_pm_worker

click node_manifest "https://github.com/brojass05/ecoalert/blob/main/app/src/main/AndroidManifest.xml"
click node_activity "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/MainActivity.kt"
click node_layout "https://github.com/brojass05/ecoalert/blob/main/app/src/main/res/layout/activity_main.xml"
click node_location_ui "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/presentation/view/UbicacionView.kt"
click node_alert_ui "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/presentation/view/EcoAlertScreen.kt"
click node_viewmodel "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/presentation/viewmodel/UbicacionViewModel.kt"
click node_clima_repo "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/ClimaRepository.kt"
click node_datastore "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/DataStoreRepository.kt"
click node_climate_models "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/model/ClimaEstado.kt"
click node_geocoding_api "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/model/NominatimServicioAPI.kt"
click node_air_api "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/model/ServicioAPICalidadAireCompleta.kt"
click node_pm_worker "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/workers/PmCheckerWorker.kt"
click node_service "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/MyService.kt"
click node_notifications "https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/presentation/ui/notifications/NotificationManager.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_manifest,node_activity,node_layout toneBlue
class node_location_ui,node_alert_ui,node_viewmodel toneAmber
class node_clima_repo,node_datastore,node_climate_models toneMint
class node_geocoding_api,node_air_api toneRose
class node_pm_worker,node_service,node_notifications toneIndigo
```

## Components

### Android app

- [App manifest](https://github.com/brojass05/ecoalert/blob/main/app/src/main/AndroidManifest.xml): Android declaration · Registers Android components. · `app/src/main/AndroidManifest.xml`
- [MainActivity](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/MainActivity.kt): activity · Primary application entry point. · `app/src/main/java/com/example/pruebasubicacion/MainActivity.kt`
- [Activity layout](https://github.com/brojass05/ecoalert/blob/main/app/src/main/res/layout/activity_main.xml): XML layout · `app/src/main/res/layout/activity_main.xml`

### Presentation

- [Location view](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/presentation/view/UbicacionView.kt): screen · `app/src/main/java/com/example/pruebasubicacion/presentation/view/UbicacionView.kt`
- [Eco alert screen](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/presentation/view/EcoAlertScreen.kt): screen · `app/src/main/java/com/example/pruebasubicacion/presentation/view/EcoAlertScreen.kt`
- [UbicacionViewModel](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/presentation/viewmodel/UbicacionViewModel.kt): view model · Coordinates UI actions and location/climate state. · `app/src/main/java/com/example/pruebasubicacion/presentation/viewmodel/UbicacionViewModel.kt`

### Data & state

- [ClimaRepository](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/ClimaRepository.kt): data repository · Central boundary for climate retrieval. · `app/src/main/java/com/example/pruebasubicacion/data/ClimaRepository.kt`
- [DataStoreRepository](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/DataStoreRepository.kt): local persistence · Stores app preferences or state. · `app/src/main/java/com/example/pruebasubicacion/data/DataStoreRepository.kt`
- [Climate state & payloads](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/model/ClimaEstado.kt): models · Application climate state plus climate and geocoding payloads. · `app/src/main/java/com/example/pruebasubicacion/data/model/ClimaEstado.kt`

### Remote integrations

- [Nominatim API contract](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/model/NominatimServicioAPI.kt): geocoding API · `app/src/main/java/com/example/pruebasubicacion/data/model/NominatimServicioAPI.kt`
- [Air-quality API contracts](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/data/model/ServicioAPICalidadAireCompleta.kt): air-quality APIs · Complete and PM-only service contracts. · `app/src/main/java/com/example/pruebasubicacion/data/model/ServicioAPICalidadAireCompleta.kt`

### Background alerts

- [PmCheckerWorker](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/workers/PmCheckerWorker.kt): background worker · Scheduled PM monitoring stage. · `app/src/main/java/com/example/pruebasubicacion/workers/PmCheckerWorker.kt`
- [MyService](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/MyService.kt): Android service · Supports work outside the activity lifecycle. · `app/src/main/java/com/example/pruebasubicacion/MyService.kt`
- [NotificationManager](https://github.com/brojass05/ecoalert/blob/main/app/src/main/java/com/example/pruebasubicacion/presentation/ui/notifications/NotificationManager.kt): notification boundary · Publishes PM alerts through Android notifications. · `app/src/main/java/com/example/pruebasubicacion/presentation/ui/notifications/NotificationManager.kt`

## Connections

- 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
