Consumo e quotas

Selo de estado: GA-candidato (franquia, ledger, entitlements determinísticos) · escala/custo em nuvem não medidos (claims #1/#2) · Atualizado em 2026-09-06. Fonte de estado: matriz de estados do produto ( franquia; ledger de IA; budgets por workload). Limite atual do produto = Preview.

Consumo é uso de recursos (processamento e IA), pago em créditos. Quotas são os limites que cada plano aplica. Este é o painel financeiro-operacional do workspace.

Conceitos#

• Créditos de uso: saldo em R$ que cobre o consumo de nuvem (queries no processamento, egress de IA).
• Franquia mensal: os créditos inclusos do plano, creditados exatamente uma vez por ciclo (YYYY-MM).
• Recarga: créditos adicionais comprados (Pix), somados ao saldo.
• Entitlements: limites de recursos por plano (relatórios agendados, destinatários, modos de atualização etc.).
• Guarda de custo: teto de bytes por consulta que evita fatura-surpresa.

Disponibilidade#

• Planos: todos têm franquia, exceto Enterprise/custom (0 créditos inclusos — contrato manda).
• Estado: franquia, ledger e entitlements são determinísticos e provados (GA-candidato); escala real (10M/100M/1B linhas) e custo faturado em BRL não foram medidos em produção (claims #1/#2).

Entitlements por plano#

* "ilimitado" = teto muito alto (999) na prática. Modo ao vivo (rt) só com nuvem própria (BYOC), fora do plano.

Permissões#

• Gerir créditos/recargas/plano exige owner (billing.manage).
• Rodar ações que consomem (query, refresh, IA, export, relatório) exige papel e permissões finas adequados — ver Usuários e permissões.

Configuração#

1. Acompanhe saldo e extrato em Custos / Consumo.
2. A franquia é creditada automaticamente por ciclo (webhook de pagamento + rede de segurança por cron diário).
3. Recarregue créditos via Pix quando quiser folga acima da franquia.
4. Ajuste os entitlements trocando de plano.

Validação#

• O extrato distingue franquia (franquia:<ws>:<ciclo>) de recarga (id do pagamento) e de storage — cada um em seu bucket.
• A franquia é idempotente: reprocessar o mesmo ciclo não credita duas vezes.
• O ledger de IA é atômico (reserva → liquidação): consumo nunca "vaza" o teto.

Exemplo#

A Comércio Aurora (Growth) recebe R$ 150 de franquia no início do ciclo. Ao rodar pipelines e perguntas de IA, o consumo é debitado do saldo. Num mês de pico, Maria recarrega mais R$ 300 (Pix) — o extrato mostra "Franquia mensal do plano Growth — ciclo 2026-09" e a recarga separadamente.

Custo#

• Acompanhar consumo/quotas: R$ 0.
• O consumo real (processamento/IA) debita créditos. BRL faturado = projeção — a medição de custo/escala em nuvem ainda não foi certificada (claims #1/#2).
• O teto de volume por consulta limita o custo por consulta.

Segurança#

• Ledger de IA atômico + rate limit fail-closed: sem crédito, o recurso recusa (não segue "no escuro").
• Budgets por workload são advisory e fail-closed — a plataforma nunca troca o modo de execução sozinha.
• Consumo é auditado por workspace.

Limites#

• Escala real não medida (10M/100M/1B) — advisor e budgets existem, mas sem promessa de desempenho (claim #1).
• Sem expiração/rollover de franquia hoje: a franquia soma ao saldo único.
• Sem pro-rata de upgrade no meio do ciclo (ciclo já concedido não recalcula).
• /api/v1 (REST/OData) tem rate limit fail-closed por chave e por workspace, mas está fora de GA (claim #6).

Troubleshooting#

Próximos passos: Suspensão e inadimplência.

Estado & evidência: franquia + ledger = GA-candidato; escala e custo em nuvem = não medidos (claims #1/#2). Estado derivado da matriz de estados do produto (motores de franquia e de entitlements por plano).