Dashboard

O dashboard consolida indicadores operacionais, comunicação, portal e, para perfis de gestão, financeiro. Ele não substitui os módulos de origem; use os cards para identificar onde investigar.

Acesso e filtros

Usuários autenticados fora do modo campo acessam o dashboard. Os filtros disponíveis são:

• período de 7, 30 ou 90 dias;
• cliente;
• status de projeto.

Nem todas as métricas usam o período da mesma forma. Projetos totais e distribuição por status representam o estado atual; séries e novos registros usam a janela escolhida; eventos próximos usam sete dias a partir de agora.

Indicadores operacionais

• Total de projetos.
• Projetos ativos: status não marcado como final.
• Clientes ativos: com projeto não final, respeitando cliente/status selecionados.
• Novos projetos e clientes na janela.
• Ocorrências abertas ou em andamento.
• Ocorrências altas ou críticas ainda abertas.
• Ocorrências resolvidas/fechadas e tempo médio de resolução.
• Eventos de hoje e dos próximos sete dias.
• Comentários do portal na janela.
• WhatsApp recebido, enviado e falhas de saída.

Indicadores financeiros

Somente owner, admin e manager recebem métricas financeiras:

• entradas e saídas realizadas na janela;
• contas a receber pendentes;
• adiantamentos ainda pagos e não descontados;
• folha pendente;
• contas vencidas e próximas do vencimento.

Os valores de contas consideram saldo restante, não apenas valor original.

Séries e listas

• Projetos por status atual.
• Ocorrências criadas e resolvidas por dia.
• WhatsApp recebido e enviado por dia.
• Comentários do portal por dia.
• Cinco ocorrências recentes.
• Cinco eventos próximos na consulta atual.
• Cinco comentários recentes.
• Clientes com mais ocorrências altas/críticas abertas.
• Clientes sem interação recente.

Para “sem interação recente”, o sistema considera ocorrências, comentários do portal e mensagens WhatsApp ligadas a projetos; o limite atual é sete dias.

Alertas

Alertas aparecem quando houver:

• ocorrência alta ou crítica aberta;
• outras ocorrências abertas;
• eventos hoje;
• falhas de WhatsApp;
• clientes sem interação recente;
• comentários novos no portal.

Como interpretar

1. Comece por alertas críticos.
2. Abra o módulo de origem e confirme os registros.
3. Aplique o mesmo cliente ou status para comparar.
4. Verifique datas e estados dos registros.
5. Trate a causa no módulo, não apenas o número do dashboard.

Como validar

Crie dados controlados de homologação: projeto em status não final, ocorrência crítica, evento hoje, comentário no portal e, se aplicável, movimento financeiro e mensagem WhatsApp. Recarregue e confira cards, séries e listas.

Erros comuns

• Projeto ativo incorreto: revise is_final do status.
• Filtro não afeta um total: algumas métricas representam estado global ou usam regras próprias; confira a descrição acima.
• Financeiro não aparece: o usuário não é owner/admin/manager.
• Cliente sem interação parece incorreto: apenas ocorrências, comentários e WhatsApp com relação de projeto entram nesse cálculo.
• Número não atualizou: confirme que o registro foi salvo e recarregue a página; realtime não substitui nova consulta de todas as métricas.

Próximos assuntos

• Status e andamento
• Issues e ocorrências
• Financeiro