Pular para o conteúdo

Planos, franquia, créditos, entitlements

Aula 6 de 107 minOperarAtualizada em 2026-10-04

Vídeo em produção

A gravação desta aula está no lote de produção. O objetivo, o exercício e a documentação já valem. Duração-alvo: 7 min.

Objetivo: Calcular o que um plano permite

Selo de estado: Preview (teto atual do produto) · Curso ACD-240 — Administração, segurança e governança · Aula 6 de 10 · Atualizado em 2026-10-04.

Objetivo#

Ao final desta aula você vai calcular o que um plano permite — separando mensalidade, franquia de créditos e entitlements, e sabendo o que acontece quando a conta não está em dia.

Vídeo#

Identificador no manifesto: acd-240-06-planos-consumo-quotas · duração-alvo 7 min · tela do produto: /settings.

Roteiro de gravação (5 capítulos):

#Minutagem-alvoCapítuloTela do produto
10:00–0:45Abertura: três coisas distintas — mensalidade, franquia de créditos e entitlements./plans
20:45–2:30Os 5 planos lado a lado: créditos inclusos, conexões, criadores, visualizadores. Nenhum plano é "capado" em BI/IA./plans
32:30–4:10Entitlements por plano: relatórios com agenda, destinatários, narrativa de IA, PDF anexo, alertas, modos de atualização./plans
44:10–5:40Franquia × recarga no extrato; ledger de IA atômico (reserva → liquidação) e a guarda de custo por consulta./billing
55:40–7:00Comparar Starter × Growth num caso real da Aurora; "Sem assinatura" × "Plano atual"; erros comuns./plans

Conteúdo#

Três grandezas que as pessoas confundem

  • Mensalidade: o preço fixo do plano.
  • Franquia mensal de créditos: o saldo em R$ que cobre o uso de nuvem (consultas no BigQuery, egress de IA), creditado exatamente uma vez por ciclo (YYYY-MM). Acima dela, o consumo come recargas (compradas por Pix).
  • Entitlements: os limites de recurso por plano — quantos relatórios com agenda ativa, quantos destinatários por relatório, se há narrativa executiva de IA, PDF anexo, alertas inteligentes e quais modos de atualização.

São 5 planos, e BI, IA e as camadas Bronze/Silver/Gold existem em todos — nenhum plano é "capado" no essencial. O que muda é escala, automação, segurança, governança e colaboração.

PlanoMensalidadeCréditos/mêsConexõesCriadoresVisualizadores
StarterR$ 499R$ 503110
GrowthR$ 999R$ 15010350
BusinessR$ 2.490R$ 5003010200
ScaleR$ 4.990R$ 1.500100251.000
EnterpriseSob consultaPersonalizadoSob medidaSob medidaSob medida

Os recursos de segurança e governança escalam com o plano: RLS a partir do Growth; governança de PII, linhagem e auditoria a partir do Business; SSO/SLA a partir do Scale; nuvem própria (BYOC) como add-on no Business e incluída no Scale+. Entitlements operacionais seguem a mesma lógica: relatórios com agenda ativa vão de 1 (Starter) a 10 (Growth) e "ilimitado" (teto prático de 999) no Business+; destinatários por relatório, de 3 a 200; narrativa executiva de IA entra no Growth; PDF anexo e alertas inteligentes, no Business. Modo de atualização é batch (1×/dia) em todos e near_rt (~15 min) do Growth para cima — o modo ao vivo (rt) só existe com nuvem própria.

Como isso aparece no produto

Em Planos (/plans) o estado comercial é mostrado em dois cartões separados, de propósito: o plano registrado e a assinatura. Isso evita a contradição antiga de ver um plano "atual" sem contrato nenhum. Se o workspace nunca contratou, o cartão diz "Nenhum plano contratado" e o selo diz "Sem assinatura" — o plano listado é só referência do cadastro; nada foi contratado, nada foi cobrado. O rótulo "Plano atual" só aparece quando existe assinatura vigente. Se o provedor de pagamento não está configurado no ambiente, a tela marca simulação: assinar ali ativa o plano localmente para testar o fluxo, sem cobrança real.

Saldo, extrato e recargas ficam na área financeira do workspace (/billing). O extrato distingue franquia (franquia:<ws>:<ciclo>) de recarga (id do pagamento) e de armazenamento — cada um no seu bucket. A franquia é idempotente: reprocessar o mesmo ciclo não credita duas vezes. E o ledger de IA é atômico (reserva → liquidação), então o consumo nunca "vaza" o teto.

Três selos, três significados

