# aurel-2/meteosphere architecture

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

- Interactive diagram: https://gitdiagram.com/aurel-2/meteosphere
- Repository: https://github.com/aurel-2/meteosphere

## Overview

Météo Sphère is a French-weather visualization and analysis product spanning an Angular client, Spring API, Python ingestion pipelines, and temperature-prediction scripts. The user-facing flow is to explore regional, station, daily, monthly, and real-time weather views; authenticate for account and favorite features; and request predictions or exports. The ETL orchestrator coordinates extraction, transformation, and database loading. README documents the ML training/deployment purpose and monitoring infrastructure, but the supplied tree has no infrastructure source files. Several API and web feature implementations were not sampled, so their links are shown only where documented or supported by the index.

Main entry points: [`etl/pipelines/orchestrator.py`](https://github.com/aurel-2/meteosphere/blob/main/etl/pipelines/orchestrator.py) (Pipeline orchestrator), [`api/src/main/java/fr/meteosphere/api/Application.java`](https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/Application.java) (Spring API), [`api/src/main/java/fr/meteosphere/api/controller`](https://github.com/aurel-2/meteosphere/tree/main/api/src/main/java/fr/meteosphere/api/controller) (Other API domains), [`web/src/app/app.ts`](https://github.com/aurel-2/meteosphere/blob/main/web/src/app/app.ts) (Angular application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["Angular application<br/>[app.ts]"]
  node_routes["Feature routes<br/>[app.routes.ts]"]
  node_webweather["Weather views"]
  node_webauth["Auth client<br/>[auth.service.ts]"]
end

subgraph group_api["Weather API"]
  node_apiapp["Spring API<br/>[Application.java]"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_monthlycontroller["Monthly endpoints"]
  node_monthlyservice["Monthly analytics"]
  node_monthlyrepo["Monthly queries"]
  node_monthlydata["Monthly observations"]
  node_otherapi["Other API domains"]
  node_export["CSV export"]
end

subgraph group_etl["Data ingestion"]
  node_etlapi["ETL trigger API"]
  node_orchestrator["Pipeline orchestrator<br/>[orchestrator.py]"]
  node_extract["Weather extractors"]
  node_transform["Weather transformers"]
  node_loader["Database loader<br/>[data_loader.py]"]
end

subgraph group_ml["Temperature prediction"]
  node_mltrain["Model training<br/>[training.py]"]
  node_mldeploy["Prediction deployment<br/>[deploy.py]"]
end

node_visitor(("Weather user"))
node_db[("PostgreSQL")]
node_monitor["Monitoring stack"]

node_visitor -->|"explores weather"| node_webapp
node_webapp -->|"renders routes"| node_routes
node_routes -->|"loads views"| node_webweather
node_webweather -.->|"requests data"| node_apiapp
node_webauth -.->|"authenticates via HTTP"| node_apiapp
node_apiapp -.->|"serves endpoints"| node_monthlycontroller
node_monthlycontroller -->|"requests analytics"| node_monthlyservice
node_monthlyservice -->|"queries observations"| node_monthlyrepo
node_monthlyrepo -->|"queries entities"| node_monthlydata
node_otherapi -.->|"handles sign-in"| node_auth
node_otherapi -.->|"offers exports"| node_export
node_export -->|"reads observations"| node_db
node_etlapi -->|"starts pipelines"| node_orchestrator
node_orchestrator -->|"runs extraction"| node_extract
node_orchestrator -->|"runs transformation"| node_transform
node_orchestrator -->|"loads datasets"| node_loader
node_loader -->|"writes datasets"| node_db
node_mltrain -.->|"produces model"| node_mldeploy
node_mldeploy -->|"stores predictions"| node_db
node_monitor -->|"scrapes metrics"| node_apiapp
node_monitor -->|"scrapes metrics"| node_db
node_monitor -->|"collects logs"| node_etlapi

click node_webapp "https://github.com/aurel-2/meteosphere/blob/main/web/src/app/app.ts"
click node_routes "https://github.com/aurel-2/meteosphere/blob/main/web/src/app/app.routes.ts"
click node_webweather "https://github.com/aurel-2/meteosphere/tree/main/web/src/app/features"
click node_webauth "https://github.com/aurel-2/meteosphere/blob/main/web/src/app/core/services/auth.service.ts"
click node_apiapp "https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/Application.java"
click node_auth "https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/service/AuthService.java"
click node_monthlycontroller "https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/controller/observation/monthly/RegionObsMonthlyController.java"
click node_monthlyservice "https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/service/ObservationMonthlyService.java"
click node_monthlyrepo "https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/repository/ObservationMonthlyRepository.java"
click node_monthlydata "https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/model/entity/ObservationMonthly.java"
click node_otherapi "https://github.com/aurel-2/meteosphere/tree/main/api/src/main/java/fr/meteosphere/api/controller"
click node_export "https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/service/ObsExportService.java"
click node_etlapi "https://github.com/aurel-2/meteosphere/blob/main/etl/api/routes/historical_router.py"
click node_orchestrator "https://github.com/aurel-2/meteosphere/blob/main/etl/pipelines/orchestrator.py"
click node_extract "https://github.com/aurel-2/meteosphere/tree/main/etl/pipelines/extractors"
click node_transform "https://github.com/aurel-2/meteosphere/tree/main/etl/pipelines/transformers"
click node_loader "https://github.com/aurel-2/meteosphere/blob/main/etl/pipelines/loaders/data_loader.py"
click node_mltrain "https://github.com/aurel-2/meteosphere/blob/main/ml/scripts/training.py"
click node_mldeploy "https://github.com/aurel-2/meteosphere/blob/main/ml/scripts/deploy.py"

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_webapp,node_routes,node_webweather,node_webauth,node_visitor toneBlue
class node_apiapp,node_auth,node_monthlycontroller,node_monthlyservice,node_monthlyrepo,node_monthlydata,node_otherapi,node_export,node_db toneAmber
class node_etlapi,node_orchestrator,node_extract,node_transform,node_loader toneMint
class node_mltrain,node_mldeploy toneRose
class node_monitor toneIndigo
```

## Components

### Web experience

- [Angular application](https://github.com/aurel-2/meteosphere/blob/main/web/src/app/app.ts): `web/src/app/app.ts`
- [Feature routes](https://github.com/aurel-2/meteosphere/blob/main/web/src/app/app.routes.ts): `web/src/app/app.routes.ts`
- [Weather views](https://github.com/aurel-2/meteosphere/tree/main/web/src/app/features): `web/src/app/features`
- [Auth client](https://github.com/aurel-2/meteosphere/blob/main/web/src/app/core/services/auth.service.ts): `web/src/app/core/services/auth.service.ts`

### Weather API

- [Spring API](https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/Application.java): `api/src/main/java/fr/meteosphere/api/Application.java`
- [Authentication](https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/service/AuthService.java): `api/src/main/java/fr/meteosphere/api/service/AuthService.java`
- [Monthly endpoints](https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/controller/observation/monthly/RegionObsMonthlyController.java): `api/src/main/java/fr/meteosphere/api/controller/observation/monthly/RegionObsMonthlyController.java`
- [Monthly analytics](https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/service/ObservationMonthlyService.java): `api/src/main/java/fr/meteosphere/api/service/ObservationMonthlyService.java`
- [Monthly queries](https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/repository/ObservationMonthlyRepository.java): `api/src/main/java/fr/meteosphere/api/repository/ObservationMonthlyRepository.java`
- [Monthly observations](https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/model/entity/ObservationMonthly.java): `api/src/main/java/fr/meteosphere/api/model/entity/ObservationMonthly.java`
- [Other API domains](https://github.com/aurel-2/meteosphere/tree/main/api/src/main/java/fr/meteosphere/api/controller): `api/src/main/java/fr/meteosphere/api/controller`
- [CSV export](https://github.com/aurel-2/meteosphere/blob/main/api/src/main/java/fr/meteosphere/api/service/ObsExportService.java): `api/src/main/java/fr/meteosphere/api/service/ObsExportService.java`

### Data ingestion

- [ETL trigger API](https://github.com/aurel-2/meteosphere/blob/main/etl/api/routes/historical_router.py): `etl/api/routes/historical_router.py`
- [Pipeline orchestrator](https://github.com/aurel-2/meteosphere/blob/main/etl/pipelines/orchestrator.py): `etl/pipelines/orchestrator.py`
- [Weather extractors](https://github.com/aurel-2/meteosphere/tree/main/etl/pipelines/extractors): `etl/pipelines/extractors`
- [Weather transformers](https://github.com/aurel-2/meteosphere/tree/main/etl/pipelines/transformers): `etl/pipelines/transformers`
- [Database loader](https://github.com/aurel-2/meteosphere/blob/main/etl/pipelines/loaders/data_loader.py): `etl/pipelines/loaders/data_loader.py`

### Temperature prediction

- [Model training](https://github.com/aurel-2/meteosphere/blob/main/ml/scripts/training.py): `ml/scripts/training.py`
- [Prediction deployment](https://github.com/aurel-2/meteosphere/blob/main/ml/scripts/deploy.py): `ml/scripts/deploy.py`

### Other components

- **Weather user**
- **PostgreSQL**
- **Monitoring stack**

## Connections

- Weather user → Angular application: explores weather (evidence: `README.md`)
- Angular application → Feature routes: renders routes (evidence: `web/src/app/app.ts`)
- Feature routes → Weather views: loads views (evidence: `web/src/app/app.routes.ts`)
- Weather views → Spring API: requests data
- Auth client → Spring API: authenticates via HTTP
- Spring API → Monthly endpoints: serves endpoints
- Monthly endpoints → Monthly analytics: requests analytics (evidence: `api/src/main/java/fr/meteosphere/api/controller/observation/monthly/RegionObsMonthlyController.java`)
- Monthly analytics → Monthly queries: queries observations (evidence: `api/src/main/java/fr/meteosphere/api/service/ObservationMonthlyService.java`)
- Monthly queries → Monthly observations: queries entities (evidence: `api/src/main/java/fr/meteosphere/api/repository/ObservationMonthlyRepository.java`)
- Other API domains → Authentication: handles sign-in
- Other API domains → CSV export: offers exports (evidence: `api/src/main/java/fr/meteosphere/api/controller/observation/ObsExportController.java`)
- CSV export → PostgreSQL: reads observations (evidence: `api/src/main/java/fr/meteosphere/api/service/ObsExportService.java`)
- ETL trigger API → Pipeline orchestrator: starts pipelines (evidence: `etl/api/routes/historical_router.py`)
- Pipeline orchestrator → Weather extractors: runs extraction (evidence: `etl/pipelines/orchestrator.py`)
- Pipeline orchestrator → Weather transformers: runs transformation (evidence: `etl/pipelines/orchestrator.py`)
- Pipeline orchestrator → Database loader: loads datasets (evidence: `etl/pipelines/orchestrator.py`)
- Database loader → PostgreSQL: writes datasets (evidence: `README.md`)
- Model training → Prediction deployment: produces model (evidence: `README.md`)
- Prediction deployment → PostgreSQL: stores predictions (evidence: `README.md`)
- Monitoring stack → Spring API: scrapes metrics (evidence: `README.md`)
- Monitoring stack → PostgreSQL: scrapes metrics (evidence: `README.md`)
- Monitoring stack → ETL trigger API: collects logs (evidence: `README.md`)
