jeffemart/pontogo repository overview

⁠PontoGo - Bot de Gerenciamento de Banco de Horas

⁠Overview

PontoGo é uma aplicação em Go que integra a API do Ponto Mais com o Telegram, permitindo gerenciar o banco de horas de funcionários através de um bot. Ideal para administradores de RH e gestores que precisam gerenciar horas de trabalho de forma eficiente.

⁠Features

• 🤖 Bot do Telegram para interação
• ⏰ Gerenciamento de banco de horas
• 👥 Listagem de colaboradores ativos
• ✏️ Edição de lançamentos
• ➕ Criação de novos lançamentos
• 🔒 Sistema de autenticação por chat ID

⁠Environment Variables

⁠Quick Start

1. Pull a imagem:

docker pull <seu_usuario>/pontogo:latest

1. Crie um arquivo .env com as variáveis necessárias:

PONTOMAIS_TOKEN="seu_token"
PONTOMAIS_BASE_URL="https://url.dominio.com.br/v1"
TELEGRAM_BOT_TOKEN="seu_bot_token"
TELEGRAM_HOSTS=123456789,987654321
DEBUG=false

1. Execute o container:

docker run -d \
  --name pontogo \
  --restart unless-stopped \
  --env-file .env \
  <seu_usuario>/pontogo:latest

⁠Docker Compose

version: '3.8'

services:
  pontogo:
    image: <seu_usuario>/pontogo:latest
    container_name: pontogo
    restart: unless-stopped
    env_file:
      - .env

⁠Comandos do Bot

• /start - Inicia o bot
• /help - Mostra a mensagem de ajuda
• /listar - Lista todos os colaboradores ativos
• /editar <ID> <quantidade_segundos> <data> <observação> <retirada> - Edita um lançamento
• /criar <ID_funcionário> <quantidade_segundos> <data> <observação> <retirada> - Cria um novo lançamento
• /relatorio - Permite processar múltiplos lançamentos de banco de horas a partir de um arquivo Excel.

⁠Security

• A imagem usa um usuário não-root
• Requer autenticação via chat ID do Telegram
• Suporta apenas hosts autorizados configurados em TELEGRAM_HOSTS

⁠Support

Para suporte, abra uma issue no GitHub repository⁠.

⁠License

MIT License - veja o arquivo LICENSE para detalhes.