# yeregd/gamehub architecture

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

- Interactive diagram: https://gitdiagram.com/yeregd/gamehub
- Repository: https://github.com/yeregd/gamehub

## Overview

Gamehub is a Spring REST service for creating, listing, retrieving, updating, and deleting games. HTTP requests enter through the game controller, which converts request/response data and delegates operations to the service; the service validates identifiers and invokes the repository abstraction. The shown PostgreSQL adapter maps domain games to JPA entities and delegates persistence to Spring Data. Request validation and global exception handling are also present. The excerpts do not show application configuration or repository selection, so database wiring and any alternate in-memory implementation are not inferred.

Main entry points: [`src/main/java/com/Yere/Gamehub/controller/GameController.java`](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/controller/GameController.java) (Game Controller), [`src/main/java/com/Yere/Gamehub/mapper/GameMapper.java`](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/mapper/GameMapper.java) (API Mapper), [`src/main/java/com/Yere/Gamehub/service/GameService.java`](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/service/GameService.java) (Game Service), [`src/main/java/com/Yere/Gamehub/mapper/GameEntityMapper.java`](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/mapper/GameEntityMapper.java) (Entity Mapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_controller["Game Controller"]
  node_requests["Request DTOs"]
  node_responses["Game Response<br/>[GameResponse.java]"]
  node_api_mapper["API Mapper<br/>[GameMapper.java]"]
end

subgraph group_domain["Game Domain"]
  node_service["Game Service<br/>[GameService.java]"]
  node_game["Game Model<br/>[Game.java]"]
end

subgraph group_persistence["Persistence"]
  node_repository_contract["Repository Contract"]
  node_postgres_adapter["Postgres Adapter"]
  node_entity_mapper["Entity Mapper"]
  node_game_entity["Game Entity<br/>[GameEntity.java]"]
  node_jpa_repository["JPA Repository"]
end

subgraph group_errors["Error Handling"]
  node_exceptions["Domain Exceptions"]
  node_exception_handler["Global Handler"]
end

node_client(("API Client"))
node_database[("PostgreSQL Database")]

node_client -->|"sends requests"| node_controller
node_controller -->|"accepts"| node_requests
node_controller -->|"maps data"| node_api_mapper
node_api_mapper -->|"reads fields"| node_requests
node_api_mapper -->|"creates"| node_game
node_api_mapper -->|"builds"| node_responses
node_controller -->|"delegates operations"| node_service
node_service -->|"calls"| node_repository_contract
node_service -->|"validates and returns"| node_game
node_service -->|"raises"| node_exceptions
node_postgres_adapter -->|"delegates persistence"| node_jpa_repository
node_postgres_adapter -->|"maps entities"| node_entity_mapper
node_entity_mapper -->|"converts"| node_game
node_entity_mapper -->|"converts"| node_game_entity
node_jpa_repository -->|"persists"| node_game_entity
node_jpa_repository -.->|"accesses"| node_database
node_exception_handler -->|"handles"| node_exceptions

click node_controller "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/controller/GameController.java"
click node_requests "https://github.com/yeregd/gamehub/tree/main/src/main/java/com/Yere/Gamehub/dto"
click node_responses "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/dto/GameResponse.java"
click node_api_mapper "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/mapper/GameMapper.java"
click node_service "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/service/GameService.java"
click node_game "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/model/Game.java"
click node_repository_contract "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/repository/Gamerepository.java"
click node_postgres_adapter "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/repository/PostgresGameRepository.java"
click node_entity_mapper "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/mapper/GameEntityMapper.java"
click node_game_entity "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/model/GameEntity.java"
click node_jpa_repository "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/repository/jpa/JpaGameRepository.java"
click node_exceptions "https://github.com/yeregd/gamehub/tree/main/src/main/java/com/Yere/Gamehub/exception"
click node_exception_handler "https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/exception/GlobalExceptionHandler.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_requests,node_responses,node_api_mapper,node_client toneBlue
class node_service,node_game,node_database toneAmber
class node_repository_contract,node_postgres_adapter,node_entity_mapper,node_game_entity,node_jpa_repository toneMint
class node_exceptions,node_exception_handler toneRose
```

## Components

### REST API

- [Game Controller](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/controller/GameController.java): `src/main/java/com/Yere/Gamehub/controller/GameController.java`
- [Request DTOs](https://github.com/yeregd/gamehub/tree/main/src/main/java/com/Yere/Gamehub/dto): `src/main/java/com/Yere/Gamehub/dto`
- [Game Response](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/dto/GameResponse.java): `src/main/java/com/Yere/Gamehub/dto/GameResponse.java`
- [API Mapper](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/mapper/GameMapper.java): `src/main/java/com/Yere/Gamehub/mapper/GameMapper.java`

### Game Domain

- [Game Service](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/service/GameService.java): `src/main/java/com/Yere/Gamehub/service/GameService.java`
- [Game Model](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/model/Game.java): `src/main/java/com/Yere/Gamehub/model/Game.java`

### Persistence

- [Repository Contract](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/repository/Gamerepository.java): `src/main/java/com/Yere/Gamehub/repository/Gamerepository.java`
- [Postgres Adapter](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/repository/PostgresGameRepository.java): `src/main/java/com/Yere/Gamehub/repository/PostgresGameRepository.java`
- [Entity Mapper](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/mapper/GameEntityMapper.java): `src/main/java/com/Yere/Gamehub/mapper/GameEntityMapper.java`
- [Game Entity](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/model/GameEntity.java): `src/main/java/com/Yere/Gamehub/model/GameEntity.java`
- [JPA Repository](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/repository/jpa/JpaGameRepository.java): `src/main/java/com/Yere/Gamehub/repository/jpa/JpaGameRepository.java`

### Error Handling

- [Domain Exceptions](https://github.com/yeregd/gamehub/tree/main/src/main/java/com/Yere/Gamehub/exception): `src/main/java/com/Yere/Gamehub/exception`
- [Global Handler](https://github.com/yeregd/gamehub/blob/main/src/main/java/com/Yere/Gamehub/exception/GlobalExceptionHandler.java): `src/main/java/com/Yere/Gamehub/exception/GlobalExceptionHandler.java`

### Other components

- **API Client**
- **PostgreSQL Database**

## Connections

- API Client → Game Controller: sends requests (evidence: `src/main/java/com/Yere/Gamehub/controller/GameController.java`)
- Game Controller → Request DTOs: accepts (evidence: `src/main/java/com/Yere/Gamehub/controller/GameController.java`)
- Game Controller → API Mapper: maps data (evidence: `src/main/java/com/Yere/Gamehub/controller/GameController.java`)
- API Mapper → Request DTOs: reads fields (evidence: `src/main/java/com/Yere/Gamehub/mapper/GameMapper.java`)
- API Mapper → Game Model: creates (evidence: `src/main/java/com/Yere/Gamehub/mapper/GameMapper.java`)
- API Mapper → Game Response: builds (evidence: `src/main/java/com/Yere/Gamehub/mapper/GameMapper.java`)
- Game Controller → Game Service: delegates operations (evidence: `src/main/java/com/Yere/Gamehub/controller/GameController.java`)
- Game Service → Repository Contract: calls (evidence: `src/main/java/com/Yere/Gamehub/service/GameService.java`)
- Game Service → Game Model: validates and returns (evidence: `src/main/java/com/Yere/Gamehub/service/GameService.java`)
- Game Service → Domain Exceptions: raises (evidence: `src/main/java/com/Yere/Gamehub/service/GameService.java`)
- Postgres Adapter → JPA Repository: delegates persistence (evidence: `src/main/java/com/Yere/Gamehub/repository/PostgresGameRepository.java`)
- Postgres Adapter → Entity Mapper: maps entities (evidence: `src/main/java/com/Yere/Gamehub/repository/PostgresGameRepository.java`)
- Entity Mapper → Game Model: converts (evidence: `src/main/java/com/Yere/Gamehub/mapper/GameEntityMapper.java`)
- Entity Mapper → Game Entity: converts (evidence: `src/main/java/com/Yere/Gamehub/mapper/GameEntityMapper.java`)
- JPA Repository → Game Entity: persists (evidence: `src/main/java/com/Yere/Gamehub/repository/jpa/JpaGameRepository.java`)
- JPA Repository → PostgreSQL Database: accesses
- Global Handler → Domain Exceptions: handles (evidence: `src/main/java/com/Yere/Gamehub/exception/GlobalExceptionHandler.java`)
