# HorusBI

> Plataforma SaaS de Business Intelligence: ETL (HorusETL), Data Warehouse (HorusDW), visualização (DataViz) e uma CLI declarativa em YAML (Lumo CLI).

## Instruções para agentes de IA

- A interface programática de GESTÃO do HorusBI é o **Lumo CLI**, uma CLI declarativa
  em YAML. Não existe servidor MCP de gestão, e isso é deliberado: a CLI cobre todas
  as operações com menor consumo de token.
- Para CONSULTAR DADOS (queries analíticas, indicadores), existe o servidor MCP do
  Lumo (beta): endpoint `/mcp` autenticado por token pessoal, read-only. Ver a
  página "Conectar seu Assistente de IA (MCP)" em /ia/mcp.
- **Comece pela skill oficial**, mantida junto do código: `llms/SKILL.md` no
  repositório do Lumo CLI. Ela tem comandos, fluxos, pegadinhas e tabela de erros.
- **Valide o YAML antes de subir.** Os schemas JSON estão em
  https://docs.horusbi.com.br/schemas/v2/<kind>.schema.json, use
  `# yaml-language-server: $schema=...` no topo do arquivo, ou rode `lumo lint`.
- **Descubra o YAML de qualquer kind sem sair do terminal:** `lumo scaffold <kind>`.
- Qualquer página desta documentação pode ser lida em markdown puro: acrescente
  `.md` ao fim da URL.

## Fluxo canônico

```bash
lumo status
lumo scaffold table > tables/d-cliente.yaml
lumo lint
lumo push
```

## Documentação

