How eparizoto/demo works
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