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

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