# jazjmjk/sshweatherapp architecture

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

- Interactive diagram: https://gitdiagram.com/jazjmjk/sshweatherapp
- Repository: https://github.com/jazjmjk/sshweatherapp

## Overview

This Spring Boot weather application presents station observations and exposes weather-data endpoints. The main workflow is a browser request handled by WeatherController, which delegates station discovery or latest/range retrieval to SshService; the service reads remote station files over SSH and produces weather records for the response or dashboard model. The controller also contains station statistics and health-check behavior. The excerpts establish these service/model relationships, but do not show the exact view mapping or SSH host configuration, so those links are omitted or marked unverified.

Main entry points: [`src/main/java/com/data/sshweatherapp/controller/WeatherController.java`](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/controller/WeatherController.java) (Weather controller), [`src/main/java/com/data/sshweatherapp/service/SshService.java`](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/service/SshService.java) (SSH weather service), [`src/main/java/com/data/sshweatherapp/model/WeatherData.java`](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/model/WeatherData.java) (Weather records), [`src/main/java/com/data/sshweatherapp/model/Estacion.java`](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/model/Estacion.java) (Station metadata)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_controller["Weather controller"]
  node_template["Weather dashboard<br/>[principal.html]"]
  node_application["Spring Boot entry"]
end

subgraph group_weather["Weather domain"]
  node_weather_data["Weather records<br/>[WeatherData.java]"]
  node_station["Station metadata<br/>[Estacion.java]"]
end

subgraph group_access["Remote data access"]
  node_service["SSH weather service<br/>[SshService.java]"]
  node_remote_files[("Remote station files")]
end

node_visitor(("Browser user"))

node_visitor -->|"requests weather"| node_controller
node_controller -->|"requests data"| node_service
node_service -->|"reads via SSH"| node_remote_files
node_service -->|"creates records"| node_weather_data
node_service -->|"builds metadata"| node_station
node_controller -->|"uses records"| node_weather_data
node_controller -->|"uses station data"| node_station
node_controller -.->|"may render"| node_template

click node_controller "https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/controller/WeatherController.java"
click node_template "https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/resources/templates/principal.html"
click node_service "https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/service/SshService.java"
click node_weather_data "https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/model/WeatherData.java"
click node_station "https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/model/Estacion.java"
click node_application "https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/SshWeatherAppApplication.java"

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_controller,node_template,node_application,node_visitor toneBlue
class node_weather_data,node_station toneAmber
class node_service,node_remote_files toneMint
```

## Components

### Web interface

- [Weather controller](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/controller/WeatherController.java): `src/main/java/com/data/sshweatherapp/controller/WeatherController.java`
- [Weather dashboard](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/resources/templates/principal.html): `src/main/resources/templates/principal.html`
- [Spring Boot entry](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/SshWeatherAppApplication.java): `src/main/java/com/data/sshweatherapp/SshWeatherAppApplication.java`

### Weather domain

- [Weather records](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/model/WeatherData.java): `src/main/java/com/data/sshweatherapp/model/WeatherData.java`
- [Station metadata](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/model/Estacion.java): `src/main/java/com/data/sshweatherapp/model/Estacion.java`

### Remote data access

- [SSH weather service](https://github.com/jazjmjk/sshweatherapp/blob/main/src/main/java/com/data/sshweatherapp/service/SshService.java): `src/main/java/com/data/sshweatherapp/service/SshService.java`
- **Remote station files**

### Other components

- **Browser user**

## Connections

- Browser user → Weather controller: requests weather (evidence: `src/main/java/com/data/sshweatherapp/controller/WeatherController.java`)
- Weather controller → SSH weather service: requests data (evidence: `src/main/java/com/data/sshweatherapp/controller/WeatherController.java`)
- SSH weather service → Remote station files: reads via SSH (evidence: `src/main/java/com/data/sshweatherapp/service/SshService.java`)
- SSH weather service → Weather records: creates records (evidence: `src/main/java/com/data/sshweatherapp/service/SshService.java`)
- SSH weather service → Station metadata: builds metadata (evidence: `src/main/java/com/data/sshweatherapp/service/SshService.java`)
- Weather controller → Weather records: uses records (evidence: `src/main/java/com/data/sshweatherapp/controller/WeatherController.java`)
- Weather controller → Station metadata: uses station data (evidence: `src/main/java/com/data/sshweatherapp/controller/WeatherController.java`)
- Weather controller → Weather dashboard: may render