exemplo = conteúdo ilustrativo · simulação = execução que não produz efeito real · estimativa = cálculo de previsão, não valor apurado. A tela de Custos é estimativa: ela projeta, não fatura.

Exemplo: Starter × Growth na Aurora

A Comércio Aurora precisa de 6 conexões, 2 pessoas montando painéis, 30 leitores, recorte de vendas por UF e um relatório semanal para 8 destinatários. No Starter (R$ 499 · R$ 50 de franquia) o caso não cabe: 3 conexões, 1 criador, 10 visualizadores, sem RLS, 1 relatório com agenda e 3 destinatários. No Growth (R$ 999 · R$ 150) cabe: 10 conexões, 3 criadores, 50 visualizadores, RLS incluída, 10 relatórios com agenda, 10 destinatários, narrativa de IA e near_rt. A conta de "o que o plano permite" é exatamente essa — item por item, contra a tabela. Num mês de pico, Maria recarrega R$ 300 por Pix, e o extrato mostra "Franquia mensal do plano Growth — ciclo 2026-09" separada da recarga.

Açãoviewermemberadminownerorg_admin
Ver o painel já materializado (leitura barata)✓✓✓✓—
Exportar (consome crédito e entitlement)—✓✓✓—
Rodar query/refresh/IA (consome crédito)——✓✓—
billing.manage — trocar plano, recarregar, pagar———✓—

Quando a conta não está em dia

A regra vive em um lugar só e é previsível: ações caras bloqueiam, leitura barata continua. São cinco ações caras — atualização manual, execução/envio de relatórios, consultas via API, exportação e recursos de IA. Em atraso, suspensa ou cancelada, cada tentativa responde 402 com mensagem pronta e link para Planos; sem contrato ativo, 403. Ver um dashboard já materializado nunca bloqueia, e a navegação continua — justamente para o dono conseguir chegar até Planos e pagar. O bloqueio vale para todos os membros, independente do papel.

Erros comuns

  • Tratar franquia como "limite de uso". Ela é saldo creditado; o limite de recurso é o entitlement.
  • Esperar pro-rata ao subir de plano no meio do ciclo. Não existe hoje: ciclo já concedido não é recalculado, e mudar includedCredits vale para os próximos ciclos.
  • Prometer o valor em BRL da fatura de nuvem. O custo faturado em BRL é projeção, não promessa — veja a aula 7.
  • Confundir 402 de cobrança com 403 de papel ou com recurso desligado por capacidade. São três camadas ortogonais.
  • Comprar Starter achando que "depois ligo a RLS". RLS começa no Growth.

Estado do produto

Catálogo de planos, franquia e entitlements são determinísticos e provados por testes; o teto público é Preview. Duas ressalvas explícitas: custo faturado em BRL é projeção e escala real (10M/100M/1B linhas) não foi medida em produção. A guarda de custo por consulta (maximumBytesBilled) existe para evitar fatura-surpresa, e o rate limit de IA é fail-closed — sem crédito, o recurso recusa em vez de seguir no escuro. A API /api/v1 tem rate limit por chave e por workspace, mas está fora de GA.

Faça você mesmo#

No workspace de treino Aurora Varejo (abra /settings no console e navegue para /plans):

  1. Abra /plans e anote qual cartão você vê: "Nenhum plano contratado" / "Sem assinatura" ou "Plano atual" com assinatura vigente.
  2. Se a tela marcar simulação, anote o que esse selo garante (nenhuma cobrança real, nenhum valor debitado).
  3. Monte o requisito da Aurora numa lista: 6 conexões · 2 criadores · 30 leitores · RLS por UF · 1 relatório semanal com 8 destinatários.
  4. Confronte a lista com Starter e com Growth, item por item, e aponte qual item reprova o Starter (há mais de um).
  5. Calcule a franquia mensal de cada um (R$ 50 × R$ 150) e escreva em uma frase o que acontece ao consumo quando a franquia acaba.
  6. Em /billing, localize no extrato a diferença entre franquia e recarga. Não faça nenhuma compra.
  7. Liste as cinco ações caras que bloqueiam quando a assinatura está em atraso — e o que continua funcionando.
  8. Responda por escrito: por que a navegação do app não é derrubada em caso de inadimplência?

Você terminou quando tiver a comparação Starter × Growth preenchida item por item, com o item reprovador identificado, e souber citar as cinco ações caras e a regra "leitura barata nunca bloqueia".

Checagem rápida#

Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.

Documentação relacionada#

Capacidades ensinadas#

C00.6 — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".

Carregando seu progresso…