Documentacao do Projeto Ponto Tangerino
Sistema automatizado de registro de ponto via Telegram + Dashboard Web
Resumo: Bot Telegram que registra entrada, intervalo, volta, saida e hora extra.
Armazena em PostgreSQL e exibe em dashboard web. Roda em Docker na VPS Contabo.
Arquitetura
Telegram (voce)
| /entrada, /saida, /status
v
ponto-bot (Python / Telegram Bot)
|
| conexao via Docker
v
ponto-db (PostgreSQL 15)
|
| consultas SQL
v
ponto-web (Flask Dashboard) -> https://ponto.algiz-phi.us
3 containers Docker rodando na VPS (194.163.166.14).
Comandos do Bot
| Comando | Funcao |
|---|
| /start | Mensagem de boas-vindas |
| /ponto | Menu de tipos de registro |
| /entrada | Registrar entrada (08:00) |
| /intervalo | Saida pro intervalo |
| /volta | Volta do intervalo |
| /saida | Registrar saida (17:00) |
| /extra | Hora extra |
| /status | Registros de hoje |
| /semana | Resumo dos ultimos 7 dias |
| /dashboard | Link do painel web |
Fluxo Diario
08:00 /entrada (chegada)
10:40 /intervalo (pausa)
11:40 /volta (volta da pausa)
17:00 /saida (fim do expediente)
16:40 /extra (se fizer hora extra)
Banco de Dados
| Coluna | Tipo | Descricao |
|---|
| id | SERIAL | ID automatico |
| tipo | VARCHAR(20) | entrada, saida, etc |
| data_hora | TIMESTAMPTZ | Data/hora do registro |
| foto_path | VARCHAR(500) | Caminho da foto |
| localizacao | VARCHAR(200) | Local do registro |
| sucesso | BOOLEAN | TRUE se registrado com sucesso |
Estrutura de Arquivos
/home/admin/ponto-tangerino/
docker-compose.yml - Orquestra os 3 containers
bot/Dockerfile - Build do bot
bot/bot.py - Codigo do bot Telegram
web/Dockerfile - Build do dashboard
web/app.py - Codigo Flask
web/templates/index.html - HTML do dashboard
db/init.sql - Cria tabela no PostgreSQL
Acessos
Comandos Uteis (SSH)
# Ver status
docker compose -f /home/admin/ponto-tangerino/docker-compose.yml ps
# Logs do bot
docker compose -f /home/admin/ponto-tangerino/docker-compose.yml logs -f ponto-bot
# Logs do web
docker compose -f /home/admin/ponto-tangerino/docker-compose.yml logs -f ponto-web
# Reiniciar o bot
docker compose -f /home/admin/ponto-tangerino/docker-compose.yml restart ponto-bot
# Parar tudo
docker compose -f /home/admin/ponto-tangerino/docker-compose.yml down
# Subir tudo
docker compose -f /home/admin/ponto-tangerino/docker-compose.yml up -d
Credenciais
| Item | Valor |
|---|
| Bot Token | 8774462162:AAE3d2hY2KqpXsGMPPpyDIHUM0bLLwNVMQY |
| DB Host | ponto-db |
| DB User | ponto |
| DB Pass | ponto_seguro_2026 |
Documentacao por Hanna - 28/05/2026