Manual de Utilizador

Presenca TCM — ferramenta de gestão de presenças e férias da equipa Treasury & Capital Markets (Asseco PST).

Visão Geral

Esta ferramenta substitui o ficheiro Excel que a equipa TCM utilizava para registar presenças, férias marcadas e gozadas, e ausências. Está acessível a partir de qualquer browser, suporta edição simultânea por vários utilizadores e mantém um histórico de todas as alterações.

A aplicação cobre os 36 colaboradores TCM distribuídos pelas geografias LX (Lisboa), FX (Parque das Nações) e LU (Luxemburgo).

Acesso e Login

O acesso é feito com email e password. A sessão dura 30 dias (cookie httpOnly). Por razões de segurança, após 5 tentativas falhadas consecutivas a conta fica bloqueada durante 15 minutos.

Roles e Permissões

Códigos de Presença

Cada dia útil pode ter um código associado a um colaborador. Os códigos são apresentados como chips coloridos no mapa mensal.

Presença

Férias Gozadas

Férias Marcadas

Férias planeadas mas ainda não gozadas. Contam para os saldos como marcado.

Neutros

Faltas

Vistas da App

Mapa Mensal

Vista principal. Mostra todos os colaboradores em linhas e os dias do mês em colunas. Permite ver e editar registos de forma rápida.

• Navegar entre meses: setas ‹ › na barra de ferramentas ou clicar no nome do mês.
• Registar um dia: clicar numa célula e escolher o código no popup. Clicar novamente apaga o registo.
• Selecção múltipla: clicar e arrastar horizontalmente para seleccionar vários dias seguidos de um colaborador, e depois escolher o código a aplicar.
• Filtro por grupo: dropdown Grupo na toolbar permite seleccionar um ou mais grupos em simultâneo; o mapa mostra apenas os colaboradores que pertencem a pelo menos um dos grupos escolhidos. "Limpar selecção" volta a mostrar todos. Os grupos dos quais o próprio utilizador é membro aparecem marcados com ★ na lista, para serem reconhecidos facilmente.
• Coluna Grupos: quando estão seleccionados dois ou mais grupos no filtro, surge uma coluna extra "Grupos" com uma etiqueta por colaborador indicando a que grupo(s) filtrado(s) pertence.
• Filtro por colaborador: dropdown Colaborador na toolbar permite seleccionar um ou mais colaboradores individualmente. O utilizador actual aparece primeiro como "Eu (nome)". Quando um ou mais grupos estão seleccionados, o dropdown mostra apenas os membros desses grupos. A selecção de colaboradores tem prioridade sobre o filtro de grupo.
• Limpar filtros: link "× Limpar filtros" aparece na toolbar sempre que algum dos filtros de grupo ou colaborador está activo; limpa ambos de uma só vez.
• Ausentes (Hoje / Esta Semana / Este Mês): três botões na toolbar mostram, em tempo real, quantos colaboradores estão ausentes. Clicar num deles filtra a lista para mostrar só essas pessoas — clicar de novo no mesmo botão desliga o filtro. Combina-se com os filtros de grupo e colaborador. Este Mês acompanha sempre o mês que estiver a ser visualizado (ex. ao navegar para Junho, mostra os ausentes de Junho). Hoje e Esta Semana só fazem sentido no mês actual — ficam desactivados (acinzentados) quando se navega para outro mês, e activam automaticamente ao voltar.
• Preferências gravadas: os filtros de grupo, colaborador, tipo de ausência e o filtro rápido de Ausentes são guardados automaticamente por utilizador. Na próxima sessão, o mapa abre com os mesmos filtros que estavam activos.
• Pesquisa: campo de texto na toolbar filtra colaboradores pelo nome.
• Badges de alerta: ícones ⚠ ou ● junto ao nome indicam alertas activos (R1–R6). Clicar no nome do colaborador abre a Vista Pessoal.
• Ausências parciais: quando um registo é de meio-dia (menos de 8h), o tooltip da célula mostra as horas entre parênteses (ex. "Férias Marcadas (4h)").
• Legenda lateral: à direita, permite filtrar a visualização por tipo de registo (clicar no item).

Vista Anual

Heatmap de todo o ano: cada linha é um colaborador, cada coluna é um dia do ano. Útil para ter uma perspectiva global das ausências e identificar padrões.

