# afks-fundamentos/backend architecture

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

- Interactive diagram: https://gitdiagram.com/afks-fundamentos/backend
- Repository: https://github.com/afks-fundamentos/backend

## Overview

##### Project type and purpose
- This is a standalone backend service (Spring Boot) implementing an “Advisory Management” domain.
- It follows Domain-Driven Design (DDD) and a layered/CQRS pattern: REST interfaces → Application services → Domain model → Persistence.

##### File structure
- Top-level files: pom.xml, maven wrapper, Application.java (Spring Boot entry).
- src/main/java/com/pcmaster/AFK/… splits into:
– advisorymanagement (the core bounded context)
· interfaces/rest (Spring MVC controllers, resource DTOs, assemblers)
· application/internal (command and query service implementations)
· domain/model (aggregates, commands, queries, value objects)
· domain/services (ports for business logic)
· infrastructure/persistence/jpa (Spring Data JPA repositories)
– config (SecurityConfig, ValidationConfig)
– shared (common domain abstractions, JPA naming strategy, OpenAPI config)
- Resources: application.properties, OpenAPI docs.

##### README
- Minimal—only “# Backend.” No additional architectural notes.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client[/"API Clients"/]:::external

    subgraph "Advisory Management Service"
      direction TB

      subgraph "API Layer"
        direction TB
        Controller["AdvisoryController"]:::api
        AdvisoryResource["AdvisoryResource"]:::api
        CreateAdvisoryResource["CreateAdvisoryResource"]:::api
        UpdateAdvisoryResource["UpdateAdvisoryResource"]:::api
        Assembler1["AdvisoryResourceFromEntityAssembler"]:::api
        Assembler2["CreateAdvisoryCommandFromResourceAssembler"]:::api
        Assembler3["UpdateAdvisoryCommandFromResourceAssembler"]:::api
      end

      subgraph "Application Layer"
        direction TB
        CommandService["AdvisoryCommandServiceImpl"]:::app
        QueryService["AdvisoryQueryServiceImpl"]:::app
      end

      subgraph "Domain Layer"
        direction TB
        Aggregate["Advisory Aggregate"]:::domain
        CreateCommand["CreateAdvisoryCommand"]:::domain
        UpdateCommand["UpdateAdvisoryCommand"]:::domain
        DeleteCommand["DeleteAdvisoryCommand"]:::domain
        Query1["GetAdvisoryByIdQuery"]:::domain
        Query2["GetAdvisoriesByCustomerIdQuery"]:::domain
        Query3["GetAdvisoriesByAdvisorIdQuery"]:::domain
        Query4["GetAdvisoriesByAdvisoryTypeQuery"]:::domain
        Query5["GetAdvisoriesByAdvisoryStatusQuery"]:::domain
        ValueObjects["Value Objects<br/>(AdvisorId,CustomerId,Type,Status)"]:::domain
        Ports["AdvisoryCommandService<br/>AdvisoryQueryService"]:::domain
      end

      subgraph "Infrastructure Layer"
        direction TB
        Repository["AdvisoryRepository (JPA)"]:::infra
        PersistenceConfig["SnakeCaseWithPluralizedTablePhysicalNamingStrategy"]:::infra
        OpenAPI["OpenApiConfiguration"]:::infra
      end

      subgraph "Configuration"
        direction TB
        Security["SecurityConfig"]:::config
        Validation["ValidationConfig"]:::config
      end

    end

    Database[(Relational Database)]:::db

    Client -->|"HTTP/JSON"| Controller
    Controller -->|"uses"| Assembler1
    Controller -->|"uses"| Assembler2
    Controller -->|"uses"| Assembler3
    Assembler2 -->|"build CreateCommand"| CommandService
    Assembler3 -->|"build UpdateCommand"| CommandService
    Assembler1 -->|"transform Entity→Resource"| Controller
    CommandService -->|"calls"| Ports
    QueryService -->|"calls"| Ports
    Ports -->|"invoke business rules"| Aggregate
    CommandService -->|"persist via"| Repository
    QueryService -->|"query via"| Repository
    Repository -->|"JPA"| Database
    OpenAPI -->|"exposes API spec"| Controller
    Security -->|"secures"| Controller
    Validation -->|"validates"| Controller

    click Controller "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/interfaces/rest/AdvisoryController.java"
    click AdvisoryResource "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/interfaces/rest/resources/AdvisoryResource.java"
    click CreateAdvisoryResource "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/interfaces/rest/resources/CreateAdvisoryResource.java"
    click UpdateAdvisoryResource "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/interfaces/rest/resources/UpdateAdvisoryResource.java"
    click Assembler1 "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/interfaces/rest/transform/AdvisoryResourceFromEntityAssembler.java"
    click Assembler2 "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/interfaces/rest/transform/CreateAdvisoryCommandFromResourceAssembler.java"
    click Assembler3 "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/interfaces/rest/transform/UpdateAdvisoryCommandFromResourceAssembler.java"
    click CommandService "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/application/internal/commandservices/AdvisoryCommandServiceImpl.java"
    click QueryService "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/application/internal/queryservices/AdvisoryQueryServiceImpl.java"
    click Aggregate "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/domain/model/aggregates/Advisory.java"
    click CreateCommand "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/domain/model/commands/CreateAdvisoryCommand.java"
    click UpdateCommand "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/domain/model/commands/UpdateAdvisoryCommand.java"
    click DeleteCommand "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/domain/model/commands/DeleteAdvisoryCommand.java"
    click Query1 "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/domain/model/queries/GetAdvisoryByIdQuery.java"
    click Query2 "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/domain/model/queries/GetAdvisoriesByCustomerIdQuery.java"
    click Query3 "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/domain/model/queries/GetAdvisoriesByAdvisorIdQuery.java"
    click Query4 "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/domain/model/queries/GetAdvisoriesByAdvisoryTypeQuery.java"
    click Query5 "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/domain/model/queries/GetAdvisoriesByAdvisoryStatusQuery.java"
    click Repository "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/advisorymanagement/infrastructure/persistence/jpa/repositories/AdvisoryRepository.java"
    click PersistenceConfig "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/shared/infrastructure/persistence/jpa/configuration/strategy/SnakeCaseWithPluralizedTablePhysicalNamingStrategy.java"
    click OpenAPI "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/shared/infrastructure/documentation/openapi/configuration/OpenApiConfiguration.java"
    click Security "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/config/SecurityConfig.java"
    click Validation "https://github.com/afks-fundamentos/backend/blob/main/src/main/java/com/pcmaster/AFK/config/ValidationConfig.java"
    classDef external fill:#8fbc8f,stroke:#2e8b57,color:#000
    classDef api fill:#87cefa,stroke:#4682b4,color:#000
    classDef app fill:#ffa500,stroke:#ff8c00,color:#000
    classDef domain fill:#ffd700,stroke:#daa520,color:#000
    classDef infra fill:#d3d3d3,stroke:#a9a9a9,color:#000
    classDef config fill:#dda0dd,stroke:#9370db,color:#000
    classDef db fill:#c0c0c0,stroke:#696969,color:#000
```
