Ambientes e multi-tenant
Como o Ecom isola cada loja por subdomínio e como direcionar as requisições ao tenant certo.
3 min de leituraAtualizado em 12 de agosto de 2026
Cada loja é um tenant com dados isolados (schema próprio no Postgres e DB por tenant no Mongo). O tenant é resolvido em toda requisição.
Como o tenant é resolvido
- Produção: pelo subdomínio do Host (ex.: minha-loja.ecom.app).
- Desenvolvimento: pelo header X-Tenant: minha-loja.
- Rotas autenticadas também derivam o tenant do próprio token (JWT).
Um token emitido para uma loja não vale em outra: o guard cross-tenant bloqueia (401) qualquer requisição cujo tenant do token não bata com o da loja.