# sifal2001/nimbuspanel-restful architecture

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

- Interactive diagram: https://gitdiagram.com/sifal2001/nimbuspanel-restful
- Repository: https://github.com/sifal2001/nimbuspanel-restful

## Overview

NimbusPanel is the Spring Boot/PostgreSQL backend half of a weather application; the JavaFX client is described in the README but is not present in this repository. The documented search flow resolves a city to coordinates, requests a forecast, and returns data for the client to render. Account creation/authentication and per-user favourites form a separate branch. The README documents the OpenWeather proxy and PostgreSQL persistence; source excerpts show service/repository wiring, but do not expose the forecast HTTP implementation. The client and upstream interactions are therefore represented only where documented.

Main entry points: [`NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java`](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java) (Location endpoint), [`NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastController.java`](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastController.java) (Forecast endpoint), [`NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java`](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java) (Account service), [`NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java`](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java) (User endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_coord_api["Location endpoint"]
  node_forecast_api["Forecast endpoint"]
  node_user_api["User endpoints"]
end

subgraph group_weather["Weather services"]
  node_coord_service["Coordinate service"]
  node_coord_data["Coordinate response<br/>[Coord.java]"]
  node_forecast_service["Forecast service"]
  node_forecast_model["Forecast model"]
end

subgraph group_accounts["Accounts"]
  node_account_service["Account service<br/>[UserService.java]"]
  node_user_model["User and favourites<br/>[User.java]"]
  node_auth_request["Credentials request"]
end

subgraph group_data["Persistence and config"]
  node_coord_repository["Coordinate repository"]
  node_forecast_repository["Forecast repository"]
  node_user_repository["User repository"]
  node_favourites_repository["Favourites repository"]
  node_api_config["API key config<br/>[Config.java]"]
  node_security_config["Security config"]
end

node_client(("JavaFX client"))
node_openweather{{"OpenWeather API"}}
node_postgres[("PostgreSQL")]

node_client -->|"resolves city"| node_coord_api
node_client -->|"requests forecast"| node_forecast_api
node_client -->|"manages account"| node_user_api
node_coord_api -->|"delegates"| node_coord_service
node_coord_api -->|"reads key"| node_api_config
node_coord_api -->|"returns coordinates"| node_coord_data
node_coord_service -->|"uses repository"| node_coord_repository
node_forecast_api -->|"delegates"| node_forecast_service
node_forecast_api -.->|"proxies forecast"| node_openweather
node_forecast_service -->|"reads forecasts"| node_forecast_repository
node_forecast_api -.->|"uses API key"| node_api_config
node_user_api -->|"delegates"| node_account_service
node_user_api -->|"accepts credentials"| node_auth_request
node_account_service -->|"queries users"| node_user_repository
node_account_service -->|"saves favourites"| node_favourites_repository
node_account_service -->|"updates records"| node_user_model
node_coord_repository -.->|"persists"| node_postgres
node_forecast_repository -->|"persists"| node_postgres
node_user_repository -->|"persists"| node_postgres
node_favourites_repository -->|"persists"| node_postgres

click node_coord_api "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java"
click node_forecast_api "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastController.java"
click node_user_api "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java"
click node_coord_service "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseService.java"
click node_coord_data "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/Coord.java"
click node_forecast_service "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastService.java"
click node_forecast_model "https://github.com/sifal2001/nimbuspanel-restful/tree/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast"
click node_account_service "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java"
click node_user_model "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/User.java"
click node_auth_request "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/AuthenticateRequest.java"
click node_coord_repository "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseRepository.java"
click node_forecast_repository "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastRepository.java"
click node_user_repository "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserRepository.java"
click node_favourites_repository "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/FavouriteLocationsRepository.java"
click node_api_config "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/Config/Config.java"
click node_security_config "https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/Config/SecurityConfig.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_coord_api,node_forecast_api,node_user_api,node_client toneBlue
class node_coord_service,node_coord_data,node_forecast_service,node_forecast_model,node_postgres toneAmber
class node_account_service,node_user_model,node_auth_request,node_openweather toneMint
class node_coord_repository,node_forecast_repository,node_user_repository,node_favourites_repository,node_api_config,node_security_config toneRose
```

## Components

### REST API

- [Location endpoint](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java`
- [Forecast endpoint](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastController.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastController.java`
- [User endpoints](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java`

### Weather services

- [Coordinate service](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseService.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseService.java`
- [Coordinate response](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/Coord.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/Coord.java`
- [Forecast service](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastService.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastService.java`
- [Forecast model](https://github.com/sifal2001/nimbuspanel-restful/tree/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast`

### Accounts

- [Account service](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java`
- [User and favourites](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/User.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/User.java`
- [Credentials request](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/AuthenticateRequest.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/AuthenticateRequest.java`

### Persistence and config

- [Coordinate repository](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseRepository.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseRepository.java`
- [Forecast repository](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastRepository.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastRepository.java`
- [User repository](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserRepository.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserRepository.java`
- [Favourites repository](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/FavouriteLocationsRepository.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/FavouriteLocationsRepository.java`
- [API key config](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/Config/Config.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/Config/Config.java`
- [Security config](https://github.com/sifal2001/nimbuspanel-restful/blob/master/NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/Config/SecurityConfig.java): `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/Config/SecurityConfig.java`

### Other components

- **JavaFX client**
- **OpenWeather API**
- **PostgreSQL**

## Connections

- JavaFX client → Location endpoint: resolves city (evidence: `README.md`)
- JavaFX client → Forecast endpoint: requests forecast (evidence: `README.md`)
- JavaFX client → User endpoints: manages account (evidence: `README.md`)
- Location endpoint → Coordinate service: delegates (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java`)
- Location endpoint → API key config: reads key (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java`)
- Location endpoint → Coordinate response: returns coordinates (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java`)
- Coordinate service → Coordinate repository: uses repository (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseService.java`)
- Forecast endpoint → Forecast service: delegates (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastController.java`)
- Forecast endpoint → OpenWeather API: proxies forecast (evidence: `README.md`)
- Forecast service → Forecast repository: reads forecasts (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastService.java`)
- Forecast endpoint → API key config: uses API key (evidence: `README.md`)
- User endpoints → Account service: delegates (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java`)
- User endpoints → Credentials request: accepts credentials (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java`)
- Account service → User repository: queries users (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java`)
- Account service → Favourites repository: saves favourites (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java`)
- Account service → User and favourites: updates records (evidence: `NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java`)
- Coordinate repository → PostgreSQL: persists (evidence: `README.md`)
- Forecast repository → PostgreSQL: persists (evidence: `README.md`)
- User repository → PostgreSQL: persists (evidence: `README.md`)
- Favourites repository → PostgreSQL: persists (evidence: `README.md`)
