# cesarandres8911/springboot-user-registration architecture

> Architecture diagram of the GitHub repository cesarandres8911/springboot-user-registration, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cesarandres8911/springboot-user-registration
- Repository: https://github.com/cesarandres8911/springboot-user-registration

## Overview

##### Project type and purpose
- This is a backend RESTful microservice built with Spring Boot. Its sole responsibility is user registration, authentication (via JWT), password‐policy configuration, and management of user data. There is no separate frontend; clients interact over HTTP (cURL, Postman, any HTTP-capable UI).

##### File structure
- Top-level Gradle build files (`build.gradle.kts`, `settings.gradle.kts`) and `src/main/java/com/example/registration/RegistrationApplication.java` bootstrap the Spring Boot app.
- `controller/` holds REST endpoints: `AuthController`, `UserController`, `ConfigurationController`.
- `service/` contains business logic (`UserService`, `ConfigurationService`, `PasswordValidationService`).
- `repository/` defines Spring Data JPA interfaces to persist `User`, `Configuration`, `ConfigurationType`.
- `model/` are JPA entities.
- `dto/` are request/response payload classes.
- `mapper/` are MapStruct interfaces mapping between entities and DTOs.
- `security/` includes JWT filter, JWT service, and Spring Security config.
- `utils/` are password utilities (regex generator, encoder, validator, configuration type).
- `config/` holds OpenAPI and Security configuration classes.
- `src/main/resources` contains H2 SQL schemas and properties.
- `docs/` contains supplemental architecture, database, security, utility documentation.

##### README for additional insights
- Core flows: register user → validate password → save user → return JWT; login → authenticate → return JWT; configuration endpoints allow runtime password-policy changes.
- Uses H2 in-memory DB, Springdoc OpenAPI for docs, Lombok for boilerplate, SLF4J for logging.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Clients"
        Browser["Browser/HTTP Client"]:::external
        Mobile["Mobile App/HTTP Client"]:::external
        CLI["CLI (cURL/Postman)"]:::external
    end

    subgraph "API Layer"
        AuthController["AuthController"]:::api
        UserController["UserController"]:::api
        ConfigurationController["ConfigurationController"]:::api
        GlobalExceptionHandler["GlobalExceptionHandler"]:::api
    end

    subgraph "Security Layer"
        JwtAuthFilter["JwtAuthenticationFilter"]:::security
        JwtService["JwtService"]:::security
        SecurityConfig["SecurityConfig"]:::security
    end

    subgraph "Service Layer"
        UserService["UserService"]:::service
        ConfigurationService["ConfigurationService"]:::service
        PasswordValidationService["PasswordValidationService"]:::service
    end

    subgraph "Data Layer"
        UserRepo["UserRepository"]:::repository
        ConfigRepo["ConfigurationRepository"]:::repository
        ConfigTypeRepo["ConfigurationTypeRepository"]:::repository
        H2DB(("H2 Database")):::repository
    end

    subgraph "Utils & Mappers"
        UserMapper["UserMapper"]:::util
        ConfigMapper["ConfigurationMapper"]:::util
        ConfigTypeMapper["ConfigurationTypeMapper"]:::util
        PhoneMapper["PhoneMapper"]:::util
        PasswordConfigType["PasswordConfigurationType"]:::util
        PasswordEncoderUtil["PasswordEncoderUtil"]:::util
        PasswordRegexGenerator["PasswordRegexGenerator"]:::util
        PasswordValidator["PasswordValidator"]:::util
    end

    subgraph "External Tools"
        SwaggerUI["Swagger/OpenAPI UI"]:::external
    end

    Browser --> JwtAuthFilter
    Mobile --> JwtAuthFilter
    CLI --> JwtAuthFilter

    JwtAuthFilter --> AuthController
    JwtAuthFilter --> UserController
    JwtAuthFilter --> ConfigurationController

    AuthController --> UserService
    UserController --> UserService
    ConfigurationController --> ConfigurationService

    AuthController --> GlobalExceptionHandler
    UserController --> GlobalExceptionHandler
    ConfigurationController --> GlobalExceptionHandler

    UserService --> UserRepo
    ConfigurationService --> ConfigRepo
    ConfigurationService --> ConfigTypeRepo
    PasswordValidationService --> ConfigRepo
    PasswordValidationService --> ConfigTypeRepo

    UserService --> PasswordEncoderUtil
    PasswordValidationService --> PasswordValidator
    PasswordValidationService --> PasswordRegexGenerator

    UserService --> UserMapper
    ConfigurationService --> ConfigMapper
    ConfigurationService --> ConfigTypeMapper
    UserService --> PhoneMapper

    UserRepo --> H2DB
    ConfigRepo --> H2DB
    ConfigTypeRepo --> H2DB

    ConfigurationController -.-> SwaggerUI
    AuthController -.-> SwaggerUI
    UserController -.-> SwaggerUI

    SecurityConfig --> JwtAuthFilter
    SecurityConfig --> JwtService
    JwtService --> JwtAuthFilter

    click AuthController "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/controller/AuthController.java"
    click UserController "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/controller/UserController.java"
    click ConfigurationController "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/controller/ConfigurationController.java"
    click JwtAuthFilter "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/security/jwt/JwtAuthenticationFilter.java"
    click JwtService "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/security/jwt/JwtService.java"
    click SecurityConfig "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/config/SecurityConfig.java"
    click UserService "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/service/UserService.java"
    click ConfigurationService "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/service/ConfigurationService.java"
    click PasswordValidationService "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/service/PasswordValidationService.java"
    click UserRepo "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/repository/UserRepository.java"
    click ConfigRepo "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/repository/ConfigurationRepository.java"
    click ConfigTypeRepo "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/repository/ConfigurationTypeRepository.java"
    click UserMapper "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/mapper/UserMapper.java"
    click ConfigMapper "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/mapper/ConfigurationMapper.java"
    click ConfigTypeMapper "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/mapper/ConfigurationTypeMapper.java"
    click PhoneMapper "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/mapper/PhoneMapper.java"
    click PasswordConfigType "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/utils/PasswordConfigurationType.java"
    click PasswordEncoderUtil "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/utils/PasswordEncoderUtil.java"
    click PasswordRegexGenerator "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/utils/PasswordRegexGenerator.java"
    click PasswordValidator "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/utils/PasswordValidator.java"
    click Browser "https://github.com/cesarandres8911/springboot-user-registration/blob/main/src/main/java/com/example/registration/RegistrationApplication.java"

    classDef api fill:#cce5ff,stroke:#004085
    classDef security fill:#d4edda,stroke:#155724
    classDef service fill:#d1ecf1,stroke:#0c5460
    classDef repository fill:#fff3cd,stroke:#856404
    classDef util fill:#e2e3e5,stroke:#6c757d
    classDef external fill:#f8d7da,stroke:#721c24
```
