Pular para o conteúdo
Atualizado em 2026-09-08

Capacidades e desligamento (visão de administração)

Como a plataforma expõe, limita ou desliga recursos caros e sensíveis em emergência, em liberação gradual ou em teste controlado — e o que isso significa para o seu workspace.

Nesta página (12)

O mecanismo de exposição/kill de capacidades é fail-closed e coberto por testes, mas é um controle operacional da plataforma — não um botão self-service por workspace hoje.

Além da verificação de conta em dia (suspensão) e do RBAC (papéis), a plataforma tem uma terceira camada: um resolvedor de capacidades que decide se uma superfície cara/sensível está exposta, limitada ou desligada — com efeito imediato em emergência.

O que é#

Uma capacidade é uma superfície nomeada que pode ser ligada/desligada de forma ortogonal ao plano e à inadimplência. Grupos:

GrupoCapacidadesEfeito de desligar
Dinheiro/consumoconsultas no console de dados, acesso ao conjunto de dados, amostragem de dados, atualização de painéis, consulta em linguagem natural, insights de IA, exportação para Excelcorta o caminho pago correspondente
Exposição/isolamentoapi.v1 (API externa REST+OData), painel público e embed (embed + dashboard público)derruba a exposição externa sem tocar no dado interno
Piloto (execução)execução de ingestão (pipeline), execução de relatórios (geração/entrega de relatório)nada roda/enfileira/entrega
Organizaçãoorg.admin (administração da org)fecha a superfície de org (por-org)

Como a decisão é tomada (ordem)#

  1. Kill global (*) → tudo fechado.
  2. Kill por capacidade → aquela superfície fechada.
  3. Config versionada (envelope { v, items }) → rollout %, allowlist/denylist, override por org/workspace/usuário, validade.
  4. Default: capacidade declarada e sem kill nasce exposta. O resolvedor também sabe tratar capacidade marcada como sensível — essa nasce OFF sem decisão explícita (fail-closed) —, mas hoje nenhuma capacidade do catálogo é marcada assim, por decisão registrada no código: marcar uma delas a deixaria desligada para todo mundo, e a barreira de inadimplência é outra camada (suspensão). Ou seja: o padrão efetivo hoje é "exposta", e o controle acontece pelo desligamento e pelos limites, não por um baseline desligado.

Em cima de tudo, o desligamento de emergência é sobreposto por último — emergência sempre vence, inclusive sobre uma config custom.

Fail-closed é a regra#

  • Config ilegível (JSON inválido) → a capacidade fecha (erro de configuração), nunca "abre no escuro".
  • Capacidade sensível sem decisão → OFF (mecanismo testado; sem uso no catálogo atual, como explicado acima).
  • Efeito imediato, sem redeploy, quando o operador aciona a emergência.

Para que serve#

  • Conter incidente: desligar a API externa ou o embed público na hora, sem derrubar o app inteiro.
  • Rollout seguro: liberar uma capacidade para uma fração (canário) antes de 100%.
  • Isolar exposição: matar api.v1/painel público e embed corta o egress sem afetar quem só usa o BI interno.

Plano e permissões#

  • Visão admin: o efeito das capacidades é visível para o workspace (uma superfície some/responde indisponível).
  • Controle: o acionamento (kill/canário/rollout) é operacional/de plataforma — não é um toggle por workspace hoje.

Exemplo#

Durante um incidente, o operador aciona o kill de api.v1. A partir daí, toda chamada às rotas /api/v1/** responde indisponível — mas os dashboards internos da Comércio Aurora (fictícia) seguem no ar, porque o dado interno não foi tocado. Resolvido o incidente, a capacidade volta a ser exposta.

Resultado esperado#

  • Capacidade exposta → funciona normalmente (a verificação de conta em dia segue valendo).
  • Capacidade desligada → a superfície responde indisponível de forma previsível; o restante do produto continua.

Relação com as outras verificações#

  • RBAC decide o que o papel pode fazer (403 de papel).
  • Verificação de conta em dia decide se a conta está em dia (402 de inadimplência).
  • Capacidade / desligamento decide se a superfície está exposta (independente dos dois). São camadas ortogonais.

Segurança#

  • Fail-closed em toda borda (config inválida/sensível → OFF).
  • Decisão por org tem cache isolado por orgId — a decisão de uma org nunca vaza para outra.
  • Kill de emergência não depende de redeploy.

Limites#

  • Não é um painel self-service por workspace: o ajuste é feito pela nossa equipe.
  • O kill de exposição (api.v1/painel público e embed) é ortogonal à inadimplência — não substitui a verificação de assinatura nem o RBAC.

Erros comuns e como resolver#

SintomaCausa provávelO que fazer
API/OData respondendo indisponívelcapacidade api.v1 desligada (incidente)acompanhe o status; abra chamado
Embed/painel público foracapacidade painel público e embed desligadaidem acima
Refresh/IA/export fora, mas dashboard abrecapacidade de consumo desligada (não é inadimplência)verifique com o suporte
Recurso "sumiu" sem aviso de pagamentokill de capacidade ≠ 402 de suspensãodiferencie de Suspensão

Relacionados#


Última revisão: 2026-09-08.

Links relacionados