COMANDOS_COMPLETOS.md

# 🤖 AKIRA BOT V21.02.2025 - GUIA COMPLETO DE COMANDOS

## 📋 Índice
1. [Comandos Públicos](#comandos-públicos)
2. [Comandos de Perfil](#comandos-de-perfil)
3. [Comandos de Moderação](#comandos-de-moderação)
4. [Comandos de Mídia](#comandos-de-mídia)
5. [Sistema de Permissões](#sistema-de-permissões)
6. [Sistema de Rate Limiting](#sistema-de-rate-limiting)
7. [Logging e Segurança](#logging-e-segurança)

---

## Comandos Públicos

### #help | #menu | #comandos | #ajuda
**Descrição:** Mostra menu completo com todos os comandos disponíveis
**Uso:** `#help`
**Permissão:** Pública (Todos)
**Exemplos:**
```
#help
#menu
#comandos
```

### #ping
**Descrição:** Testa latência e status do bot
**Uso:** `#ping`
**Permissão:** Pública (Todos)
**Retorna:**
- Latência em ms
- Uptime do bot
- Status da conexão
- URL da API

### #info | #botinfo | #about
**Descrição:** Informações completas do bot
**Uso:** `#info`
**Permissão:** Pública (Todos)
**Mostra:**
- Nome e versão
- Desenvolvedor e localização
- Recursos implementados
- Serviços de áudio
- Informações de segurança
- Comandos rápidos

### #donate | #doar | #apoiar | #doacao
**Descrição:** Formas de apoiar o projeto
**Uso:** `#donate`
**Permissão:** Pública (Todos)
**Mostra:**
- Benefícios de apoiar
- Formas de pagamento (PIX, Ko-fi, PayPal)
- Valores sugeridos
- Benefícios do apoiador
- Impacto de cada doação

---

## Comandos de Perfil

### #perfil | #profile | #myperfil
**Descrição:** Visualiza seu perfil pessoal e estatísticas
**Uso:** `#perfil`
**Permissão:** Pública (Todos)
**Mostra:**
- Informações pessoais (nome, idade)
- Nível e XP atual
- Progresso para próximo nível
- Conquistas desbloqueadas
- Dicas para subir de nível

**Exemplo de Saída:**
```
👤 SEU PERFIL

📝 INFORMAÇÕES PESSOAIS
Nome: Isaac Quarenta
Idade: 25 anos
Registrado em: 24/01/2026

🎮 ESTATÍSTICAS DE JOGO
Nível: 15
Experiência (XP): 4.250
Próximo nível: 5.000
Progresso: ██████░░░░ 85%

🏆 CONQUISTAS
✅ Bronze - Nível 5
✅ Prata - Nível 10
⬜ Ouro - Nível 25
⬜ Platina - Nível 50
⬜ Diamante - Nível 100
```

### #registrar Nome|Idade
**Descrição:** Registra novo usuário no sistema
**Uso:** `#registrar Isaac Quarenta|25`
**Permissão:** Pública (Todos)
**Validações:**
- Nome obrigatório
- Idade entre 1-120 anos
- Formato: Nome|Idade
- Não pode registrar duas vezes

**Exemplo:**
```
#registrar João Silva|30
```

**Retorna:**
- ID serial único
- Data de registro
- Nível inicial (1)
- XP inicial (0)

### #level | #nivel | #rank
**Descrição:** Ver nível e progresso no grupo / Gerenciar sistema de leveling (Dono)
**Uso:** 
- Ver nivel: `#level`
- Ativar: `#level on`
- Desativar: `#level off`
- Status: `#level status`

**Permissão:** 
- Ver nível: Pública
- Gerenciar: Apenas Dono

**Mostra:**
- Nível atual no grupo
- XP acumulado
- Progresso até próximo nível
- Barra visual de progresso

---

## Comandos de Moderação

### #add <número>
**Descrição:** Adiciona membro ao grupo
**Uso:** `#add 244937035662`
**Permissão:** Apenas Dono
**Requer:** Bot deve ser admin
**Log:** Registra ação no arquivo de admin_actions.log

**Exemplo:**
```
#add 244937035662
```

**Resposta:**
```
✅ 244937035662 foi adicionado ao grupo com sucesso!
```

### #remove | #kick | #ban @usuário
**Descrição:** Remove/bane membro do grupo
**Uso:** 
- Com @mention: `#remove @João`
- Com reply: Responda mensagem + `#remove`

**Permissão:** Apenas Dono
**Requer:** Bot deve ser admin
**Log:** Registra ação e quantidade de removidos

**Exemplos:**
```
#remove @João
#ban @Maria
#kick @Pedro
```

### #promote @usuário
**Descrição:** Promove membro a admin
**Uso:** 
- Com @mention: `#promote @João`
- Com reply: Responda mensagem + `#promote`

**Permissão:** Apenas Dono
**Requer:** Bot deve ser admin
**Log:** Registra promoção

### #demote @usuário
**Descrição:** Remove admin do grupo
**Uso:** 
- Com @mention: `#demote @João`
- Com reply: Responda mensagem + `#demote`

**Permissão:** Apenas Dono
**Requer:** Bot deve ser admin
**Log:** Registra rebaixamento

### #mute @usuário
**Descrição:** Silencia usuário por tempo progressivo
**Uso:** 
- Com @mention: `#mute @João`
- Com reply: Responda mensagem + `#mute`

**Permissão:** Apenas Dono
**Duração:** 5 minutos (progressivo se reincidente)
**Progressão:**
- 1ª vez: 5 minutos
- 2ª vez: 10 minutos
- 3ª vez: 20 minutos
- 4ª vez: 40 minutos
- etc (exponencial)

**Comportamento:**
- Usuário não consegue enviar mensagens
- Se tenta enviar: mensagem é deletada
- Se persiste: é removido do grupo automaticamente

**Log:** Registra cada mute com duração e contagem

### #desmute @usuário
**Descrição:** Remove silenciamento do usuário
**Uso:** 
- Com @mention: `#desmute @João`
- Com reply: Responda mensagem + `#desmute`

**Permissão:** Apenas Dono
**Log:** Registra remoção de silenciamento

### #antilink on | off | status
**Descrição:** Ativa/desativa remoção automática de links
**Uso:** 
- Ativar: `#antilink on`
- Desativar: `#antilink off`
- Ver status: `#antilink status`

**Permissão:** Apenas Dono
**Comportamento:**
- Detecta URLs (https://, www., bit.ly, t.me, wa.me, etc)
- Deleta mensagem com link automaticamente
- Remove usuário do grupo

**Padrões detectados:**
- `https://` | `http://`
- `www.`
- `bit.ly/`
- `t.me/`
- `wa.me/`
- `chat.whatsapp.com/`

**Log:** Registra cada ação de anti-link

---

## Comandos de Mídia

### #sticker | #s | #fig
**Descrição:** Cria sticker de imagem
**Uso:** 
- Enviar imagem com comando: `#sticker`
- Reply em imagem: Responda + `#sticker`

**Permissão:** Pública (Todos)
**Aceita:**
- PNG, JPG, JPEG
- Stickers (copia)

**Personalização:**
- Nome automático: [Nome do Usuário]'s Pack
- Autor: Nome do usuário

### #gif
**Descrição:** Cria sticker animado de vídeo
**Uso:** 
- Enviar vídeo com comando: `#gif`
- Reply em vídeo: Responda + `#gif`

**Permissão:** Pública (Todos)
**Limitações:**
- Máximo 30 segundos
- Máximo 500KB
- Formato: MP4, AVI, MOV

**Exemplo:**
```
[Enviar vídeo de 10s] #gif
→ Sticker animado criado
```

### #toimg | #img | #unstick
**Descrição:** Converte sticker para imagem PNG
**Uso:** Responda sticker + `#toimg`

**Permissão:** Pública (Todos)
**Retorna:** Imagem PNG

### #play <nome ou link>
**Descrição:** Baixa áudio do YouTube
**Uso:** 
- Por nome: `#play Imagine John Lennon`
- Por link: `#play https://youtu.be/...`

**Permissão:** Pública (Todos)
**Limitações:**
- Máximo 25MB
- Recomendado: até 10 minutos

**Métodos:**
- API externa confiável (primeiro)
- ytdl-core (fallback)

**Retorna:** Arquivo MP3

### #tts <idioma> <texto>
**Descrição:** Converte texto para áudio (Text-to-Speech)
**Uso:** `#tts pt Olá, como você está?`

**Permissão:** Pública (Todos)
**Limitações:**
- Máximo 200 caracteres
- Idiomas suportados: pt, en, es, fr, de, it, ja, ko, zh, ar, ru, hi, pt-BR, pt-PT, en-US, en-GB

**Idiomas:**
- `pt` = Português
- `en` = English
- `es` = Español
- `fr` = Français
- `de` = Deutsch
- `ja` = 日本語
- `ko` = 한국어
- `zh` = 中文

**Exemplo:**
```
#tts pt Olá mundo!
#tts en Hello world!
#tts es ¡Hola mundo!
```

---

## Sistema de Permissões

### Níveis de Acesso

#### 🔓 Pública (Todos)
- `#help`, `#menu`, `#ping`, `#info`, `#donate`
- `#perfil`, `#registrar`, `#level`
- `#sticker`, `#gif`, `#toimg`, `#play`, `#tts`
- Áudio inteligente (STT/TTS automático)

#### 🔐 Apenas Dono (Isaac Quarenta)
- `#add` - Adicionar membros
- `#remove`, `#kick`, `#ban` - Remover membros
- `#promote`, `#demote` - Gerenciar admins
- `#mute`, `#desmute` - Silenciar usuários
- `#antilink on/off` - Controlar anti-link
- `#level on/off` - Gerenciar leveling

#### ⏳ Premium Features (1x a cada 90 dias para usuários)
- Ferramentas de segurança avançadas
- Acesso a recursos experimental
- Resgates especiais

**Owners têm:** Acesso ilimitado a tudo

---

## Sistema de Rate Limiting

### Proteção contra Spam

#### Rate Limit Global
- **Window:** 8 segundos
- **Máximo:** 6 comandos por janela
- **Aplicado a:** Todos os usuários
- **Mensagem:** "⏰ Você está usando comandos muito rápido"

### Premium Feature Cooldown
- **Intervalo:** 90 dias (3 meses)
- **Aplicado a:** Usuários comuns
- **Owners:** Sem limite
- **Redireciona para:** #donate

---

## Logging e Segurança

### Arquivo de Log Administrativo
**Localização:** `logs/admin_actions.log`

**Formato:**
```
[TIMESTAMP] ACTION | User: NOME (NUMERO) | Target: ALVO | Details: DETALHES
```

**Exemplo:**
```
[2026-01-24T16:30:45.123Z] MUTE_USER | User: Isaac Quarenta (244937035662) | Target: 244978787009@s.whatsapp.net | Details: 5 minutos
[2026-01-24T16:32:10.456Z] REMOVE_MEMBERS | User: Isaac Quarenta (244937035662) | Target: 2 membros | Details: grupo: 120362032@g.us
[2026-01-24T16:35:22.789Z] ANTILINK_ON | User: Isaac Quarenta (244937035662) | Target: 120362032@g.us | Details: Anti-link ativado
```

### Ações Registradas
- `ADD_MEMBER` - Membro adicionado
- `REMOVE_MEMBERS` - Membros removidos
- `PROMOTE_MEMBERS` - Membros promovidos
- `DEMOTE_MEMBERS` - Membros rebaixados
- `MUTE_USER` - Usuário mutado
- `UNMUTE_USER` - Mutação removida
- `WARN_USER` - Aviso registrado
- `LEVEL_ON` - Sistema de níveis ativado
- `LEVEL_OFF` - Sistema de níveis desativado
- `ANTILINK_ON` - Anti-link ativado
- `ANTILINK_OFF` - Anti-link desativado

### Proteção contra Abuso

#### Detecção de Links
Padrões detectados:
- Qualquer URL (http/https)
- URLs encurtadas (bit.ly)
- Telegram (t.me)
- WhatsApp (wa.me, chat.whatsapp.com)
- Customizável via regex

#### Comportamento ao Violar
1. Mensagem com link é **deletada automaticamente**
2. Usuário é **removido do grupo**
3. Ação é **registrada em log**
4. Aviso é enviado no grupo

---

## Funcionalidades Especiais

### Áudio Inteligente (STT/TTS)
- **STT:** Deepgram nova-2 (transcrição)
- **TTS:** Google Text-to-Speech (síntese)
- **Ativação em Grupos:** Mencione "Akira" ou responda áudio
- **Em PV:** Sempre ativo
- **Transcrição:** Interna (nunca mostrada)

### Sistema de Níveis
- **XP Automático:** Ao conversar naturalmente
- **Progressão:** Exponencial (1000, 2000, 4000...)
- **Por Grupo:** Níveis diferentes em cada grupo
- **Conquistas:** Bronze (5), Prata (10), Ouro (25), Platina (50), Diamante (100)

### Sistema de Registro
- **Armazenamento:** `database/datauser/registered.json`
- **ID Serial:** Único por usuário
- **Data:** Automática
- **Vinculação:** JID do WhatsApp

---

## Dicas de Uso

### Para Maximizar XP
1. Converse naturalmente com o bot
2. Responda áudios do bot
3. Envie áudios para bot transcrever
4. Participe ativamente do grupo

### Para Usar Comandos de Moderação
1. Certifique-se que o bot é admin
2. Use @mentions ou reply
3. Verifique as permissões
4. Consulte o log de ações

### Para Criar Stickers Criativos
1. Use imagens em alta qualidade
2. Fundo transparente (PNG) é ideal
3. Tamanho: 512x512 ou similar
4. Vídeos até 30s funcionam melhor

---

## Suporte e Contato

**Desenvolvedor:** Isaac Quarenta
**WhatsApp:** +244 937 035 662
**Email:** isaac.quarenta@akira.bot
**Localização:** 🇦🇴 Luanda, Angola

**Versão:** v21.02.2025
**Status:** Enterprise Grade
**Uptime:** 24/7
**SLA:** 99.9%

---

## Changelog

### v21.02.2025 (Current)
- ✅ CommandHandler completo reescrito
- ✅ Menus profissionais em ASCII art
- ✅ Sistema de permissões robusto
- ✅ Rate limiting avançado
- ✅ Logging de ações administrativas
- ✅ Premium features com cooldown
- ✅ 15+ comandos funcionais

### v21.01.2025
- ✅ Contexto de reply otimizado
- ✅ Mensagem citada enviada completa
- ✅ Correção API_URL

---

## Licença e Termos

Este bot é fornecido como está. O uso implica aceitação dos termos de serviço.
Todas as ações administrativas são registradas para fins de segurança e auditoria.

**Desenvolvido com ❤️ por Isaac Quarenta**