El mecanismo de exposición/kill de capacidades es fail-closed y está cubierto por pruebas, pero es un control operativo de la plataforma — no un botón self-service por workspace hoy.
Además de la verificación de cuenta al día (suspensão) y del RBAC (papéis), la plataforma tiene una tercera capa: un resolutor de capacidades que decide si una superficie cara/sensible está expuesta, limitada o apagada — con efecto inmediato en emergencia.
Qué es#
Una capacidad es una superficie nombrada que puede encenderse/apagarse de forma ortogonal al plan y a la morosidad. Grupos:
| Grupo | Capacidades | Efecto de apagar |
|---|---|---|
| Dinero/consumo | consultas 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 Excel | corta la vía de pago correspondiente |
| Exposición/aislamiento | api.v1 (API externa REST+OData), painel público e embed (embed + dashboard público) | derriba la exposición externa sin tocar los datos internos |
| Piloto (ejecución) | execução de ingestão (pipeline), execução de relatórios (geração/entrega de relatório) | nada corre/encola/entrega |
| Organización | org.admin (administración de la org) | cierra la superficie de org (por-org) |
Cómo se toma la decisión (orden)#
- Kill global (
*) → todo cerrado. - Kill por capacidad → esa superficie cerrada.
- Config versionada (sobre
{ v, items }) → rollout %, allowlist/denylist, override por org/workspace/usuario, validez. - Predeterminado: capacidad declarada y sin kill nace expuesta. El resolutor también sabe tratar capacidad marcada como sensível — esa nace OFF sin decisión explícita (fail-closed) —, pero hoy ninguna capacidad del catálogo está marcada así, por decisión registrada en el código: marcar una de ellas la dejaría apagada para todo el mundo, y la barrera de morosidad es otra capa (suspensão). Es decir: el estándar efectivo hoy es "expuesta", y el control ocurre por el apagado y por los límites, no por un baseline apagado.
Encima de todo, el apagado de emergencia se superpone al final — emergencia siempre gana, incluso sobre una config custom.
Fail-closed es la regla#
- Config ilegible (JSON inválido) → la capacidad cierra (error de configuración), nunca "abre a oscuras".
- Capacidad sensível sin decisión → OFF (mecanismo probado; sin uso en el catálogo actual, como se explicó arriba).
- Efecto inmediato, sin redeploy, cuando el operador acciona la emergencia.
Para qué sirve#
- Contener incidente: apagar la API externa o el embed público en el momento, sin tumbar la app entera.
- Rollout seguro: liberar una capacidad para una fracción (canario) antes de 100%.
- Aislar exposición: matar
api.v1/painel público e embed corta el egress sin afectar a quienes solo usan el BI interno.
Plan y permisos#
- Visión admin: el efecto de las capacidades es visible para el workspace (una superficie desaparece/responde no disponible).
- Control: el accionamiento (kill/canario/rollout) es operacional/de plataforma — no es un toggle por workspace hoy.
Ejemplo#
Durante un incidente, el operador acciona el kill de api.v1. A partir de ahí, toda
llamada a las rutas /api/v1/** responde no disponible — pero los dashboards internos
de Comércio Aurora (ficticia) siguen en línea, porque los datos internos no fueron
tocados. Resuelto el incidente, la capacidad vuelve a exponerse.
Resultado esperado#
- Capacidad expuesta → funciona normalmente (la verificación de cuenta al día sigue vigente).
- Capacidad apagada → la superficie responde no disponible de forma predecible; el resto del producto continúa.
Relación con las otras verificaciones#
- RBAC decide qué puede hacer el rol (403 de rol).
- Verificación de cuenta al día decide si la cuenta está en día (402 de morosidad).
- Capacidad / apagado decide si la superficie está expuesta (independiente de las dos). Son capas ortogonales.
Seguridad#
- Fail-closed en todo el borde (config inválida/sensível → OFF).
- Decisión por org tiene cache aislada por
orgId— la decisión de una org nunca se filtra a otra. - Kill de emergencia no depende de redeploy.
Límites#
- No es un panel self-service por workspace: el ajuste lo hace nuestro equipo.
- El kill de exposición (
api.v1/painel público e embed) es ortogonal a la morosidad — no sustituye la verificación de suscripción ni el RBAC.
Errores comunes y cómo resolverlos#
| Sintoma | Causa probable | Qué hacer |
|---|---|---|
| API/OData respondiendo no disponible | capacidad api.v1 apagada (incidente) | acompañe el status; abra ticket |
| Embed/panel público fuera | capacidad painel público e embed apagada | ídem arriba |
| Refresh/IA/export fuera, pero dashboard abre | capacidad de consumo apagada (no es morosidad) | verifique con soporte |
| Recurso "desapareció" sin aviso de pago | kill de capacidad ≠ 402 de suspensión | diferencie de Suspensão |
Relacionados#
Última revisión: 2026-09-08.