Conceitos

O Coda Cloud organiza os recursos em uma hierarquia simples: organização → projeto → ambiente → aplicação. As permissões vêm do papel que cada pessoa tem na organização.

Organizações

A organização é o tenant. Ela tem um plano, membros, projetos, integrações com provedores Git, domínios, conta de cobrança e trilha de auditoria.

• Você só vê as organizações das quais é membro. Recursos de outra organização respondem como inexistentes.
• Uma pessoa pode pertencer a várias organizações e alterna entre elas pelo seletor do portal.
• Toda organização mantém pelo menos um Owner.
• Uma organização pode ser suspensa pela administração da plataforma em caso de abuso ou incidente. A suspensão pode bloquear o acesso, os deploys e o tráfego apenas daquela organização, e o portal mostra um aviso aos membros.

Projetos

O projeto agrupa aplicações, domínios e rotas de um mesmo produto. Owner e Admin criam projetos, com nome e slug únicos dentro da organização. Somente o Owner arquiva um projeto: projetos arquivados saem da listagem padrão e não aceitam novos ambientes nem recursos.

Ambientes

Cada projeto nasce com três ambientes:

Ambiente	Uso
development	Desenvolvimento e testes do time.
staging	Homologação antes de produção.
production	Produção. É protegido e não pode ser removido.

Owner, Admin e Developer podem criar ambientes extras (por exemplo, preview) e remover ambientes vazios. Variáveis, segredos e deploys são sempre por ambiente. Cada ambiente roda isolado dos demais, com rede fechada por padrão.

Aplicações

A aplicação é o que roda: uma imagem de contêiner com porta interna, número de instâncias, CPU, memória e health check. Cada aplicação pertence a um ambiente. Veja Deploy de aplicação.

Papéis

Papel	O que pode fazer
Owner	Tudo o que o Admin faz, mais: atribuir ou remover outros Owner, arquivar projetos e alterar a conta de cobrança.
Admin	Gerenciar membros e convites, criar projetos, conectar provedores Git, gerenciar domínios, políticas e exceções do WAF, aprovar exceções de vulnerabilidade, remover segredos e consultar auditoria, consumo e faturas.
Developer	Criar ambientes, aplicações, deploys, builds, rotas e domínios; escalar e fazer rollback; criar, alterar e rotacionar variáveis e segredos.
Viewer	Somente leitura. Não vê as ações de alteração no portal.

O portal mostra apenas as ações permitidas ao seu papel, e a API recusa as demais.

Auditoria

Toda alteração gera um evento de auditoria na mesma transação: quem fez, o quê, em qual recurso, quando e com qual motivo. Os eventos são imutáveis e encadeados por hash, o que permite detectar remoção ou alteração. Valores de segredos, senhas, tokens e cookies nunca entram na auditoria. Owner e Admin consultam a trilha da organização em Auditoria, com filtros por ação, pessoa e período.