• Clique num colaborador para navegar directamente para a Vista Pessoal.
• O ano navega-se pelas setas na toolbar.
• Filtros de Grupo e Colaborador idênticos ao Mapa Mensal, partilhando o mesmo estado de selecção.
• Ausências parciais: um registo de meio-dia (menos de 8h) aparece com a cor do tipo mais esbatida (mais transparente), para se distinguir visualmente de uma ausência de dia completo. O tooltip da célula mostra as horas entre parênteses.

Tabela de Saldos

Mostra, para cada colaborador, o resumo de saldos de férias: dias totais, gozados, marcados e disponíveis — divididos por tipo (base, carry, extra, flex).

• Editar saldo: admin pode editar todos os campos (base, extra, flex, carry). editor pode editar extra, flex e carry, sujeitos a limites máximos configurados pelo admin. O campo base é restrito a admins. Todas as alterações ficam registadas no log de auditoria.
• Os valores actualizam em tempo real conforme os registos do mapa.
• Exportar CSV: o botão ↓ Exportar CSV na toolbar está disponível a todos os utilizadores autenticados e exporta os saldos visíveis no ecrã.
• Filtros de Grupo e Colaborador na toolbar (mesmo comportamento que nas outras vistas). Para ver apenas o seu próprio saldo, seleccione "Eu" no dropdown Colaborador.

Vista Pessoal

Vista individual de um colaborador, com o calendário do ano e o detalhe dos saldos e alertas. Acessível clicando no nome no Mapa Mensal ou na Vista Anual, ou directamente no selector da própria tab A Minha Vista.

• Faixa de resumo (KPI): linha de tiles no topo da página com os valores-chave — dias disponíveis (colorido por urgência), dias gozados, marcados, número de alertas activos e próxima escala HD2 (quando aplicável). Permite ter uma leitura imediata da situação sem percorrer os cards.
• Painel esquerdo: Saldo de Férias (tabela detalhada + barra de utilização) → Os meus pedidos → Estado das Regras. O card Estado das Regras mostra apenas os alertas activos (amarelo/vermelho); as regras sem alertas ficam colapsadas numa linha "N regras sem alertas" clicável para expandir.
• Marcação de ausências: clicar em qualquer dia útil (na vista Calendário ou Tabela) abre o mesmo popup do Mapa Mensal para registar ou apagar um código. Para vários dias seguidos, clicar e arrastar horizontalmente para seleccionar um intervalo.
• Escalas HD2 (apenas para colaboradores com funções HD2 atribuídas): card no painel direito (acima do Calendário) com duas tabs:
  • Próximas 3 sem. — as próximas 3 semanas onde o colaborador está escalado, em grelha semanal (SEG–DOM). A semana corrente é destacada a azul.
  • Conflitos — semanas futuras (a partir da semana corrente) em que existe pelo menos um dia de escala com ausência marcada. O tab exibe um badge vermelho com o número de semanas em conflito. Dias com conflito surgem com fundo laranja e borda vermelha. Semanas já terminadas não são mostradas.
• Reportar Bug / Pedido de Melhoria: o botão 💬 Reportar Bug no canto superior direito abre um formulário para submeter bugs ou pedidos de melhoria. O campo de descrição suporta formatação Markdown:
  • Toolbar: botões B (negrito), I (itálico), </> (código inline) e • lista.
  • Atalhos de teclado: Ctrl+B (negrito), Ctrl+I (itálico), Ctrl+E (código inline).
  • Imagens: colar um screenshot directamente com Ctrl+V — a imagem é comprimida automaticamente e incorporada na descrição (sem necessidade de upload externo).
  • Pré-visualizar / Editar: tabs no fundo do editor para alternar entre o texto Markdown e a renderização formatada.
• Os meus pedidos: quando está a visualizar o seu próprio perfil, aparece o card (entre o Saldo e o Estado das Regras) com todos os bugs e melhorias submetidos, com estado e eventuais respostas. A descrição é apresentada com a formatação e imagens que foram inseridas na submissão.

Painel Admin

Apenas visível para admin. A navegação é feita através de uma sidebar lateral organizada em cinco grupos:

• Pessoas
  • Perfis e Permissões: gerir contas, resetar passwords, alterar roles. Se um utilizador estiver bloqueado por excesso de tentativas de login, aparece um botão 🔒 (vermelho) junto ao seu nome — clicar remove o bloqueio imediatamente sem aguardar os 15 minutos.
  • Excepções: registar excepções formais R1/R3/R4 para colaboradores específicos.
