# eparizoto/demo architecture

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

- Interactive diagram: https://gitdiagram.com/eparizoto/demo
- Repository: https://github.com/eparizoto/demo

## Overview

##### Project Type and Purpose
- This is a Java Spring Boot monolithic REST API “demo” project.
- Purpose: serve as a template for building token-based (JWT) APIs, exposing authentication (LoginController) and product operations (ProdutoController), with layered design (API, core, infra).

##### File Structure Analysis
- Top-level: pom.xml, Maven wrapper, README.md.
- src/main/java/com/example/demo: three main packages:
- api – Spring REST controllers, config (OpenAPI, interceptor), exception handlers.
- core – business services (LoginService, ProdutoService), domain models & factories, core JWT abstraction.
- infra – concrete implementation of JwtToken (JwtTokenImpl).
- No persistence layer present (in‐memory or external service assumed).
- src/main/resources/application.properties – runtime settings.
- src/test – unit tests for application boot.

##### README Insights
- Confirms demonstration/template status for APIs.
- Shows example JWT.

##### Diagramming the Architecture
a. Main Components
- Client (e.g., browser, REST client, Swagger UI)
- API Layer
- OpenAPIConfig (Swagger)
- TokenInterceptor (pre-handler) + AuthorizationDecoder
- Controllers: LoginController, ProdutoController
- ApiControllerAdvice (global exception handling)
- Core Layer
- LoginService, ProdutoService
- JwtToken (abstraction)
- Domain models (TokenDados, Produto, ProdutoFactory, Cartao, etc.)
- Infra Layer
- JwtTokenImpl (concrete JWT generation/validation)
- External/Infrastructure
- (Optional) External JWT secret/provider, other external services for product data
b. Relationships & Data Flow
1. Client → HTTP Request → TokenInterceptor (checks/decodes JWT)
2. If authenticated: Request → Controller →
- LoginController calls LoginService → JwtTokenImpl → returns token
- ProdutoController calls ProdutoService → domain logic/factory → returns product data
3. Exceptions bubble up → ApiControllerAdvice handles & maps to ApiErrorResponse
4. Response → Client
c. Architectural Patterns & Principles
- Layered architecture (Controller → Service → Infra)
- Separation of concerns (auth, business logic, infra)
- Factory pattern for product models (ProdutoFactory)
- Interceptor for cross-cutting concerns (JWT verification)
d. Key Technologies & Frameworks
- Spring Boot (Web, MVC, Interceptor)
- Springdoc OpenAPI (OpenAPIConfig)
- JWT (io.jsonwebtoken or similar via JwtTokenImpl)
- Maven build

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Client
    Client(("Client")):::external

    %% API Layer
    subgraph "API Layer"
        OpenAPIConfig["OpenAPIConfig"]:::config
        TokenInterceptor["TokenInterceptor"]:::interceptor
        AuthorizationDecoder["AuthorizationDecoder"]:::interceptor
        TokenInterceptorConfig["TokenInterceptorConfig"]:::config
        LoginController["LoginController"]:::controller
        ProdutoController["ProdutoController"]:::controller
        ApiControllerAdvice["ApiControllerAdvice"]:::handler
        ApiErrorResponse["ApiErrorResponse"]:::model
    end

    %% Core Layer
    subgraph "Core Layer"
        LoginService["LoginService"]:::service
        ProdutoService["ProdutoService"]:::service
        JwtToken["JwtToken"]:::interface
        subgraph "Domain Models"
            TokenDados["TokenDados"]:::model
            Token["Token"]:::model
            subgraph "Product Models"
                ProdutoFactory["ProdutoFactory"]:::model
                Produto["Produto"]:::model
                Produto1["Produto1"]:::model
                Produto2["Produto2"]:::model
                ProdutoPai["ProdutoPai"]:::model
                Produtos["Produtos"]:::model
                Cartao["Cartao"]:::model
            end
        end
    end

    %% Infra Layer
    subgraph "Infra Layer"
        JwtTokenImpl["JwtTokenImpl"]:::implementation
    end

    %% Resources
    application["application.properties"]:::resources

    %% External Dependencies
    JWTSecretStore(("JWT Secret Store")):::external

    %% Flow: Documentation
    Client -->|"view API docs"| OpenAPIConfig

    %% Flow: Request interception
    Client -->|"HTTP Request"| TokenInterceptor
    TokenInterceptor -->|"extract token"| AuthorizationDecoder
    AuthorizationDecoder -->|"decoded token data"| TokenDados
    TokenInterceptor -->|"validate token"| JwtToken
    JwtToken -->|"use implementation"| JwtTokenImpl
    JwtTokenImpl -->|"fetch secret"| JWTSecretStore

    %% Controller invocation
    TokenInterceptor -->|"proceed if valid"| LoginController
    TokenInterceptor -->|"proceed if valid"| ProdutoController

    %% Auth flow
    LoginController -->|"authenticate user"| LoginService
    LoginService -->|"generate token"| JwtToken
    LoginController -->|"return token"| Client

    %% Product flow
    ProdutoController -->|"fetch products"| ProdutoService
    ProdutoService -->|"use factory"| ProdutoFactory
    ProdutoFactory -->|"create instances"| Produto1
    ProdutoFactory -->|"create instances"| Produto2
    ProdutoFactory -->|"create parent"| ProdutoPai
    ProdutoService -->|"return collection"| Produtos
    ProdutoController -->|"return products"| Client

    %% Exception handling
    LoginService -->|throws| ApiControllerAdvice
    ProdutoService -->|throws| ApiControllerAdvice
    ApiControllerAdvice -->|"map to error"| ApiErrorResponse
    ApiErrorResponse -->|"error response"| Client

    %% Resources
    application -->|loaded at startup| DemoApplication

    %% Click Events
    click DemoApplication "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/DemoApplication.java"
    click OpenAPIConfig "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/api/config/OpenApiConfig.java"
    click TokenInterceptor "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/api/token/TokenInterceptor.java"
    click AuthorizationDecoder "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/api/token/AuthorizationDecoder.java"
    click TokenInterceptorConfig "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/api/token/TokenInterceptorConfig.java"
    click ApiControllerAdvice "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/api/handlers/ApiControllerAdvice.java"
    click ApiErrorResponse "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/api/handlers/model/ApiErrorResponse.java"
    click LoginController "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/api/controller/LoginController.java"
    click ProdutoController "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/api/controller/ProdutoController.java"
    click TokenDados "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/api/token/model/TokenDados.java"
    click LoginService "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/LoginService.java"
    click ProdutoService "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/ProdutoService.java"
    click JwtToken "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/JwtToken.java"
    click JwtTokenImpl "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/infra/JwtTokenImpl.java"
    click ProdutoFactory "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/model/produto/ProdutoFactory.java"
    click Produto "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/model/produto/Produto.java"
    click Produto1 "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/model/produto/Produto1.java"
    click Produto2 "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/model/produto/Produto2.java"
    click ProdutoPai "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/model/produto/ProdutoPai.java"
    click Produtos "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/model/produto/Produtos.java"
    click Cartao "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/model/produto/Cartao.java"
    click Token "https://github.com/eparizoto/demo/blob/main/src/main/java/com/example/demo/core/model/token/Token.java"
    click application "https://github.com/eparizoto/demo/blob/main/src/main/resources/application.properties"
    
    %% Styles
    classDef external fill:#f9d5d3,stroke:#e06c75,stroke-width:2px;
    classDef controller fill:#cce5ff,stroke:#004085,stroke-width:2px;
    classDef service fill:#d4edda,stroke:#155724,stroke-width:2px;
    classDef interceptor fill:#fff3cd,stroke:#856404,stroke-width:2px;
    classDef config fill:#e2e3e5,stroke:#6c757d,stroke-width:2px;
    classDef handler fill:#f8d7da,stroke:#721c24,stroke-width:2px;
    classDef model fill:#fff5b1,stroke:#856404,stroke-width:2px;
    classDef implementation fill:#ffe5d9,stroke:#cb997e,stroke-width:2px;
    classDef resources fill:#d1ecf1,stroke:#0c5460,stroke-width:2px;
```
