# stevenartz/modul_183_backend architecture

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

- Interactive diagram: https://gitdiagram.com/stevenartz/modul_183_backend
- Repository: https://github.com/stevenartz/modul_183_backend

## Overview

Modul_183 is a Spring-based backend for authenticating users and managing people and their songs in MySQL. The main workflow is an HTTP request: authentication or a song/person endpoint delegates authorization and input handling, then DAO code performs database access and returns domain objects or a status. The README documents no capabilities, so endpoint scope is inferred from the source index and sampled code. Unsampled controllers and modules are represented only where their references are listed; unsupported links are omitted.

Main entry points: [`src/main/java/com/uls/security/RequestHandler.java`](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/RequestHandler.java) (Request handler), [`src/main/java/com/uls/dao/personDAO/PersonDAO.java`](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/personDAO/PersonDAO.java) (Person DAO), [`src/main/java/com/uls/dao/mapper/Mapper.java`](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/mapper/Mapper.java) (Result mapper), [`src/main/java/com/uls/dao/songDAO/SongDAO.java`](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/songDAO/SongDAO.java) (Song DAO)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_auth["Authentication endpoints"]
  node_people["Person endpoints"]
  node_songs["Song endpoints"]
end

subgraph group_security["Authentication &amp; validation"]
  node_handler["Request handler"]
  node_jwt["JWT helper<br/>[JWTHelper.java]"]
  node_hasher["SHA-512 hasher<br/>[SHA512Hasher.java]"]
  node_escape["HTML escaping<br/>[HTMLEscaper.java]"]
  node_regex["Input patterns<br/>[Regex.java]"]
end

subgraph group_data["Persistence"]
  node_persondao["Person DAO<br/>[PersonDAO.java]"]
  node_songdao["Song DAO<br/>[SongDAO.java]"]
  node_query["SQL query builder<br/>[QueryManager.java]"]
  node_mapper["Result mapper<br/>[Mapper.java]"]
  node_connection["Connection factory"]
  node_personmodel["Person model<br/>[Person.java]"]
  node_songmodel["Song model<br/>[Song.java]"]
  node_persontype["Person column names<br/>[PersonType.java]"]
  node_songtype["Song column names<br/>[SongType.java]"]
  node_personinterface["Person DAO contract<br/>[IPersonDAO.java]"]
  node_songinterface["Song DAO contract<br/>[ISongDAO.java]"]
end

node_client(("API client"))
node_mysql[("MySQL database")]

node_client -->|"sends auth request"| node_auth
node_client -->|"sends person request"| node_people
node_client -->|"sends song request"| node_songs
node_auth -->|"checks credentials"| node_handler
node_auth -->|"creates token"| node_jwt
node_people -->|"handles requests"| node_handler
node_people -->|"looks up people"| node_persondao
node_songs -->|"checks requests"| node_handler
node_songs -->|"manages songs"| node_songdao
node_handler -->|"verifies tokens"| node_jwt
node_handler -->|"looks up account"| node_persondao
node_handler -->|"hashes password"| node_hasher
node_handler -->|"escapes input"| node_escape
node_handler -->|"validates fields"| node_regex
node_persondao -->|"gets connection"| node_connection
node_persondao -->|"gets SQL"| node_query
node_persondao -->|"maps results"| node_mapper
node_songdao -->|"gets connection"| node_connection
node_songdao -->|"gets SQL"| node_query
node_songdao -->|"maps results"| node_mapper
node_connection -->|"opens JDBC connection"| node_mysql
node_query -->|"uses column names"| node_persontype
node_query -->|"uses column names"| node_songtype
node_mapper -->|"reads columns"| node_persontype
node_mapper -->|"reads columns"| node_songtype
node_mapper -->|"creates persons"| node_personmodel
node_mapper -->|"creates songs"| node_songmodel
node_persondao -->|"implements contract"| node_personinterface
node_songdao -->|"implements contract"| node_songinterface

