Allan Simões AdegasEnglish
Menu
Voltar para o início

Tenant Starter

Demo validada

Starter de SaaS multiempresa com FastAPI, identidade via OIDC e isolamento por linha no PostgreSQL.

Papel
Projeto pessoal
Início
2026
Tenant Starter
Ilustração do projeto
2
tenants sintéticos
5
testes executados com PostgreSQL 17

Visão geral

Dois tenants sintéticos usam a mesma API e o mesmo banco. Para listar ou criar um item, o usuário precisa apresentar um token válido e ter vínculo com o tenant escolhido.

O modelo aproveita a ideia de vínculos e políticas de acesso usada no projeto Gestão Condominial.

O que ele faz

Identidade e associação
A API valida assinatura, emissor, audiência e prazo do JWT. O vínculo é conferido pelo backend antes de abrir o escopo de dados.
Políticas no banco
O PostgreSQL limita leitura e inserção ao tenant da transação. O papel em uso na API tem RLS aplicado.

Arquitetura

Arquitetura: Tenant StarterCliente → FastAPI. FastAPI → JWKS. FastAPI → Vínculo do tenant. Vínculo do tenant → PostgreSQLJWTClienteFastAPIJWKSVínculo do tenantPostgreSQLRow-level security
A API valida identidade e vínculo antes de consultar itens sob as políticas de isolamento.

Decisões e trade-offs

Escopo por transação
O contexto do tenant termina junto da transação. Isso permite reutilizar conexões do pool depois de commit ou rollback.

Qualidade e operação

  • Os testes verificam isolamento de leitura e escrita, falha fechada sem contexto e limpeza do escopo na mesma conexão do pool.
  • JWTs assinados foram validados com um JWKS simulado no teste.

Estado e próximos passos

  • Integrar um provedor de identidade e preparar migrações e gestão de vínculos para um ambiente persistente.

Stack

PythonFastAPISQLAlchemyPostgreSQLRLSOIDCpytestDocker Compose