# marco-mendes/arquitetura-software architecture

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

- Interactive diagram: https://gitdiagram.com/marco-mendes/arquitetura-software
- Repository: https://github.com/marco-mendes/arquitetura-software

## Overview

##### Project type and purpose
- This is a monorepo for a “Livro de Fundamentos de Arquitetura de Software Modernas.”
- It combines Markdown chapters (theory) with runnable code samples illustrating each architectural style (in Go, Python, Docker).
- Its goal is educational: teach styles such as Layered, Pipes-Filters, Microkernel, API styles, Microservices, Event-Driven, Container/Cloud.

##### File structure
- Top-level: numbered .md files (1.0…5.5) covering theory and exercises.
- README.md lists all chapters and links.
- “codigos” folder: one subfolder per style/chapter, e.g.:
- chassi-arquitetural, estilo em camadas, microkernel
- go-kong-api (Kong gateway + Go)
- microsservicos-rabbitmq and microsservicos (Go microservices with RabbitMQ)
- “pipes and filters” (Go + Kafka)
- protocolos-api-python (GraphQL, gRPC, REST HTTP/2/3, WebSocket demos in Python)
- protocolos-api (Go demos for GraphQL, gRPC, HTTP3, WebSocket)
- Each demo folder contains source (main.go or app.py), build files (go.mod, requirements.txt), Dockerfiles/docker-compose, sometimes certs.

##### README for additional insights
- Shows progression from fundamentals → API styles → microservices → events → cloud/container.
- Implies each code folder directly maps to a chapter’s pattern.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Theory Layer"
        Theory["Markdown Chapters"]:::theory
        README["README.md"]:::code
    end

    subgraph "Code Examples"
        subgraph "Go-based Demos"
            Chassis["Architectural Chassis<br/>(Microkernel)"]:::code
            Layered["Layered Architecture Demo"]:::code
            Microkernel["Microkernel Demo"]:::code
            Kong["API Gateway with Kong"]:::code
            MSBasic["Microservices Demo<br/>(Basic)"]:::code
            MSRabbit["Microservices Demo<br/>(RabbitMQ)"]:::code
            Pipes["Pipes-and-Filters Demo"]:::code
        end

        subgraph "Python Protocol Demos"
            PyGraphQL["GraphQL (Python)"]:::code
            PygRPC["gRPC (Python)"]:::code
            PyHTTP2["REST over HTTP/2"]:::code
            PyHTTP3["REST over HTTP/3"]:::code
            PyWS["WebSocket (Python)"]:::code
            PyModel["Domain Model"]:::code
        end

        subgraph "Go Protocol Demos"
            GoGraphQL["GraphQL (Go)"]:::code
            GogRPC["gRPC (Go)"]:::code
            GoHTTP3["HTTP/3 (Go)"]:::code
            GoWS["WebSocket (Go)"]:::code
        end
    end

    Theory -->|"drives"| Chassis
    Theory --> Layered
    Theory --> Microkernel
    Theory --> Kong
    Theory --> MSBasic
    Theory --> MSRabbit
    Theory --> Pipes
    Theory --> PyGraphQL
    Theory --> PygRPC
    Theory --> PyHTTP2
    Theory --> PyHTTP3
    Theory --> PyWS
    Theory --> GoGraphQL
    Theory --> GogRPC
    Theory --> GoHTTP3
    Theory --> GoWS

    click Theory "https://github.com/marco-mendes/arquitetura-software/blob/main/."
    click README "https://github.com/marco-mendes/arquitetura-software/blob/main/README.md"
    click Chassis "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/chassi-arquitetural/main.go"
    click Layered "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/estilo em camadas/estilo_em_camadas.go"
    click Microkernel "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/microkernel/microkernel.go"
    click Kong "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/go-kong-api/src/main.go"
    click MSBasic "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/microsservicos/api-gateway/main.go"
    click MSRabbit "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/microsservicos-rabbitmq/api-gateway/main.go"
    click Pipes "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/pipes and filters/produtor/produtorKafka.go"
    click PyGraphQL "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/protocolos-api-python/graphql_api/servidor/app.py"
    click PygRPC "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/protocolos-api-python/grpc_api/servidor/app.py"
    click PyHTTP2 "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/protocolos-api-python/rest_http2/servidor/app.py"
    click PyHTTP3 "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/protocolos-api-python/rest_http3/servidor/app.py"
    click PyWS "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/protocolos-api-python/websocket/servidor/app.py"
    click PyModel "https://github.com/marco-mendes/arquitetura-software/tree/main/codigos/protocolos-api-python/modelo_dominio"
    click GoGraphQL "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/protocolos-api/graph-ql/server/main.go"
    click GogRPC "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/protocolos-api/grpc/greeter_server/main.go"
    click GoHTTP3 "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/protocolos-api/http3/server/main.go"
    click GoWS "https://github.com/marco-mendes/arquitetura-software/blob/main/codigos/protocolos-api/websocket/server/server.go"

    classDef theory fill:#dddddd,stroke:#888888,color:#333333;
    classDef code fill:#bbddff,stroke:#5588ff,color:#000000;
    classDef infra fill:#ddffdd,stroke:#55aa55,color:#004400;
    classDef client fill:#ffffbb,stroke:#cccc55,color:#333300;
```
