Métricas¶

Todo número que a Brandvelia reporta é um agregado SQL determinístico. Funcionalidades de IA, dashboards e páginas de finanças leem as mesmas definições — ninguém recalcula à mão na UI.

Definições centrais de métricas¶

Métrica	Fórmula
`revenue`	Valor bruto dos pedidos (USD).
`refunds`	Dinheiro devolvido (USD).
`chargebacks`	Disputas (USD).
`fees`	Taxas de plataforma/rede (USD).
`ad_spend`	Gasto com anúncios (USD).
`opex`	Despesas operacionais (USD).
`conversions`	Pedidos concluídos.
`net_revenue`	`receita − reembolsos − chargebacks − taxas`
`profit`	`net_revenue − ad_spend − opex`
`gross_roas`	`receita / ad_spend`
`net_roas`	`net_revenue / ad_spend`

Todos os valores monetários estão em USD. Os períodos são delimitados por data de calendário: today (últimas 24h) e range (janela selecionada).

Snapshot determinístico¶

getDashboardSummary() (usado por Finanças, Copilot e Experimentos) executa a RPC bv_get_dashboard_summary sobre uma janela mensal e retorna:

interface DashboardSummary {
  today: PeriodMetrics;
  range: PeriodMetrics;
  funnel: { visits: number; leads: number; conversions: number };
  top_offers: RankedEntity[];
  top_campaigns: RankedEntity[];
}

Entidades rankeadas ordenam por net_revenue − ad_spend.

Sinais do Radar / Opportunity Score¶

Para produtos de marketplace, o Radar alimenta um Opportunity Score composto (0–100) construído a partir de:

Gravity — demanda do marketplace (sweet spot: 25–120).
Payout inicial (USD).
Quality tier.
Marcos de payout.
Quebra percentual entre os sinais.

No Motor de Decisão, o Opportunity Score v2 (opportunity/v2) é calculado em SHADOW apenas sobre cohorts maduras: 50% cobertura de conversão + 50% economia líquida normalizada (saturação USD 1.000), com hash determinístico por snapshot.

Os KPIs do dashboard são SQL puro: total de snapshots, score médio, contagem no sweet spot e maior payout inicial.

A regra da lei¶

Métricas e cálculos financeiros são determinísticos em SQL — nunca calculados por um LLM. Assistentes de IA leem o snapshot pré-computado e só podem reportar o que está presente.