• Calendário
  • Feriados Oficiais: adicionar/remover feriados por geografia.
  • Tolerâncias: gerir dias de tolerância da empresa. Cada registo mostra a data, descrição, entidade e duração (Dia inteiro / Xh ½ dia). O botão ✏ permite editar um registo existente — incluindo corrigir as horas — e o × elimina-o.
• Escalas HD2
  • Escalas HD2: gerir rotação semanal HD2 (substituições, trocas, shift).
  • Créditos HD2: gerir créditos de horas HD2 por colaborador.
  • Cobertura Mínima: configurar grupos e limiares de presença mínima (R6).
• Monitorização
  • Feedback: issue tracker integrado com os feedbacks reportados pela equipa. Ocupa o ecrã completo quando seleccionado.
    • Tabs: Em aberto (por defeito) mostra apenas issues Novo / Em análise / Backlog, com coluna Registado (data e hora de submissão). Todos mostra o histórico completo e acrescenta a coluna Resolvido (data/hora da resposta, preenchida apenas para issues Feito ou Rejeitado).
    • Filtros: barra acima da tabela com pesquisa por ID / título / descrição (texto livre), dropdowns para Tipo, Reporter, Estado, Prioridade, Categoria e Esforço, e intervalos de data para Registo e Resolução. Os filtros aplicam-se instantaneamente (sem nova consulta à base de dados). Os campos activos ficam a azul; o botão ✕ Limpar repõe tudo.
    • Painel de detalhe: ao clicar numa linha a grelha encolhe para metade e o painel de detalhe abre à direita. Permite alterar o estado (Novo / Em análise / Backlog / Feito / Rejeitado), escrever uma resposta ao utilizador, classificar prioridade / severidade / impacto / categoria / esforço e adicionar notas internas. A descrição é apresentada com a formatação Markdown e imagens incluídas pelo utilizador. Clicar na mesma linha (ou no ✕) fecha o painel.
  • Log de Auditoria: histórico completo de todas as alterações, apresentado em tabela de largura total com colunas Data/Hora, Tipo, Por, Entidade e Alteração. Cobre os seguintes tipos: Presença, Saldo, Perfis, Feriados, Tolerâncias, Excepções, Grupos, Feedback, Escalas HD2, Créditos HD2 e Cobertura Mínima. Filtrável por tipo, período e utilizador.
• Processos
  • Processo Anual: operações de fecho e abertura de ano (saldos, carry-over).
  • Config. Saldos: configura os dias base por empresa (ASSECO PST para LX/FX; LEBATECHNOLOGY para LU) e os limites máximos que os editores podem atribuir aos campos extra, flex e carry. Se um campo de limite ficar vazio, não existe restrição para editores.

Grupos Virtuais

Permite criar agrupamentos de colaboradores para filtrar o Mapa Mensal, Vista Anual e Tabela de Saldos. Os grupos são independentes da hierarquia organizacional — um colaborador pode pertencer a vários grupos.

• Criar grupo: botão + Novo Grupo (admin). O nome deve ser único.
• Adicionar membros: botão + Adicionar membros no card do grupo. Suporta pesquisa e selecção múltipla.
• Remover membro: passar o rato sobre o nome do membro e clicar ×.
• Eliminar grupo: botão ✕ no cabeçalho do card (admin). Remove o grupo e todos os seus membros.
• Reordenar grupos: arrastar o ícone ⠿ no cabeçalho do card para a posição desejada. A ordem é guardada automaticamente e reflecte-se no dropdown de filtro das outras vistas.
• Meus grupos (★): os cards dos grupos dos quais o utilizador autenticado é membro ficam marcados com uma borda azul e uma estrela ★ junto ao nome, para serem identificados facilmente entre os restantes.

Escalas HD2

Vista de rotação semanal HD2. Mostra, para cada semana do ano, quem está escalado nos 5 papéis de serviço. Visível a todos os utilizadores autenticados.

• Colunas: HD2, Suplente HD2, Apoio HD2 n.úteis, Suplente Apoio, On Training 09h-18h.
• Navegação por ano: setas ‹ › na toolbar.
• Semana actual: destacada a azul com barra lateral.
• Alerta de conflito: fundo vermelho na linha do papel quando o colaborador escalado tem férias ou falta marcada nesse dia exacto.
• Filtros multi-select: a toolbar tem dois filtros de selecção múltipla — o painel mantém-se aberto para seleccionar várias opções em simultâneo; fecha ao clicar fora:
  • Pessoa — mostrar só as semanas onde determinada(s) pessoa(s) estão escaladas.
  • Papel — mostrar só determinados papéis (ex: esconder Suplente HD2 e Suplente Apoio para uma visão mais limpa).
