How marco-mendes/arquitetura-software works
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.