Mapa de Controlo

O Mapa de Controlo é a ferramenta central para acompanhar o trabalho contabilístico mensal de cada cliente. Oferece uma visão rápida do que está completo, em progresso ou pendente.

Layout da Página

A Matriz

Estrutura

• Coluna fixa — Nome/número do cliente (esquerda)
• 12 colunas — Uma por mês (Janeiro a Dezembro)
• Células coloridas — Indicam estado do mês

Cores das Células

Mês Atual

• Destacado com cor primária
• Indicador de pulso visual
• Meses futuros aparecem acinzentados

Controlos Manuais

Cada cliente/mês tem 7 controlos manuais:

Estados dos Controlos

Fluxo de Trabalho

Pendente → Feito → Verificado

1. Utilizador marca como "Feito"
2. Sistema regista quem e quando
3. Outro utilizador marca como "Verificado"
4. Sistema regista verificação

Modal de Detalhes do Mês

Clique numa célula para abrir o modal com:

Cabeçalho

• Nome e número do cliente
• NIF
• Mês e ano selecionado

Secção: Controlos Manuais

Lista dos 7 controlos com:

• Badge de estado (Pendente/Feito/Verificado)
• Histórico — Quem fez, quando
• Botões de ação — Marcar como Feito/Verificado/Reverter

Secção: Controlos Automáticos

SAFTs Importados:

• Lista de origens com SAFTs
• Contagem: importados vs esperados
• Indicador de dados legacy

Controlos Bancários:

• Por cada banco do cliente:
  • Extrato recebido
  • Extrato arquivado
  • Reconciliação feita/finalizada

Secção: Log de Documentos

• Histórico de receção de arquivo
• Data e hora de cada entrada
• Útil para rastreabilidade

Secção: Estatísticas

• Percentagem de conclusão
• Contagem de verificados vs total

Filtros e Pesquisa

Pesquisa

Encontre clientes por:

• Número de cliente
• Nome
• NIF
• Email

A pesquisa tem debounce de 300ms para melhor performance.

Seletor de Ano

Escolha o ano a visualizar (±2 anos do atual).

Filtro de Gestor

Veja apenas clientes de um gestor específico.

Filtro de Estado

Cards de Estatísticas

No topo ou lateral:

Os números atualizam com os filtros aplicados.

Performance e Cache

Carregamento Instantâneo

O sistema usa IndexedDB para cache local:

1. Primeira visita carrega dados do servidor
2. Visitas seguintes carregam do cache instantaneamente
3. Dados são atualizados em background

Indicador de Cache

Se os dados são do cache local, aparece um indicador discreto.

Pré-carregamento

O sistema pré-carrega automaticamente:

• Páginas adjacentes
• Dados de meses recentes

Paginação

• 10 clientes por página
• Navegação com botões Anterior/Próximo
• Indicador de página atual vs total
• Filtros persistem na URL

Ações nos Controlos

Marcar como Feito

1. Abra o modal clicando na célula
2. Encontre o controlo
3. Clique em "Marcar como Feito"
4. O sistema regista:
   • Quem marcou
   • Data e hora

Verificar

1. Abra o modal
2. Encontre o controlo já marcado como "Feito"
3. Clique em "Verificar"
4. O sistema regista a verificação

Reverter

Se precisar desfazer:

1. Abra o modal
2. Clique em "Reverter" no controlo
3. O estado volta ao anterior

Dependências entre Controlos

Alguns controlos dependem de outros:

O sistema pode alertar se tentar marcar um controlo sem o precedente.

Clientes Inativos

• Clientes que cessaram atividade aparecem com indicador
• Meses após a data de inatividade ficam bloqueados
• Histórico anterior mantém-se visível

Dados Legacy

Para dados anteriores a Setembro 2025:

• Aparecem com indicador "legacy"
• Podem ter estrutura diferente
• Sistema trata automaticamente

Boas Práticas

Organização Diária

• Comece pelo filtro de gestor (se aplicável)
• Foque no mês atual
• Use cores para identificar prioridades

Marcar Controlos

• Marque logo que concluir a tarefa
• Não acumule para marcar depois
• Peça verificação a um colega

Verificação

• Verifique trabalho de outros diariamente
• Use o filtro "Aguarda Verificação"
• A verificação garante qualidade

Comunicação

• Use notas/observações para casos especiais
• Documente exceções no histórico
• Comunique atrasos ao gestor