• Cores por papel: cada papel tem um label colorido — HD2 (azul), Suplente HD2 (azul claro), Apoio HD2 (laranja), Suplente Apoio (laranja claro), On Training (verde) — para facilitar a leitura rápida.
• Editar célula (admin e editores do pool HD2/Suplente HD2): clicar numa célula abre um popup com quatro opções:

• Substituir: escolher outro colaborador para substituir o actual nesse dia específico — os restantes dias da semana ficam inalterados. Marcar Aplicar a toda a semana para sobrescrever a semana inteira (e limpar eventuais overrides de dia).
• Trocar: trocar dias de escala com outro colaborador. Fluxo: seleccionar a pessoa com quem trocar (lista filtrada pelos elementos do mesmo papel) → o sistema mostra um calendário semanal com os dias em que cada pessoa está escalada — o dia da célula clicada é pré-seleccionado → seleccionar o mesmo número de dias de cada lado → clicar Confirmar → rever o resumo da troca → clicar Sim, confirmar para executar. Útil para situações como "não posso trabalhar no fim-de-semana X, mas faço dois dias na semana Y em troca". Só dias com alocação efectiva podem ser seleccionados; a troca tem de ser equilibrada (N dias ↔ N dias); não há restrição de dia-da-semana (é possível trocar um sábado por uma segunda-feira).
• Shift ↓: inserir um novo colaborador e empurrar a rotação uma semana para a frente — o actual passa para a semana seguinte, e assim sucessivamente. Fluxo: seleccionar o colaborador na grelha → clicar Confirmar → rever o resumo completo das semanas afectadas → clicar Sim, confirmar para executar.
• Shift ↑: remover o colaborador desta semana e recuar a rotação — o da semana seguinte passa a esta, e assim sucessivamente (a última semana do ano fica vazia). Útil para desfazer um Shift ↓ aplicado por engano. Fluxo: clicar Confirmar → rever o resumo completo das semanas afectadas → clicar Sim, confirmar para executar.

Gestão de Escalas (Admin)

Em Admin → Escalas HD2 o administrador pode:

• Gerir pools: 3 pools independentes — HD2 (partilhado entre HD2 e Suplente), Apoio HD2 (partilhado entre Apoio e Suplente Apoio) e On Training. A ordem dos membros dentro de cada pool define a sequência de rotação.
• Gerar escala anual (wizard): escolher o ano e modo (preencher gaps / sobrescrever tudo) e clicar em Gerar. O algoritmo cicla pelos pools: HD2[i], Suplente[i+1], semana a semana.
• Edição célula a célula: clicar em qualquer célula abre o popup de edição com as opções Substituir, Trocar, Shift ↓ e Shift ↑ (ver acima).

Regras e Alertas (R1–R6)

A aplicação verifica automaticamente seis regras de negócio e apresenta alertas visuais no Mapa Mensal e na Vista Pessoal. Alguns alertas podem ser suprimidos por uma excepção formal registada por um admin.

Modelo de Saldos

Os saldos de férias são calculados automaticamente com base nos registos do mapa. A fórmula é:

• Base: dias base anuais. O padrão por empresa é configurável em Admin → Config. Saldos (ASSECO PST e LEBATECHNOLOGY podem ter valores diferentes); o padrão por omissão é 25. Pode ser substituído individualmente por um admin (ex: colaboradores contratados a meio do ano). Edição restrita a admins.
• Extra: dias adicionais. Configurável por admin ou editor (sujeito a limite máximo definido em Config. Saldos).
• Flex: dias flex. Configurável por admin ou editor (sujeito a limite máximo definido em Config. Saldos).
• Carry: dias transitados de 2025. Configurável por admin ou editor (sujeito a limite máximo definido em Config. Saldos).

Operações Comuns

Registar Presença / Ausência

1. No Mapa Mensal ou em A Minha Vista (vista Calendário ou Tabela), navegar para o dia pretendido.
2. Clicar na célula do colaborador e do dia. Abre-se o popup de registo.
3. Clicar nos chips de tipo (ex: RM FM) para os adicionar à lista de registo. Cada entrada aparece com os botões − e + para ajustar as horas (o total não pode ultrapassar 8h).
4. Clicar em Guardar para gravar. A confirmação aparece na barra de estado (canto superior direito).

Vários tipos no mesmo dia: é possível registar múltiplos tipos numa mesma célula — por exemplo, 3h de FJ e 5h de RM. Basta adicionar os chips pretendidos e ajustar as horas de cada um antes de guardar.

