Sumário do artigo

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.