- [Aba Conceitos IA](https://docs.horusbi.com.br/dataviz/02-apps/ai-concepts.md)
- [Aba Dashboards](https://docs.horusbi.com.br/dataviz/02-apps/dashboards.md)
- [Aba Expressões (Fórmulas Calculadas)](https://docs.horusbi.com.br/dataviz/02-apps/expressions.md)
- [Aba Geral (Configurações da Aplicação)](https://docs.horusbi.com.br/dataviz/02-apps/general.md)
- [Aba Tabelas (Modelo de Dados)](https://docs.horusbi.com.br/dataviz/02-apps/tables.md)
- [Agentes de IA](https://docs.horusbi.com.br/ia/agentes.md)
- [Alertas Inteligentes](https://docs.horusbi.com.br/dataviz/04-features/alerts.md)
- [App](https://docs.horusbi.com.br/lumo/referencia/app.md): Referência do YAML de app de BI no Lumo: tabelas, relacionamentos, expressões, indicadores e um exemplo completo.
- [Apresentações](https://docs.horusbi.com.br/dataviz/04-features/apresentacoes.md)
- [Apresentações pelo Lumo CLI](https://docs.horusbi.com.br/lumo/apresentacoes.md)
- [Arquitetura do Sistema](https://docs.horusbi.com.br/etl/architecture.md)
- [Arquitetura Lógica do HorusDW](https://docs.horusbi.com.br/dw/architecture.md)
- [Arquivo](https://docs.horusbi.com.br/hec/archive.md)
- [Arquivo CSV](https://docs.horusbi.com.br/etl/processors/inputs/csv.md)
- [Arquivo de Aplicações](https://docs.horusbi.com.br/dataviz/02-apps/archive.md)
- [Arquivo de Fluxos](https://docs.horusbi.com.br/etl/guides/archive.md)
- [Arquivo de Tabelas](https://docs.horusbi.com.br/dw/tables/archive.md)
- [Arquivo Excel](https://docs.horusbi.com.br/etl/processors/inputs/excel.md)
- [Arquivo Parquet](https://docs.horusbi.com.br/etl/processors/inputs/parquet.md)
- [Arquivos — Repositório de Arquivos do Tenant](https://docs.horusbi.com.br/hec/resources/arquivos.md)
- [Autenticação de Dois Fatores (2FA)](https://docs.horusbi.com.br/dataviz/04-features/two-factor-auth.md)
- [Autenticação de Dois Fatores (2FA)](https://docs.horusbi.com.br/hec/users-groups/security-2fa.md)
- [Avançado](https://docs.horusbi.com.br/dataviz/04-features/alerts/webhook/advanced.md)
- [Cadastros — Visão Geral](https://docs.horusbi.com.br/dw/tables/cadastros.md)
- [Cadastros no BI](https://docs.horusbi.com.br/dataviz/04-features/cadastros/no-bi.md)
- [Cadastros no DataViz](https://docs.horusbi.com.br/dataviz/04-features/cadastros.md)
- [Calendário](https://docs.horusbi.com.br/dataviz/03-widgets/calendar.md)
- [Canais de Entrega](https://docs.horusbi.com.br/dataviz/04-features/alerts/channels.md)
- [Carregando Dados](https://docs.horusbi.com.br/dw/getting-started/upload.md)
- [Central de Notificações](https://docs.horusbi.com.br/hec/notifications.md)
- [Chat com Dados](https://docs.horusbi.com.br/ia/chat.md)
- [Chat IA — API REST (Lumia)](https://docs.horusbi.com.br/api/ai-chat.md)
- [Ciclo de Vida de Execução](https://docs.horusbi.com.br/etl/architecture/execution-lifecycle.md)
- [Classificação por IA (AIExtract)](https://docs.horusbi.com.br/etl/processors/transforms/ai-extract.md)
- [Cobrança e limites de Cadastros](https://docs.horusbi.com.br/hec/resources/cadastros-cobranca.md)
- [Como o Chat Responde](https://docs.horusbi.com.br/ia/chat/como-funciona.md)
- [Como Receber e Testar](https://docs.horusbi.com.br/dataviz/04-features/alerts/webhook/receivers.md)
- [Componentes Reutilizáveis (Svelte Paramétrico)](https://docs.horusbi.com.br/dataviz/03-widgets/svelte-parametrico.md)
- [Comunicação e Redes](https://docs.horusbi.com.br/etl/architecture/communication.md)
- [Concatenar (Union)](https://docs.horusbi.com.br/etl/processors/transforms/union.md)
- [Conceitos](https://docs.horusbi.com.br/lumo/conceitos.md)
- [Conectar seu Assistente de IA (MCP)](https://docs.horusbi.com.br/ia/mcp.md)
- [Conexões de Banco de Dados](https://docs.horusbi.com.br/etl/guides/conexoes-banco.md)
- [Configurando a Tabela](https://docs.horusbi.com.br/dw/getting-started/configuration.md)
- [Consulta Firebird](https://docs.horusbi.com.br/etl/processors/inputs/firebird.md)
- [Consulta InterSystems IRIS](https://docs.horusbi.com.br/etl/processors/inputs/intersystems-iris.md)
- [Consulta MySQL](https://docs.horusbi.com.br/etl/processors/inputs/mysql.md)
- [Consulta ODBC](https://docs.horusbi.com.br/etl/processors/inputs/odbc.md)
- [Consulta OracleDB](https://docs.horusbi.com.br/etl/processors/inputs/oracle.md)
- [Consulta PostgreSQL](https://docs.horusbi.com.br/etl/processors/inputs/postgresql.md)
- [Consulta SQL Server](https://docs.horusbi.com.br/etl/processors/inputs/sql-server.md)
- [Consultar Lakehouse](https://docs.horusbi.com.br/etl/processors/inputs/lakehouse.md)
- [Conteúdo](https://docs.horusbi.com.br/hec/resources/01-content.md)
- [Conteúdo: Análise por IA](https://docs.horusbi.com.br/dataviz/04-features/alerts/content-ai.md)
- [Conteúdo: Gráfico (Snapshot)](https://docs.horusbi.com.br/dataviz/04-features/alerts/content-chart.md)
- [Conteúdo: Relatório (PDF / Excel)](https://docs.horusbi.com.br/dataviz/04-features/alerts/content-report.md)
- [Conteúdo: Texto com Variáveis](https://docs.horusbi.com.br/dataviz/04-features/alerts/content-text.md)
- [Controle de Acesso às Mesas](https://docs.horusbi.com.br/dw/desks/controle-de-acesso.md)
- [Credential](https://docs.horusbi.com.br/lumo/referencia/credential.md): Referência do YAML de credencial no Lumo: propriedades, tipos, drivers suportados e um exemplo completo.
- [Criando a Primeira Aplicação](https://docs.horusbi.com.br/dataviz/01-getting-started/create-app.md)
- [Criar e estruturar](https://docs.horusbi.com.br/dw/tables/cadastros/criar.md)
- [Dashboards Pessoais](https://docs.horusbi.com.br/dataviz/04-features/personal-dashboards.md)
- [Datamarts](https://docs.horusbi.com.br/dw/datamarts.md)
- [DataViz (Visualização)](https://docs.horusbi.com.br/dataviz.md)
- [Desk](https://docs.horusbi.com.br/lumo/referencia/desk.md): Referência do YAML de desk no Lumo: dw-desk, bi-desk, propriedades e um exemplo completo.
- [Diagrama](https://docs.horusbi.com.br/dataviz/03-widgets/diagram.md)
- [Disparo Condicional](https://docs.horusbi.com.br/dataviz/04-features/alerts/conditions.md)
- [Disparo por Agendamento](https://docs.horusbi.com.br/dataviz/04-features/alerts/triggers.md)
- [Editor de Slides Desenhados](https://docs.horusbi.com.br/dataviz/04-features/apresentacoes/editor.md)
- [Especificação Completa](https://docs.horusbi.com.br/api/spec.md)
- [Execução e Agendamento](https://docs.horusbi.com.br/etl/guides/execucao-agendamentos.md)
- [Exemplos de Indicadores](https://docs.horusbi.com.br/ia/chat/exemplos-de-fatos.md)
- [Explorer (Relatórios Nativos)](https://docs.horusbi.com.br/dataviz/02-apps/explorer.md)
- [Extrair Datalake](https://docs.horusbi.com.br/etl/processors/inputs/datalake.md)
- [Flow](https://docs.horusbi.com.br/lumo/referencia/flow.md): Referência do YAML de flow do Lumo: propriedades, tipos, restrições e um exemplo completo.
- [Fluxo de Trabalho: Mesas e Publicação](https://docs.horusbi.com.br/etl/guides/mesas-publicacao.md)
- [Formato de Entrega](https://docs.horusbi.com.br/dataviz/04-features/alerts/delivery.md)
- [Funcionalidades e Extensões](https://docs.horusbi.com.br/dataviz/04-features.md)
- [Gerar Apresentação com IA](https://docs.horusbi.com.br/dataviz/04-features/apresentacoes/ia.md)
- [Gerenciamento de Agentes](https://docs.horusbi.com.br/etl/guides/agentes.md)
- [Gerenciamento de Tabelas](https://docs.horusbi.com.br/dw/tables.md)
- [Gestão de Clientes](https://docs.horusbi.com.br/hec/resources/clients.md)
- [Gestão de Grupos](https://docs.horusbi.com.br/hec/users-groups/groups.md)
- [Gestão de Permissões e Segurança](https://docs.horusbi.com.br/dw/datamarts/managing-access.md)
- [Gestão de Tenants](https://docs.horusbi.com.br/hec/resources/tenants.md)
- [Gestão de Usuários](https://docs.horusbi.com.br/hec/users-groups/users.md)
- [Google Sheet (Leitura)](https://docs.horusbi.com.br/etl/processors/inputs/google-sheets.md)
- [Gráfico BI](https://docs.horusbi.com.br/dataviz/04-features/apresentacoes/grafico-bi.md)
- [Gráficos de Barra, Linha e Área (Combo)](https://docs.horusbi.com.br/dataviz/03-widgets/bar-line.md)
- [Guia da Plataforma HorusBI](https://docs.horusbi.com.br/guia.md)
- [Guias de Operação e Gerenciamento](https://docs.horusbi.com.br/etl/guides.md)
- [Hierarquia da Informação](https://docs.horusbi.com.br/dw/architecture/hierarchy.md)
- [Hierarquia de Entidades](https://docs.horusbi.com.br/hec/concepts/hierarchy.md)
- [Horus Enterprise Control (HEC)](https://docs.horusbi.com.br/hec.md)
- [HorusDW](https://docs.horusbi.com.br/dw.md)
- [HorusETL](https://docs.horusbi.com.br/etl.md)
- [IA na plataforma](https://docs.horusbi.com.br/ia.md): Mapa da IA na plataforma HorusBI: onde cada peça vive no produto e para quem ela serve.
- [Importar e exportar](https://docs.horusbi.com.br/dw/tables/cadastros/importar-exportar.md)
- [Indicadores](https://docs.horusbi.com.br/dataviz/04-features/indicadores.md)
- [Indicadores: Ensinando seu Negócio](https://docs.horusbi.com.br/ia/chat/fatos.md)
- [Infraestrutura](https://docs.horusbi.com.br/hec/resources/02-infrastructure.md)
- [Inputs (Leitura de Dados)](https://docs.horusbi.com.br/etl/processors/inputs.md)
- [Inserir e editar dados](https://docs.horusbi.com.br/dw/tables/cadastros/dados.md)
- [Inserir Google Sheet](https://docs.horusbi.com.br/etl/processors/outputs/google-sheets.md)
- [Inserir no Datawarehouse](https://docs.horusbi.com.br/etl/processors/outputs/datawarehouse.md)
- [Instalação Manual (outros agentes)](https://docs.horusbi.com.br/lumo/integracoes/manual.md)
- [Integrações com IA](https://docs.horusbi.com.br/lumo/integracoes.md)
- [Introdução ao HEC](https://docs.horusbi.com.br/hec/intro/overview.md)
- [Introdução ao Horus DataViz](https://docs.horusbi.com.br/dataviz/00-intro.md)
- [Introdução ao HorusDW](https://docs.horusbi.com.br/dw/intro.md)
- [Introdução ao HorusETL](https://docs.horusbi.com.br/etl/intro.md)
- [Join (Junção)](https://docs.horusbi.com.br/etl/processors/transforms/join.md)
- [Jornada do Usuário: Do Dado ao Dashboard](https://docs.horusbi.com.br/guia/jornada.md)
- [KPI (Indicador-Chave de Desempenho)](https://docs.horusbi.com.br/dataviz/03-widgets/kpi.md)
- [Lista de Seleção (ListBox)](https://docs.horusbi.com.br/dataviz/03-widgets/listbox.md)
- [Logs e Monitoramento](https://docs.horusbi.com.br/etl/guides/logs-monitoramento.md)
- [Lumo CLI](https://docs.horusbi.com.br/lumo.md)
- [Lumo CLI no Claude Code](https://docs.horusbi.com.br/lumo/integracoes/claude-code.md)
- [Lumo CLI no Codex](https://docs.horusbi.com.br/lumo/integracoes/codex.md)
- [Lumo CLI no Cursor](https://docs.horusbi.com.br/lumo/integracoes/cursor.md)
- [Map (Script C#)](https://docs.horusbi.com.br/etl/processors/transforms/map.md)
- [Mapa](https://docs.horusbi.com.br/dataviz/03-widgets/map.md)
- [Matriz (Pivot Table)](https://docs.horusbi.com.br/dataviz/03-widgets/matrix.md)
- [Matriz Composta (Demonstrativo)](https://docs.horusbi.com.br/dataviz/03-widgets/composed-matrix.md)
- [Mesas](https://docs.horusbi.com.br/hec/desks/mesas.md)
- [Mesas e Gestão de Tabelas](https://docs.horusbi.com.br/dw/desks.md)
- [Modelagem de Dados](https://docs.horusbi.com.br/dataviz/02-apps/data-modeling.md)
- [Modo Kiosk (Apresentação Pública)](https://docs.horusbi.com.br/dataviz/04-features/apresentacoes/kiosk.md)
- [Monitoramento: o vigia](https://docs.horusbi.com.br/dataviz/04-features/indicadores/monitoramento.md)
- [O Motor do Horus](https://docs.horusbi.com.br/dw/architecture/engine.md)
- [Outputs (Destinos e Escrita)](https://docs.horusbi.com.br/etl/processors/outputs.md)
- [Permissões de Cadastro](https://docs.horusbi.com.br/hec/resources/cadastros-permissoes.md)
- [Permissões e Compartilhamento](https://docs.horusbi.com.br/dataviz/04-features/alerts/permissions.md)
- [Permissões e Segurança](https://docs.horusbi.com.br/hec/users-groups/permissions.md)
- [Personalizando Gráficos no Slide](https://docs.horusbi.com.br/dataviz/04-features/apresentacoes/personalizar-grafico.md)
- [Pizza, Rosca e Funil](https://docs.horusbi.com.br/dataviz/03-widgets/pie.md)
- [Plataforma e Administração](https://docs.horusbi.com.br/hec/resources/03-platform.md)
- [Previsão (Forecast)](https://docs.horusbi.com.br/dataviz/03-widgets/forecast.md)
- [Primeiros Passos](https://docs.horusbi.com.br/dw/getting-started.md)
- [Primeiros Passos (Consumidor)](https://docs.horusbi.com.br/dataviz/01-getting-started.md)
- [Primeiros Passos com HorusETL](https://docs.horusbi.com.br/etl/getting-started.md)
- [Primeiros Passos com o Lumo CLI](https://docs.horusbi.com.br/lumo/getting-started.md)
- [Processadores (Nós)](https://docs.horusbi.com.br/etl/processors.md)
- [Punchcard](https://docs.horusbi.com.br/dataviz/03-widgets/punchcard.md)
- [Python (Pandas)](https://docs.horusbi.com.br/etl/processors/transforms/python.md)
- [Receita: Banco de Dados → Dashboard](https://docs.horusbi.com.br/guia/receitas/banco-dashboard.md)
- [Receita: Calendário e Filtros Dinâmicos](https://docs.horusbi.com.br/guia/receitas/calendario-filtros.md)
- [Receita: Excel → Dashboard (sem ETL)](https://docs.horusbi.com.br/guia/receitas/excel-dashboard.md)
- [Receita: Google Sheets → Dashboard](https://docs.horusbi.com.br/guia/receitas/google-sheets-dashboard.md)
- [Receitas Práticas](https://docs.horusbi.com.br/guia/receitas.md)
- [Referência de Comandos](https://docs.horusbi.com.br/lumo/comandos.md)
- [Referência de YAML](https://docs.horusbi.com.br/lumo/referencia.md): Referência do YAML do Lumo: um kind por página, com propriedades, tipos, restrições e exemplos.
- [Referência do Payload](https://docs.horusbi.com.br/dataviz/04-features/alerts/webhook/payload.md)
- [Repositório de Arquivos — API REST](https://docs.horusbi.com.br/api/files.md)
- [Requisição HTTP (API)](https://docs.horusbi.com.br/etl/processors/inputs/http-request.md)
- [Requisitos de Hardware do Agente](https://docs.horusbi.com.br/etl/guides/requisitos-hardware.md)
- [Revisando o trabalho da IA](https://docs.horusbi.com.br/lumo/revisar.md)
- [Salvar Parquet](https://docs.horusbi.com.br/etl/processors/outputs/parquet.md)
- [Schedule](https://docs.horusbi.com.br/lumo/referencia/schedule.md): Referência do YAML de agendamento no Lumo: flows, gatilhos, contextos de carga e um exemplo completo.
- [Segurança e Governança](https://docs.horusbi.com.br/dw/architecture/security.md)
- [Segurança e Integridade](https://docs.horusbi.com.br/etl/architecture/security.md)
- [SQL (DuckDB)](https://docs.horusbi.com.br/etl/processors/transforms/sql-duckdb.md)
- [Tabela](https://docs.horusbi.com.br/dataviz/03-widgets/table.md)
- [Tabelas Cloud (Datalake)](https://docs.horusbi.com.br/dw/tables/datalake.md)
- [Tabelas Físicas (Excel e Dataflow)](https://docs.horusbi.com.br/dw/tables/physical.md)
- [Table](https://docs.horusbi.com.br/lumo/referencia/table.md): Referência do YAML de tabela do DW no Lumo: propriedades, tipos, restrições e um exemplo completo.
- [Templates e Linhas de Produto](https://docs.horusbi.com.br/hec/resources/templates.md)
- [Texto e Imagens](https://docs.horusbi.com.br/dataviz/03-widgets/text.md)
- [Tipos de Carga](https://docs.horusbi.com.br/etl/guides/tipos-de-carga.md): Tipos de carga do HorusETL: Total, Temporal e Incremental. Como cada um apaga e insere no Data Warehouse, o que exige da tabela de destino e como escolher.
- [Trabalhando com a IA](https://docs.horusbi.com.br/lumo/trabalhando-com-ia.md)
- [Trabalhando com Aplicações](https://docs.horusbi.com.br/dataviz/02-apps.md)
- [Transformações (Lógica de Dados)](https://docs.horusbi.com.br/etl/processors/transforms.md)
- [Untitled](https://docs.horusbi.com.br/api.md)
- [Validações e expressões](https://docs.horusbi.com.br/dw/tables/cadastros/validacoes-expressoes.md)
- [Variables](https://docs.horusbi.com.br/lumo/referencia/variables.md): Referência do YAML de variáveis do tenant no Lumo: chaves, segredos e um exemplo completo.
- [Variáveis Globais](https://docs.horusbi.com.br/etl/guides/variaveis-globais.md)
- [Velocímetro (Gauge)](https://docs.horusbi.com.br/dataviz/03-widgets/gauge.md)
- [Versões e publicação](https://docs.horusbi.com.br/dw/tables/cadastros/versoes-publicar.md)
- [Webhook (Visão Geral)](https://docs.horusbi.com.br/dataviz/04-features/alerts/webhook.md)
- [Widget Svelte (Código Avançado)](https://docs.horusbi.com.br/dataviz/03-widgets/svelte-custom.md)
- [Widgets e Visualizações](https://docs.horusbi.com.br/dataviz/03-widgets.md)