Atualizar README com documentação completa das funcionalidades

README.md

@@ -1,16 +1,77 @@
 # Agents Orchestrator
 
-Painel administrativo web para orquestração de agentes [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Crie, configure e execute múltiplos agentes com diferentes personalidades, modelos e diretórios de trabalho — tudo a partir de uma interface visual.
+Painel administrativo web para orquestração de agentes [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Crie, configure e execute múltiplos agentes com diferentes personalidades, modelos e diretórios de trabalho — tudo a partir de uma interface visual profissional.
 
 ## Funcionalidades
 
-- **Gerenciamento de agentes** — Crie agentes com nome, system prompt, modelo (Sonnet/Opus/Haiku), diretório de trabalho e tags. Ative, desative, edite ou exclua a qualquer momento.
+### Gerenciamento de Agentes
-- **Execução de tarefas** — Execute tarefas sob demanda em qualquer agente ativo. Templates rápidos incluídos (detecção de bugs, revisão OWASP, refatoração, testes, documentação, performance).
+- Crie agentes com nome, system prompt, modelo (Sonnet/Opus/Haiku), diretório de trabalho, ferramentas permitidas, modo de permissão e tags
-- **Terminal em tempo real** — Acompanhe a saída dos agentes via WebSocket com streaming chunk-a-chunk. Indicador de status de conexão e filtro por execução.
+- Ative, desative, edite, **duplique** ou exclua a qualquer momento
-- **Agendamento cron** — Agende tarefas recorrentes com expressões cron. Presets incluídos (horário, diário, semanal, mensal).
+- Exporte/importe configurações completas em JSON
-- **Pipelines** — Encadeie múltiplos agentes em fluxos sequenciais. A saída de cada passo alimenta o próximo via template `{{input}}`. Ideal para fluxos como "analisar → corrigir → testar".
+
-- **Dashboard** — Visão geral com métricas (agentes, execuções ativas, agendamentos), atividade recente e status do sistema.
+### Execução de Tarefas
-- **Exportação** — Exporte a configuração completa de qualquer agente em JSON.
+- Execute tarefas sob demanda em qualquer agente ativo
+- Templates rápidos incluídos (detecção de bugs, revisão OWASP, refatoração, testes, documentação, performance)
+- **Reexecute** tarefas que falharam ou foram canceladas com um clique
+- Continuação de conversa (resume session) no terminal
+
+### Terminal em Tempo Real
+- Streaming chunk-a-chunk via WebSocket com indicador de conexão
+- **Busca** no output do terminal com navegação entre ocorrências
+- **Download** da saída completa como `.txt`
+- **Copiar** saída para a área de transferência
+- **Toggle de auto-scroll** para controle manual da rolagem
+- Filtro por execução
+
+### Dashboard com Gráficos
+- Métricas em tempo real (agentes, execuções, agendamentos, custo, webhooks)
+- **Gráfico de execuções** por dia (barras empilhadas sucesso/erro)
+- **Gráfico de custo** por dia (linha com área preenchida)
+- **Distribuição de status** (doughnut chart)
+- **Top 5 agentes** mais executados (barras horizontais)
+- **Taxa de sucesso** geral (gauge com percentual)
+- Seletor de período: 7, 14 ou 30 dias
+
+### Agendamento Cron
+- Agende tarefas recorrentes com expressões cron
+- Presets incluídos (horário, diário, semanal, mensal)
+- Histórico de execuções por agendamento com duração e custo
+
+### Pipelines
+- Encadeie múltiplos agentes em fluxos sequenciais
+- Saída de cada passo alimenta o próximo via template `{{input}}`
+- Portões de aprovação humana entre passos (human-in-the-loop)
+- Ideal para fluxos como "analisar → corrigir → testar"
+
+### Webhooks
+- Dispare execuções de agentes ou pipelines via HTTP externo
+- **Edite** webhooks existentes (nome, alvo, status)
+- **Teste** webhooks com um clique para verificar configuração
+- Snippet cURL pronto para copiar
+- Assinatura HMAC-SHA256 para validação de origem
+
+### Notificações
+- **Centro de notificações** no header com badge de contagem
+- Notificações automáticas para execuções concluídas e com erro
+- **Notificações nativas do navegador** (Browser Notification API)
+- Marcar como lidas / limpar todas
+- Polling automático a cada 15 segundos
+
+### Tema Claro/Escuro
+- Toggle de tema no header com transições suaves
+- Persistência da preferência em localStorage
+- Terminal mantém fundo escuro em ambos os temas
+
+### Exportação de Dados
+- **Exportar histórico** de execuções como CSV (UTF-8 com BOM)
+- Exportar configuração de agentes em JSON
+
+### Atalhos de Teclado
+| Tecla | Ação |
+|-------|------|
+| `1`–`9` | Navegar entre seções |
+| `N` | Novo agente |
+| `Esc` | Fechar modal |
 
 ## Pré-requisitos
 
@@ -37,7 +98,18 @@ npm run dev
 
 Acesse **http://localhost:3000** no navegador. A porta pode ser alterada via variável de ambiente `PORT`.
 
-## Como funciona
+## Variáveis de Ambiente
+
+| Variável | Descrição | Padrão |
+|----------|-----------|--------|
+| `PORT` | Porta do servidor | `3000` |
+| `AUTH_TOKEN` | Token Bearer para autenticação da API | _(desabilitado)_ |
+| `ALLOWED_ORIGIN` | Origin permitida para CORS | `http://localhost:3000` |
+| `WEBHOOK_SECRET` | Segredo HMAC para assinatura de webhooks | _(desabilitado)_ |
+| `CLAUDE_BIN` | Caminho para o binário do Claude CLI | _(auto-detectado)_ |
+| `REDIS_URL` | URL do Redis para cache L2 (opcional) | _(somente memória)_ |
+
+## Como Funciona
 
 ### Criando um agente
 
@@ -57,7 +129,8 @@ Acesse **http://localhost:3000** no navegador. A porta pode ser alterada via var
 1. Vá em **Pipelines** → **Novo Pipeline**
 2. Adicione pelo menos 2 passos, selecionando um agente para cada
 3. Opcionalmente defina um template de input usando `{{input}}` para referenciar a saída do passo anterior
-4. Execute o pipeline fornecendo o input inicial
+4. Marque passos que requerem aprovação humana antes de prosseguir
+5. Execute o pipeline fornecendo o input inicial
 
 ### Agendando uma tarefa
 
@@ -68,32 +141,40 @@ Acesse **http://localhost:3000** no navegador. A porta pode ser alterada via var
 ## Arquitetura
 
 ```
-server.js                     Express + WebSocket na mesma porta
+server.js                     Express + WebSocket + rate limiting + auth
 src/
-  routes/api.js               API REST (/api/*)
+  routes/api.js               API REST (/api/*) — 30+ endpoints
   agents/
-    manager.js                CRUD + orquestração de agentes
+    manager.js                CRUD + orquestração + notificações
     executor.js               Spawna o CLI claude como child_process
-    scheduler.js              Agendamento cron (in-memory)
+    scheduler.js              Agendamento cron (in-memory + persistido)
-    pipeline.js               Execução sequencial de steps
+    pipeline.js               Execução sequencial com aprovação humana
-  store/db.js                 Persistência em JSON (data/*.json)
+  store/db.js                 Persistência em JSON com escrita atômica
+  cache/index.js              Cache em 2 níveis (memória + Redis opcional)
 public/
-  index.html                  SPA single-page
+  index.html                  SPA single-page com hash routing
-  css/styles.css              Estilos (Inter, JetBrains Mono, Lucide)
+  css/styles.css              Design system (dark/light themes)
   js/
-    app.js                    Controlador principal + WebSocket client
+    app.js                    Controlador principal + WebSocket + tema + routing
     api.js                    Client HTTP para a API
-    components/               UI por seção (dashboard, agents, tasks, etc.)
+    components/               UI por seção (15 módulos)
 data/
   agents.json                 Agentes cadastrados
   tasks.json                  Templates de tarefas
   pipelines.json              Pipelines configurados
+  schedules.json              Agendamentos persistidos
+  executions.json             Histórico de execuções (max 5000)
+  webhooks.json               Configuração de webhooks
+  notifications.json          Notificações do sistema
+  settings.json               Configurações globais
 ```
 
 O executor invoca o binário `claude` com `--output-format stream-json`, parseia o stdout linha a linha e transmite os chunks via WebSocket para o frontend em tempo real.
 
 ## API REST
 
+### Agentes
+
 | Método | Endpoint | Descrição |
 |--------|----------|-----------|
 | `GET` | `/api/agents` | Listar agentes |
@@ -102,15 +183,34 @@ O executor invoca o binário `claude` com `--output-format stream-json`, parseia
 | `PUT` | `/api/agents/:id` | Atualizar agente |
 | `DELETE` | `/api/agents/:id` | Excluir agente |
 | `POST` | `/api/agents/:id/execute` | Executar tarefa no agente |
-| `POST` | `/api/agents/:id/cancel/:executionId` | Cancelar execução |
+| `POST` | `/api/agents/:id/continue` | Continuar conversa (resume) |
+| `POST` | `/api/agents/:id/cancel/:execId` | Cancelar execução |
 | `GET` | `/api/agents/:id/export` | Exportar agente (JSON) |
+| `POST` | `/api/agents/:id/duplicate` | Duplicar agente |
+
+### Tarefas
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
 | `GET` | `/api/tasks` | Listar tarefas |
 | `POST` | `/api/tasks` | Criar tarefa |
 | `PUT` | `/api/tasks/:id` | Atualizar tarefa |
 | `DELETE` | `/api/tasks/:id` | Excluir tarefa |
+
+### Agendamentos
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
 | `GET` | `/api/schedules` | Listar agendamentos |
 | `POST` | `/api/schedules` | Criar agendamento |
+| `PUT` | `/api/schedules/:taskId` | Atualizar agendamento |
 | `DELETE` | `/api/schedules/:taskId` | Remover agendamento |
+| `GET` | `/api/schedules/history` | Histórico de execuções agendadas |
+
+### Pipelines
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
 | `GET` | `/api/pipelines` | Listar pipelines |
 | `POST` | `/api/pipelines` | Criar pipeline |
 | `GET` | `/api/pipelines/:id` | Obter pipeline |
@@ -118,8 +218,51 @@ O executor invoca o binário `claude` com `--output-format stream-json`, parseia
 | `DELETE` | `/api/pipelines/:id` | Excluir pipeline |
 | `POST` | `/api/pipelines/:id/execute` | Executar pipeline |
 | `POST` | `/api/pipelines/:id/cancel` | Cancelar pipeline |
-| `GET` | `/api/system/status` | Status geral do sistema |
+| `POST` | `/api/pipelines/:id/approve` | Aprovar passo pendente |
+| `POST` | `/api/pipelines/:id/reject` | Rejeitar passo pendente |
+
+### Webhooks
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
+| `GET` | `/api/webhooks` | Listar webhooks |
+| `POST` | `/api/webhooks` | Criar webhook |
+| `PUT` | `/api/webhooks/:id` | Atualizar webhook |
+| `DELETE` | `/api/webhooks/:id` | Excluir webhook |
+| `POST` | `/api/webhooks/:id/test` | Testar webhook |
+
+### Execuções e Histórico
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
 | `GET` | `/api/executions/active` | Execuções em andamento |
+| `GET` | `/api/executions/history` | Histórico paginado com filtros |
+| `GET` | `/api/executions/recent` | Execuções recentes |
+| `GET` | `/api/executions/export` | Exportar histórico como CSV |
+| `GET` | `/api/executions/:id` | Detalhes de uma execução |
+| `DELETE` | `/api/executions/:id` | Excluir execução do histórico |
+| `POST` | `/api/executions/:id/retry` | Reexecutar execução falha |
+| `DELETE` | `/api/executions` | Limpar histórico |
+
+### Notificações
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
+| `GET` | `/api/notifications` | Listar notificações |
+| `POST` | `/api/notifications/:id/read` | Marcar como lida |
+| `POST` | `/api/notifications/read-all` | Marcar todas como lidas |
+| `DELETE` | `/api/notifications` | Limpar notificações |
+
+### Sistema
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
+| `GET` | `/api/health` | Health check (sem auth) |
+| `GET` | `/api/system/status` | Status geral do sistema |
+| `GET` | `/api/system/info` | Informações do servidor |
+| `GET` | `/api/stats/costs` | Estatísticas de custo |
+| `GET` | `/api/stats/charts` | Dados para gráficos do dashboard |
+| `GET/PUT` | `/api/settings` | Configurações globais |
 
 ## Eventos WebSocket
 
@@ -134,14 +277,28 @@ O servidor envia eventos tipados via WebSocket que o frontend renderiza no termi
 | `pipeline_step_complete` | Passo do pipeline concluído |
 | `pipeline_complete` | Pipeline finalizado |
 | `pipeline_error` | Erro em um passo do pipeline |
+| `pipeline_approval_required` | Passo aguardando aprovação humana |
+
+## Segurança
+
+- **Autenticação** via Bearer token (variável `AUTH_TOKEN`)
+- **Rate limiting** — 100 requisições por minuto por IP
+- **CORS** restrito à origin configurada
+- **Timing-safe comparison** para tokens de autenticação e webhooks
+- **Correlation IDs** em todas as requisições para rastreabilidade
+- **Escrita atômica** em disco (temp + rename) para integridade de dados
+- **Sanitização** de prompts (NUL, caracteres de controle, limite de 50.000 chars)
+- **Assinatura HMAC-SHA256** para webhooks recebidos
 
 ## Stack
 
-- **Backend**: Node.js, Express, WebSocket (ws), node-cron, uuid
+- **Backend**: Node.js, Express, WebSocket (ws), node-cron, uuid, express-rate-limit
 - **Frontend**: HTML, CSS, JavaScript vanilla (sem framework, sem bundler)
+- **Gráficos**: Chart.js 4.x
 - **Ícones**: Lucide
 - **Fontes**: Inter (UI), JetBrains Mono (código/terminal)
-- **Persistência**: Arquivos JSON em disco
+- **Persistência**: Arquivos JSON em disco com escrita atômica
+- **Cache**: In-memory com suporte opcional a Redis (ioredis)
 
 ## Licença