How sifal2001/nimbuspanel-restful works
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: CoordResponseController.java Location endpoint · WeatherCastController.java Forecast endpoint · UserService.java Account service · UserController.java User endpoints
Components 19
REST API
- Location endpoint
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java - Forecast endpoint
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastController.java - User endpoints
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java
Weather services
- Coordinate service
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseService.java - Coordinate response
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/Coord.java - Forecast service
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastService.java - Forecast model
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast
Accounts
- Account service
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java - User and favourites
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/User.java - Credentials request
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/AuthenticateRequest.java
Persistence and config
- Coordinate repository
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseRepository.java - Forecast repository
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastRepository.java - User repository
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserRepository.java - Favourites repository
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/FavouriteLocationsRepository.java - API key config
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/Config/Config.java - Security config
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/Config/SecurityConfig.java
Other components
- JavaFX client
- OpenWeather API
- PostgreSQL
Connections 20
- JavaFX client → Location endpoint: resolves city
README.md - JavaFX client → Forecast endpoint: requests forecast
README.md - JavaFX client → User endpoints: manages account
README.md - Location endpoint → Coordinate service: delegates
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java - Location endpoint → API key config: reads key
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java - Location endpoint → Coordinate response: returns coordinates
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseController.java - Coordinate service → Coordinate repository: uses repository
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/CoordResponse/CoordResponseService.java - Forecast endpoint → Forecast service: delegates
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastController.java - Forecast endpoint → OpenWeather API: proxies forecast
README.md - Forecast service → Forecast repository: reads forecasts
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/WeatherCast/WeatherCastService.java - Forecast endpoint → API key config: uses API key
README.md - User endpoints → Account service: delegates
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java - User endpoints → Credentials request: accepts credentials
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserController.java - Account service → User repository: queries users
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java - Account service → Favourites repository: saves favourites
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java - Account service → User and favourites: updates records
NimbusPanel/src/main/java/com/NimbusPanel/NimbusPanelService/user/UserService.java - Coordinate repository → PostgreSQL: persists
README.md - Forecast repository → PostgreSQL: persists
README.md - User repository → PostgreSQL: persists
README.md - Favourites repository → PostgreSQL: persists
README.md