Conceitos

O Lumo CLI não inventa conceitos próprios — ele opera os mesmos recursos do HorusBI que você já vê na interface, só que como arquivos YAML num diretório local. Esta página conecta cada tipo de recurso do Lumo ao conceito da plataforma e aponta onde se aprofundar.

TIP

Se você é novo no HorusBI, leia esta página como mapa. Cada linha liga uma pasta do seu workspace a um conceito — e o link leva à explicação completa daquele conceito.

O modelo mental

Um tenant é o seu ambiente HorusBI. O lumo init <tenant-id> cria um workspace: um diretório local que espelha esse tenant em YAML. Você edita os arquivos, e push/pull sincronizam com o servidor.

Cada pasta do workspace corresponde a um tipo de recurso da plataforma:

Pasta	Recurso	O que é	Aprofunde em
flows/	Flow	Pipeline de ETL: extrai, transforma e carrega dados	Introdução ao HorusETL
tables/	Tabela DW	Tabela do Data Warehouse (fato ou dimensão)	Introdução ao HorusDW · Arquitetura do DW
apps/	App	Aplicação de BI / dashboard com widgets	Introdução ao DataViz
credentials/	Credencial	Conexão com um banco ou fonte de dados	Conexões de Banco
schedules/	Agendamento	Execução automática e recorrente de um flow	Execução e Agendamentos
agents/	Agente	Worker que executa os flows	Agentes de Execução
dw-desks/	Mesa de dados	Agrupa flows + tabelas publicados	Mesas e Publicação
bi-desks/	Mesa de aplicação	Agrupa apps publicados	Mesas e Publicação
variables/	Variável	Valor reutilizável no tenant	Variáveis Globais

Conceitos que aparecem nos comandos

Alguns termos surgem direto na Referência de Comandos. Aqui está o que significam e onde estudá-los a fundo:

• Tipo de carga (--context Total | Incremental | Temporal em lumo flow run) — define como o flow grava no DW: substituindo tudo, acrescentando o novo, ou por janela temporal. Veja o processador Inserir no Datawarehouse.
• Star schema / Relacionamentos — tabelas Fato se conectam a Dimensões (1:N); conectar dois Fatos direto causa explosão cartesiana. Essencial para modelar apps. Veja Modelagem de Dados.
• Rascunho → Publicado — você constrói e itera um flow/app como rascunho (editável); ao publicar, ele vai para uma mesa, fica somente-leitura e é compartilhado. Por isso editar um recurso publicado exige clone antes. Veja Mesas e Publicação.
• Mesa de dados vs Mesa de aplicação (dw-desk vs bi-desk) — flows e tabelas publicam em mesas de dados; apps publicam em mesas de aplicação. Veja Mesas.

Próximo passo

Com o mapa em mente, siga para os Primeiros Passos e crie seu primeiro workspace.