Comece aqui

Tipo

Visão geral

O Lumo é a plataforma de dados da HorusBI. Ele reúne num só lugar o dado que hoje está espalhado pelos sistemas da empresa (o ERP, o banco de um sistema próprio, planilhas, APIs), guarda esse dado em tabelas e responde a quem pergunta por ele: numa tela de Dashboard, numa conversa com IA ou de dentro de outro sistema.

Para trazer o dado, um Agente ETL lê os bancos e as APIs nos horários agendados e grava o resultado no Lumo. Para um banco que só aceita conexão da rede interna, como costuma ser o do ERP, o Agente é instalado numa máquina dessa rede, e a conexão sempre sai dela para o Lumo: o banco não precisa ficar exposto na internet. Para uma API ou um banco em nuvem, o Agente pode rodar na nuvem da HorusBI. O dado chega em tabelas do HorusDW, o data warehouse do Lumo, onde cada coluna tem tipo e cada tabela tem chave. Veja Como o HorusETL funciona.

Antes de qualquer consulta, duas coisas ficam definidas no Lumo e valem para todo mundo:

• O que cada número significa. Um Indicador grava uma vez a fórmula de um número do negócio, como o faturamento líquido, com os filtros fixos e a coluna de data que mede o tempo. A tela de Indicadores, o Chat com Dados e o MCP leem essa mesma definição. A conta não muda conforme o lugar onde se pergunta; muda só o recorte de linhas que cada pessoa pode ver.
• Quem vê o quê. O acesso é dado por tabela, e dentro dela pode ser recortado por linha e por coluna. Um vendedor, por exemplo, vê só as próprias vendas. O recorte vale em toda consulta: no Dashboard, na exportação, no Chat com Dados, no MCP e nos alertas. Veja Acesso a dados.

Com isso definido, o mesmo dado pode ser lido de vários lugares: Dashboards, alertas e apresentações do DataViz; o Chat com Dados, que responde perguntas escritas como numa conversa; assistentes de fora, como o Claude e o ChatGPT, ligados pelo MCP; e o sistema de um parceiro que embute o Lumo para os próprios clientes. Todos passam pelas mesmas definições e pelo mesmo recorte de acesso.

As camadas do Lumo

Cada camada fica numa suíte, ou em duas (as suítes são as partes do Lumo com menu próprio: HorusETL, HorusDW, DataViz e HEC). A IA usa o mesmo dado e as mesmas permissões das suítes.

Camada	O que faz	Onde
Ingestão	Dataflows que um Agente ETL roda nos horários agendados, lendo bancos, planilhas do Google e APIs	HorusETL
Armazenamento	Tabelas com tipo de coluna e chave, e Cadastros, tabelas preenchidas dentro do Lumo	HorusDW
Camada semântica	Relacionamentos entre tabelas e expressões, numa Aplicação; Indicadores, com nome e fórmula fixos	DataViz e IA
Governança	Usuários, grupos, acesso às Mesas e às tabelas, restrição de linha e de coluna, uso de recursos e conta	HEC
Consumo	Dashboards, alertas e apresentações; Chat com Dados; MCP	DataViz e IA

Fluxo do dado

O dado entra por um de três caminhos, todos terminando numa tabela do HorusDW. A planilha .xlsx vira um Cadastro já preenchido.

Entrada	Quando usar	Onde começa
Planilha	Dado que parou de mudar: base histórica, levantamento pontual	HorusDW, Novo Cadastro › A partir de um Excel
Cadastro	Dado digitado por pessoas: metas, de-para, parâmetros	HorusDW, Novo Cadastro › Começar vazio
Dataflow	Dado que um sistema mantém: banco, ERP, API	HorusETL, com Agente ETL

A escolha entre os três está em Como o dado entra.

Depois da entrada, o caminho é sempre o mesmo. Tudo nasce em Minha Mesa, onde só quem criou enxerga. A tabela é publicada numa Mesa de Dados (no caso do Dataflow, publicar o Dataflow publica a tabela junto). Uma Aplicação do DataViz usa a tabela, e ela também é publicada, numa Mesa de Aplicação. Por fim, quem administra libera para os colegas a Mesa de Aplicação e a tabela.

O passo de liberar é o que mais se esquece. Publicar não dá acesso a ninguém, e liberar só a Mesa de Aplicação entrega um Dashboard que abre sem número: quem consome precisa também do acesso à tabela. Veja Mesas e publicação e Acesso a dados.

Para fazer o caminho inteiro uma vez, siga Seu primeiro Dashboard compartilhado.

Pelo Lumo CLI

O mesmo ambiente pode ser montado sem passar pelas telas. O Lumo CLI descreve Dataflows, tabelas, Cadastros, Aplicações e Mesas em arquivos YAML, que você versiona e que um agente de IA consegue editar por você. Veja Lumo CLI.

Quando o número não bate

O sintoma costuma apontar a parte do caminho onde está o problema:

O que aparece	Onde costuma estar	Veja
Número faltando, ou parado numa data antiga	Na carga: o Dataflow falhou ou não rodou	Problemas do HorusETL
Número dobrado	Na tabela, uma linha gravada duas vezes; ou na Aplicação, duas tabelas fato ligadas direto	A tabela duplica a cada carga e Modelo de dados
Quem criou vê o número, o colega vê os gráficos vazios	No acesso: o colega tem a Mesa de Aplicação, mas não a tabela	Acesso a dados

Por onde começar

Você	Quer	Comece por
Usuário	Abrir Dashboards, filtrar, exportar, receber alertas	DataViz
Analista	Montar Aplicações e Dashboards sobre tabelas que já existem	Primeira Aplicação
Engenharia de dados	Trazer o dado de um banco ou API com carga agendada	Instalar o Agente ETL
Administrador do Tenant	Dar acesso, cuidar de usuários e segurança	HEC e Papéis
Parceiro whitelabel	Revender ou embutir o Lumo, criar Tenants, usar a sua marca	Whitelabel
Desenvolvedor	Versionar o ambiente em YAML, integrar pela API, programar widgets	Lumo CLI e API

Termos novos estão no Glossário.