Skip to content

Bot de votação integrado à API do Telegram. Simula uma Urna Eletrônica permitindo computar votos remotamente, gerenciar candidatos e gerar relatórios de apuração em tempo real.

Notifications You must be signed in to change notification settings

brunnodev50/bot-urna-eletronica-python-telegram

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Repository files navigation

🗳️ Bot Urna Eletrônica (Telegram)


🇧🇷 Sobre

Bot de Telegram que simula uma Urna Eletrônica. O sistema permite computar votos remotamente através da API do Telegram, gerenciar candidatos e gerar relatórios de apuração em tempo real.

✨ Funcionalidades

  • Painel Administrativo: Protegido por senha para gestão da eleição.
  • Validação de Eleitor: Exige Nome e CPF (voto único por CPF).
  • Estados da Eleição: Comandos para Abrir, Encerrar e Reabrir a votação.
  • Relatórios em Tempo Real: Visualização instantânea da apuração.

🚀 Instalação e Configuração

  1. Criar o Bot: Fale com o @BotFather no Telegram para criar um bot e obter seu Token.
  2. Configurar: Adicione o token na variável correspondente dentro do código.
  3. Instalar Dependências:
    pip install -r requirements.txt
  4. Rodar:
    python main.py

🛠️ Comandos de Administrador

Senha Padrão: 1234

Comando Descrição
/inserir_presidente Adiciona um novo candidato à eleição.
/lista_presidentes Lista todos os candidatos cadastrados.
/deletar_presidente Remove um candidato (Ação irreversível).
/encerrar Encerra a eleição e libera os resultados para todos.
/reabrir Reabre a eleição para novos votos.
/zerar_banco Reset Total: Apaga todos os dados do banco de dados.

📸 Telas do Administrador

Clique para ver as Telas de Admin

Adicionar Candidato & Listar:

Deletar & Reabrir:


👤 Fluxo do Usuário (Eleitor)

  1. O usuário inicia com /start.
  2. O bot solicita Nome e CPF.
  3. O sistema verifica se o CPF já votou (impede votos duplicados).
  4. O usuário escolhe o candidato e confirma.

📸 Telas do Eleitor

Clique para ver a Votação e Resultados

Processo de Votação:

Resultados da Apuração (Após Encerrar):

About

Bot de votação integrado à API do Telegram. Simula uma Urna Eletrônica permitindo computar votos remotamente, gerenciar candidatos e gerar relatórios de apuração em tempo real.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages