Painel Principal (Dashboard)

Visão Geral

O Painel Principal é o "cockpit" de gestão do NossoCondo. Foi concebido para fornecer aos Administradores e Gestores de Condomínios uma visibilidade imediata e fidedigna sobre o estado atual da propriedade. Em vez de navegar por múltiplos menus, o Dashboard agrega os indicadores de desempenho mais críticos (KPIs) numa interface única, permitindo uma tomada de decisão baseada em dados reais.

Esta funcionalidade utiliza tecnologia de sincronização em tempo real, o que significa que qualquer pagamento registado ou despesa inserida por outros membros da equipa será refletida instantaneamente no seu ecrã, sem necessidade de atualizar a página.

O Dashboard adapta-se automaticamente ao perfil do utilizador. Enquanto um Administrador visualiza métricas financeiras globais, um Residente terá uma visão simplificada focada exclusivamente nas suas obrigações e pagamentos pessoais.

Funcionalidades Principais

O Dashboard é composto por diversos módulos analíticos que extraem dados de diferentes áreas da plataforma:

• Seletor de Mandato/Período Financeiro: Localizado no topo da página, permite filtrar todos os dados do painel (receitas e despesas) com base num intervalo de datas específico ou mandato de gestão.
• Indicadores de Gestão Operacional:
  • Contagem de Frações/Apartamentos: Visualização rápida do total de unidades registadas sob gestão.
  • Censo de Residentes: Monitorização do número total de utilizadores ativos e residentes no ecossistema do condomínio.
• Métricas Financeiras de Receita (Payments):
  • Listagem e soma de pagamentos recebidos e pendentes.
  • Ordenação cronológica automática por data de vencimento (Due Date).
  • Dica O sistema carrega automaticamente os últimos 100 registos para garantir performance, a menos que um filtro de data específico seja aplicado.
• Métricas Financeiras de Despesa (Expenses):
  • Monitorização de saídas de caixa e custos operacionais.
  • Análise de despesas ordenadas da mais recente para a mais antiga.
• Sincronização Multi-Fonte: O painel integra dados das definições do condomínio (moeda, nome, regras) para garantir que os valores apresentados estão na divisa correta.
• Controlo de Acessos Granular: O que o utilizador vê é estritamente controlado pelas suas permissões de leitura. Se um gestor não tiver permissão para ver "Despesas", o módulo correspondente será omitido do Dashboard para garantir a confidencialidade.

Guia Prático / Como Fazer

1. Filtrar Dados por Período ou Mandato

Para analisar a performance financeira de um período específico (ex: o ano civil anterior ou o mandato atual da administração):

1. Localize o componente Seletor de Mandato no cabeçalho da página (Page Header).
2. Clique para abrir as opções de data.
3. Selecione o intervalo desejado.
4. O Dashboard irá processar automaticamente os dados de pagamentos e despesas, removendo o limite de visualização de 100 registos para apresentar o total exato do período selecionado.

2. Interpretar os Indicadores de Resumo

No topo do Dashboard, encontrará cartões de resumo:

1. Total de Apartamentos: Confirme se o inventário de frações está correto.
2. Total de Residentes: Verifique a adesão dos condóminos à plataforma.
3. Fluxo de Caixa: Analise a relação entre os pagamentos recebidos e as despesas efetuadas no período visível.

3. Gestão de Erros e Carregamento

O NossoCondo utiliza estados de carregamento inteligentes (Skeletons) para que possa começar a ler a estrutura da página antes mesmo dos dados terminarem de carregar.

• Se visualizar uma mensagem de erro "Não foi possível carregar o seu painel", verifique se o seu perfil tem um condomínio atribuído.
• Atenção Caso os dados pareçam desatualizados, verifique a sua ligação à internet; o sistema tenta restabelecer a ligação em tempo real automaticamente.

4. Visualização de Residente (Auto-Serviço)

Se estiver a instruir um residente sobre como usar o portal:

1. Explique que o Dashboard dele é simplificado.
2. Ele verá apenas os seus próprios pagamentos (Quotas, Fundo de Reserva, etc.).
3. As definições do condomínio (como o nome do edifício) aparecerão no topo para confirmar que ele está a aceder à conta correta.

Para garantir a máxima segurança, o sistema valida as permissões de leitura (canRead) em cada carregamento. Se um utilizador tentar aceder a dados para os quais não tem autorização, o Dashboard omitirá essa informação silenciosamente, preservando a integridade do sistema.