🤗 HugMe - Gerenciador de Apoios via PIX e Cartão para Discord (Em Desenvolvimento)

HugMe é um projeto em desenvolvimento que visa integrar o sistema de doações mensais via PIX e Cartão de crédito/débito a um servidor Discord da comunidade autista. Através de um bot, o sistema atribui automaticamente cargos especiais no Discord aos apoiadores com base em seu status de contribuição :D.

📌 Descrição

O HugMe é uma aplicação backend escrita em Python, que oferece:

• Integração com comprovantes de doação via PIX e cartão de crédito para gerenciamento de apoios
• Persistência das informações de apoiadores e doações em um banco PostgreSQL
• Automatização da atribuição de cargos no Discord com base no tempo e nível de apoio
• Painel web administrativo (futuramente) para gerenciamento e visualização dos dados
• Suporte a pagamentos únicos e assinaturas recorrentes

🚧 Status do Projeto

Este projeto está em Desenvolvimento Ativo

PIX via Pagbank: Integração [██████████] 100%

Cartão de Crédito: Integração [██████████] 100%

Funcionalidades prontas antigas:

Funcionalidades Gerais em andamento:

• Implementar agendamentos para:
  • Verificação de expiração
  • Atualização de cargos automaticamente

🎮 Sistema de RPG por Texto

Funcionalidades Concluídas:

• Sistema de Personagens: Criação com 6 atributos (1-20) via /rpg_personagem
• Múltiplos Personagens: Até 3 personagens por usuário com gerenciamento completo
• Histórico Persistente: Sessões salvas em banco MariaDB com SQLAlchemy async
• Comandos Híbridos: /rpg, /rpg_personagem, /rpg_status, etc (slash e prefixo)
• Integração DeepSeek: API para geração de aventuras com contexto histórico
• Sistema de Tutorial: Guia interativo para novos jogadores
• Status Embed: Visualização elegante do progresso da aventura
• Gestão de Sessões: Histórico mantém últimas 8 interações por desempenho
• Sistema de Resumo: Resumos automáticos para histórias longas
• Suporte a DMs: Jogável tanto em canal designado quanto por mensagem privada
• Comandos de Gerenciamento:
  • /rpg_personagens - Lista todos os personagens
  • /rpg_usar_personagem [ID] - Seleciona personagem ativo
  • /rpg_deletar_personagem [ID] - Remove personagem
  • /rpg_ajuda - Tutorial manual

Funcionalidades em Andamento:

🦗🦗🦗🦗 nao tem nada mais por enquanto...

Tecnologias Utilizadas:

• Database: MariaDB com SQLAlchemy ORM async
• API: DeepSeek Chat para geração de conteúdo
• Framework: discord.py com comandos híbridos
• Armazenamento: JSON em campos SQL para flexibilidade

Arquitetura:

• Modelos: RPGSession (sessões), RPGCharacter (personagens)
• Engine Async: Operações não-bloqueantes para melhor performance
• Cache Inteligente: Histórico mantido em memória com persistência automática
• Tratamento de Erros: Sistema robusto com fallbacks amigáveis

Exemplo de Uso:

1. /rpg_personagem João Mago Humano 3 5 4 10 10 5
2. /rpg iniciar - Começa uma aventura épica
3. /rpg Atacar o dragão com magia - Interage com o mundo
4. /rpg_status - Verifica progresso e atributos

🧭 Próximos Passos

• Adicionar painel com histórico e logs
• Documentar API para integrações externas

🏁 Etapa Final

• Testes completos no ambiente real
• Migrar o bot para ambiente de produção

🛠 Tecnologias Utilizadas

• Python 3.12+
• discord.py
• SQLAlchemy ORM
• PostgreSQL
• FastAPI
• httpx
• asyncio
• BlazeHosting (hospedagem do bot e painel, bem recomendado)

📬 Contato

📧 hugmebotdev@gmail.com

---

Projeto pessoal desenvolvido com fins de aprendizado e apoio à comunidade autista. 💙

---

🧱 Arquitetura do Projeto