Documentação Ponto Ágil - Versão 2.0 (Revisada)

1. Visão Geral e Arquitetura

O Ponto Ágil é uma aplicação web completa para gestão de jornada de trabalho, desenvolvida para ser robusta, segura e intuitiva. O sistema permite o registro de ponto por colaboradores, a gestão detalhada por parte dos supervisores e do RH, e o controle total pela administração.

Tecnologias Principais:

• Back-end: Python com o micro-framework Flask.
• Banco de Dados: SQLite, um banco de dados leve e eficiente baseado em arquivo.
• Front-end: HTML, CSS e JavaScript, utilizando o framework Bootstrap 5 para um design responsivo e moderno.
• Componentes Adicionais: SQLAlchemy (ORM), Flask-Migrate (migrações de banco), Flask-Login (autenticação), WTForms (formulários), Geopy (geocodificação), Pandas (importação Excel), WeasyPrint (exportação PDF) e Chart.js (gráficos).
• Estrutura do Projeto: O projeto é modularizado usando a arquitetura de Blueprints do Flask, separando as responsabilidades em: core (páginas principais), auth (autenticação), user (ações do colaborador), supervisor (painel do supervisor), rh (painel do RH), e admin (painel de administração). A lógica de cálculo principal está centralizada no arquivo app/utils.py.

2. Perfis de Usuário e Permissões

O sistema opera com quatro níveis de acesso distintos, criando uma hierarquia clara de gestão.

Perfil	Nível de Acesso	Responsabilidades Principais
Colaborador	usuario	Bater seu próprio ponto, visualizar seu histórico, enviar justificativas e solicitar férias.
Supervisor	supervisor	Gerenciar a equipe do seu setor, validar folhas de ponto, e realizar a pré-aprovação de férias.
Gestor de RH	master	Gerenciar todos os colaboradores, editar folhas de ponto, aprovar justificativas, dar a aprovação final de férias, fechar períodos e gerar relatórios.
Administrador	administrador	Acesso total. Inclui todas as permissões do RH, mais a capacidade de gerenciar usuários de todos os níveis, setores, jornadas, configurações do sistema e backups.

3. Guia do Colaborador (Perfil: usuario)

3.1. Plataforma de Ponto

• O que é? A tela principal para o registro diário da jornada.
• Como usar? 1. Ao fazer login, o colaborador é direcionado para a /platform. Um relógio sincronizado com o servidor exibe a hora oficial. 2. O sistema indica qual será a próxima batida (Entrada, Saída para Almoço, etc.). 3. Ao clicar em “Bater Ponto Agora”, o sistema registra o horário e a localização. 4. Abaixo, são exibidos os 4 principais registros do dia.

3.2. Histórico de Ponto

• O que é? Uma visão completa de todas as folhas de ponto, passadas e presente.
• Como usar? 1. Na Plataforma, clicar em “Ver Histórico Completo”. 2. A página /history é exibida. O colaborador pode usar os filtros de mês e ano para navegar. 3. A tela exibe um aviso se a folha do mês está “Aberta para Ajustes” ou “Fechada” pelo RH.

3.3. Envio de Justificativas

• O que é? A ferramenta para o colaborador justificar ausências ou registros incompletos.
• Como usar? 1. Acesse o Histórico de Ponto. Para o mês corrente e se a folha estiver aberta, ao lado de um dia com status “Falta” ou “Incompleto”, aparecerá o botão “Justificar”. 2. Ao clicar, o colaborador preenche o formulário e anexa um documento (PDF, JPG, PNG). 3. A justificativa fica com o status “Pendente” até ser analisada pelo RH.

3.4. Solicitação de Férias

• O que é? Um módulo para solicitar formalmente um período de férias.
• Como usar? 1. O colaborador acede à nova secção “Minhas Férias” em seu painel. 2. Preenche um formulário indicando as datas de início e fim desejadas. 3. Após o envio, a solicitação é enviada para seu supervisor direto para uma pré-aprovação e, posteriormente, para o RH para aprovação final. O status da solicitação pode ser acompanhado nesta mesma tela.

4. Guia do Gestor (Perfil: master / RH)

4.1. Painel de Gestão Principal

• O que é? A tela inicial para gestores, com um resumo do sistema.
• Como usar? 1. Ao fazer login, o gestor é direcionado para a página /management. 2. São exibidos cards com dados rápidos e “Acessos Rápidos” para as áreas de gestão.

4.2. Dashboard de Colaboradores (Gestão RH)

• O que é? A visão geral de todos os colaboradores, com um resumo de suas folhas de ponto do mês.
• Como usar? 1. Uma tabela exibe todos os colaboradores e os totais calculados para o mês corrente: Horas Esperadas, Horas Trabalhadas e o Saldo do Mês. 2. Ao lado de cada colaborador, o botão “Gerenciar” leva à sua folha de ponto detalhada.

4.3. Gerenciamento Individual do Colaborador

• O que é? A tela com controle total sobre a vida funcional do colaborador. Possui 3 abas:
  • Aba “Informações e Jornada”:
    • Permite editar dados básicos, de RH (cargo, nº de registro) e de salário.
    • Permite definir a Data de Admissão do colaborador.
    • Permite marcar o usuário como Cargo de Confiança. Um usuário com esta marcação não registra ponto e não entra nos cálculos de saldo de horas.
    • Permite atribuir uma das “Jornadas de Trabalho” pré-cadastradas.
  • Aba “Folha de Ponto”:
    • Exibe a folha de ponto detalhada. Horários são clicáveis para edição. Endereços de registro são visíveis.
  • Aba “Ações”:
    • Permite ao RH redefinir a senha do colaborador.

