Central de Ajuda Para devs: developers.firmbe.at

Central de Ajuda

Como usar o Firmbeat — o Expectation OS da sua empresa.

O que é o Firmbeat

O Firmbeat é uma camada de observabilidade de negócio acima dos seus sistemas (SAP, Cloud ALM, ServiceNow, Datadog). Ele calcula a expectativa de cada métrica e a probabilidade de bater metas ou violar SLAs — ligando a saúde técnica ao resultado financeiro, com explicações.

Três perguntas que o Firmbeat responde em tempo real:

📈 Estamos no ritmo esperado?
🎲 Qual a probabilidade de virar problema?
⏱️ Agir agora ou esperar?

Acesso e papéis

O login usa Microsoft Entra. A Spingere acessa o admin pela conta corporativa; os clientes acessam studio e app por convite (a pessoa define a senha no fluxo do Entra).

Onboarding por convite

O administrador gera um convite por e-mail com um papel. No primeiro login com aquele e-mail, a conta é vinculada automaticamente ao workspace e ao papel.

Papéis

PapelOndeO que pode
platform_adminadminSpingere: cria tenants, convida, vê todos os clientes
tenant_adminstudioConsultor/admin do cliente: configura tudo do seu workspace
noc_analystappSala de Situação: leitura de todas as áreas (cross-área)
memberappUsuário final: vê o painel da sua área

Admin — backoffice (Spingere)

Em admin.firmbe.at:

  • Tenants: provisione um cliente (nome, domínio, e-mail do 1º admin). As 7 áreas padrão são semeadas automaticamente.
  • Convites & usuários: gere convites por e-mail com papel (member, NOC, tenant_admin).
  • Estrutura & licenciamento: visão somente-leitura do organograma do cliente — contagem de cargos, preenchidos, vagos e usuários (a edição é feita pelo cliente no Studio).

Studio — console do consultor

Em studio.firmbe.at o consultor configura o workspace do cliente:

  • Source Systems / Agentes: cadastro de fontes (SAP, Cloud ALM…) e ativação de coletores.
  • Métricas & Data Contracts: define as métricas canônicas.
  • Organograma: cria/edita cargos (árvore), atribui pessoas e papéis, recolhe ramos, cria áreas.
  • Visões por cargo: escolhe métricas e o tipo de gráfico (número/linha/barra/donut) que cada área/cargo vê.
  • Motor de Risco (fórmulas): ver abaixo.
  • Firmbeat Calendar: ver abaixo.
  • Alert Rules: regras de alerta com roteamento por área.

Um seletor de área no topo escopa o Calendar e os Alertas à área escolhida.

App — painel do usuário

Em app.firmbe.at o usuário final acompanha:

  • Meu Pulse: risco de não bater a meta, valor em risco, confiança e as métricas da sua área (esperado × atual + % no ritmo). Um seletor de área permite alternar entre as áreas a que o usuário tem acesso.
  • Sala de Situação: ver abaixo (papel NOC/admin).
  • Relatórios: snapshots do estado da empresa no tempo.

Organograma & visões

O organograma é uma árvore de cargos por área. Cada cargo tem um papel de acesso, uma pessoa atribuída e uma visão (conjunto de métricas + gráficos). O que o usuário final vê no painel é a visão do seu cargo (ou a visão default da área).

A plataforma traz uma biblioteca de métricas pré-pronta para as áreas mais comuns (Comercial, Marketing, TI, Produção, Manutenção, Financeiro, Controladoria).

Motor de Risco — fórmulas

No Studio, em Motor de Risco (fórmulas), o consultor modela a expectativa de cada métrica com fórmulas:

  • Biblioteca pré-pronta por departamento (ex.: Receita esperada, Probabilidade de bater a meta, OEE, Disponibilidade).
  • Editáveis: expressão + variáveis, com teste ao vivo do resultado.
  • Versionadas: cada alteração cria uma versão; é possível voltar (rollback) e publicar.
  • Variáveis disponíveis incluem eventFactor (dos eventos do Calendar) e funções exp, log, sqrt, pow, min, max, abs.

O painel passa a usar a fórmula publicada como expectativa; a realidade é o valor observado. A diferença gera o risco e a probabilidade (% no ritmo).

Firmbeat Calendar

Calendário organizacional de eventos que impactam métricas — qualitativa e quantitativamente.

  • Recorrência: pontual, anual ou a cada N anos (ex.: Copa do Mundo).
  • Multi-área: um evento pode atingir várias áreas.
  • Impactos: cada evento pode elevar/reduzir métricas (ex.: ▲ Receita 15%) — isso ajusta o baseline esperado na janela do evento.
  • Biblioteca de templates: Global, Brasil e EUA (Copa, Olimpíadas, Black Friday, Dia das Mães, Super Bowl, eleições…).
  • Visão mensal estilo Outlook, além da lista.

Sala de Situação (NOC)

Um video-wall com um painel por área, para monitorar a empresa inteira ao mesmo tempo. Cada painel mostra risco, valor em risco e as métricas da área, com realce por severidade. Tem atualização automática e modo tela cheia. Disponível para os papéis NOC, tenant_admin e platform_admin.

Alertas multi-área

Uma regra de alerta pode ser roteada para várias áreas. Exemplo: um alerta de latência do e-commerce vai ao gerente de TI e também ao de Marketing. No painel de cada área aparecem os alertas roteados a ela (mais os de "todas as áreas").

Relatórios (snapshots)

No app, em Relatórios, é possível capturar um snapshot do estado atual da empresa — risco, valor em risco, métricas (esperado × real), alertas e eventos do momento — congelado e datado. O histórico permite consultar como a empresa estava em cada data.

Como o Firmbeat pensa

Expectativa vs. realidade

Para cada métrica, o Firmbeat compara o esperado (fórmula/baseline + eventos) com o real (observado). O desvio vira risco e probabilidade.

Probabilidade explicável

Em vez de só mostrar um número, o Firmbeat estima a probabilidade de estar no ritmo e o valor em risco — e mostra os drivers.

Multi-área

Áreas têm visões, eventos e alertas próprios; um item pode atravessar áreas quando faz sentido.

FAQ

Não consigo entrar / "não encontramos uma conta"

No primeiro acesso, use "Criar uma" no login para cadastrar a conta com o mesmo e-mail do convite.

Minha conta não está vinculada a um workspace

Peça ao administrador um convite para o seu e-mail; o vínculo ocorre no primeiro login.

Por que o esperado da métrica mudou?

Provavelmente uma fórmula foi publicada/ajustada no Motor de Risco, ou há um evento do Calendar em curso ajustando o baseline.

Firmbeat — saiba o que sua empresa deveria estar fazendo agora.