Pular para o estudo de caso
Todos os projetos
Projetos selecionados02 / 04 · 2 min de leitura

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.

Esquema conceitual do sistema · não é uma captura do produto
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.

01 /

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.

02 /

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.

03 /

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.

  1. Clientes e API

    O cliente Streamlit consome a API versionada do FastAPI. Uma interface independente com Next.js está em desenvolvimento.

  2. Fluxos de aplicação

    Os módulos de autenticação, usuários e itens coordenam operações e autorização por casos de uso.

  3. Domínio e portas

    Os limites de aplicação descrevem a persistência e os serviços necessários em cada fluxo.

  4. 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.

01

Organizar 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.

02

Usar 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.

03

Consultar 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