Planos
A matriz que define o que cada plano da plataforma inclui — módulos, features e limites.
Esta tela é acessível apenas a quem tem a permissão plans:manage — tipicamente o time da plataforma Adalink, não cliente final. Se você gerência uma org cliente e quer mudar o que está ativo, vá em Feature Flags.
Esta é a tabela mestra que decide o que cada plano (Free, Starter, Pro, Enterprise) entrega. Cada linha é uma capacidade da plataforma — pode ser um módulo (Chat, Agentes, Estúdio Criativo), uma feature granular (analytics.realtime) ou um limite numérico (limit.maxAgents). Cada coluna é um plano. Cada célula diz se aquele plano tem ou não aquela capacidade — ou, no caso de limites, qual o valor numérico.
Como funciona
A matriz é dinâmica — vem do banco. Você marca/desmarca direto na célula (boolean) ou edita o valor (limites). As mudanças entram em vigor imediatamente para novos clientes que assinam aquele plano. Para clientes que já estão no plano, a regra é entrar em vigor no próximo ciclo de cobrança — assim ninguém é surpreendido no meio do mês.
Os preços (R$ 0, R$ 99, R$ 399, Custom) ficam mostrados no topo de cada coluna como referência visual. A cobrança real e a gestão de assinatura são feitas via Stripe (no caso de Pro/Starter) ou contrato direto (Enterprise).
Para quem é útil
- Time da plataforma Adalink — define o portfólio dos planos e ajusta inclusões/limites entre tiers.
- Customer success — quando um cliente pede uma feature "que está só no Pro", aqui é onde se confirma.
A matriz é montada a partir de duas fontes: GET /v1/flags/definitions (catálogo agrupado por MODULE / FEATURE / LIMIT) e GET /v1/plans (overrides por plano). A edição célula-por-célula vai por PUT /v1/plans/{planId}/features/{flagKey}.
Endpoints
# Listar planos com a matriz de flags
curl https://api.adalink.ai/v1/plans \
-H "Authorization: Bearer SUPERADMIN_TOKEN"
# Atualizar uma feature/limite de um plano
curl -X PUT https://api.adalink.ai/v1/plans/PLAN_ID/features/chat.voice-input \
-H "Authorization: Bearer SUPERADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "value": true }'
# Limite numerico
curl -X PUT https://api.adalink.ai/v1/plans/PLAN_ID/features/limit.maxAgents \
-H "Authorization: Bearer SUPERADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "value": 50 }'Propagação de mudanças
Mudanças em um plano valem imediatamente para novos clientes que assinarem esse plano. Para clientes já no plano, o backend espera o próximo ciclo de cobrança para propagar — preserva o contrato vigente. Não há flag para forçar atualização imediata pelo painel; se precisar, vire um override de Feature Flag por organização (ver /v1/flags/org/{key}).
Os preços exibidos no topo da matriz vêm de constante hardcoded (PLAN_META) — só visualização. Cobrança real é gerenciada via Stripe (Pro/Starter) ou contrato direto (Enterprise). Não há endpoint público para alterar preço por aqui.