# orberyx/astrowatch architecture

> Architecture diagram of the GitHub repository orberyx/astrowatch, 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/orberyx/astrowatch
- Repository: https://github.com/orberyx/astrowatch

## Overview

AstroWatch’s visible runtime centers on retrieving NASA near-Earth-object feed data, mapping it into asteroid and close-approach domain objects, and providing persistence and account-authentication components. The README documents no user-facing screens or broader workflows; the application entry point was read but showed no references. The graph therefore preserves the evidenced ingestion, persistence, and authentication pieces without assuming how they are orchestrated. Several DAO and session relationships are based on excerpts or the source index; unsampled behavior is not inferred.

Main entry points: [`src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AsteroideMapper.java`](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AsteroideMapper.java) (Asteroid mapper), [`src/main/java/io/github/orberyx/astrowatch/database/DatabaseConnection.java`](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/database/DatabaseConnection.java) (DB connection), [`src/main/java/io/github/orberyx/astrowatch/nasa/NasaApiService.java`](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/NasaApiService.java) (NASA feed service), [`src/main/java/io/github/orberyx/astrowatch/AuthService.java`](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_nasa["NASA ingestion"]
  node_nasa_service["NASA feed service"]
  node_feed_dto["Feed response"]
  node_asteroid_dto["Asteroid DTO<br/>[AsteroideDto.java]"]
  node_approach_dto["Approach DTO"]
  node_asteroid_mapper["Asteroid mapper"]
  node_approach_mapper["Approach mapper"]
end

subgraph group_domain["Domain models"]
  node_asteroid["Asteroid<br/>[Asteroide.java]"]
  node_approach["Close approach<br/>[Aproximacao.java]"]
end

subgraph group_accounts["Accounts and persistence"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_user_dao["User DAO<br/>[UsuarioDAO.java]"]
  node_user["User<br/>[Usuario.java]"]
  node_session["Session<br/>[sessao.java]"]
  node_asteroid_dao["Asteroid DAO<br/>[AsteroideDAO.java]"]
  node_approach_dao["Approach DAO"]
  node_db_connection["DB connection"]
end

node_nasa_api["NASA API"]
node_database[("AstroWatch database")]

node_nasa_service -->|"requests feed"| node_nasa_api
node_nasa_service -->|"parses JSON"| node_feed_dto
node_feed_dto -->|"contains entries"| node_asteroid_dto
node_nasa_service -->|"maps entries"| node_asteroid_mapper
node_asteroid_mapper -->|"reads fields"| node_asteroid_dto
node_asteroid_mapper -->|"delegates mapping"| node_approach_mapper
node_asteroid_mapper -->|"creates model"| node_asteroid
node_approach_mapper -->|"reads fields"| node_approach_dto
node_approach_mapper -->|"creates model"| node_approach
node_asteroid_dto -->|"contains approaches"| node_approach_dto
node_asteroid -->|"holds approaches"| node_approach
node_auth -->|"checks credentials"| node_user_dao
node_auth -->|"loads account"| node_user
node_auth -->|"starts or ends"| node_session
node_user_dao -->|"opens connection"| node_db_connection
node_asteroid_dao -->|"opens connection"| node_db_connection
node_asteroid_dao -->|"reads or writes"| node_asteroid
node_approach_dao -->|"opens connection"| node_db_connection
node_approach_dao -->|"persists approach"| node_approach
node_db_connection -->|"connects to"| node_database

click node_nasa_service "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/NasaApiService.java"
click node_feed_dto "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/dto/FeedResponseDto.java"
click node_asteroid_dto "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/dto/AsteroideDto.java"
click node_approach_dto "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/dto/AproximacaoDto.java"
click node_asteroid_mapper "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AsteroideMapper.java"
click node_approach_mapper "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AproximacaoMapper.java"
click node_asteroid "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/model/Asteroide.java"
click node_approach "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/model/Aproximacao.java"
click node_auth "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/AuthService.java"
click node_user_dao "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/dao/UsuarioDAO.java"
click node_user "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/Usuario.java"
click node_session "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/sessao.java"
click node_asteroid_dao "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/dao/AsteroideDAO.java"
click node_approach_dao "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/dao/AproximacaoDAO.java"
click node_db_connection "https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/database/DatabaseConnection.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_nasa_service,node_feed_dto,node_asteroid_dto,node_approach_dto,node_asteroid_mapper,node_approach_mapper toneBlue
class node_asteroid,node_approach,node_database toneAmber
class node_auth,node_user_dao,node_user,node_session,node_asteroid_dao,node_approach_dao,node_db_connection,node_nasa_api toneMint
```

## Components

### NASA ingestion

- [NASA feed service](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/NasaApiService.java): `src/main/java/io/github/orberyx/astrowatch/nasa/NasaApiService.java`
- [Feed response](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/dto/FeedResponseDto.java): `src/main/java/io/github/orberyx/astrowatch/nasa/dto/FeedResponseDto.java`
- [Asteroid DTO](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/dto/AsteroideDto.java): `src/main/java/io/github/orberyx/astrowatch/nasa/dto/AsteroideDto.java`
- [Approach DTO](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/dto/AproximacaoDto.java): `src/main/java/io/github/orberyx/astrowatch/nasa/dto/AproximacaoDto.java`
- [Asteroid mapper](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AsteroideMapper.java): `src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AsteroideMapper.java`
- [Approach mapper](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AproximacaoMapper.java): `src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AproximacaoMapper.java`

### Domain models

- [Asteroid](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/model/Asteroide.java): `src/main/java/io/github/orberyx/astrowatch/model/Asteroide.java`
- [Close approach](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/model/Aproximacao.java): `src/main/java/io/github/orberyx/astrowatch/model/Aproximacao.java`

### Accounts and persistence

- [Authentication](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/AuthService.java): `src/main/java/io/github/orberyx/astrowatch/AuthService.java`
- [User DAO](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/dao/UsuarioDAO.java): `src/main/java/io/github/orberyx/astrowatch/dao/UsuarioDAO.java`
- [User](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/Usuario.java): `src/main/java/io/github/orberyx/astrowatch/Usuario.java`
- [Session](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/sessao.java): `src/main/java/io/github/orberyx/astrowatch/sessao.java`
- [Asteroid DAO](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/dao/AsteroideDAO.java): `src/main/java/io/github/orberyx/astrowatch/dao/AsteroideDAO.java`
- [Approach DAO](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/dao/AproximacaoDAO.java): `src/main/java/io/github/orberyx/astrowatch/dao/AproximacaoDAO.java`
- [DB connection](https://github.com/orberyx/astrowatch/blob/main/src/main/java/io/github/orberyx/astrowatch/database/DatabaseConnection.java): `src/main/java/io/github/orberyx/astrowatch/database/DatabaseConnection.java`

### Other components

- **NASA API**
- **AstroWatch database**

## Connections

- NASA feed service → NASA API: requests feed (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/NasaApiService.java`)
- NASA feed service → Feed response: parses JSON (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/NasaApiService.java`)
- Feed response → Asteroid DTO: contains entries (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/dto/FeedResponseDto.java`)
- NASA feed service → Asteroid mapper: maps entries (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/NasaApiService.java`)
- Asteroid mapper → Asteroid DTO: reads fields (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AsteroideMapper.java`)
- Asteroid mapper → Approach mapper: delegates mapping (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AsteroideMapper.java`)
- Asteroid mapper → Asteroid: creates model (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AsteroideMapper.java`)
- Approach mapper → Approach DTO: reads fields (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AproximacaoMapper.java`)
- Approach mapper → Close approach: creates model (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/mapper/AproximacaoMapper.java`)
- Asteroid DTO → Approach DTO: contains approaches (evidence: `src/main/java/io/github/orberyx/astrowatch/nasa/dto/AsteroideDto.java`)
- Asteroid → Close approach: holds approaches (evidence: `src/main/java/io/github/orberyx/astrowatch/model/Asteroide.java`)
- Authentication → User DAO: checks credentials (evidence: `src/main/java/io/github/orberyx/astrowatch/AuthService.java`)
- Authentication → User: loads account (evidence: `src/main/java/io/github/orberyx/astrowatch/AuthService.java`)
- Authentication → Session: starts or ends (evidence: `src/main/java/io/github/orberyx/astrowatch/AuthService.java`)
- User DAO → DB connection: opens connection (evidence: `src/main/java/io/github/orberyx/astrowatch/dao/UsuarioDAO.java`)
- Asteroid DAO → DB connection: opens connection (evidence: `src/main/java/io/github/orberyx/astrowatch/dao/AsteroideDAO.java`)
- Asteroid DAO → Asteroid: reads or writes (evidence: `src/main/java/io/github/orberyx/astrowatch/dao/AsteroideDAO.java`)
- Approach DAO → DB connection: opens connection (evidence: `src/main/java/io/github/orberyx/astrowatch/dao/AproximacaoDAO.java`)
- Approach DAO → Close approach: persists approach (evidence: `src/main/java/io/github/orberyx/astrowatch/dao/AproximacaoDAO.java`)
- DB connection → AstroWatch database: connects to (evidence: `src/main/java/io/github/orberyx/astrowatch/database/DatabaseConnection.java`)
