# gastrobaralemans/backend architecture

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

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

## Overview

##### Project type and purpose
- This is a Spring Boot monolithic backend service (Java) for the “Gastrobar Alemans”/“Unibytes” project.
- It exposes RESTful endpoints for authentication, menu management, order processing, reservations, comments/posts, and notifications.

##### File structure
- Top-level: pom.xml (Maven), mvnw, .mvn for build tool; src/main/java for application code; src/main/resources for config; src/test for unit/integration tests.
- Package breakdown under com.gastrobar_alemans_backend:
- DTO – data transfer objects between layers
- model – JPA entities and request models
- repository – Spring Data JPA interfaces for persistence
- service – business logic
- controllers – REST API layer
- config – Web, Security, Encoder configurations
- security – JWT utilities and filters
- advice – global exception handlers
- application.properties holds database and JWT settings.

##### README
- Very brief: “Repositorio para el backend del proyecto Unibytes.”

##### Detailed breakdown (to capture essential elements)
- Package/controller group: AuthController, RegisterController
- Package/controller group: MenuController + PlatilloIngredienteController + IngredienteController
- Package/controller group: PedidoController + ReserveController
- Repository cluster: all *Repository interfaces
- Service cluster: MenuService, PedidoService, PersonDetailsService
- Security cluster: JwtAuthenticationFilter, JWTUtil, SecurityConfig
- Model/DTO cluster: Entities vs. DTOs for request/response mapping

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Clients
    Clients["Clients (Web/Mobile)"]:::external

    %% Security Layer
    subgraph "Security Layer"
        JWTFilter["JwtAuthenticationFilter"]:::security
        JWTUtil["JWTUtil"]:::security
        SecurityConfig["SecurityConfig"]:::config
    end

    %% API Layer (Controllers)
    subgraph "API Layer (Controllers)"
        ControllersDir["Controllers Package"]:::controllers
        AuthController["AuthController"]:::controllers
        RegisterController["RegisterController"]:::controllers
        MenuController["MenuController"]:::controllers
        IngredienteController["IngredienteController"]:::controllers
        PlatilloIngredienteController["PlatilloIngredienteController"]:::controllers
        PedidoController["PedidoController"]:::controllers
        ReserveController["ReserveController"]:::controllers
        PostController["PostController"]:::controllers
        PersonController["PersonController"]:::controllers
    end

    %% Service Layer
    subgraph "Service Layer"
        ServicesDir["Service Package"]:::service
        MenuService["MenuService"]:::service
        PedidoService["PedidoService"]:::service
        PersonDetailsService["PersonDetailsService"]:::service
    end

    %% Persistence Layer (Repositories)
    subgraph "Persistence Layer (Repositories)"
        ComentarioRepo["ComentarioRepository"]:::repository
        IngredienteRepo["IngredienteRepository"]:::repository
        MenuCategoryRepo["MenuCategoryRepository"]:::repository
        MenuItemRepo["MenuItemRepository"]:::repository
        MenuItemPromoRepo["MenuItemPromoRepository"]:::repository
        NotisRepo["NotisRepository"]:::repository
        PedidoRepo["PedidoRepository"]:::repository
        PersonRepo["PersonRepository"]:::repository
        PlatilloIngredienteRepo["PlatilloIngredienteRepository"]:::repository
        PostRepo["PostRepository"]:::repository
        ReserveRepo["ReserveRepository"]:::repository
    end

    %% Database
    Database["Relational Database (MySQL/PostgreSQL)"]:::database

    %% Exception Handling and Config
    ValidationHandler["ValidationExceptionHandler"]:::advice
    AppProperties["application.properties"]:::config

    %% Connections
    Clients --> JWTFilter
    JWTFilter --> JWTUtil
    JWTFilter --> ControllersDir
    SecurityConfig --> JWTFilter
    ControllersDir --> AuthController
    ControllersDir --> RegisterController
    ControllersDir --> MenuController
    ControllersDir --> IngredienteController
    ControllersDir --> PlatilloIngredienteController
    ControllersDir --> PedidoController
    ControllersDir --> ReserveController
    ControllersDir --> PostController
    ControllersDir --> PersonController

    AuthController --> MenuService
    RegisterController --> PersonDetailsService
    MenuController --> MenuService
    IngredienteController --> MenuService
    PlatilloIngredienteController --> MenuService
    PedidoController --> PedidoService
    ReserveController --> PedidoService
    PostController --> PersonDetailsService
    PersonController --> PersonDetailsService

    MenuService --> ComentarioRepo
    MenuService --> IngredienteRepo
    MenuService --> MenuCategoryRepo
    MenuService --> MenuItemRepo
    MenuService --> MenuItemPromoRepo
    PedidoService --> PedidoRepo
    PedidoService --> PlatilloIngredienteRepo
    PedidoService --> ReserveRepo
    PedidoService --> PostRepo
    PersonDetailsService --> PersonRepo
    PersonDetailsService --> NotisRepo

    ComentarioRepo --> Database
    IngredienteRepo --> Database
    MenuCategoryRepo --> Database
    MenuItemRepo --> Database
    MenuItemPromoRepo --> Database
    NotisRepo --> Database
    PedidoRepo --> Database
    PersonRepo --> Database
    PlatilloIngredienteRepo --> Database
    PostRepo --> Database
    ReserveRepo --> Database

    ControllersDir --> ValidationHandler
    AppProperties --> SecurityConfig
    AppProperties --> Database

    %% Click Events - Controllers
    click ControllersDir "https://github.com/gastrobaralemans/backend/tree/main/src/main/java/com/gastrobar_alemans_backend/controllers"
    click AuthController "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/controllers/AuthController.java"
    click RegisterController "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/controllers/RegisterController.java"
    click MenuController "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/controllers/MenuController.java"
    click IngredienteController "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/controllers/IngredienteController.java"
    click PlatilloIngredienteController "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/controllers/PlatilloIngredienteController.java"
    click PedidoController "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/controllers/PedidoController.java"
    click ReserveController "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/controllers/ReserveController.java"
    click PostController "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/controllers/PostController.java"
    click PersonController "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/controllers/PersonController.java"

    %% Click Events - Services
    click ServicesDir "https://github.com/gastrobaralemans/backend/tree/main/src/main/java/com/gastrobar_alemans_backend/service"
    click MenuService "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/service/MenuService.java"
    click PedidoService "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/service/PedidoService.java"
    click PersonDetailsService "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/service/PersonDetailsService.java"

    %% Click Events - Repositories
    click ComentarioRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/ComentarioRepository.java"
    click IngredienteRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/IngredienteRepository.java"
    click MenuCategoryRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/MenuCategoryRepository.java"
    click MenuItemRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/MenuItemRepository.java"
    click MenuItemPromoRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/MenuItemPromoRepository.java"
    click NotisRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/NotisRepository.java"
    click PedidoRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/PedidoRepository.java"
    click PersonRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/PersonRepository.java"
    click PlatilloIngredienteRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/PlatilloIngredienteRepository.java"
    click PostRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/PostRepository.java"
    click ReserveRepo "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/repository/ReserveRepository.java"

    %% Click Events - Security & Config
    click JWTFilter "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/security/JwtAuthenticationFilter.java"
    click JWTUtil "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/security/JWTUtil.java"
    click SecurityConfig "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/config/SecurityConfig.java"
    click AppProperties "https://github.com/gastrobaralemans/backend/blob/main/src/main/resources/application.properties"
    click ValidationHandler "https://github.com/gastrobaralemans/backend/blob/main/src/main/java/com/gastrobar_alemans_backend/advice/ValidationExceptionHandler.java"

    %% Styles
    classDef external fill:#f9d176,stroke:#333,stroke-width:1px
    classDef security fill:#f28c8c,stroke:#333,stroke-width:1px
    classDef controllers fill:#8dcff8,stroke:#333,stroke-width:1px
    classDef service fill:#c88df8,stroke:#333,stroke-width:1px
    classDef repository fill:#8df8a0,stroke:#333,stroke-width:1px
    classDef database fill:#6ba58f,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
    classDef config fill:#f8e58d,stroke:#333,stroke-width:1px
    classDef advice fill:#d3d3d3,stroke:#333,stroke-width:1px
```
