Magic Point é uma ferramenta desenvolvida para simplificar o tratamento de marcações de ponto de funcionários, transformando registros brutos em dados valiosos para análise.
- Separação automática de Data e Dia da Semana
- Divisão inteligente das marcações de ponto (batidas)
- Limpeza e organização das justificativas
- Geração de planilha pronta para análise
Para utilizar o programa, você deve ter o Python 3.9 ou superior instalado corretamente. Recomenda-se o uso da versão mais recente do Python para melhor compatibilidade com as bibliotecas mais atuais. Você pode baixar a última versão do Python aqui.
-
Baixar o Projeto: Clone este repositório para o seu ambiente local ou faça o download do arquivo ZIP.
git clone [https://github.com/Draken573/Magic-Point.git](https://github.com/Draken573/Magic-Point.git) # Substitua pelo seu link do repositório, se diferente cd Magic-Point
-
Configuração do Ambiente Virtual e Instalação de Dependências: É altamente recomendado o uso de um ambiente virtual para isolar as dependências do projeto e evitar conflitos com outras instalações Python no seu sistema.
-
Criar e ativar o ambiente virtual:
python3 -m venv venv source venv/bin/activate # Para Linux/macOS # Ou .\\venv\\Scripts\\activate.bat (Para Windows - Prompt de Comando) # Ou .\\venv\\Scripts\\Activate.ps1 (Para Windows - PowerShell)
(Substitua
venvpelo nome que preferir para o seu ambiente virtual). -
Instalar dependências de sistema (se necessário): Em sistemas Debian/Ubuntu, se você encontrar erros de compilação relacionados a pacotes como
numpyoupandas, pode ser necessário instalar as ferramentas de desenvolvimento do Python e outras dependências de compilação:sudo apt update sudo apt install python3-dev build-essential libssl-dev libffi-dev
-
Atualizar
pip,setuptoolsewheelno ambiente virtual: Garanta que as ferramentas de instalação estejam atualizadas:pip install --upgrade pip setuptools wheel
-
Instalar as dependências do projeto:
pip install -r requirements.txt
-
-
Execução: Com o ambiente virtual ativado e as dependências instaladas, execute o script principal:
python PontoMagico.py
-
Entrada de Dados: O programa solicitará o caminho completo da planilha de entrada (.xlsx). Insira o caminho completo ou arraste o arquivo para a janela do terminal.
-
Resultados: Após o processamento, uma nova planilha tratada será gerada e salva na pasta
tratamentos, localizada no diretório do projeto.
Imagine que você possui uma planilha de marcações de ponto chamada relatorio_ponto.xlsx. Ao executar o Magic Point e fornecer o caminho desta planilha, o programa irá processá-la e gerar uma nova planilha na pasta tratamentos, pronta para análise detalhada.
Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para mais detalhes.
Feito com 💪 por Anderson Monteiro 💻