---
name: dashboard
description: Criação e gestão de dashboards Metabase — questions, visualizações e filtros para bi.descomplicar.pt.
disable-model-invocation: true
---

# Skill /dashboard - Metabase Dashboard Management

Criar e gerir dashboards Metabase com questions, visualizações e filtros para bi.descomplicar.pt.

## Sintaxe

```
/dashboard [operação] [contexto]
```

**Operações:**
- `create [nome]` - Criar novo dashboard
- `add-card [dashboard_id]` - Adicionar question/card a dashboard
- `list` - Listar todos os dashboards
- `view [id]` - Ver detalhes de um dashboard
- `share [id]` - Obter link público de partilha
- `export [id]` - Exportar dados de um dashboard

## Quando usar

- Criar dashboards de negócio (vendas, marketing, operações)
- Adicionar visualizações a dashboards existentes
- Organizar métricas em painéis visuais
- Partilhar dashboards com equipa

---

## Protocolo de execução

### 1. Carregar MCP

```
ToolSearch("metabase")
```

### 2. Operação: create

**Workflow completo para criar dashboard:**

```
1. CONFIRMAR objectivo com utilizador
2. Identificar database e tabelas relevantes
   - mcp__metabase__list_databases
   - mcp__metabase__get_database_tables
3. Escolher/criar collection destino
   - mcp__metabase__list_collections
4. Criar questions/cards necessários
   - Definir query (SQL ou query builder)
   - Escolher tipo de visualização (bar, line, pie, table, number)
5. Criar dashboard
   - mcp__metabase__create_dashboard (nome, descrição, collection_id)
6. Adicionar cards ao dashboard
7. Confirmar resultado com URL
```

**Tipos de visualização recomendados:**

| Métrica | Visualização |
|---------|-------------|
| KPI singular (total vendas) | Number |
| Evolução temporal | Line chart |
| Comparação categorias | Bar chart |
| Distribuição/proporção | Pie chart |
| Dados detalhados | Table |
| Geográfico | Map |

### 3. Operação: add-card

```
1. Verificar dashboard existe: mcp__metabase__get_dashboard
2. Criar question se necessário
3. Adicionar card ao dashboard
4. Confirmar posição e tamanho
```

### 4. Operação: list

```
1. mcp__metabase__list_dashboards
2. Apresentar: ID, nome, collection, cards count, última actualização
```

### 5. Operação: view

```
1. mcp__metabase__get_dashboard (id)
2. Mostrar: nome, descrição, cards, filtros, parâmetros
3. URL directa: https://bi.descomplicar.pt/dashboard/{id}
```

### 6. Operação: share

```
1. Gerar link público se não existir
2. Retornar URL de embed/partilha
```

### 7. Operação: export

```
1. Para cada card no dashboard, exportar dados
2. Formatar em tabela Markdown ou sugerir CSV
```

## Templates de dashboard

### Dashboard vendas
- Total facturado (mês actual vs anterior)
- Facturas por estado (paid/unpaid/overdue)
- Top 10 clientes por valor
- Evolução mensal receita

### Dashboard projectos
- Projectos activos vs concluídos
- Tarefas por estado
- Tempo registado por projecto
- Deadlines próximos

### Dashboard suporte
- Tickets abertos vs fechados
- Tempo médio de resposta
- Tickets por departamento
- Satisfação cliente

## Notas

- Objectos criados via AI usam prefixo `claude_ai_` (comportamento do MCP)
- Sempre confirmar com utilizador antes de criar/modificar
- Preferir collections organizadas por tema

---

## Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```

*Adicionar nova linha após cada erro corrigido.*
