# ceciliore/patharchitecture architecture

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

- Interactive diagram: https://gitdiagram.com/ceciliore/patharchitecture
- Repository: https://github.com/ceciliore/patharchitecture

## Overview

##### Project Type and Purpose
- This is a full-stack Node.js/Express/Sequelize + React/TypeScript application implemented in four architectural styles—Monolith, Modular Monolith, Microservices, and SOA—to compare organization, scalability, coupling, and integration for a school-talks domain.

##### File Structure Overview
- Top-level directories:
- monolito (classic monolith)
- monolito_modular (modular monolith)
- microsservico (independent microservices + API Gateway)
- soa (services integrated via ESB and SOAP/XML with a REST adapter)
- Each variant includes its own Docker/Docker-Compose files, server.js entry point, Sequelize models, routes/controllers, and configuration.
- Frontend React build artifacts are embedded under the `build/` folder in both monolith variants.

##### Key Insights from README
- Technologies: Node.js, Express, Sequelize, PostgreSQL, React/TypeScript, Docker, Swagger for API docs.
- Each architectural style has its own README with Docker-based run instructions.
- Domain: “palestras escolares” with entities like User/Perfil, Palestra, Comentário, Presença.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Monolith Architecture
    subgraph "Monolith Architecture"
        direction TB
        MonFrontend["Frontend (React Build)"]:::frontend
        MonServer["Express Server"]:::backend
        MonDB["PostgreSQL DB"]:::database
        MonSwagger["Swagger UI"]:::external
        MonModels["Domain Models"]:::backend
        MonFrontend -->|"HTTP Requests"| MonServer
        MonServer -->|"ORM Calls"| MonModels
        MonModels -->|"SQL Queries"| MonDB
        MonServer -->|"Serves Docs"| MonSwagger
    end

    %% Modular Monolith Architecture
    subgraph "Modular Monolith Architecture"
        direction TB
        ModServer["Express Server"]:::backend
        ModConfig["DB Config"]:::backend
        ModModels["Models"]:::backend
        subgraph "Modules"
            direction TB
            Usuarios["Usuarios Module"]:::module
            Palestras["Palestras Module"]:::module
            Comentarios["Comentarios Module"]:::module
            Presencas["Presencas Module"]:::module
        end
        ModServer -->|uses| ModConfig
        ModServer -->|loads| ModModels
        ModServer -->|routes| Usuarios
        ModServer -->|routes| Palestras
        ModServer -->|routes| Comentarios
        ModServer -->|routes| Presencas
    end

    %% Microservices Architecture
    subgraph "Microservices Architecture"
        direction TB
        APIGateway["API Gateway"]:::gateway
        subgraph "Services"
            direction TB
            US["User Service"]:::service
            PS["Perfil Service"]:::service
            PalS["Palestra Service"]:::service
            CS["Comentario Service"]:::service
            PrS["Presenca Service"]:::service
        end
        subgraph "Databases"
            direction TB
            USDB["User DB"]:::database
            PSDB["Perfil DB"]:::database
            PalDB["Palestra DB"]:::database
            CDB["Comentario DB"]:::database
            PrDB["Presenca DB"]:::database
        end
        APIGateway -->|REST| US
        APIGateway -->|REST| PS
        APIGateway -->|REST| PalS
        APIGateway -->|REST| CS
        APIGateway -->|REST| PrS
        US -->|queries| USDB
        PS -->|queries| PSDB
        PalS -->|queries| PalDB
        CS -->|queries| CDB
        PrS -->|queries| PrDB
    end

    %% SOA Architecture
    subgraph "SOA Architecture"
        direction TB
        ESB["ESB Service"]:::middleware
        RESTAdapter["REST-to-SOAP Adapter"]:::middleware
        subgraph "SOA Services"
            direction TB
            SOAUser["User/Perfil Service"]:::service
            SOAPal["Palestra/Comentario/Presenca Service"]:::service
        end
        subgraph "SOA Databases"
            direction TB
            SOAUserDB["User DB"]:::database
            SOAPalDB["Palestra DB"]:::database
        end
        ESB -->|exposes| RESTAdapter
        RESTAdapter -->|REST Calls| ESB
        ESB -->|SOAP/XML| SOAUser
        ESB -->|SOAP/XML| SOAPal
        SOAUser -->|queries| SOAUserDB
        SOAPal -->|queries| SOAPalDB
    end

    %% Click Events
    click MonFrontend "https://github.com/ceciliore/patharchitecture/tree/main/monolito/build"
    click MonServer "https://github.com/ceciliore/patharchitecture/blob/main/monolito/server.js"
    click MonConfig "https://github.com/ceciliore/patharchitecture/blob/main/monolito/config/db.js"
    click MonConfig "https://github.com/ceciliore/patharchitecture/blob/main/monolito/swagger.js"
    click MonModels "https://github.com/ceciliore/patharchitecture/tree/main/monolito/models"
    click ModServer "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/server.js"
    click ModConfig "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/src/config/db.js"
    click ModModels "https://github.com/ceciliore/patharchitecture/tree/main/monolito_modular/src/models"
    click Usuarios "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/src/modules/usuarios/usuario.controller.js"
    click Usuarios "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/src/modules/usuarios/usuario.routes.js"
    click Palestras "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/src/modules/palestras/palestra.controller.js"
    click Palestras "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/src/modules/palestras/palestra.routes.js"
    click Comentarios "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/src/modules/comentarios/comentario.controller.js"
    click Comentarios "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/src/modules/comentarios/comentario.routes.js"
    click Presencas "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/src/modules/presencas/presenca.controller.js"
    click Presencas "https://github.com/ceciliore/patharchitecture/blob/main/monolito_modular/src/modules/presencas/presenca.routes.js"
    click APIGateway "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/api-gateway/server.js"
    click APIGateway "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/api-gateway/docker-compose.yml"
    click US "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/user-service/server.js"
    click US "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/user-service/src/controllers/usuario.controller.js"
    click US "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/user-service/src/models/usuario.model.js"
    click US "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/user-service/src/routes/usuario.routes.js"
    click PS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/perfil-service/server.js"
    click PS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/perfil-service/src/controllers/perfil.controller.js"
    click PS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/perfil-service/src/models/perfil.model.js"
    click PS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/perfil-service/src/routes/perfil.routes.js"
    click PalS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/palestra-service/server.js"
    click PalS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/palestra-service/src/controllers/palestra.controller.js"
    click PalS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/palestra-service/src/models/palestra.model.js"
    click PalS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/palestra-service/src/routes/palestra.routes.js"
    click CS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/comentario-service/server.js"
    click CS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/comentario-service/src/controllers/comentario.controller.js"
    click CS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/comentario-service/src/models/comentario.model.js"
    click CS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/comentario-service/src/routes/comentario.routes.js"
    click PrS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/presenca-service/server.js"
    click PrS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/presenca-service/src/controllers/presenca.controller.js"
    click PrS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/presenca-service/src/models/presenca.model.js"
    click PrS "https://github.com/ceciliore/patharchitecture/blob/main/microsservico/presenca-service/src/routes/presenca.routes.js"
    click ESB "https://github.com/ceciliore/patharchitecture/blob/main/soa/esb-service/server.js"
    click ESB "https://github.com/ceciliore/patharchitecture/blob/main/soa/esb-service/rest-to-soap.js"
    click ESB "https://github.com/ceciliore/patharchitecture/blob/main/soa/esb-service/esb.wsdl"
    click SOAUser "https://github.com/ceciliore/patharchitecture/blob/main/soa/user-service/server.js"
    click SOAUser "https://github.com/ceciliore/patharchitecture/blob/main/soa/user-service/src/controllers/usuario.controller.js"
    click SOAUser "https://github.com/ceciliore/patharchitecture/blob/main/soa/user-service/src/controllers/perfil.controller.js"
    click SOAUser "https://github.com/ceciliore/patharchitecture/tree/main/soa/user-service/src/models"
    click SOAPal "https://github.com/ceciliore/patharchitecture/blob/main/soa/palestra-service/server.js"
    click SOAPal "https://github.com/ceciliore/patharchitecture/blob/main/soa/palestra-service/src/controllers/palestra.controller.js"
    click SOAPal "https://github.com/ceciliore/patharchitecture/blob/main/soa/palestra-service/src/controllers/comentario.controller.js"
    click SOAPal "https://github.com/ceciliore/patharchitecture/blob/main/soa/palestra-service/src/controllers/presenca.controller.js"
    click SOAPal "https://github.com/ceciliore/patharchitecture/tree/main/soa/palestra-service/src/models"

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#0366d6,color:#0366d6;
    classDef backend fill:#E6FFEA,stroke:#28a745,color:#28a745;
    classDef database fill:#FFE5B4,stroke:#e36209,color:#e36209;
    classDef external fill:#F0F0F0,stroke:#6a737d,color:#6a737d;
    classDef module fill:#FFF5E1,stroke:#d73a49,color:#d73a49;
    classDef gateway fill:#F5E6FF,stroke:#6f42c1,color:#6f42c1;
    classDef service fill:#E8F0FE,stroke:#1f6feb,color:#1f6feb;
    classDef middleware fill:#FBEFF5,stroke:#d73a49,color:#d73a49;
```
