PHSYS - Wiki

Conceito

O Dashboard é a funcionalidade do sistema que reúne, em um único painel visual, indicadores e gráficos configuráveis, permitindo o acompanhamento rápido de informações relevantes do negócio sem a necessidade de gerar relatórios manualmente. Cada dashboard é composto por um conjunto de itens — indicadores numéricos (cards) ou gráficos (barra, linha ou pizza) — organizados em um layout de grade dentro da tela.

O que é

O Dashboard é uma tela de visualização somente leitura, formada por blocos (itens) distribuídos em grade. Cada item exibe o resultado de uma consulta previamente configurada no sistema, podendo assumir dois formatos:

• Indicador (card): exibe um único valor em destaque, geralmente representando uma contagem, total ou métrica-chave (KPI).
• Gráfico: exibe uma série de dados no formato de barra, linha ou pizza.

A montagem do dashboard (quais itens existem, em que ordem, com que tamanho e com que consulta) é feita previamente pelos cadastros de Dashboard, Itens do Dashboard, Gráfico e Indicador. A tela do Dashboard em si apenas exibe o resultado já configurado — não é nela que se adiciona, remove ou redimensiona itens. Cada item é alimentado por uma consulta SQL própria (Expressão SQL), definida no cadastro do gráfico ou indicador correspondente.

Para que serve

Quando compreendemos a funcionalidade do Dashboard, conseguimos acompanhar de forma visual e centralizada os principais números da operação, tomando decisões com mais agilidade e sem depender da geração manual de relatórios para obter uma visão geral da situação atual.

Quais os benefícios e/ou ganhos de uso

Ao concentrar as informações mais relevantes em um único painel visual, o usuário reduz o tempo gasto navegando por diferentes telas e relatórios para entender a situação do negócio. Isso favorece a identificação rápida de tendências, desvios e pontos de atenção, além de padronizar a forma como diferentes usuários enxergam os mesmos indicadores, evitando interpretações divergentes sobre os mesmos dados.

Exemplos

Um dashboard pode reunir, por exemplo, um indicador com o total de pedidos em aberto, um gráfico de barras com o volume de vendas por período e um gráfico de pizza com a participação de cada categoria de produto no faturamento. Dessa forma, em uma única tela, o usuário consegue visualizar tanto números pontuais quanto tendências ao longo do tempo.

Cadastro

O Dashboard é composto por dois cadastros: o Dashboard propriamente dito e os Itens do Dashboard. Cada item, por sua vez, exibe um Gráfico ou um Indicador já cadastrado — o cadastro desses dois (onde entram título, cores, formato e a Expressão SQL) é tratado em páginas próprias (veja Sugestão de Leitura).

Dashboard

• Nome: Nome interno do dashboard, utilizado também como identificador ao exportar/importar sua configuração.
• Legenda: Subtítulo/legenda exibida para o usuário.
• Data/Hora: Data e horário da última alteração. Preenchido automaticamente pelo sistema.
• É Sistema: Indica se o dashboard é nativo do sistema (padrão) ou foi criado pelo usuário.

Itens do Dashboard

• Dashboard: Dashboard ao qual o item pertence.
• Sequência: Posição/ordem do item dentro do dashboard.
• Nome: Nome interno do item.
• Título: Título exibido no topo do item.
• Altura: Altura do item na grade do dashboard.
• Largura: Largura do item na grade do dashboard (a grade possui 16 unidades de largura por linha; itens são distribuídos lado a lado até completar esse limite, quebrando para a linha seguinte quando necessário).
• Gráfico: Gráfico já cadastrado a ser exibido neste item, quando aplicável.
• Indicador: Indicador já cadastrado a ser exibido neste item, quando aplicável.
• Data/Hora: Data e horário da última alteração. Preenchido automaticamente pelo sistema.
• É Sistema: Indica se o item é nativo do sistema (padrão) ou foi criado pelo usuário.

Observação: cada item deve estar associado a um Gráfico ou a um Indicador, nunca aos dois ao mesmo tempo.

Comportamentos

• Atualizar: Permite recarregar o dashboard por completo, buscando novamente a estrutura e os dados de todos os itens.
• Carregamento por item: Cada item do dashboard é carregado de forma independente: a estrutura visual (títulos, cores, formato) aparece imediatamente, enquanto os dados de cada item são buscados individualmente e exibidos em seguida, com uma animação de entrada.
• Indicação de carregamento: Enquanto os dados de um item ainda não retornaram, é exibido um indicador de carregamento (spinner) sobre o item.
• Sem dados / Erro ao carregar: Caso a consulta de um item não retorne dados, ou ocorra uma falha ao buscá-los, o item exibe uma mensagem informando a situação, sem impedir a exibição dos demais itens do dashboard.
• Distribuição em grade: Os itens são organizados automaticamente em uma grade de 16 colunas, respeitando a largura e altura configuradas em cada item, se ajustando ao tamanho da tela.
• Exportar/Importar: No cadastro de dashboards, é possível exportar a configuração de um dashboard (incluindo seus itens, gráficos e colunas) para um arquivo, e importá-la posteriormente, seja no mesmo ambiente ou em outro.
• Sem armazenamento temporário (cache): Toda abertura ou atualização do dashboard executa novamente, em tempo real, a Expressão SQL de todos os seus itens — não há reaproveitamento de um resultado buscado anteriormente.

Como Configurar um Dashboard

Esta seção resume, o que precisa ser feito para configurar um dashboard.

1. Cadastre primeiro o Gráfico ou o Indicador que você quer usar no dashboard — é lá que ficam o título, as cores, o formato e a Expressão SQL que busca os dados (veja as páginas de Gráficos e Indicadores em Sugestão de Leitura).
2. Cadastre o Dashboard, informando nome e legenda.
3. Cadastre os Itens do Dashboard, vinculando cada item ao Dashboard criado e ao Gráfico ou Indicador já cadastrado, e definindo seu título, posição e tamanho na grade.
4. Abra a tela de Dashboard apontando para o dashboard desejado — os itens cadastrados aparecem automaticamente, cada um já exibindo seu resultado.

Pontos de atenção

• Como a Expressão SQL é texto livre, o controle de quem pode ver informações sensíveis num dashboard depende de quem tem permissão para visualizar os Dashboard.

Conclusão

O Dashboard é o recurso responsável por consolidar, em uma única tela, os principais indicadores e gráficos definidos para acompanhamento do negócio. Por ser inteiramente configurável através dos cadastros de Dashboard e Itens — que reaproveitam Gráficos e Indicadores já cadastrados, permite que diferentes visões sejam montadas conforme a necessidade de cada área ou perfil de usuário, sem exigir alterações no sistema. Dessa forma, contribui para uma tomada de decisão mais ágil, baseada em informação centralizada e sempre atualizada.

Sugestão de Leitura

Assuntos Relacionados

Gráficos

Indicadores