# mariolkotsiai/seismowatch architecture

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

- Interactive diagram: https://gitdiagram.com/mariolkotsiai/seismowatch
- Repository: https://github.com/mariolkotsiai/seismowatch

## Overview

SeismoWatch is an Android app that fetches nearby earthquake and other disaster events, estimates their distance and impact relative to the user, then displays a risk-ranked event list. Startup requests location permission; the app uses the last known location when available and falls back to Athens otherwise. The repository excerpt shows the fetch, mapping, scoring, and UI path. The manifest and unsampled response model details are not included, so only explicit source references and visible service configuration are represented.

Main entry points: [`app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt`](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt) (Disaster repository), [`app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListViewModel.kt`](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListViewModel.kt) (Event list state), [`app/src/main/java/com/mariolkotsiai/seismowatch/MainActivity.kt`](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/MainActivity.kt) (Main activity), [`app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListScreen.kt`](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListScreen.kt) (Event list screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_main["Main activity<br/>[MainActivity.kt]"]
end

subgraph group_sources["Disaster sources"]
  node_repository["Disaster repository"]
  node_retrofit["Retrofit clients"]
  node_earthquake_api["Earthquake API"]
  node_eonet_api["NASA EONET API"]
  node_earthquake_response["Earthquake response"]
  node_eonet_response["EONET response"]
end

subgraph group_processing["Event processing"]
  node_calculator["Impact calculator"]
  node_event["Disaster event model<br/>[DisasterEvent.kt]"]
end

subgraph group_interface["Event interface"]
  node_viewmodel["Event list state"]
  node_screen["Event list screen<br/>[EventListScreen.kt]"]
  node_card["Event card<br/>[EventCard.kt]"]
end

node_user(("App user"))
node_location["Location provider"]
node_usgs["USGS service"]
node_nasa["NASA EONET service"]

node_user -->|"opens"| node_main
node_main -->|"creates"| node_viewmodel
node_main -->|"displays"| node_screen
node_main -->|"requests location"| node_location
node_viewmodel -->|"reads last location"| node_location
node_screen -->|"observes state"| node_viewmodel
node_screen -->|"requests retry"| node_viewmodel
node_viewmodel -->|"fetches events"| node_repository
node_repository -->|"gets clients"| node_retrofit
node_retrofit -->|"creates client"| node_earthquake_api
node_retrofit -->|"creates client"| node_eonet_api
node_repository -->|"fetches earthquakes"| node_earthquake_api
node_repository -->|"fetches events"| node_eonet_api
node_earthquake_api -->|"queries"| node_usgs
node_eonet_api -->|"queries"| node_nasa
node_earthquake_api -->|"returns"| node_earthquake_response
node_eonet_api -->|"returns"| node_eonet_response
node_repository -->|"calculates distance and impact"| node_calculator
node_repository -->|"maps and ranks events"| node_event
node_viewmodel -->|"publishes events"| node_event
node_screen -->|"renders events"| node_card
node_card -->|"displays details"| node_event

click node_main "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/MainActivity.kt"
click node_viewmodel "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListViewModel.kt"
click node_screen "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListScreen.kt"
click node_card "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/ui/components/EventCard.kt"
click node_repository "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt"
click node_retrofit "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/RetrofitInstance.kt"
click node_earthquake_api "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/EarthquakeApiService.kt"
click node_eonet_api "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/NasaEonetApiService.kt"
click node_earthquake_response "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/model/EarthquakeResponse.kt"
click node_eonet_response "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/model/NasaEonetResponse.kt"
click node_calculator "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/domain/usecase/ImpactCalculator.kt"
click node_event "https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/domain/model/DisasterEvent.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_main,node_user toneBlue
class node_repository,node_retrofit,node_earthquake_api,node_eonet_api,node_earthquake_response,node_eonet_response toneAmber
class node_calculator,node_event toneMint
class node_viewmodel,node_screen,node_card toneRose
class node_location,node_usgs,node_nasa toneIndigo
```

## Components

### App entry

- [Main activity](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/MainActivity.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/MainActivity.kt`

### Disaster sources

- [Disaster repository](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt`
- [Retrofit clients](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/RetrofitInstance.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/RetrofitInstance.kt`
- [Earthquake API](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/EarthquakeApiService.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/EarthquakeApiService.kt`
- [NASA EONET API](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/NasaEonetApiService.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/NasaEonetApiService.kt`
- [Earthquake response](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/model/EarthquakeResponse.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/model/EarthquakeResponse.kt`
- [EONET response](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/model/NasaEonetResponse.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/model/NasaEonetResponse.kt`

### Event processing

- [Impact calculator](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/domain/usecase/ImpactCalculator.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/domain/usecase/ImpactCalculator.kt`
- [Disaster event model](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/domain/model/DisasterEvent.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/domain/model/DisasterEvent.kt`

### Event interface

- [Event list state](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListViewModel.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListViewModel.kt`
- [Event list screen](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListScreen.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListScreen.kt`
- [Event card](https://github.com/mariolkotsiai/seismowatch/blob/main/app/src/main/java/com/mariolkotsiai/seismowatch/ui/components/EventCard.kt): `app/src/main/java/com/mariolkotsiai/seismowatch/ui/components/EventCard.kt`

### Other components

- **App user**
- **Location provider**
- **USGS service**
- **NASA EONET service**

## Connections

- App user → Main activity: opens (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/MainActivity.kt`)
- Main activity → Event list state: creates (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/MainActivity.kt`)
- Main activity → Event list screen: displays (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/MainActivity.kt`)
- Main activity → Location provider: requests location (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/MainActivity.kt`)
- Event list state → Location provider: reads last location (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListViewModel.kt`)
- Event list screen → Event list state: observes state (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListScreen.kt`)
- Event list screen → Event list state: requests retry (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListScreen.kt`)
- Event list state → Disaster repository: fetches events (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListViewModel.kt`)
- Disaster repository → Retrofit clients: gets clients (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt`)
- Retrofit clients → Earthquake API: creates client (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/RetrofitInstance.kt`)
- Retrofit clients → NASA EONET API: creates client (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/RetrofitInstance.kt`)
- Disaster repository → Earthquake API: fetches earthquakes (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt`)
- Disaster repository → NASA EONET API: fetches events (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt`)
- Earthquake API → USGS service: queries (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/EarthquakeApiService.kt`)
- NASA EONET API → NASA EONET service: queries (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/NasaEonetApiService.kt`)
- Earthquake API → Earthquake response: returns (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/EarthquakeApiService.kt`)
- NASA EONET API → EONET response: returns (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/remote/api/NasaEonetApiService.kt`)
- Disaster repository → Impact calculator: calculates distance and impact (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt`)
- Disaster repository → Disaster event model: maps and ranks events (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/data/repository/DisasterRepository.kt`)
- Event list state → Disaster event model: publishes events (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListViewModel.kt`)
- Event list screen → Event card: renders events (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/ui/screens/eventlist/EventListScreen.kt`)
- Event card → Disaster event model: displays details (evidence: `app/src/main/java/com/mariolkotsiai/seismowatch/ui/components/EventCard.kt`)
