Multi-tenancy

Hierarquia

Organization (Pepino Solution)
└── Project (Conquista Corretora · slug: conquista-corretora)
    ├── User (owner@cliente.com — role OWNER)
    │   └── User (vendas@cliente.com — role MEMBER)
    ├── ApiKey (pzk_live_xxx... — usada pelos seus sistemas)
    ├── Instance (vendas-1, vendas-2, ...)
    ├── Webhook (n8n, zapier, sistema próprio)
    └── Campaign (campanha-boas-vindas, ...)

Isolamento

Cada Project tem schema lógico isolado — uma API key só vê dados do próprio projeto
req.project.id injetado pelo ApiKeyGuard em toda chamada autenticada
Webhooks e campaigns são por Project (não compartilham entre projetos)
Instâncias têm sharding por worker — mais detalhe em Instâncias

Quem cria o quê

Quem	O que pode criar
Super admin (operador da plataforma)	Projects, suspende projetos, vê tudo
Owner do projeto	Users adicionais, API keys, instances, webhooks, campaigns
Admin do projeto	Mesma coisa que Owner exceto deletar o projeto
Member do projeto	Apenas opera (envia mensagens, vê conversas)

Em breve: mais detalhes sobre RBAC e permissões finas.

Hierarquia

Isolamento

Quem cria o quê

On this page