> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Visão Geral do Dashboard
> O dashboard web do EvoNexus — interface visual para gerenciar agentes, rotinas, integrações e mais
# Visão Geral do Dashboard
O dashboard web do EvoNexus é uma aplicação React + Flask que oferece uma interface visual para gerenciar agentes, rotinas, integrações, memória e mais.
## Iniciando o Dashboard
```bash theme={null}
make dashboard-app
```
Isso inicia o backend Flask (com suporte a WebSocket) e serve o frontend React em uma única porta. Padrão: `http://localhost:8080`.
### Mudando a Porta
Defina a porta em `config/workspace.yaml`:
```yaml theme={null}
dashboard:
port: 8080
```
Ou via variável de ambiente:
```bash theme={null}
EVONEXUS_PORT=9090 make dashboard-app
```
## Setup na Primeira Execução
Quando não há usuários no banco, o dashboard redireciona para um wizard de setup em `/setup`. O wizard passa por:
1. **Informações do workspace** — nome, empresa, fuso horário
2. **Conta admin** — crie seu primeiro usuário (username + senha)
3. **Agentes** — escolha quais dos 17 agentes habilitar
4. **Integrações** — selecione quais serviços conectar
Após o setup terminar, você está logado como admin e tem acesso a todas as páginas.
## Páginas do Dashboard
### Overview
Dashboard de métricas unificado. Mostra dados agregados de todos os agentes — snapshot financeiro, saúde da comunidade, status de projetos, alcance social. É a página inicial após o login.
### Systems
Registre apps e serviços externos que seu time usa. Cada sistema tem nome, URL, tipo (container Docker, URL externa ou iframe) e ícone. Útil para links rápidos a ferramentas como Grafana, Portainer ou apps internos.
### Reports
Navegue pelos relatórios HTML gerados pelas rotinas automatizadas. Os relatórios são armazenados em subpastas de `workspace/` e exibidos com data, agente e tipo. Clique em qualquer relatório para abrir o HTML completo em uma nova aba.
### Agents
Visualize as definições dos 17 agentes. Cada card mostra o nome do agente, slash command, domínio e o system prompt completo (carregado de `.claude/agents/`). Agentes core têm ícones e cores dedicados; agentes customizados aparecem com badge cinza.
### Routines
Métricas de cada rotina automatizada: total de execuções, taxa de sucesso, duração média, uso de tokens e custo. Inclui um botão "Run Now" para disparar qualquer rotina manualmente.
### Tasks
Crie e gerencie ações agendadas pontuais. Agende uma skill, prompt ou script para rodar em uma data/hora específica. Filtre por status (pending, running, completed, failed), crie novas tasks, execute imediatamente ou veja resultados. Veja [Scheduled Tasks](../routines/scheduled-tasks) para detalhes.
### Triggers
Triggers reativos por evento — webhooks e eventos. Crie triggers que executam skills ou rotinas em resposta a eventos externos (push no GitHub, pagamento no Stripe, atualizações no Linear). Filtre por tipo (webhooks, eventos), status (enabled, disabled) e gerencie configurações.
### Skills
Navegue por todas as skills instaladas, agrupadas por prefixo (`social-`, `fin-`, `int-`, `prod-`, etc). Clique em uma skill para ver descrição completa, condições de trigger e arquivo de origem.
### Templates
Faça preview dos templates HTML de relatório em `.claude/templates/html/`. Veja como cada template renderiza antes que as rotinas o usem.
### Services
Inicie e pare serviços em background (scheduler, bot do Telegram) direto da UI. Mostra logs ao vivo via WebSocket. Indicadores de status mostram se cada serviço está rodando.
### Workspace
Navegue pelos relatórios e arquivos de saída do workspace, organizados por domínio (community, courses, daily-logs, finance, meetings, personal, projects, social, strategy). Navegue por pastas, filtre arquivos e abra relatórios direto do dashboard.
### Memory
Navegue pelo sistema de memória de duas camadas:
* **CLAUDE.md** — memória de trabalho, carregada toda sessão
* **memory/** — arquivos detalhados (pessoas, projetos, glossário, tendências)
* **Memória de agente** — contexto por agente em `.claude/agent-memory/`
### Knowledge Base
Busca semântica opcional via [MemPalace](https://github.com/milla-jovovich/mempalace). Habilite com um clique, adicione diretórios (código, docs, notas) como fontes, indexe-os e busque por significado — não só palavras-chave. Tudo roda localmente usando vetores ChromaDB. Veja [knowledge-base](knowledge-base) para detalhes.
### Integrations
Painel de status para todas as 18 integrações. Mostra quais estão conectadas (verde), quais precisam de configuração (amarelo) e quais estão desabilitadas. Contas de redes sociais (YouTube, Instagram, LinkedIn) podem ser conectadas via OAuth direto desta página.
### Providers
Escolha e configure qual backend LLM alimenta o EvoNexus — Anthropic (padrão) ou qualquer um dos 6 alternativos via [OpenClaude](https://www.npmjs.com/package/@gitlawb/openclaude): OpenRouter, OpenAI, Gemini, Codex Auth, AWS Bedrock, Vertex AI. Cada card de provedor mostra status de instalação (claude vs openclaude), flags configurado/não-configurado e um botão Test que executa ` --version` com o env mesclado. Trocar provedor tem efeito imediato — tanto o terminal-server quanto o ADW runner releem `config/providers.json` a cada nova sessão, sem restart. Secrets são mascarados na UI e em toda resposta da API. Veja [providers](providers) para a referência completa.
### Chat
Terminal Claude Code embutido com xterm.js + WebSocket. Execute comandos do Claude Code, invoque agentes via slash commands e veja o output em tempo real — tudo no navegador.
### Users
Página de gestão de usuários (apenas admin). Crie, edite, desative usuários. Atribua roles. Veja timestamps do último login.
### Roles
Defina roles customizadas com matriz granular de permissões. Cada role mapeia recursos (chat, services, reports, etc.) para ações (view, execute, manage). Roles built-in (admin, operator, viewer) não podem ser deletadas mas podem ser clonadas.
### Costs
Acompanhamento de uso de tokens e custo por rotina. Exibe gráficos com tendências de custo no tempo, breakdown de consumo de tokens (input vs output) e comparação de custo por rotina. Útil para monitorar gastos com a API do Claude entre workflows automatizados.
### Files
Navegue pelos arquivos do workspace direto do dashboard. Navegue na estrutura de pastas, faça preview de arquivos e entenda como o workspace está organizado sem precisar de acesso ao terminal.
### Scheduler
Gerencie serviços em background e rotinas agendadas. Mostra todas as rotinas registradas com badges core/custom, suas agendas, estado enabled/disabled e status da última execução. Inicie, pare ou dispare rotinas desta página.
### Audit Log
Trilha completa de auditoria de todas as ações: logins, mudanças de config, execuções de rotinas, gestão de usuários. Filtrável por usuário, ação, recurso e período.
### Backups
Exporte e restaure dados do workspace (todos os arquivos gitignored do usuário). Crie backups locais, baixe ZIPs, restaure em modo merge ou replace. Mostra status da configuração S3 quando o backup em nuvem está disponível. A rotina de backup diário roda automaticamente às 21:00.
### Settings
Hub de configuração do workspace com três abas:
* **Workspace** — edite nome do workspace, dono, empresa, idioma, fuso horário e porta do dashboard (`config/workspace.yaml`)
* **Routines** — ative/desative rotinas, edite agendas inline, veja agentes e scripts (`config/routines.yaml`). Mudanças disparam reload automático do scheduler.
* **Reference** — visualizações read-only de CLAUDE.md, targets do Makefile e slash commands
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.