🛡️ LostGuard

Moderação de conteúdo inteligente, local e transparente para comunidades no Discord.

---

🧠 O que ele faz

LostGuard é um bot de moderação de conteúdo que combina classificação de texto por IA 100% local (sem enviar suas mensagens para APIs de terceiros) com análise de imagem opcional via provedores externos, sob controle total do administrador do servidor.

Diferente de bots que dependem de APIs externas para tudo, o núcleo de decisão roda dentro do próprio processo do bot, usando um modelo ONNX (DistilBERT multilingual) treinado para classificar mensagens em categorias de risco — sem latência de rede, sem envio de dados para nuvem, sem custo por chamada.

---

⚙️ Como funciona

1. Ingestão — toda mensagem enviada (e editada) é analisada em tempo real.
2. Classificação — um modelo de linguagem local avalia o texto em múltiplas categorias de severidade.
3. Decisão por regras — cada servidor define seus próprios limiares: o que é deletado automaticamente, o que vai para timeout preventivo, o que só é logado, e o que exige revisão humana.
4. Modo Shadow — teste as regras sem aplicar ações reais, apenas observando o que seria feito.
5. Auditoria — toda decisão gera um registro de metadados (não de conteúdo bruto) para rastreabilidade.

> 🖼️ Análise de imagem é opt-in por servidor. Quando ativada, imagens são processadas por um provedor externo configurável, com orçamento de chamadas por hora para controlar custo e exposição de dados.

---

🎛️ Painel de administração

O comando /painel abre um painel interativo (embed + botões) onde administradores configuram:

• 🔀 Modo de operação: shadow (observação) ou active (ação real)
• 👁️ Análise de imagem: ligado/desligado
• 🎚️ Severidade máxima por categoria
• 📋 Canais dedicados de log e de revisão
• 📊 Estatísticas de moderação do servidor
• 🎓 Status de treino do modelo
• ↩️ Undo de ações recentes (janela configurável, padrão 72h)
• 🗑️ Purge administrativo de dados

---

🔒 Privacidade em primeiro lugar

Construído desde o início pensando em conformidade com LGPD e GDPR:

| Comando | Descrição | Visibilidade |
|---|---|---|
| /privacy policy | Exibe a política de privacidade completa | Ephemeral |
| /privacy export | Exporta somente os seus dados — nunca de terceiros | Ephemeral |
| /privacy purge | Remove definitivamente seus dados (com confirmação) | Ephemeral |
| /privacy optout | Sai do uso de mensagens para retreinamento do modelo | Ephemeral |
| /dataset purge <user_id> | Remoção administrativa de dados de um usuário | Restrito a admins |

Como protegemos seus dados:

• 🔐 IDs de usuário e servidor são armazenados como hash HMAC-SHA256 com salt secreto — nunca em texto plano.


• ⏱️ Texto bruto é retido apenas por uma janela curta configurável (padrão 72h) para permitir reversão de ações.


• 🗄️ Dados anonimizados seguem a política de retenção definida por cada servidor.


• 🚫 Nada é vendido. Nada é compartilhado com terceiros além do estritamente necessário para análise de imagem opt-in.


• ♻️ Exclusões são propagadas para backups em até 30 dias.

---

🏗️ Arquitetura técnica

• Linguagem: Go
• Gateway: Discord Gateway API (WebSocket) com wrapper interno testável
• Classificação de texto: modelo ONNX (DistilBERT multilingual, 9 categorias)
• Persistência: SQLite (configurações multi-servidor) + JSONL (dataset anonimizado)
• Métricas: exportação Prometheus para observabilidade
• Treinamento: pipeline de re-treino com critérios de qualidade (F1-macro, taxa de falso-positivo) antes de qualquer deploy de novo modelo, com rollback automático

---

✅ Por que confiar

• Sem caixa-preta: decisões seguem regras configuráveis pelo próprio servidor, não um algoritmo opaco de terceiros.
• Sem dependência externa para o essencial: a moderação de texto funciona mesmo sem internet para provedores de IA de terceiros.
• Auditável: toda