4.4. Ações na Folha de Ponto

• O que são? Botões interativos na coluna “Ações” da folha de ponto detalhada.
• Como usar?
  • Analisar Justificativa: Abre um modal para aprovar ou recusar uma justificativa enviada pelo colaborador.
  • Abonar Falta: Permite ao RH criar uma justificativa já aprovada em nome do colaborador.
  • Anular Dia: Permite ao RH anular todos os registros de um dia, com a devida motivação.

4.5. Relatórios e Exportação

• O que é? Seção para gerar relatórios com visualização em tela, gráficos e exportação para PDF.
• Como usar? Selecione o colaborador e o período para gerar um relatório detalhado ou estatístico. O botão “Exportar para PDF” gera um documento profissional.

4.6. Gerenciamento de Períodos

• O que é? A ferramenta de “fechamento de mês”, agora com um fluxo de validação.
• Como usar? 1. A tela lista os colaboradores e o status do mês. 2. Se o fluxo de aprovação estiver ativo, o RH clica em “Liberar p/ Supervisor”. O status muda para “Pendente Avaliação”. 3. Após o supervisor validar (status muda para “Avaliado”), o RH pode ver os comentários do supervisor e clicar em “Fechar Mês”. 4. Se o fluxo estiver desabilitado, o RH fecha o mês diretamente. O mês pode ser reaberto se necessário.

4.7. Gestão de Férias

• O que é? Um novo painel dedicado para a aprovação final das solicitações de férias.
• Como usar? 1. Acesse “Gerir Férias” no painel do RH. 2. A tela exibe uma lista de todos os pedidos de férias que já foram pré-aprovados pelos supervisores. 3. O RH pode revisar cada pedido, adicionar comentários e dar a aprovação final ou recusar a solicitação.

5. Guia do Administrador (Perfil: administrador)

O Administrador tem acesso a todas as funcionalidades do RH e, adicionalmente, às seguintes áreas:

5.1. Gestão de Usuários (Painel Admin)

• O que é? Controle total sobre todas as contas de usuário.
• Como usar? O admin pode criar qualquer tipo de usuário (usuario, supervisor, master, administrador), e deletar permanentemente qualquer conta.

5.2. Gestão de Jornadas de Trabalho

• O que é? O admin cria e edita os modelos de jornada de trabalho que o RH irá atribuir.
• Como usar? Crie novas jornadas definindo nome, dias da semana, horários e duração do almoço.

5.3. Importação via Excel

• O que é? Ferramenta para cadastrar múltiplos colaboradores em massa.
• Como usar? Baixe o modelo, preencha a planilha .xlsx e faça o upload para importação em lote.

5.4. Configurações do Sistema

• O que é? Área para definir parâmetros globais do Ponto Ágil.
• Como usar?
  • Data de Início da Ferramenta: Define a data a partir da qual o sistema começa a calcular os pontos.
  • Tema Visual da Aplicação: Permite escolher entre diferentes temas (Claro, Escuro, etc.).
  • Habilitar fluxo de aprovação por Supervisor: Uma caixa de seleção que ativa ou desativa globalmente todo o fluxo de validação da folha de ponto e pré-aprovação de férias pelo supervisor.

5.5. Gerenciamento de Banco de Dados

• O que é? Ferramenta para monitorar e proteger os dados.
• Como usar? Exibe estatísticas de armazenamento e permite criar e baixar um backup do banco de dados.

5.6. Gestão de Setores

• O que é? Ferramenta para criar a estrutura organizacional de equipes.
• Como usar? 1. Acesse “Gerenciar Setores” no painel Admin. 2. Crie novos setores (ex: “Tecnologia”, “Financeiro”). 3. Para cada setor, o admin designa um usuário com o perfil supervisor para ser o líder. 4. O RH então pode atribuir cada colaborador a um dos setores criados.

6. Guia do Supervisor (Perfil: supervisor)

Este é um novo guia dedicado ao perfil de liderança de equipe.

6.1. Painel do Supervisor

• O que é? A tela inicial do supervisor, focada em sua equipe direta.
• Como usar? Ao fazer login, o supervisor é direcionado a um painel que exibe apenas os colaboradores que pertencem ao seu setor. São exibidos resumos, pendências de validação e solicitações de férias da equipe.

6.2. Validação da Folha de Ponto

• O que é? O processo de revisão e validação mensal da folha de ponto dos seus liderados.
• Como usar? 1. Após o RH “Liberar p/ Supervisor”, o supervisor vê um status de “Pendente Avaliação” no seu painel. 2. Ele pode acessar a folha de ponto detalhada de cada colaborador, revisar os registros, adicionar um comentário geral e clicar em “Validar”. 3. O status da folha muda para “Avaliado”, notificando o RH que a revisão foi concluída.

6.3. Pré-aprovação de Férias

• O que é? O primeiro nível de aprovação para solicitações de férias da equipe.
• Como usar? 1. Quando um colaborador do seu setor solicita férias, uma pendência aparece no painel do supervisor. 2. O supervisor analisa a solicitação, verifica o período e pode pré-aprovar ou recusar o pedido. 3. Somente após a pré-aprovação do supervisor, a solicitação é encaminhada ao RH para a aprovação final.