Console e equipe da plataforma

Este guia é para a equipe que opera o Coda Cloud. O console de administração fica em /admin no portal. A visão geral e a gestão de planos, entitlements e cortesias exigem o papel platform_admin; uma conta de tenant que abre essas telas recebe "Acesso negado".

Contas da equipe da plataforma

A equipe da plataforma é toda conta com um papel de realm de plataforma: platform_admin, marketplace_admin e marketplace_reviewer. Ela administra a plataforma, mas não é tenant: não é Owner, Admin, Developer nem Viewer de organização nenhuma.

Ação	Resposta para uma conta da equipe
Criar organização	403 platform.staff_cannot_join_organization
Ser convidada para uma organização (convite para o e-mail dela)	409 platform.staff_cannot_join_organization
Aceitar convite, inclusive um feito antes de entrar na equipe	409 platform.staff_cannot_join_organization
Receber papel em organização	409 platform.staff_cannot_join_organization

• Login: a conta da equipe cai direto no console /admin, sem a navegação de tenant nem o seletor de organização. As telas de organização (/orgs/...), /dashboard e as de convite mostram "Contas da equipe da plataforma não usam o portal de organizações".
• Membro promovido: se alguém que já era membro de uma organização entra na equipe, a associação fica bloqueada (403 nas rotas da organização e "bloqueado" na lista de membros), sem apagar nada. Se a organização ficar sem Owner ativo, ela aparece na visão geral.
• Testar como cliente: use uma conta separada, sem papel de plataforma.

Agir sobre uma organização

Plano, overrides, cortesias e suspensão de uma organização são feitos em Organizações (/admin/orgs). Cada ação entra na auditoria da organização com o ator e a marca platform_staff. A organização vê essas entradas na própria auditoria, sem o motivo interno dos overrides.

Visão geral

A home do console (/admin) é a visão geral com os pontos de atenção da plataforma. Cada cartão traz severidade (info, warning ou critical), a contagem, até 5 itens e um link para a lista filtrada.

Cartão	O que mostra
Organizações acima de quota	Organizações cujo uso passou do limite efetivo de alguma quota, por quota (por exemplo, depois de um rebaixamento)
Overrides e cortesias vencendo	Overrides e cortesias que vencem nos próximos 7 dias, e overrides sem validade
Chaves órfãs e valores fora da faixa	Valores de planos para chaves que saíram do catálogo e valores que ficaram fora da faixa atual da definição
Organizações sem Owner ativo	Organizações em que nenhum Owner pode agir, por exemplo depois de uma promoção à equipe
Planos	Planos ativos sem nenhuma organização e plano padrão que não está disponível para escolha

Cada cartão é calculado com um limite de tempo. Um cartão que falha aparece como indisponível, sem derrubar os outros. Outros módulos acrescentam os próprios cartões conforme chegam (capacidade, segurança e borda).

API

Registries autorizados e tamanhos de aplicação

Em Registries autorizados (/admin/registries), autorize o host de um registry de imagens ou remova uma autorização. Informe somente o host e, se necessário, a porta, sem https:// nem caminho. A lista é paginada. A remoção impede novos deploys dessa origem; não remove aplicações em execução. Credenciais privadas continuam sendo configuradas nas integrações de cada organização.

Em Tamanhos de aplicação (/admin/workload-sizes), ajuste CPU em millicores, memória em MiB e a disponibilidade dos tamanhos oferecidos a aplicações e workers. Os limites de plano continuam sendo aplicados. Alterar um tamanho não redimensiona automaticamente as aplicações existentes: os novos valores valem para futuras escolhas de tamanho. Essas duas telas exigem platform_admin, e as alterações ficam registradas na auditoria da plataforma.

Método e rota	O que faz
GET /api/v1/admin/registries	Lista paginada de hosts autorizados
POST /api/v1/admin/registries	Autoriza um host
DELETE /api/v1/admin/registries/{id}	Remove a autorização
GET /api/v1/admin/workload-sizes	Catálogo completo, incluindo tamanhos indisponíveis
PUT /api/v1/admin/workload-sizes/{name}	Ajusta recursos e disponibilidade

Visão geral

Método e rota	O que faz
GET /api/v1/admin/overview	Cartões da visão geral

Todas as rotas /api/v1/admin/* exigem platform_admin. A gestão de planos, entitlements e cortesias está em Planos e entitlements.