Conceitos
O Orbi gira em torno de poucos conceitos. Entendê-los é tudo que você precisa para usar a plataforma com tranquilidade.
Indicador
Um indicador é a definição de algo que você quer medir — por exemplo "Notas fiscais emitidas" ou "Tempo médio de atendimento". Ele descreve o quê, mas não carrega o valor: o valor vive nas medições.
Um indicador tem:
- Nome — como ele aparece nos painéis.
- Unidade — contagem, moeda (R$), porcentagem, milissegundos, razão…
- Direção — se maior é melhor, menor é melhor ou neutro. É o que faz o semáforo da meta saber o que é "bom".
- Agregação — como colapsar vários pontos de um período num só número: somar, média, último, mínimo ou máximo.
- Período padrão — a granularidade natural (minuto, hora, dia, semana, mês).
- Tags e dimensões — para organizar e recortar (veja abaixo).
Medição
Uma medição é um ponto no tempo: um indicador, um instante, um valor e, opcionalmente, dimensões. Por exemplo: "Notas fiscais emitidas = 142 em 09/06/2026 às 18h, filial isaec".
As medições são imutáveis e append-only — cada nova medição acrescenta um ponto à história, em vez de sobrescrever. (A única exceção é o reenvio da mesma medição, que atualiza em vez de duplicar; veja idempotência.)
Série
Uma série é o conjunto de todas as medições de um indicador ao longo do tempo. É a série que permite ver tendência, desenhar o gráfico e comparar períodos. O Orbi também sabe reamostrar a série — por exemplo, mostrar valores diários agregados por semana ou por mês.
Meta
Uma meta (ou target) é o valor-alvo de um indicador num período, junto com limiares que definem as faixas do semáforo (verde / amarelo / vermelho). O Orbi usa a direção do indicador para interpretar os limiares corretamente e calcular o percentual de atingimento.
Origem
Uma origem é de onde vêm as medições: outro sistema, uma consulta agendada, um webhook ou entrada manual. Cada origem se identifica por um nome estável e alimenta o Orbi pelo protocolo.
Dimensão
Uma dimensão é um recorte do valor — por exemplo filial ou setor. Uma
mesma medição pode trazer dimensões (filial = isaec), permitindo filtrar e
empilhar a série por esses recortes nos dashboards.
Como tudo se encaixa
Regra mental: a origem entrega o número pronto. O Orbi não calcula nada do domínio da origem — ele armazena, versiona, agrega no tempo, compara com a meta e exibe.
Um indicador reúne suas medições numa série; a série é comparada com uma meta; e o resultado aparece no dashboard com valor, tendência e semáforo.