@poolzin/pool-bot 2026.3.21 → 2026.3.23

package/docs/components/login-gate.md

@@ -0,0 +1,219 @@
+# Login Gate
+
+O Login Gate é o componente de autenticação do Pool Bot Dashboard, responsável por gerenciar a conexão segura com o gateway.
+
+## Features
+
+- 🔐 **Autenticação Segura** - Token-based auth
+- 👁️ **Toggle Visibilidade** - Mostrar/ocultar tokens
+- ✅ **Validação** - Validação em tempo real
+- 📝 **Instruções** - Guia de conexão embutido
+- 🔗 **Links de Ajuda** - Documentação integrada
+
+## Componentes
+
+### Campos de Entrada
+
+1. **Gateway URL**
+   - URL do gateway (ex: `ws://127.0.0.1:18789`)
+   - Auto-complete de URLs salvas
+   - Validação de formato
+
+2. **Token**
+   - Token de autenticação do gateway
+   - Toggle de visibilidade (eye/eye-off)
+   - Armazenamento seguro (opcional)
+
+3. **Password** (Opcional)
+   - Senha adicional se configurada
+   - Toggle de visibilidade
+   - Não obrigatório por padrão
+
+### Estados
+
+#### Desconectado
+```
+┌─────────────────────────────┐
+│  Pool Bot                   │
+│  Connect to Gateway         │
+│                             │
+│  Gateway URL    [input]    │
+│  Token          [input]    │
+│  Password       [input]    │
+│                             │
+│  [Connect]                  │
+│                             │
+│  Quick Start:               │
+│  1. poolbot gateway run     │
+│  2. poolbot dashboard       │
+│  3. Copy tokenized URL      │
+└─────────────────────────────┘
+```
+
+#### Conectado
+```
+┌─────────────────────────────┐
+│  ✓ Connected                │
+│                             │
+│  Gateway authentication     │
+│  successful                 │
+└─────────────────────────────┘
+```
+
+#### Erro
+```
+┌─────────────────────────────┐
+│  ✗ Connection Error         │
+│                             │
+│  Auth failed. Re-copy a     │
+│  tokenized URL...           │
+│                             │
+│  [Docs: Control UI auth]    │
+└─────────────────────────────┘
+```
+
+## Uso
+
+### Componente Lit
+
+```typescript
+import { LoginGate } from './components/login-gate'
+
+// Criar elemento
+const gate = document.createElement('login-gate')
+
+// Props
+gate.connected = false
+gate.error = null
+gate.loading = false
+
+// Eventos
+gate.addEventListener('login', (e) => {
+  const { token, password } = e.detail
+  // Conectar ao gateway
+})
+```
+
+### Props
+
+```typescript
+type LoginGateProps = {
+  connected: boolean           // Estado de conexão
+  error: string | null         // Mensagem de erro
+  token: string                // Token atual
+  password: string             // Password atual
+  showToken: boolean           // Mostrar token?
+  showPassword: boolean        // Mostrar password?
+  loading: boolean             // Loading state?
+}
+```
+
+### Eventos
+
+```typescript
+// Evento de login
+gate.addEventListener('login', (e: CustomEvent) => {
+  const { token, password } = e.detail
+  // Tentar conectar
+})
+```
+
+## Fluxo de Autenticação
+
+```
+1. Usuário abre dashboard
+         ↓
+2. Login Gate renderiza
+         ↓
+3. Usuário insere credenciais
+         ↓
+4. Clica em "Connect"
+         ↓
+5. Validação local
+         ↓
+6. Conexão com gateway
+         ↓
+7. Sucesso → Dashboard
+   Falha → Mostra erro
+```
+
+## Segurança
+
+### Best Practices
+
+1. **Tokens**
+   - Nunca log tokens em console
+   - Usar secure context (HTTPS)
+   - Expirar tokens periodicamente
+
+2. **Passwords**
+   - Hash antes de enviar
+   - Usar HTTPS sempre
+   - Rate limiting
+
+3. **Armazenamento**
+   - Usar sessionStorage
+   - Limpar on logout
+   - Não persistir em produção
+
+### Configuração de Segurança
+
+```typescript
+// Forçar HTTPS
+poolbot config set gateway.requireHttps true
+
+// Expirar tokens
+poolbot config set gateway.tokenExpiry 3600
+
+// Rate limiting
+poolbot config set gateway.rateLimit 10
+```
+
+## Customização
+
+### Estilização
+
+```css
+login-gate {
+  --bg-primary: #ffffff;
+  --text-muted: #666666;
+  --success: #4caf50;
+  --error: #f44336;
+}
+```
+
+### Mensagens Customizadas
+
+```typescript
+// i18n
+const customMessages = {
+  'login.connected': 'Conectado com sucesso!',
+  'login.subtitle': 'Entre com suas credenciais',
+  'common.connecting': 'Conectando...',
+}
+```
+
+## Testes
+
+```bash
+# Testar componente
+pnpm test -- login-gate
+
+# Testes incluem:
+# - Renderização
+# - Validação de campos
+# - Estados de erro
+# - Toggle de visibilidade
+```
+
+## Arquivos Relacionados
+
+- `ui/src/ui/components/login-gate.ts` - Componente principal
+- `ui/src/ui/icons.ts` - Ícones (eye, eyeOff)
+- `src/gateway/auth.ts` - Autenticação do gateway
+
+## Links Relacionados
+
+- [Autenticação](/security/authentication)
+- [Gateway](/architecture/gateway)
+- [Segurança](/security/overview)

