---
name: report
description: Relatórios agregados semanal, mensal e por projecto. Compila dados de múltiplas fontes CRM. Usar quando "report", "relatório", "semanal", "mensal", "resumo período".
context: fork
---

# /report v1.0 - Relatórios Agregados

Relatórios de período compilando dados de múltiplas fontes.

---

## Comandos

| Comando | Função |
|---------|--------|
| `/report` | Relatório semanal (default) |
| `/report weekly` | Relatório semanal detalhado |
| `/report monthly` | Relatório mensal |
| `/report project <id>` | Relatório de projecto |

---

## Protocolo

### /report weekly (Semanal)

```
1. mcp__mcp-time__current_time → Calcular Seg-Dom da semana
2. Recolher dados:
   a. Timesheets da semana
   b. Tarefas concluídas
   c. Tickets fechados
   d. Facturas emitidas/pagas
3. Calcular métricas
4. Gerar relatório
```

**Output:**

```markdown
## 📊 Relatório Semanal - W06 (03-09 Fev 2026)

### ⏱️ Tempo
| Dia | Horas | Billable |
|-----|-------|----------|
| Seg | 6h 30m | 5h |
| Ter | 7h 15m | 6h |
| Qua | 4h 45m | 4h |
| Qui | 8h 00m | 7h |
| Sex | 5h 30m | 5h |
| **Total** | **32h** | **27h (84%)** |

### ✅ Tarefas Concluídas (12)
| ID | Tarefa | Projecto |
|----|--------|----------|
| #1446 | Documentação | Stack |
| #1448 | Testes | Stack |

### 🎫 Tickets (8)
- Fechados: 6
- Em aberto: 2
- Tempo médio resolução: 4h

### 💰 Facturação
| Métrica | Valor |
|---------|-------|
| Emitido | €5.500 |
| Recebido | €3.200 |
| Pendente | €7.800 |

### 📈 Highlights
- Projecto SFV-360: 15h (47%)
- Projecto Stack: 10h (31%)
- Interno: 7h (22%)
```

---

### /report monthly (Mensal)

```
1. Calcular primeiro e último dia do mês
2. Recolher dados agregados
3. Comparar com mês anterior
4. Gerar relatório
```

**Output:**

```markdown
## 📊 Relatório Mensal - Janeiro 2026

### Resumo Executivo
- Horas trabalhadas: 142h
- Billable: 118h (83%)
- Facturado: €12.500
- Recebido: €9.800

### Comparação
| Métrica | Jan | Dez | Δ |
|---------|-----|-----|---|
| Horas | 142h | 128h | +11% |
| Facturado | €12.5k | €10.2k | +23% |
| Tickets | 32 | 28 | +14% |

### Projectos Activos (5)
| Projecto | Horas | Valor |
|----------|-------|-------|
| SFV-360 | 45h | €4.500 |
| Stack | 38h | Interno |

### Clientes
| Cliente | Facturado | Pago | Saldo |
|---------|-----------|------|-------|
| TechCorp | €5.000 | €5.000 | €0 |
| StartupX | €3.500 | €2.000 | €1.500 |
```

---

### /report project <id>

```
1. mcp__desk-crm-v3__get_project({ project_id })
2. mcp__desk-crm-v3__get_tasks({ project_id })
3. mcp__desk-crm-v3__get_project_time_tracking({ project_id })
4. mcp__desk-crm-v3__get_invoices({ project_id })
5. Gerar relatório
```

**Output:**

```markdown
## 📁 Relatório Projecto: SFV-360 (#80)

### Status
- **Progresso:** 65%
- **Início:** 2026-01-15
- **Deadline:** 2026-03-31

### Tarefas
| Status | Qtd |
|--------|-----|
| Concluídas | 12 |
| Em curso | 5 |
| Pendentes | 8 |

### Tempo
- Total: 45h
- Estimado: 80h
- Burn rate: 56%

### Financeiro
| Factura | Valor | Status |
|---------|-------|--------|
| INV-045 | €2.500 | Pendente |
| INV-040 | €2.000 | Pago |

### Timeline
- 15/Jan: Kickoff
- 25/Jan: Fase 1 concluída
- 05/Fev: Entrega parcial
```

---

## Métricas Calculadas

| Métrica | Fórmula |
|---------|---------|
| Billable % | Horas billable / Total horas |
| Burn rate | Horas gastas / Horas estimadas |
| Ticket SLA | Tickets dentro SLA / Total |
| DSO | Dias médios para pagamento |

---

## Integração Skills

| Dados | Fonte |
|-------|-------|
| Tempo | /time (timesheets) |
| Tarefas | /crm (tasks) |
| Tickets | /ticket |
| Facturas | /invoice |

---

## Storage

Relatórios podem ser guardados em:
- **Discussão #31** (Logs) - Relatórios semanais
- **memory-supabase** - Backup para análise histórica

---

## Anti-Patterns

- **NUNCA** gerar relatório sem período definido
- **NUNCA** incluir dados estimados como factos
- **NUNCA** mostrar valores financeiros a staff não autorizado

---

## Changelog

### v1.0.0 (2026-02-05)
- Versão inicial
- Relatórios weekly, monthly, project
- Integração com skills Desk
- Métricas calculadas

---

*Skill v1.0.0 | 2026-02-05 | Descomplicar®*

---

## 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.*