Datas no passado: ao clicar numa célula anterior ao dia de hoje, o popup mostra automaticamente as opções Gozadas (FG TG EG XG) em vez das Marcadas — uma ausência já passada é sempre gozada.

Para apagar um registo, abrir o popup da célula preenchida, remover todas as entradas da lista (botão ×) e clicar Limpar dia. O sistema pede confirmação antes de apagar.

Para cancelar sem guardar alterações, clicar Cancelar ou no fundo escuro fora do popup.

Para vários dias seguidos, clicar e arrastar horizontalmente e depois escolher o código no popup de selecção múltipla. Se a selecção abranger dias passados e futuros, os dias passados são gravados automaticamente como Gozados e os futuros como Marcados. Esta funcionalidade está disponível tanto no Mapa Mensal como em A Minha Vista (calendário e tabela).

Dias Extra (EG / EM)

Os dias extra são dias adicionais ganhos por trabalho em feriados ou fins-de-semana. Cada dia é registado individualmente com a data em que foi ganho, o motivo e a duração (1 dia ou ½ dia).

Para marcar dias extra no mapa, usar os códigos EG (Extra Gozado) e EM (Extra Marcado). Ao guardar, o sistema pede que se indique qual o extra ganho a associar — escolher da lista (por ordem FIFO, do mais antigo para o mais recente). Se a selecção abranger vários dias, cada dia fica associado a um extra diferente.

Para gerir os extras ganhos de um colaborador, clicar no ícone 🎯 junto ao valor Extra na Tabela de Saldos. O diálogo mostra todos os registos com o estado (disponível / usado) e o dia de mapa ao qual estão associados.

• Adicionar: clicar em + Adicionar dia extra para registar um novo direito — preencher a data em que foi ganho e o motivo.
• Corrigir: clicar directamente na Data ganho, Motivo ou Dur. de qualquer linha existente — o campo torna-se editável (borda azul) e guarda automaticamente ao sair. A tecla Enter também confirma.
• Remover: o botão × apaga o registo, desde que não esteja associado a um dia no mapa.

Ao cancelar um dia EG ou EM no mapa (usando Limpar dia ou substituindo por outro tipo), o extra correspondente fica automaticamente disponível para associar a outro dia.

Excepções Formais (R1, R3, R4, R6)

As regras R1, R3, R4 e R6 podem ser suprimidas por uma excepção formal, quando existe uma justificação aprovada.

1. Aceder ao Painel Admin (apenas admin).
2. Secção Excepções.
3. Criar nova excepção: escolher o colaborador, a regra (R1/R3/R4/R6), o período e o motivo.

Enquanto a excepção estiver activa, o alerta correspondente desaparece para esse colaborador.

Perguntas Frequentes

Esqueci-me da password — o que faço?

Contactar um admin (Miguel Figueiredo, Rubina Gouveia ou Fernando Silva) para reset da password.

Não consigo editar um colaborador

O seu role não tem permissão para isso. Os viewer não podem editar. Os editor só podem editar os colaboradores do seu grupo. Se achar que é um erro, contacte um admin.

O saldo de um colaborador parece errado

Verificar se os registos de TG/TM (carry-over) estão correctamente introduzidos. Os saldos base e carry podem ser ajustados directamente na Tabela de Saldos por um admin ou editor. Todas as alterações ficam registadas no Log de Auditoria.

Como funciona a conversão automática de Marcado → Gozado?

Todos os dias às 18h, o sistema percorre automaticamente os dias marcados (FM, TM, EM, XM) que já passaram e converte-os nos códigos gozados correspondentes (FG, TG, EG, XG). Não é necessária nenhuma acção manual.

O alerta RM aparece mas o colaborador tem excepção — porquê?

Verificar se a excepção está dentro do período correcto (data de início e limite) e se foi criada para a regra certa (R1). Se estiver tudo correcto, contactar um admin.

Como ver o histórico de alterações de um colaborador?

No Painel Admin → Log de Auditoria. A tabela ocupa o ecrã completo e mostra todas as alterações ordenadas por data descendente. Disponíveis filtros por tipo (Presença, Saldo, Perfis, Escalas HD2, Créditos HD2, Cobertura Mínima, entre outros), período de datas e nome de utilizador.

A app não carrega / diz "Erro de ligação"

Verificar a ligação à internet. Se o problema persistir, contactar o responsável técnico (Miguel Figueiredo).