Agenor, o Mestre

Bot de WhatsApp com tema RPG medieval que transforma treinos em missoes epicas usando IA.

Agenor e um sábio guerreiro medieval que guia herois em jornadas de treino fisico dentro de um mundo de fantasia. Ele gera quests personalizadas, motiva com linguagem epica e adapta exercicios ao perfil de cada usuario — tudo via WhatsApp.

Como funciona

1. O usuario envia uma mensagem no WhatsApp
2. O bot inicia uma anamnese (perfil do heroi): idade, objetivo, local de treino, restricoes
3. O usuario escolhe uma classe RPG (Guerreiro, Mago, Ladino, Patrulheiro ou Clerigo)
4. A IA gera quests de treino personalizadas com linguagem imersiva de RPG
5. O usuario recebe XP, sobe de nivel e mantém streak de treino

Classes RPG

Stack

• Crystal + Kemal — web framework rapido e type-safe
• PostgreSQL — banco de dados
• OpenAI API — geracao de quests e interacoes com IA
• Wappfly — API de WhatsApp

Deploy

Render (recomendado)

1. Fork este repo
2. No Render, crie um New Web Service
3. Aponte para o seu fork
4. Configure as variaveis de ambiente (ver abaixo)
5. O Render detecta o Dockerfile e faz o build automatico

Local

Requisitos

• Crystal >= 1.21.0
• PostgreSQL
• Conta na OpenAI
• Conta na Wappfly

Setup

# Clone o repo
git clone https://github.com/davi19/agenor_o_mestre.git
cd agenor_o_mestre

# Copie e configure as variaveis de ambiente
cp .env.example .env

# Instale as dependencias
shards install

# Rode o servidor
crystal run src/agenor_o_mestre.cr

Docker

docker-compose up --build

Variaveis de ambiente

Endpoints

Estrutura

src/
  agenor_o_mestre.cr      # Entry point e rotas
  config/settings.cr       # Configuracoes via ENV
  data/
    connection.cr          # Conexao com PostgreSQL
    migrations/            # Migrations do banco
  game/
    classes.cr             # Classes RPG (Guerreiro, Mago, etc)
    exercises.cr           # Exercicios por classe e local
    quests.cr              # Logica de quests
    templates.cr           # Templates de mensagens
  handlers/
    anamnesis_handler.cr   # Fluxo de anamnese (perfil)
    class_handler.cr       # Escolha de classe
    intro_handler.cr       # Mensagem inicial
    provocation_handler.cr # Provocacoes motivacionais
    quest_handler.cr       # Geracao e feedback de quests
  models/
    user.cr                # Modelo de usuario
    quest.cr               # Modelo de quest
    exercise.cr            # Modelo de exercicio
    player_class.cr        # Modelo de classe
  services/
    ai_service.cr          # Integracao com OpenAI
    message_router.cr      # Roteamento de mensagens
    wappfly_client.cr      # Cliente da API Wappfly
  utils/
    phone.cr               # Utilitarios de telefone
scripts/
  migrate.cr               # Script de migration manual

Contribuindo

1. Fork o repo
2. Crie uma branch (git checkout -b minha-feature)
3. Commit suas mudancas (git commit -m 'adiciona feature')
4. Push para a branch (git push origin minha-feature)
5. Abra um Pull Request

Licenca

MIT — veja LICENSE para detalhes.