package/docs/getting-started/installation.md

@@ -0,0 +1,191 @@
+# Instalação do Pool Bot
+
+## Pré-requisitos
+
+- **Node.js** 22+ ou **Bun** 1.0+
+- **pnpm** 8+ (recomendado) ou npm
+- **Git** para clonar o repositório
+
+## Métodos de Instalação
+
+### 1. Via NPM (Recomendado)
+
+```bash
+# Instalação global
+npm install -g @poolzin/pool-bot
+
+# Ou com pnpm
+pnpm add -g @poolzin/pool-bot
+
+# Verificar instalação
+poolbot --version
+```
+
+### 2. Via Docker
+
+```bash
+# Pull da imagem
+docker pull poolbot/pool-bot:latest
+
+# Rodar container
+docker run -d \
+  --name poolbot \
+  -v poolbot-data:/root/.poolbot \
+  -p 18789:18789 \
+  poolbot/pool-bot:latest
+```
+
+### 3. Do Source
+
+```bash
+# Clonar repositório
+git clone https://github.com/poolbot/poolbot.git
+cd poolbot
+
+# Instalar dependências
+pnpm install
+
+# Build
+pnpm build
+
+# Link global (opcional)
+pnpm link --global
+```
+
+## Primeiros Passos
+
+### 1. Inicializar Configuração
+
+```bash
+# Criar diretório de configuração
+poolbot config init
+
+# Ou criar manualmente
+mkdir -p ~/.poolbot
+```
+
+### 2. Configurar Gateway
+
+```bash
+# Configuração básica
+poolbot config set gateway.mode local
+poolbot config set gateway.port 18789
+poolbot config set gateway.bind loopback
+```
+
+### 3. Iniciar Gateway
+
+```bash
+# Iniciar gateway
+poolbot gateway run
+
+# Ou em modo development
+poolbot gateway run --dev
+```
+
+### 4. Acessar Dashboard
+
+```bash
+# Abrir dashboard no browser
+poolbot dashboard
+
+# Ou URL direta
+# http://127.0.0.1:18789
+```
+
+## Configuração de Canais
+
+### Telegram
+
+```bash
+# Obter token do @BotFather
+poolbot config set channels.telegram.token YOUR_BOT_TOKEN
+
+# Habilitar canal
+poolbot config set channels.telegram.enabled true
+```
+
+### Discord
+
+```bash
+# Obter token do Discord Developer Portal
+poolbot config set channels.discord.token YOUR_BOT_TOKEN
+
+# Habilitar canal
+poolbot config set channels.discord.enabled true
+```
+
+### Slack
+
+```bash
+# Obter bot token do Slack App
+poolbot config set channels.slack.token xoxb-YOUR-TOKEN
+
+# Habilitar canal
+poolbot config set channels.slack.enabled true
+```
+
+### WhatsApp
+
+```bash
+# Escanear QR Code
+poolbot whatsapp scan
+
+# Ou configurar sessão
+poolbot config set channels.whatsapp.session YOUR_SESSION_ID
+```
+
+## Verificação
+
+```bash
+# Verificar status do gateway
+poolbot gateway status
+
+# Verificar canais
+poolbot channels status
+
+# Verificar configuração
+poolbot config list
+```
+
+## Troubleshooting
+
+### Gateway não inicia
+
+```bash
+# Verificar logs
+poolbot gateway logs
+
+# Verificar porta
+lsof -i :18789
+
+# Resetar configuração
+poolbot config reset
+```
+
+### Canais não conectam
+
+```bash
+# Verificar tokens
+poolbot channels test telegram
+
+# Re-autenticar
+poolbot login <channel>
+```
+
+### Problemas de permissão
+
+```bash
+# Linux/Mac
+chmod +x $(which poolbot)
+
+# Windows (Admin)
+# Reinstalar como administrador
+```
+
+## Próximos Passos
+
+- [Configuração](/getting-started/configuration)
+- [Quick Start](/getting-started/quick-start)
+- [Canais](/channels/overview)
+- [Dashboard](/components/dashboard)

