Tenant Budgets & Circuit Breakers

A Prevenção de Abuso Financeiro (Billing Exhaustion)

Como o sistema opera chamadas frequentes a APIs externas cobradas por volume (DevCod AI Core, DevCod Voice Synthesizer, DevCod Mail), o DevCod Agency conta com uma camada rigorosa de proteção financeira para os tenants.

Modelo de Dados (DevCod ORM: `TenantBudget`)

Toda transação passa pela tabela de orçamentos e limites antes de iniciar:

{`
model TenantBudget {
  id              String   @id @default(cuid())
  siteId          String   @unique
  maxMonthlyTokens Int      @default(5000000)
  usedTokensThisMonth Int    @default(0)
  maxMonthlyEmails Int      @default(10000)
  usedEmailsThisMonth Int    @default(0)
  maxMonthlyVoiceSeconds Int @default(3600)
  usedVoiceSecondsThisMonth Int @default(0)
  circuitBreakerActive Boolean @default(false)
  updatedAt       DateTime @updatedAt
}
          `}

O Circuit Breaker Criptográfico

O motor de orquestração do Agente Prime realiza uma verificação prévia (Pre-flight Check) antes de iniciar qualquer chamada de IA ou processamento:

• Comparação de Cotas: Compara o saldo de tokens ou e-mails usados contra o limite contratado.
• Disparo do Circuit Breaker: Se o faturamento ou cota exceder 100% (ou se circuitBreakerActive for setado manualmente para True por falta de pagamento), as APIs respondem imediatamente com erro HTTP 402 (Payment Required) e suspendem os fluxos do Flow Builder.
• Reset Mensal: As contagens de consumo são limpas de forma atômica no primeiro dia de cada mês por meio de um Cron Job interno de manutenção do sistema.