click node_auth "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/controller/AuthenticationController.java"
click node_people "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/controller/PersonController.java"
click node_songs "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/controller/SongController.java"
click node_handler "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/RequestHandler.java"
click node_jwt "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/JWTHelper.java"
click node_hasher "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/SHA512Hasher.java"
click node_escape "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/HTMLEscaper.java"
click node_regex "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/Regex.java"
click node_persondao "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/personDAO/PersonDAO.java"
click node_songdao "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/songDAO/SongDAO.java"
click node_query "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/manager/QueryManager.java"
click node_mapper "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/mapper/Mapper.java"
click node_connection "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/factory/ConnectionFactory.java"
click node_personmodel "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/model/Person.java"
click node_songmodel "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/model/Song.java"
click node_persontype "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/type/PersonType.java"
click node_songtype "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/type/SongType.java"
click node_personinterface "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/personDAO/IPersonDAO.java"
click node_songinterface "https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/songDAO/ISongDAO.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_auth,node_people,node_songs,node_client toneBlue
class node_handler,node_jwt,node_hasher,node_escape,node_regex,node_mysql toneAmber
class node_persondao,node_songdao,node_query,node_mapper,node_connection,node_personmodel,node_songmodel,node_persontype,node_songtype,node_personinterface,node_songinterface toneMint
```

## Components

### HTTP API

- [Authentication endpoints](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/controller/AuthenticationController.java): `src/main/java/com/uls/controller/AuthenticationController.java`
- [Person endpoints](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/controller/PersonController.java): `src/main/java/com/uls/controller/PersonController.java`
- [Song endpoints](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/controller/SongController.java): `src/main/java/com/uls/controller/SongController.java`

### Authentication & validation

- [Request handler](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/RequestHandler.java): `src/main/java/com/uls/security/RequestHandler.java`
- [JWT helper](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/JWTHelper.java): `src/main/java/com/uls/security/JWTHelper.java`
- [SHA-512 hasher](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/SHA512Hasher.java): `src/main/java/com/uls/security/SHA512Hasher.java`
- [HTML escaping](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/HTMLEscaper.java): `src/main/java/com/uls/security/HTMLEscaper.java`
- [Input patterns](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/security/Regex.java): `src/main/java/com/uls/security/Regex.java`

### Persistence

- [Person DAO](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/personDAO/PersonDAO.java): `src/main/java/com/uls/dao/personDAO/PersonDAO.java`
- [Song DAO](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/songDAO/SongDAO.java): `src/main/java/com/uls/dao/songDAO/SongDAO.java`
- [SQL query builder](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/manager/QueryManager.java): `src/main/java/com/uls/dao/manager/QueryManager.java`
- [Result mapper](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/mapper/Mapper.java): `src/main/java/com/uls/dao/mapper/Mapper.java`
- [Connection factory](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/factory/ConnectionFactory.java): `src/main/java/com/uls/dao/factory/ConnectionFactory.java`
- [Person model](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/model/Person.java): `src/main/java/com/uls/model/Person.java`
- [Song model](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/model/Song.java): `src/main/java/com/uls/model/Song.java`
- [Person column names](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/type/PersonType.java): `src/main/java/com/uls/dao/type/PersonType.java`
- [Song column names](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/type/SongType.java): `src/main/java/com/uls/dao/type/SongType.java`
- [Person DAO contract](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/personDAO/IPersonDAO.java): `src/main/java/com/uls/dao/personDAO/IPersonDAO.java`
- [Song DAO contract](https://github.com/stevenartz/modul_183_backend/blob/master/src/main/java/com/uls/dao/songDAO/ISongDAO.java): `src/main/java/com/uls/dao/songDAO/ISongDAO.java`

### Other components

- **API client**
- **MySQL database**

## Connections

- API client → Authentication endpoints: sends auth request (evidence: `src/main/java/com/uls/controller/AuthenticationController.java`)
- API client → Person endpoints: sends person request (evidence: `src/main/java/com/uls/controller/PersonController.java`)
- API client → Song endpoints: sends song request (evidence: `src/main/java/com/uls/controller/SongController.java`)
- Authentication endpoints → Request handler: checks credentials (evidence: `src/main/java/com/uls/controller/AuthenticationController.java`)
- Authentication endpoints → JWT helper: creates token (evidence: `src/main/java/com/uls/controller/AuthenticationController.java`)
- Person endpoints → Request handler: handles requests (evidence: `src/main/java/com/uls/controller/PersonController.java`)
- Person endpoints → Person DAO: looks up people (evidence: `src/main/java/com/uls/controller/PersonController.java`)
- Song endpoints → Request handler: checks requests (evidence: `src/main/java/com/uls/controller/SongController.java`)
- Song endpoints → Song DAO: manages songs (evidence: `src/main/java/com/uls/controller/SongController.java`)
- Request handler → JWT helper: verifies tokens (evidence: `src/main/java/com/uls/security/RequestHandler.java`)
- Request handler → Person DAO: looks up account (evidence: `src/main/java/com/uls/security/RequestHandler.java`)
- Request handler → SHA-512 hasher: hashes password (evidence: `src/main/java/com/uls/security/RequestHandler.java`)
- Request handler → HTML escaping: escapes input (evidence: `src/main/java/com/uls/security/RequestHandler.java`)
- Request handler → Input patterns: validates fields (evidence: `src/main/java/com/uls/security/RequestHandler.java`)
- Person DAO → Connection factory: gets connection (evidence: `src/main/java/com/uls/dao/personDAO/PersonDAO.java`)
- Person DAO → SQL query builder: gets SQL (evidence: `src/main/java/com/uls/dao/personDAO/PersonDAO.java`)
- Person DAO → Result mapper: maps results (evidence: `src/main/java/com/uls/dao/personDAO/PersonDAO.java`)
- Song DAO → Connection factory: gets connection (evidence: `src/main/java/com/uls/dao/songDAO/SongDAO.java`)
- Song DAO → SQL query builder: gets SQL (evidence: `src/main/java/com/uls/dao/songDAO/SongDAO.java`)
- Song DAO → Result mapper: maps results (evidence: `src/main/java/com/uls/dao/songDAO/SongDAO.java`)
- Connection factory → MySQL database: opens JDBC connection (evidence: `src/main/java/com/uls/dao/factory/ConnectionFactory.java`)
- SQL query builder → Person column names: uses column names (evidence: `src/main/java/com/uls/dao/manager/QueryManager.java`)
- SQL query builder → Song column names: uses column names (evidence: `src/main/java/com/uls/dao/manager/QueryManager.java`)
- Result mapper → Person column names: reads columns (evidence: `src/main/java/com/uls/dao/mapper/Mapper.java`)
- Result mapper → Song column names: reads columns (evidence: `src/main/java/com/uls/dao/mapper/Mapper.java`)
- Result mapper → Person model: creates persons (evidence: `src/main/java/com/uls/dao/mapper/Mapper.java`)
- Result mapper → Song model: creates songs (evidence: `src/main/java/com/uls/dao/mapper/Mapper.java`)
- Person DAO → Person DAO contract: implements contract (evidence: `src/main/java/com/uls/dao/personDAO/PersonDAO.java`)
- Song DAO → Song DAO contract: implements contract (evidence: `src/main/java/com/uls/dao/songDAO/SongDAO.java`)
