# pdiiazz/goldenpong-backend architecture

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

- Interactive diagram: https://gitdiagram.com/pdiiazz/goldenpong-backend
- Repository: https://github.com/pdiiazz/goldenpong-backend

## Overview

Goldenpong is a Spring Boot player-management API. Its principal workflow accepts player requests, handles create/read/update/delete operations through a controller and service, and persists player records in a local JSON file. The model carries player identity and statistics; response DTOs expose selected fields. The excerpts show the controller, service, model, and repository behavior, but not Spring’s runtime component wiring, so that link is left unasserted.

Main entry points: [`src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java`](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java) (Player Controller), [`src/main/java/es/goldenpong/goldenpong/repositories/PlayerJsonRepository.java`](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/repositories/PlayerJsonRepository.java) (Player Repository), [`src/main/java/es/goldenpong/goldenpong/services/PlayerService.java`](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/services/PlayerService.java) (Player Service), [`src/main/java/es/goldenpong/goldenpong/models/Player.java`](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/models/Player.java) (Player Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_controller["Player Controller"]
  node_request["Player Request<br/>[PlayerRequest.java]"]
  node_response["Player Response"]
end

subgraph group_domain["Player Domain"]
  node_service["Player Service<br/>[PlayerService.java]"]
  node_player["Player Model<br/>[Player.java]"]
end

subgraph group_persistence["JSON Persistence"]
  node_repository["Player Repository"]
  node_playerfile[("players.json")]
end

subgraph group_runtime["Application Runtime"]
  node_application["Spring Boot App"]
end

node_client(("API Client"))

node_client -->|"sends HTTP"| node_controller
node_controller -->|"accepts body"| node_request
node_controller -->|"invokes"| node_service
node_controller -->|"creates and maps"| node_player
node_controller -->|"returns"| node_response
node_service -->|"delegates CRUD"| node_repository
node_repository -->|"loads and stores"| node_player
node_repository -->|"reads and writes"| node_playerfile

click node_application "https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/GoldenpongApplication.java"
click node_controller "https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java"
click node_request "https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/http/requests/PlayerRequest.java"
click node_response "https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/http/responses/PlayerResponse.java"
click node_service "https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/services/PlayerService.java"
click node_player "https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/models/Player.java"
click node_repository "https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/repositories/PlayerJsonRepository.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_request,node_response,node_client toneBlue
class node_service,node_player toneAmber
class node_repository,node_playerfile toneMint
class node_application toneRose
```

## Components

### HTTP API

- [Player Controller](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java): `src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java`
- [Player Request](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/http/requests/PlayerRequest.java): `src/main/java/es/goldenpong/goldenpong/http/requests/PlayerRequest.java`
- [Player Response](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/http/responses/PlayerResponse.java): `src/main/java/es/goldenpong/goldenpong/http/responses/PlayerResponse.java`

### Player Domain

- [Player Service](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/services/PlayerService.java): `src/main/java/es/goldenpong/goldenpong/services/PlayerService.java`
- [Player Model](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/models/Player.java): `src/main/java/es/goldenpong/goldenpong/models/Player.java`

### JSON Persistence

- [Player Repository](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/repositories/PlayerJsonRepository.java): `src/main/java/es/goldenpong/goldenpong/repositories/PlayerJsonRepository.java`
- **players.json**

### Application Runtime

- [Spring Boot App](https://github.com/pdiiazz/goldenpong-backend/blob/main/src/main/java/es/goldenpong/goldenpong/GoldenpongApplication.java): `src/main/java/es/goldenpong/goldenpong/GoldenpongApplication.java`

### Other components

- **API Client**

## Connections

- API Client → Player Controller: sends HTTP (evidence: `src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java`)
- Player Controller → Player Request: accepts body (evidence: `src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java`)
- Player Controller → Player Service: invokes (evidence: `src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java`)
- Player Controller → Player Model: creates and maps (evidence: `src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java`)
- Player Controller → Player Response: returns (evidence: `src/main/java/es/goldenpong/goldenpong/controllers/PlayerController.java`)
- Player Service → Player Repository: delegates CRUD (evidence: `src/main/java/es/goldenpong/goldenpong/services/PlayerService.java`)
- Player Repository → Player Model: loads and stores (evidence: `src/main/java/es/goldenpong/goldenpong/repositories/PlayerJsonRepository.java`)
- Player Repository → players.json: reads and writes (evidence: `src/main/java/es/goldenpong/goldenpong/repositories/PlayerJsonRepository.java`)
