3. Painel (Dashboard)

O painel é a primeira página que aparece depois de iniciar sessão. Dá uma visão geral do movimento da clínica.

Endereço: /dashboard Menu: grupo Painel → Dashboard

[CAPTURA: painel completo, com os quatro cartões no topo, os dois gráficos circulares e a lista de espera em baixo]

Para que serve

O painel responde a três perguntas do início do turno:

1. Quanto trabalho houve nos últimos meses e como está a evoluir.
2. Como se distribuem as marcações por especialidade e por estado.
3. Quem está à espera de ser atendido neste momento.

Quem pode usar

Todos os utilizadores internos da clínica (administrador, médico, enfermeiro, receção, laboratório) são levados para esta página logo após iniciar sessão.

Os utilizadores com perfil paciente não veem este painel. Vão para um painel próprio, em /patient/your/dashboard.

O que aparece no ecrã, de cima para baixo

Cabeçalho

• Linha pequena: Visão geral
• Título: Dashboard

Os quatro cartões de números

Cada cartão mostra um número total, uma percentagem com uma seta (para cima ou para baixo) e um pequeno gráfico de linha por baixo, com a evolução mês a mês. A seta fica verde quando a percentagem é positiva.

Cartão	O que conta
Total de agendamentos	Todas as marcações registadas, agrupadas por mês
Consultas canceladas	Marcações no estado Cancelado
Pacientes de retorno	Marcações no estado Retorno
Pacientes ausentes	Marcações no estado Faltou

Os meses aparecem no formato ano-mês (por exemplo, 2026-07) e por ordem cronológica.

Os dois gráficos circulares

Gráfico	O que mostra
Agendamentos por especialidade	Quantas consultas houve em cada especialidade
Agendamentos por estado	Quantas marcações estão em cada estado (Agendado, Em espera, Cancelado, etc.)

A legenda de cada gráfico fica por baixo do círculo. Ao passar o rato por cima de uma fatia, aparece o valor exato.

Cartão Pedidos online

Mostra quantos pedidos de marcação feitos pelos pacientes pela internet estão à espera de resposta.

• Ao lado do número aparece a palavra pendente (se for um) ou pendentes (se forem vários).
• Quando há pelo menos um pedido, o ícone fica em cor de âmbar (amarelo-torrado).
• Ao clicar no cartão, abre a lista de pedidos online (/booking-requests).
• O cartão atualiza-se sozinho a cada 30 segundos. Não é preciso recarregar a página.
• Se não tiver permissão para gerir pedidos online, este cartão não aparece de todo.

Lista de espera

Bloco no fim da página.

• Título: Lista de espera
• Subtítulo: Pacientes que marcaram consulta
• Cada linha mostra a inicial do nome do paciente, a frase "«Nome do paciente» marcou uma consulta" e a data e hora da marcação.
• Se não houver ninguém, aparece: "Sem pacientes em espera."

Esta lista mostra as marcações que estão no estado Em espera.

Cada botão, o que faz

O painel tem poucos elementos clicáveis.

Elemento	O que faz
Cartão Pedidos online	Abre a lista de pedidos de marcação online
Fatias dos gráficos circulares	Mostram o valor ao passar o rato; clicar numa entrada da legenda esconde ou mostra essa fatia
Barra de topo e barra de menu	Ver o capítulo 02 — Navegação

Não existem, nesta página, botões para criar marcações nem para atender pacientes. Essas ações fazem-se na agenda e na fila de espera.

Exemplo prático

Situação: é segunda-feira de manhã. A Dona Teresa, rececionista, inicia sessão às 07h50.

1. Entra e cai no painel.
2. Vê no cartão Pedidos online o número 3 pendentes. Sabe que houve três pedidos feitos pela internet durante o fim de semana.
3. Clica no cartão e trata dos três pedidos.
4. Volta ao painel e olha para a Lista de espera. Está vazia, porque ainda não chegou ninguém.
5. Repara no cartão Pacientes ausentes: o número subiu no mês passado. Comunica ao administrador que talvez valha a pena ativar lembretes de consulta.

Fluxo completo

1. Iniciar sessão.
2. Ler os quatro cartões de números — dão o retrato do mês.
3. Verificar o cartão Pedidos online; se houver pendentes, tratá-los.
4. Verificar a Lista de espera ao longo do dia.
5. Passar para a agenda (grupo Agenda → Calendario) para o trabalho corrente.

Erros comuns e como resolver

Situação	Porquê	O que fazer
Os números não mudaram depois de eu criar uma marcação	Os números do painel são guardados temporariamente pelo sistema durante 10 minutos para a página abrir depressa	Aguarde alguns minutos e volte a carregar a página
A Lista de espera está vazia mas há pacientes no balcão	A lista só mostra marcações no estado Em espera. Se ninguém mudou o estado, não aparecem	Na agenda, abra o agendamento e use Mudar estado → Em espera
O cartão Pedidos online não aparece	Não tem a permissão de gestão de pedidos online, ou o plano da clínica não inclui marcação online	Fale com o administrador da clínica
Os gráficos circulares aparecem vazios	Ainda não há marcações registadas, ou nenhuma consulta tem especialidade preenchida	Registe marcações com especialidade preenchida
Aparece um mês com valor estranho ou em falta	Marcações sem data de início não são contadas	Verifique as marcações na agenda

Dicas e boas práticas

• A Lista de espera é a única parte do painel que está sempre atualizada ao segundo. Todo o resto é guardado durante 10 minutos.
• Compare o cartão Pacientes ausentes de mês para mês. Uma subida contínua costuma indicar que os lembretes de consulta não estão a funcionar.
• O painel dá números gerais. Para análise de gestão a sério (receitas, ocupação, produtividade), use a página Indicadores, no mesmo grupo do menu, quando o plano da clínica a incluir.

Por confirmar

• O painel não tem filtros de data nem de médico. Não foi possível confirmar se os cartões contam marcações de todos os anos ou apenas de um período.
• O cartão Consultas canceladas conta marcações no estado cancelled. Não foi possível confirmar se marcações apagadas entram nesta contagem.
• Não foi possível confirmar se o painel é diferente conforme o perfil (médico, receção, laboratório). O código carrega a mesma página para todos os perfis internos; apenas o cartão Pedidos online se esconde por falta de permissão.