package/docs/getting-started/introduction.md

@@ -0,0 +1,120 @@
+# Introdução ao Pool Bot
+
+## O que é Pool Bot?
+
+Pool Bot é uma plataforma de automação e integração de mensagens multi-canal com suporte a agentes de IA. Ele permite que você conecte seus canais de comunicação favoritos (Telegram, Discord, Slack, WhatsApp, etc.) e automatize respostas, gerencie sessões e integre com modelos de linguagem.
+
+## Principais Features
+
+### 🎯 Multi-Canal
+Conecte e gerencie múltiplos canais de comunicação em um único lugar:
+- **Telegram** - Bots do Telegram
+- **Discord** - Servidores Discord
+- **Slack** - Workspaces Slack
+- **WhatsApp** - WhatsApp Web
+- **Signal** - Signal Bot
+- **iMessage** - iMessage (macOS)
+- **Google Chat** - Google Workspace
+- **IRC** - Servidores IRC
+- **Nostr** - Protocolo Nostr descentralizado
+
+### 🤖 Agentes de IA
+Integração com modelos de linguagem para automação inteligente:
+- Suporte a múltiplos provedores (Claude, GPT, etc.)
+- Gerenciamento de sessões por usuário
+- Memória contextual
+- Customização de prompts
+
+### 🎛️ Dashboard Web
+Interface web moderna para gerenciamento:
+- Command Palette (Cmd+K)
+- Visão geral em tempo real
+- Gerenciamento de sessões
+- Configuração de canais
+- Monitoramento de custos
+
+### ⏰ Cron & Agendamento
+Automatize tarefas recorrentes:
+- Jobs agendados por canal
+- Filtros avançados (usuário, sessão, agente)
+- Logs de execução
+- Retry automático
+
+### 💰 Cost Tracking
+Monitore custos de API:
+- Tracking de tokens
+- Tempo de processamento
+- Chamadas de API
+- Exportação de relatórios (CSV, JSON, Markdown)
+
+### 🔌 Sistema de Plugins
+Estenda funcionalidades:
+- Memory Core - Gerenciamento de memória
+- Keyed Async Queue - Filas concorrentes
+- Desenvolva seus próprios plugins
+
+## Casos de Uso
+
+### 1. Atendimento ao Cliente
+Automatize respostas frequentes em múltiplos canais enquanto mantém a capacidade de escalar para atendimento humano.
+
+### 2. Notificações
+Envie notificações automatizadas para seus canais preferidos baseadas em eventos do seu sistema.
+
+### 3. Automação de Comunidade
+Gerencie comunidades no Discord/Telegram com moderação automática, boas-vindas e FAQs.
+
+### 4. Assistente Pessoal
+Conecte seus canais pessoais e tenha um assistente de IA disponível em todos eles.
+
+### 5. Monitoramento
+Receba alertas e monitore sistemas através dos seus canais de comunicação.
+
+## Arquitetura
+
+```
+┌─────────────────────────────────────────────────────┐
+│                 Pool Bot Gateway                     │
+├─────────────────────────────────────────────────────┤
+│  ┌─────────┐  ┌─────────┐  ┌─────────┐             │
+│  │Telegram │  │ Discord │  │  Slack  │  ...        │
+│  └────┬────┘  └────┬────┘  └────┬────┘             │
+│       │            │            │                   │
+│       └────────────┴────────────┘                   │
+│                    │                                │
+│           ┌────────▼────────┐                       │
+│           │  Message Router │                       │
+│           └────────┬────────┘                       │
+│                    │                                │
+│       ┌────────────┴────────────┐                   │
+│       │                         │                   │
+│  ┌────▼────┐             ┌─────▼─────┐             │
+│  │ Session │             │   Agent   │             │
+│  │ Manager │             │  Manager  │             │
+│  └────┬────┘             └─────┬─────┘             │
+│       │                         │                   │
+│       └────────────┬────────────┘                   │
+│                    │                                │
+│           ┌────────▼────────┐                       │
+│           │   ACP Layer     │                       │
+│           └────────┬────────┘                       │
+│                    │                                │
+│       ┌────────────┴────────────┐                   │
+│       │                         │                   │
+│  ┌────▼────┐             ┌─────▼─────┐             │
+│  │  LLM    │             │  Memory   │             │
+│  │ Provider│             │  Store    │             │
+│  └─────────┘             └───────────┘             │
+└─────────────────────────────────────────────────────┘
+```
+
+## Começando
+
+Veja nosso guia de [Instalação](/getting-started/installation) para começar em 5 minutos!
+
+## Links Relacionados
+
+- [Instalação](/getting-started/installation)
+- [Configuração](/getting-started/configuration)
+- [Quick Start](/getting-started/quick-start)
+- [Arquitetura](/architecture/overview)