Organizações na Zenifra
Organizações são o contexto principal para usar recursos na Zenifra. Cada conta CPF ou CNPJ possui uma organização, e uma mesma pessoa pode participar de várias organizações com a mesma conta de usuário.
Esse modelo permite separar projetos pessoais, empresas, clientes e equipes sem criar várias contas. Ao alternar a organização ativa no console, você muda o conjunto de projetos, bancos, chaves de IA, configurações de GitHub, cobranças e membros disponíveis naquele contexto.
Como funciona
Uma organização representa o espaço onde os recursos são criados e administrados. Projetos HTTP, bancos gerenciados, chaves de IA, integrações de deploy e dados de cobrança pertencem à organização ativa.
| Conceito | Descrição |
|---|---|
| Organização pessoal | Criada para uma conta individual, normalmente vinculada a CPF |
| Organização empresarial | Criada para uma empresa, normalmente vinculada a CNPJ |
| Organização ativa | Contexto selecionado no console para criar, visualizar e gerenciar recursos |
| Membro | Usuário convidado para colaborar em uma organização |
Quando você cria um projeto, ele fica associado à organização selecionada naquele momento. Para visualizar ou alterar esse projeto depois, é necessário estar na mesma organização e ter permissão suficiente.
Múltiplas organizações por usuário
Um usuário pode participar de N organizações com o mesmo login. Isso é útil para quem trabalha em mais de uma empresa, presta serviço para clientes diferentes ou precisa separar ambientes internos.
Exemplos comuns:
- uma pessoa tem sua organização pessoal e também participa da organização da empresa;
- uma consultoria mantém uma organização para cada cliente;
- um time separa produção, laboratório e projetos internos em organizações diferentes;
- um responsável financeiro participa apenas da organização onde precisa acompanhar custos.
As permissões são avaliadas por organização. Ter acesso amplo em uma organização não concede acesso automático a outra.
Papéis e responsabilidades
A Zenifra usa papéis para definir o nível base de acesso de cada membro.
| Papel | Uso recomendado |
|---|---|
| Owner | Responsável principal pela organização, cobrança, membros e permissões |
| Assistant | Pessoa de confiança para operar projetos e ajudar na administração |
| Member | Colaborador com acesso limitado aos recursos necessários |
O owner tem acesso administrativo completo. assistant e member podem receber permissões granulares para recursos e ações específicas, como visualizar logs de um projeto, alterar variáveis de ambiente, acionar deploys ou consultar transações.
Segurança e colaboração
Organizações ajudam a aplicar o princípio do menor privilégio. Em vez de compartilhar uma conta, cada pessoa usa seu próprio usuário e recebe apenas os acessos necessários.
Boas práticas:
- convide usuários pelo email correto da conta Zenifra;
- prefira permissões específicas para projetos críticos;
- revise membros ativos periodicamente;
- remova acessos quando uma pessoa sair do time;
- evite conceder permissões de cobrança ou variáveis de ambiente sem necessidade.
Esse fluxo reduz risco operacional, melhora rastreabilidade e facilita a colaboração entre pessoas técnicas, financeiras e administrativas.
Próximos passos
FAQ
Toda conta tem uma organização?
Sim. Contas CPF e CNPJ operam por meio de uma organização, mesmo quando apenas uma pessoa usa a conta.
Posso participar de mais de uma organização?
Sim. O mesmo usuário pode participar de várias organizações e alternar o contexto no console.
Projetos são compartilhados entre organizações?
Não. Projetos pertencem à organização onde foram criados. Para acessá-los, o usuário precisa estar naquela organização e ter permissão adequada.