--- title: Manual do Usuário slug: manual-do-usuario docTags: createdAt: 2026-08-16T18:09:20.767Z --- ## 1. Antes de começar *** ### Entrar O acesso é pelo **Keycloak** — não há login próprio da plataforma. Ao abrir o endereço, você é levado à tela de autenticação da empresa e volta autenticado. O **espaço de trabalho** (tenant) vem do seu usuário. Cada espaço tem os próprios dados, conexões e painéis: o que você vê é o do seu espaço, sempre. *** ### A barra superior | Elemento | Para que serve | | -------- | ----------------------------------------------------------------------------------------------------------- | | Idioma | Português, English, Español, Français. Muda a interface na hora. | | 🌙 / ☀️ | Alterna entre tema claro e escuro. | | 🔔 Sino | Alertas e insights do Pulse (ver [Automação](https://docs.citsmart.com/TDbT-manual-do-usuario#12-automao)). | | Seu nome | Identifica a sessão. | | Sair | Encerra a sessão. | *** ### O menu lateral Quatro grupos: - **Análise & Preparação** — Explorar, Datasets, Fluxos de dados, Modelagem, SQL Lab, Galeria - **Visualização** — Páginas/Dashs/Apps, Relatórios, Portal Análise Dados, Portal de Relatórios - **Automação & IA** — Automação, Conhecimento, Conectores LLM - **Administração** — Conexões, Histórico, Perfis de Acesso, Configurações O menu pode ser recolhido para ganhar espaço horizontal. **O que aparece nele depende dos seus perfis** — ver [Perfis de Acesso](https://docs.citsmart.com/TDbT-manual-do-usuario#perfis-de-acesso). *** ### O caminho mais curto para o primeiro gráfico 1. **Explorar → Enviar arquivo** e escolha um CSV, Excel, JSON ou Parquet. 2. Arraste um campo para **Dimensões** e outro para **Medidas**. 3. Escolha o **Tipo de apresentação**. 4. **Salvar no dashboard**. *** ## 2. Conceitos da plataforma Vale ler esta seção uma vez: quase toda dúvida de uso nasce de confundir dois destes conceitos. | Conceito | O que é | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | **Conexão** | O acesso a uma origem: banco, API REST, arquivo. Guarda endereço e credencial. | | **Dataset** | Uma tabela consultável na plataforma, com campos classificados em dimensões e medidas. É a matéria-prima de toda análise. | | **Consulta salva** | Uma análise montada no Explorar e guardada com nome. Pode ser reaproveitada em painéis e páginas. | | **Dashboard** | Uma grade de widgets com filtros globais. | | **Página** | Uma composição livre de blocos — inclui texto, botões, vídeo e conteúdo incorporado, além de gráficos. | | **Aplicação** | Um conjunto de páginas e dashboards navegáveis como um produto só, com ícone, cor e tela inicial. | | **Relatório** | Um documento em seções, feito para ser exportado em PDF, Excel, Word ou PowerPoint. | | **Fluxo de dados** | Uma sequência de passos que transforma uma ou mais origens e gera um dataset novo. | | **Modelo** | Tabelas de uma conexão ligadas por relacionamentos, que geram um dataset sem escrever SQL. | | **Documento de conhecimento** | Regra de negócio, glossário ou definição em Markdown, consultado pela IA e exibível nos widgets. | *** ### Dashboard, Página ou Relatório? - **Dashboard** quando o objetivo é *acompanhar*: números lado a lado, filtros no topo, atualização periódica. - **Página** quando o objetivo é *conduzir*: texto explicativo entre os gráficos, parâmetros, botões de ação. - **Relatório** quando o objetivo é *entregar*: o material vai virar arquivo e circular por e-mail. *** ## 3. Explorar — o construtor de análises É a tela onde as análises nascem. *** ### Painel de fontes (esquerda) - **Enviar arquivo** — CSV, Excel, JSON ou Parquet viram dataset na hora. - **Conectar fonte de dados** — banco ou API REST (ver [Conexões](https://docs.citsmart.com/TDbT-manual-do-usuario#14-conexes)). - **Nova planilha (digitar dados)** — cria um dataset digitando os dados à mão, útil para metas, orçamentos e tabelas de apoio. - **Datasets** e **Consultas salvas** — o que já existe, com busca. *** ### Painel de campos Os campos do dataset, separados em **Dimensões** (o que agrupa), **Medidas** (o que se soma) e **Métricas** (cálculos nomeados, reutilizáveis). O botão f+ cria um **campo calculado**; o Σ ao lado de uma métrica indica um cálculo salvo no dataset. *** ### Montando a análise 1. **Tipo de apresentação** — 36 formatos (ver [referência](https://docs.citsmart.com/TDbT-manual-do-usuario#16-referncia-rpida)). 2. **Dimensões** — arraste os campos que agrupam. 3. **Medidas** — arraste os campos numéricos; escolha a agregação (SUM, AVG, MIN, MAX, COUNT, COUNT DISTINCT, mediana, P90, P95, desvio padrão, variância). 4. **Filtros** — arraste campos para restringir. 5. **Segmentos** — salve o conjunto de filtros atual com um nome e reaplique depois em um clique. *** ### Os três popovers de ajuste - **Formatação** — paleta, título, títulos dos eixos, formato dos números, rótulos, empilhamento, orientação, legenda, opções da tabela dinâmica. - **Interação** — o que acontece ao clicar: detalhar, filtrar o painel, abrir uma URL, abrir outro dashboard, ou nada. - **Análise** — linha de tendência, linha de média, linha de referência (meta), previsão, agrupamento (k-means). *** ### A barra de ações | Botão | O que faz | | ----------------------- | -------------------------------------------------------------------------------------------------------- | | **Salvar** | Grava a consulta. Se já estava aberta uma, atualiza; a mensagem confirma qual das duas coisas aconteceu. | | **Salvar como…** | Cria uma consulta nova a partir da atual. | | **CSV** | Baixa o resultado. | | **Prever** | Projeta os próximos períodos de uma série. | | **Insights** | Resumo executivo e anomalias detectadas. Permite **assinar a métrica no Pulse**. | | **Consulta** | Mostra o SQL gerado — útil para conferir ou levar a outra ferramenta. | | **Form. condicional** | Regras que colorem as células (ver abaixo). | | **Indicadores** | Colunas de sinalizadores (ver abaixo). | | **Salvar no dashboard** | Envia a análise para um painel. | | **Modo foco** | Esconde a configuração e amplia o gráfico. | *** ### Formatação condicional Disponível em **Tabela** e **Dinâmica**. Três tipos de regra: - **Escala de cor** — o valor pinta a célula em um degradê. - **Barra de dados** — uma barra proporcional dentro da célula. - **Limiar** — pinta quando o valor passa de um limite (>, ≥, \<, ≤, =). O campo **Regra por texto** aceita linguagem natural (“destaque em vermelho vendas abaixo de 1000”) e a IA monta a regra. O painel pode ser **redimensionado pelo canto**, e o tamanho fica guardado. *** ### Colunas de indicador Também em **Tabela** e **Dinâmica**. É a ideia dos conjuntos de ícones do Excel: o valor cai numa faixa e a faixa define um símbolo. Seis conjuntos prontos — **Semáforo, Setas, Sinais, Bandeiras, Bolinhas, Estrelas** — e o campo do símbolo aceita **qualquer emoji ou texto curto** colado. Ao criar, os limites já vêm sugeridos a partir dos terços do intervalo real da coluna, arredondados. Ajuste-os à sua régua. **As faixas valem de cima para baixo: a primeira que casar define o símbolo.** Cada indicador escolhe **onde aparece**: - **Em coluna própria** — uma coluna nova à direita. Na dinâmica, ela avalia o **total da linha**: o sinal fala da linha inteira. - **Dentro da célula do valor** — o símbolo entra na célula, como no Excel. Na dinâmica é a única forma de sinalizar **célula a célula**. Para ter os dois, crie dois indicadores sobre a mesma medida. *** ### Tabela dinâmica A barra própria da dinâmica oferece: - **Expandir tudo / Recolher tudo** e o seletor de **Níveis** - **Escalonado** (hierarquia recuada numa coluna) ou **Colunas** (uma coluna por dimensão) - **Trocar eixos** — leva as dimensões de linha para as colunas e vice-versa - **Subtotais** e **Col. total** - **Heatmap** — colore as células por escala - **CSV** Arraste a divisa entre as colunas para redimensioná-las. *** ### Detalhar um ponto **Duplo clique** em uma barra, fatia ou célula abre a janela de **Detalhe** com as linhas por trás daquele número. - Datas e valores saem formatados conforme a configuração do sistema. - Os cabeçalhos usam o **Rótulo** do cadastro do dataset (o nome técnico fica na dica da coluna). - **Copiar** leva a tabela para a área de transferência **separada por TAB** — colando no Excel, cai direto nas células. *** ### Análise de IA Um dos tipos de apresentação. Em vez de um gráfico, a plataforma escreve a leitura dos dados em texto. O campo **Pergunta** direciona a análise (“compare com o mês anterior e aponte o que explica a queda”). Exige um conector LLM configurado. *** ## 4. Datasets A tela lista os datasets do espaço. Ao editar um, há seis abas. *** ### Identidade Nome, descrição e a marca **Fonte certificada (confiável)**, que sinaliza aos demais usuários que aquele dataset é oficial. Mostra também a **origem** — e avisa quando a conexão de origem não existe mais: o dataset continua consultável com o que já foi materializado, mas **não consegue se atualizar**. *** ### Campos Cada campo tem: - **Rótulo** — o nome que aparece nas telas. É o que resolve sum\_valor\_da\_venda virar “Valor da Venda” em filtros, parâmetros e no detalhe. - **Papel** — Dimensão ou Medida. - **Tipo** — o tipo do dado. Edite quantos quiser e use **Salvar campos** para gravar todos de uma vez; o contador mostra quantos estão com alteração pendente. **+ Campo calculado** cria uma coluna por expressão SQL, por exemplo (receita - custo) / nullif(receita, 0). *** ### Acesso Os perfis (roles) que podem ver e usar o dataset no Explorar. **Vazio = visível a todos.** Administradores sempre veem. *** ### Sincronização Define com que frequência os dados são trazidos da origem — vale para todas as consultas e painéis que usam o dataset. - **Intervalo** (minutos, horas, dias) ou **expressão CRON** de cinco campos, com conferência dos próximos disparos. - **Como atualizar**: - **Completa** — recarrega a origem inteira. Sempre fiel, mais cara. - **Incremental** — traz só o que mudou desde a última vez. Exige uma **coluna de avanço** (crescente: data de atualização ou id sequencial) e as **colunas que identificam a linha**. **Atenção com a carga incremental:** ela não enxerga linhas **excluídas** na origem. Configure a **recarga periódica de reconciliação** — é o que impede a diferença de se acumular, e o melhor uso da expressão CRON, para cair fora do horário de pico. *** ### Dados Edita as células diretamente (até 500 linhas de amostra). É como se mantém uma planilha de metas ou uma tabela de apoio criada na plataforma. *** ### SQL Para datasets vindos de consulta: permite trocar o SQL que os alimenta. *** ## 5. Fluxos de dados Um fluxo transforma dados e **gera um dataset**. É a alternativa ao SQL para quem prefere montar a transformação passo a passo — e ao mesmo tempo comporta SQL e JavaScript onde eles forem necessários. *** ### Estrutura - **Origens** — os datasets de entrada, cada um com um **apelido** usado nos passos. - **Variáveis** — valores reaproveitáveis, escritos como $ dentro dos passos. Há 15 embutidas (data e hora atuais, última execução, usuário, espaço). - **Passos** — a sequência de transformações. - **Resultado final** — o passo que vira dataset. *** ### Prévia Cada passo mostra o resultado **daquele ponto**, com contagem de colunas e linhas de amostra. É assim que se confere a transformação sem executar o fluxo inteiro. A prévia **não chama** serviços externos: passos de IA e de API aparecem com as colunas vazias. Use o **Testar** do próprio passo e depois **Executar**. *** ### Passos disponíveis **Preparar** — Filtrar linhas · Colunas · Coluna calculada · Converter tipo · Ordenar · Limitar linhas · Remover duplicatas · Substituir texto · Dividir coluna **Combinar** — Juntar (LEFT, INNER, FULL, ANTI, SEMI) · Empilhar · Juntar por semelhança (Jaro-Winkler ou Levenshtein) **Remodelar** — Agrupar e resumir · Colunas viram linhas · Linhas viram colunas **Análise avançada** — Detectar anomalias (z-score ou IQR, comparando dentro de cada grupo) · Faixas de valor (quantis ou intervalos iguais) · Normalizar escala · Correlação · Agrupar semelhantes (k-means) · Prever série · Preencher faltantes **Código e IA** — SQL · Código (JavaScript) · Definir variável · Perguntar à IA · Buscar de API *** ### Passo SQL O passo anterior chega como entrada e as origens pelo apelido. É **uma consulta só**, sem ponto e vírgula. Use $\{variável} onde entra uma data de corte ou um parâmetro. *** ### Passo Código (JavaScript) Recebe a linha (ou todas as linhas, no modo tabela) e a lista de variáveis. O painel lateral mostra **como a linha chega**, com a amostra real e os cuidados — principalmente com valores nulos, que derrubam o passo se usados sem verificação. *** ### Passo Perguntar à IA Classifica, extrai ou resume o conteúdo de cada linha com um modelo de linguagem. Traz exemplos prontos (Classificar, Extrair, Resumir, Sentimento). **Custo:** cada pergunta **distinta** é uma chamada paga. Linhas que geram a mesma pergunta são perguntadas **uma vez só** — classificar mil linhas em dez categorias custa dez chamadas. Há uma trava de **máximo de linhas**. *** ### Passo Buscar de API Três modos: **Enriquecer cada linha** (uma chamada por valor distinto), **Empilhar o resultado** ou **Juntar por chave**. Também tem trava de linhas e um **Testar em 5 linhas**. *** ### Agendamento Depois da primeira execução bem-sucedida, o fluxo pode rodar sozinho na frequência escolhida. *** ## 6. Modelagem Conecta tabelas de uma fonte, sugere os relacionamentos e gera datasets **sem escrever SQL**. 1. Escolha a **conexão** à esquerda e clique nas tabelas para adicioná-las. 2. As **relações prováveis aparecem sozinhas** — confirme, ajuste o tipo de junção ou remova. 3. Defina a **tabela base**. 4. **Ver SQL** para conferir o que foi montado; **Gerar dataset** para materializar. Cada relacionamento tem a opção **Prevenir fan-out**, que evita que uma junção de um-para-muitos infle as medidas. O modelo pode ser **ao vivo** (consulta a fonte a cada uso, com pushdown) ou **materializado** (copia para o motor analítico). *** ## 7. SQL Lab Para quem escreve SQL. - **Schema** — as tabelas disponíveis; clique para ver as colunas. JOIN é permitido. - **Salvas** — suas consultas SQL guardadas. - **Gerar SQL** por linguagem natural — descreva a consulta e revise o que a IA escreveu antes de executar. - **Data Manager** — selecione dois ou mais datasets e a plataforma **sugere associações prováveis**, analisando nomes de colunas, tipos e sobreposição real de chaves, com percentual de confiança. Gera o SQL do modelo. - **Unir (append)** — empilha datasets alinhando colunas por nome. - **Materializar como dataset** ou **Criar gráfico** a partir do resultado. - **Histórico** de execuções, para reaproveitar um SQL já rodado. *** ## 8. Galeria de modelos Modelos prontos de dashboards, relatórios e apps, filtráveis por setor. Escolha o modelo, aponte o **dataset** e a plataforma monta a estrutura — os campos do modelo são mapeados automaticamente para as colunas escolhidas. Você também pode transformar seus próprios dashboards e relatórios em modelos, pelo botão **Modelo** dentro deles. *** ## 9. Páginas, Dashboards e Aplicações Uma tela só reúne os três, porque eles se compõem. *** ### Dashboards Uma grade de widgets. Cada widget tem cabeçalho com as ações: - **↑ ↓** ordenam - **Inteira / ½ / ⅓** definem a largura - **✎** abre o construtor - **📖** vincula conhecimento (ver abaixo) - **✕** remove Arraste a alça do canto inferior direito para mudar a altura. ### Barra superior: | Recurso | O que faz | | ----------------------------------- | ----------------------------------------------- | | Auto-refresh | Reconsulta em intervalo fixo. | | Ao vivo | Reconsulta quando um dataset usado muda. | | Tema e tela cheia | Só para exibição. | | 🔒 | Trava o layout contra arrasto acidental. | | + Seção / + Card / + Consulta salva | Acrescenta conteúdo. | | PDF | Exporta o painel. | | ⭐ 🔗 \ 🗑 | Favoritar, link público, incorporação, excluir. | | Comentários | Discussão anexada ao painel. | **Filtros** aceitam três tipos de campo — valor (multisseleção), numérico (intervalo) e data (intervalo) — e oferecem: - **Escopo por widget** — a quais widgets cada filtro se aplica. - **Cascata** — as opções de um filtro refletem os demais filtros ativos. Clicar num ponto do gráfico aplica **cross-filter** ao painel, conforme a configuração de Interação da análise. **Retratos (versões)** guardam o estado do painel — capturados diariamente e a cada clique — e permitem **comparar dois retratos** indicador a indicador. *** ### Páginas Composição livre, em **fluxo vertical** ou **grade**. Tipos de bloco: | Bloco | Para que serve | | ------------------------------ | --------------------------------------------------------------------------------------------- | | **Texto** | Markdown: títulos, listas, ênfase. | | **Gráfico / Tabela / Métrica** | Dados, montados ali ou vindos de uma consulta salva. | | **Parâmetro** | Um seletor que filtra os demais blocos da mesma fonte de dados. Aceita multisseleção. | | **Ação** | Botão: navegar, definir parâmetro, disparar evento, abrir relatório, gravar dado, abrir link. | | **HTML / Vídeo / Incorporar** | Conteúdo próprio, YouTube ou iframe externo. | *** ### Aplicações Reúnem páginas e dashboards existentes como **telas** de um produto só, com nome, descrição, ícone, cor e **tela inicial**. Dois modos: - **Estrutura** — editar telas, identidade e acesso. - **Executar** — navegar como o usuário final. *** ### Conhecimento no widget O ícone 📖 no cabeçalho aparece **quando há orientação vinculada** — e só quando há. Duas formas, que servem a coisas diferentes: - **Nota do widget** — o que vale só ali: *“este total exclui devoluções”*. - **Documentos da base** — o que vale em muitos lugares: a definição de “cliente ativo”, a regra de rateio. Escritos uma vez, corrigidos uma vez, e a correção chega a todo widget que aponta para eles. Nas telas públicas aparece **apenas a nota**. Os documentos da base exigem sessão, e publicá-los junto com o link exporia material interno. *** ### Consultas salvas vinculadas Ao arrastar uma **consulta salva** para um painel ou página, fica registrado de qual consulta ela veio — o ícone de elo no cabeçalho indica isso. A configuração é lida da origem a cada abertura, inclusive no PDF e nas telas públicas. - **Editar o widget no construtor desfaz o vínculo** (com aviso): a partir dali as mudanças valem só naquele painel. - Se a consulta for **apagada**, o widget continua funcionando com a última configuração conhecida. *** ### Compartilhamento - **Acesso por perfil** — quais roles podem abrir. - **Link público** — endereço que dispensa login. Pode ser revogado. - **Incorporação** — código para embutir em outro sistema, com filtros travados no servidor. ## 10. Relatórios Documentos em seções, feitos para virar arquivo. *** ### Seções | Tipo | Conteúdo | | ------------- | ---------------------------------------------------------------------------------------- | | **Texto** | Markdown, com marcadores de data e nome do relatório. | | **Tabela** | Listagem simples (com escolha e rótulo das colunas, e subtotais por campo) ou agregação. | | **Gráfico** | Barras, linhas, área ou pizza. | | **Parâmetro** | Um seletor que filtra as demais seções da mesma fonte de dados. | Cada seção tem título, formato dos números, limite de linhas e largura (inteira ou metade — duas meias formam uma linha). *** ### Gráfico: legenda **Mostrar legenda** liga e desliga; **Texto da legenda** troca o nome da série. O campo mostra como placeholder o nome atual (sum\_vendas), e apagá-lo volta ao original. Na pizza a legenda lista as fatias, e o texto vem dos próprios dados — por isso o campo não aparece ali. *** ### Parâmetros Mesmo desenho do bloco de parâmetro das Páginas: fonte de dados, campo, rótulo e multisseleção. O recorte é **por fonte de dados** — um parâmetro de uf não filtra seção que lê outra tabela. **Os parâmetros valem também nos arquivos exportados**, e cada formato registra o recorte aplicado: parágrafo no PDF, resumo no Excel, cabeçalho no Word, capa no PowerPoint. Um arquivo filtrado que não diz por qual valor engana quem o receber adiante. *** ### Exportação **PDF**, **Excel**, **Word** e **PowerPoint**. O PDF desenha os gráficos com a mesma paleta da tela. **Modelo** transforma o relatório num modelo reaproveitável na Galeria. *** ## 11. Portais Duas telas de consumo, para quem usa e não constrói: - **Portal Análise Dados** — tudo que você tem permissão de executar: dashboards, páginas e aplicações, em cards ou listagem, com busca. - **Portal de Relatórios** — os relatórios que você pode ver, já com os botões de exportação. *** ## 12. Automação Cinco recursos, na mesma tela. *** ### Envio agendado de relatórios Escolha o relatório, os destinatários, o formato do anexo e a frequência — **intervalo** ou **expressão cron** de seis campos (ex.: 0 0 8 \* \* MON-FRI = dias úteis às 8h), com fuso horário. **Enviar agora** testa na hora. *** ### Alertas por condição de dado Vigiam uma consulta salva e disparam quando o valor passa de um limiar (maior que, menor que, igual a) ou quando foge do padrão (**anomalia por desvio σ**). Canais: **e-mail**, **in-app (sino)** e **webhook**. **Testar** mostra o valor atual e se dispararia agora. *** ### Entrega de dados agendada Exporta o resultado de uma consulta salva — com seus filtros — em CSV ou XLSX e envia por e-mail no intervalo ou cron definido. *** ### Gatilhos por evento de negócio Disparam e-mail ou relatório **quando o sistema de origem chama o webhook** — por exemplo, um pedido confirmado. Copie a URL gerada e configure no sistema transacional. Nos textos de assunto e corpo, use e os campos do payload como . *** ### Pulse — insights proativos Assine uma métrica pelo botão **Assinar no Pulse**, dentro do modal **Insights** do Explorar. O Pulse verifica periodicamente e avisa no **sino** (e por e-mail) quando surge uma anomalia ou tendência — sem você precisar procurar. Sem SMTP configurado, os envios ficam em **dry-run**: são registrados no log do servidor, mas não saem. Ver [Configurações](https://docs.citsmart.com/TDbT-manual-do-usuario#configuraes). *** ## 13. Conhecimento e IA *** ### Conhecimento A base que a IA consulta ao responder — e de onde saem as orientações exibidas nos widgets. Organize **pastas** e **documentos Markdown**. Crie na tela ou faça **upload** de .md, .txt, .csv, .json, .docx. Cada documento pode ser **vinculado a datasets**: sem marcar nenhum, vale como conhecimento geral; marcando, o assistente usa aquele documento apenas nas conversas sobre os datasets escolhidos. *** ### Conectores LLM Os modelos de linguagem que a plataforma usa. Provedores suportados: | Provedor | Observação | | --------------------------- | ------------------------------------------------ | | **Anthropic** | Chave em console.anthropic.com | | **OpenAI** | Chave em platform.openai.com | | **Google Gemini** | Chave no Google AI Studio | | **Ollama (local)** | Roda na sua infraestrutura; não precisa de chave | | **vLLM (servidor próprio)** | Servidor compatível com a API da OpenAI | Um conector precisa estar **ativo** e marcado como **padrão** — sem isso, os recursos de IA não têm a quem perguntar. **Testar** confirma que o modelo responde. Ollama e vLLM rodam na sua infraestrutura e **não mandam dado nenhum para fora**. *** ### O assistente (botão IA) Presente no canto inferior direito. Permite: - **Conversar com os dados** em linguagem natural, com perguntas de acompanhamento; a IA responde em texto **e monta o gráfico**. - **Gerar insights automáticos** sobre um dataset. - **Gerar um painel ou página inteiros** a partir de uma descrição (“vendas por região e evolução mensal”), com a opção de salvar ou descartar. - **Falar** em vez de digitar, nos navegadores com reconhecimento de voz. *** ## 14. Conexões *** ### Tipos suportados **Banco de dados**, agrupados por família: - **Relacional (SQL)** — PostgreSQL, MySQL, SQL Server, SQLite (arquivo) e afins - **Data warehouse (nuvem)** - **Query engine / OLAP** — inclui OpenSearch, cujos **índices** aparecem como tabelas - **Big Data (Hadoop)** - **Object storage** — Parquet/CSV por URI, com região e endpoint MinIO opcional - **NoSQL** **API REST**, com autenticação **Nenhuma**, **Basic**, **Token/JWT (Bearer)** ou **cabeçalho personalizado (API key)**, cabeçalhos extras e **Caminho JSON** para quando os registros vêm dentro de um envelope (resultado.itens). **Testar API** confere antes de salvar. *** ### Importar Ao conectar, a plataforma lista as tabelas (ou índices). Selecione as que interessam: **cada uma vira um dataset** com o nome da tabela. *** ### A tela Conexões (Administração) Manutenção do que já existe: renomear, trocar parâmetros, **testar**, excluir e definir **quais perfis podem mexer** em cada conexão. Aqui, **nenhum perfil marcado = só administrador** — o oposto dos datasets, onde lista vazia libera. A diferença é proposital: nos datasets se lê dado; aqui se altera a credencial de um banco. Excluir uma conexão em uso avisa quantos datasets deixarão de se atualizar. *** ## 15. Administração *** ### Histórico Registro de acessos aos componentes de BI: quando, quem, tipo e componente. *** ### Perfis de Acesso Define **quais funcionalidades cada perfil (role) pode acessar** — é o que decide o menu de cada usuário. Regras que valem a pena conhecer: - Administradores sempre acessam tudo. - Um usuário **sem nenhuma funcionalidade concedida** enxerga o sistema sem restrição de menu. É proposital: evita travar o acesso de todos por um cadastro incompleto. **Segurança em nível de linha (RLS)** fica na mesma área: 1. Dê **atributos** ao usuário (regiao=Sul). 2. Crie a **regra por dataset**: linhas onde o campo regiao = o atributo regiao do usuário. A partir daí, cada pessoa vê apenas as linhas que lhe cabem, em qualquer tela. *** ### Configurações **Formato de data e moeda** — data, hora, moeda, separadores e casas decimais, com prévia. Vale para Explorar, Relatórios, dashboards e páginas. “Segue o idioma” usa a convenção do idioma escolhido na barra superior. Prefira um **formato fixo** quando o material precisa sair igual para todo mundo. **E-mail (SMTP)** — remetente, host, porta, usuário e senha. Sem **habilitar envio real**, tudo fica em dry-run. **Backup e portabilidade** — exporta todos os elementos criados (dashboards, consultas, relatórios, automação, configurações) num único .json, e importa um pacote para restaurar ou migrar. Os **dados brutos das fontes não são incluídos** — apenas as definições. A inclusão de segredos (senhas e chaves) é opcional e explícita. *** ## 16. Referência rápida *** ### Tipos de apresentação **Comparação** — Barras · Linhas · Área · Combinado · Cascata · Tornado · Bullet · Marimekko **Composição** — Pizza · Rosca · Treemap · Sunburst · Funil · Stream graph **Relação** — Dispersão · Bolhas · Correlação em matriz (heatmap) · Radar · Coordenadas paralelas · Sankey · Grafo · Árvore **Distribuição** — Histograma · Boxplot **Evolução no tempo** — Calendário · Gantt · Candlestick · Pulse **Número único** — KPI · Tendência · Medidor (gauge) **Tabelas** — Tabela · Tabela dinâmica **Geográfico** — Mapa (país, UF, cidade, bairro) **Texto** — Nuvem de palavras **Narrativa** — Análise de IA *** ### Agregações SUM · AVG · MIN · MAX · COUNT · COUNT DISTINCT · MEDIAN · P90 · P95 · STDDEV · VARIANCE *** ### Formatos de número | Formato | Exemplo | | ---------- | ----------- | | Número | 1.234,56 | | Milhares | 1.235 | | Moeda | R$ 1.234,56 | | Percentual | 1.234,6% | O símbolo da moeda e os separadores vêm das **Configurações** do espaço. *** ## 17. Perguntas frequentes **Alterei uma consulta salva e o painel não mudou.** Painéis criados antes da versão que introduziu o vínculo guardam uma cópia solta. Adicione a consulta ao painel novamente: a partir daí ele acompanha a origem. **Um campo aparece com nome técnico (sum\_vendas) nos filtros.** Preencha o **Rótulo** do campo em *Datasets → Campos*. Ele vale para filtros, parâmetros, cabeçalhos e para a janela de detalhe. **O e-mail não chega.** Confira em *Configurações → E-mail* se **Habilitar envio real** está ligado. Sem isso, os envios ficam em dry-run e só aparecem no log do servidor. **Os recursos de IA estão indisponíveis.** É preciso um conector em *Conectores LLM* que esteja **ativo** e marcado como **padrão**. **A carga incremental está deixando linhas para trás.** A carga incremental não enxerga exclusões na origem. Configure a **recarga periódica de reconciliação** na aba Sincronização do dataset. **O dataset parou de se atualizar.** Veja a aba *Identidade*: se a conexão de origem foi excluída, o dataset continua consultável com o que já foi materializado, mas não se atualiza mais. **Não consigo ver um menu que meu colega vê.** O menu depende dos perfis. Peça a um administrador para conferir em *Perfis de Acesso*. **Preciso que os números saiam iguais para todo mundo, em qualquer idioma.** Em *Configurações → Formato*, escolha um formato **fixo** em vez de “Segue o idioma”. *Este manual descreve a plataforma como ela está. Recursos e telas evoluem — em caso de divergência, a tela é a referência.*