# santiago01011/tdl_auth_api architecture

> Architecture diagram of the GitHub repository santiago01011/tdl_auth_api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/santiago01011/tdl_auth_api
- Repository: https://github.com/santiago01011/tdl_auth_api

## Overview

##### Project type and purpose
- This is a standalone backend microservice (“Auth API with JWT”) built in Java/Spring Boot. Its sole responsibility is to handle user registration (with email verification), login, and JWT‐based session management for external client applications.

##### File structure
- Top‐level build and config:
- pom.xml, mvnw, .mvn/wrapper → Maven project
- Dockerfile, .dockerignore → containerization
- DB-SCRIPTS/INIT and DB-SCRIPTS/FUNC → SQL initialization and helper functions for PostgreSQL
- Source code layout (src/main/java/com/ToDoList/auth):
- config → application wiring, HTTP security (SecurityConfig, JwtAuthenticationFilter), JWT utilities
- controller → REST endpoints (AuthController)
- service → business logic (AuthService, JwtService)
- repository → data access via Spring Data JPA (UserRepository, PendingUserRepository)
- model → JPA entity definitions (User, PendingUser)
- exception → centralized error handling (ApiExceptionHandler, custom exceptions)
- Resources (application.properties) hold DB and SMTP connection settings.

##### README for additional insights
- Describes authentication flows (registration → email → verification → activation; login → credential check → JWT issuance).

## Diagram (Mermaid)

```mermaid
graph TD
    Client["External Client"]:::client
    subgraph "Security Layer"
        JwtFilter["JwtAuthenticationFilter"]:::security
        SecurityConfig["SecurityConfig"]:::security
    end
    subgraph "Presentation Layer"
        AuthController["AuthController"]:::controller
    end
    subgraph "Business Layer"
        AuthService["AuthService"]:::service
        JwtService["JwtService"]:::service
    end
    subgraph "Data Layer"
        UserRepo["UserRepository"]:::repo
        PendingRepo["PendingUserRepository"]:::repo
    end
    Database[(PostgreSQL Database)]:::db
    Email["Email Service (SMTP)"]:::external
    subgraph "Deployment / Config"
        AppEntry["AuthApiJwtApplication"]:::app
        AppConfig["ApplicationConfig"]:::config
        AppProps["application.properties"]:::config
        DockerfileNode["Dockerfile"]:::config
        InitScript["initDB.sql"]:::script
        FuncScripts["DB Helper Functions"]:::script
    end

    Client -->|HTTPS Request| JwtFilter
    JwtFilter -->|authorize| AuthController
    AuthController -->|calls| AuthService
    AuthService -->|uses| JwtService
    AuthService -->|reads/writes| UserRepo
    AuthService -->|reads/writes| PendingRepo
    AuthService -->|sends email| Email
    AuthController -->|returns JWT| Client
    JwtService -->|generates JWT| AuthController
    UserRepo --> Database
    PendingRepo --> Database

    AppEntry --> AppConfig
    AppConfig --> AppProps
    DockerfileNode --> AppEntry
    DockerfileNode --> InitScript
    DockerfileNode --> FuncScripts
    AppEntry -->|startup initializes| Database

    click AppEntry "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/java/com/ToDoList/auth/AuthApIwJwtApplication.java"
    click AuthController "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/java/com/ToDoList/auth/controller/AuthController.java"
    click SecurityConfig "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/java/com/ToDoList/auth/config/SecurityConfig.java"
    click JwtFilter "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/java/com/ToDoList/auth/config/JwtAuthenticationFilter.java"
    click AppConfig "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/java/com/ToDoList/auth/config/ApplicationConfig.java"
    click AuthService "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/java/com/ToDoList/auth/service/AuthService.java"
    click JwtService "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/java/com/ToDoList/auth/service/JwtService.java"
    click UserRepo "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/java/com/ToDoList/auth/repository/UserRepository.java"
    click PendingRepo "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/java/com/ToDoList/auth/repository/PendingUserRepository.java"
    click InitScript "https://github.com/santiago01011/tdl_auth_api/blob/main/DB-SCRIPTS/INIT/initDB.sql"
    click FuncScripts "https://github.com/santiago01011/tdl_auth_api/blob/main/DB-SCRIPTS/FUNC/HelperInsertFunctions.sql"
    click FuncScripts "https://github.com/santiago01011/tdl_auth_api/blob/main/DB-SCRIPTS/FUNC/RetrieveTasksIJSONB.sql"
    click FuncScripts "https://github.com/santiago01011/tdl_auth_api/blob/main/DB-SCRIPTS/FUNC/insertTasksFJSONB.sql"
    click FuncScripts "https://github.com/santiago01011/tdl_auth_api/blob/main/DB-SCRIPTS/FUNC/updateTasksFJSONB.sql"
    click AppProps "https://github.com/santiago01011/tdl_auth_api/blob/main/src/main/resources/application.properties"
    click DockerfileNode "https://github.com/santiago01011/tdl_auth_api/tree/main/Dockerfile"

    classDef client fill:#E3F2FD,stroke:#90CAF9,color:#0D47A1;
    classDef security fill:#FFEBEE,stroke:#E57373,color:#B71C1C;
    classDef controller fill:#E8F5E9,stroke:#81C784,color:#1B5E20;
    classDef service fill:#FFF3E0,stroke:#FFB74D,color:#E65100;
    classDef repo fill:#F3E5F5,stroke:#BA68C8,color:#4A148C;
    classDef db fill:#E0F7FA,stroke:#4DD0E1,color:#006064;
    classDef external fill:#FFFDE7,stroke:#FFF176,color:#F57F17;
    classDef app fill:#ECEFF1,stroke:#B0BEC5,color:#263238;
    classDef config fill:#FAFAFA,stroke:#EEEEEE,color:#424242;
    classDef script fill:#F1F8E9,stroke:#AED581,color:#33691E;
```
