Estudo de caso ↘
FastAPI Ecosystem Lab
Um backend, vários clientes e limites explícitos.
O projeto explora como conectar autenticação, contas e operações sobre itens mantendo a lógica de aplicação separada de bancos de dados, cache e serviços externos.
- Meu papel
- Desenvolvedor · projeto pessoal de aprendizado
- Contexto
- Prática de arquitetura backend e integração full stack
- Estado do projeto
- Backend em evolução · interface Next.js em desenvolvimento
- Período
- Mar 2026 – Atualmente
O desafio
Tudo começa com um problema.
O problema
Um backend que atende a diferentes clientes precisa de regras consistentes de autenticação, propriedade e acesso a dados. Misturá-las às rotas dificulta a compreensão conforme as integrações crescem.
A abordagem
Organizar autenticação, usuários e itens em módulos. Posicionar os fluxos de aplicação atrás das rotas e conectar persistência, cache, arquivos e eventos por adaptadores.
Minha contribuição
Da ideia à implementação.
Autenticação e contas
Conexão de uma API versionada com autenticação, renovação de tokens, encerramento de sessão e gerenciamento de contas.
Operações com controle de propriedade
Implementação de fluxos que resolvem o proprietário autorizado antes de consultar ou alterar itens, com leituras de listas usando cache sob demanda.
Adaptadores e integração de clientes
Composição de adaptadores SQLAlchemy, Redis, Cloudinary e eventos do servidor, com um cliente Streamlit e uma interface Next.js em desenvolvimento.
Arquitetura
Como as peças se conectam.
Um backend modular em um monorepo de aprendizado. A apresentação chama os fluxos de aplicação; regras de domínio e portas separam esses fluxos da infraestrutura.
Clientes e API
O cliente Streamlit consome a API versionada do FastAPI. Uma interface independente com Next.js está em desenvolvimento.
Fluxos de aplicação
Os módulos de autenticação, usuários e itens coordenam operações e autorização por casos de uso.
Domínio e portas
Os limites de aplicação descrevem a persistência e os serviços necessários em cada fluxo.
Adaptadores de infraestrutura
A composição de dependências conecta SQLAlchemy, cache Redis, arquivos no Cloudinary e eventos SSE.
Ferramentas do projeto
- Python
- FastAPI
- SQLAlchemy
- PostgreSQL
- Redis
- Streamlit
- Next.js
Decisões
O raciocínio por trás do código.
01Organizar por funcionalidade e responsabilidade
Separar autenticação, usuários e itens, com responsabilidades de apresentação, aplicação, domínio e infraestrutura.
Por que esta decisão / compromisso
Mais módulos e configuração explícita em troca de locais claros para alterar um fluxo ou uma integração.
02Usar portas para serviços externos
Compor os adaptadores concretos de persistência, cache, arquivos e eventos no limite de dependências.
Por que esta decisão / compromisso
Os contratos dos adaptadores exigem trabalho inicial e mantêm os detalhes de cada serviço fora dos fluxos de aplicação.
03Consultar listas com cache
Usar cache sob demanda nas listas de itens após resolver o escopo autorizado do usuário.
Por que esta decisão / compromisso
O cache acrescenta necessidades de invalidação e consistência junto ao acesso ao banco de dados.
O resultado
O que o projeto entrega.
API versionada para autenticação, contas e operações sobre itens com controle de propriedade.
Fluxos de aplicação conectados a persistência, cache, envio de arquivos e adaptadores SSE.
Cliente Streamlit implementado e interface Next.js em desenvolvimento no mesmo monorepo.
O que aprendi
Separar regras de aplicação e infraestrutura torna as dependências visíveis. O projeto permite estudar escopo de autorização, consistência de cache e como diferentes clientes compartilham uma API.
Explore a implementação
Aprofunde-se nos detalhes consultando o código-fonte.
Continue explorando
Vamos construir algo útil.
Vamos conversar