# erik-cupsa/spring-security-tutorial architecture

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

- Interactive diagram: https://gitdiagram.com/erik-cupsa/spring-security-tutorial
- Repository: https://github.com/erik-cupsa/spring-security-tutorial

## Overview

##### Project type and purpose
- This is a backend-only Spring Boot application implementing user authentication:
- Signup with email verification
- JWT-based login
- Basic user profile retrieval and error handling
- No frontend code; intended clients (Postman or any HTTP client) interact via REST APIs.

##### File structure
- Top-level “demo” directory contains:
- src/main/java/com/example/demo
– config: Spring and security configurations (JWT filter, mail, CORS, etc.)
– controller: REST controllers for auth and user endpoints
– dto: request/response data transfer objects
– model: JPA entity (User)
– repository: Spring Data JPA UserRepository
– service: core business logic (AuthenticationService, UserService, JwtService, EmailService)
- src/main/resources/application.properties: DB (Supabase) and mail properties
- src/test: basic application test
- build scripts: Gradle wrapper, settings.gradle
- Pattern: classic layered MVC with service and repository layers.

##### README for additional insights
- Dependencies: Java 8+, Spring Boot, Spring Security, JWT, email (SMTP), Supabase (PostgreSQL), Gradle
- Features call out external mail server and Supabase database.

## Diagram (Mermaid)

```mermaid
graph TB
    %% External Clients and Systems
    Client["HTTP Client (Postman)"]:::external
    SMTPServer["SMTP Mail Server"]:::external_mail
    SupabaseDB["Supabase PostgreSQL"]:::external_db

    %% Entry Point
    DemoApp["DemoApplication"]:::entry

    %% Configuration Layer
    subgraph "Configuration"
        AppConfig["ApplicationConfiguration"]:::config
        SecurityConfig["SecurityConfiguration"]:::config
        EmailConfig["EmailConfiguration"]:::config
    end

    %% Filter Layer
    subgraph "Security Filter"
        JwtFilter["JwtAuthenticationFilter"]:::config
    end

    %% Controllers Layer
    subgraph "Controllers"
        AuthController["AuthenticationController"]:::controllers
        UserController["UserController"]:::controllers
    end

    %% DTOs and Responses
    subgraph "DTOs / Responses"
        RegisterDto["RegisterUserDto"]:::dto
        VerifyDto["VerifyUserDto"]:::dto
        LoginDto["LoginUserDto"]:::dto
        LoginResp["LoginResponse"]:::dto
    end

    %% Services Layer
    subgraph "Services"
        AuthService["AuthenticationService"]:::services
        UserService["UserService"]:::services
        JwtService["JwtService"]:::services
        EmailService["EmailService"]:::services
    end

    %% Repository and Model Layer
    subgraph "Repository & Model"
        UserRepo["UserRepository"]:::repository
        UserModel["User Entity"]:::model
    end

    %% Resources and Tests
    Resources["application.properties"]:::config
    Tests["DemoApplicationTests"]:::tests

    %% Request Flow - Auth
    Client -->|"/signup,/login,/verify"| AuthController
    AuthController -->|uses DTOs| RegisterDto
    AuthController -->|uses DTOs| VerifyDto
    AuthController -->|uses DTOs| LoginDto
    AuthController -->|returns| LoginResp
    AuthController -->|calls| AuthService
    AuthService --> UserRepo
    UserRepo --> SupabaseDB
    AuthService --> EmailService
    EmailService --> SMTPServer
    AuthService --> JwtService

    %% Request Flow - User Profile
    Client -->|"/user"| JwtFilter
    JwtFilter --> JwtService
    JwtFilter --> UserController
    UserController --> UserService
    UserService --> UserRepo

    %% Configuration and Bootstrapping
    DemoApp --> AppConfig
    DemoApp --> SecurityConfig
    DemoApp --> EmailConfig
    DemoApp --> Resources

    %% Tests
    DemoApp --> Tests

    %% Click Events
    click DemoApp "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/DemoApplication.java"
    click Resources "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/resources/application.properties"
    click AuthController "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/controller/AuthenticationController.java"
    click UserController "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/controller/UserController.java"
    click RegisterDto "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/dto/RegisterUserDto.java"
    click VerifyDto "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/dto/VerifyUserDto.java"
    click LoginDto "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/dto/LoginUserDto.java"
    click LoginResp "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/responses/LoginResponse.java"
    click UserModel "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/model/User.java"
    click UserRepo "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/repository/UserRepository.java"
    click AuthService "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/service/AuthenticationService.java"
    click UserService "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/service/UserService.java"
    click JwtService "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/service/JwtService.java"
    click EmailService "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/service/EmailService.java"
    click JwtFilter "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/config/JwtAuthenticationFilter.java"
    click SecurityConfig "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/config/SecurityConfiguration.java"
    click AppConfig "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/config/ApplicationConfiguration.java"
    click EmailConfig "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/main/java/com/example/demo/config/EmailConfiguration.java"
    click Tests "https://github.com/erik-cupsa/spring-security-tutorial/blob/main/demo/src/test/java/com/example/demo/DemoApplicationTests.java"

    %% Styles
    classDef controllers fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef services fill:#87CEFA,stroke:#000,stroke-width:1px
    classDef repository fill:#E0FFFF,stroke:#000,stroke-width:1px
    classDef model fill:#FFA07A,stroke:#000,stroke-width:1px
    classDef dto fill:#F0E68C,stroke:#000,stroke-width:1px
    classDef config fill:#B0E0E6,stroke:#000,stroke-width:1px
    classDef entry fill:#FFD700,stroke:#000,stroke-width:1px
    classDef external_mail fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef external_db fill:#98FB98,stroke:#000,stroke-width:1px
    classDef external fill:#EEEEEE,stroke:#000,stroke-width:1px
    classDef tests fill:#FFE4E1,stroke:#000,stroke-width:1px
```
