claude-plugins/gestao/skills/report-templates/references/client-update.md

# Template: Update Mensal de Cliente

**Tipo:** Comunicacao periodica de progresso
**Frequencia:** Mensal (ou quinzenal em projectos activos)
**Tom:** Profissional, directo, orientado para dados
**Extensao:** 1 pagina (equivalente)

---

## Estrutura do Template

### HTML (Desk CRM)

```html
<h4>Update {{MES_ANO}} — {{NOME_PROJECTO}}</h4>

<p>Caro {{NOME_CLIENTE}},</p>
<p>Segue o update de progresso referente a {{MES_ANO}}.</p>

<h4>Trabalho Concluido</h4>
<ul>
  <li>{{TAREFA_1}}</li>
  <li>{{TAREFA_2}}</li>
  <li>{{TAREFA_3}}</li>
</ul>

<h4>Metricas do Periodo</h4>
<table>
  <tr>
    <th>Metrica</th>
    <th>Valor</th>
  </tr>
  <tr>
    <td>Horas dedicadas</td>
    <td>{{HORAS_TOTAL}}h</td>
  </tr>
  <tr>
    <td>Tarefas concluidas</td>
    <td>{{TAREFAS_CONCLUIDAS}}</td>
  </tr>
  <tr>
    <td>Progresso geral</td>
    <td>{{PROGRESSO_PERCENTAGEM}}%</td>
  </tr>
</table>

<h4>Em Curso</h4>
<ul>
  <li>{{ITEM_EM_CURSO_1}}</li>
  <li>{{ITEM_EM_CURSO_2}}</li>
</ul>

<h4>Proximos Passos</h4>
<ul>
  <li>{{PROXIMO_PASSO_1}} — previsto para {{DATA_1}}</li>
  <li>{{PROXIMO_PASSO_2}} — previsto para {{DATA_2}}</li>
</ul>

<p>Qualquer questao, estamos disponiveis.</p>

<hr>
<p>
  <strong>Descomplicar®</strong> |
  <a href="mailto:info@descomplicar.pt">info@descomplicar.pt</a> |
  911 510 005
</p>
<p><em>Update gerado em {{DATA_HOJE}} | Projecto #{{PROJECTO_ID}}</em></p>
```

### Markdown (Email / Hub)

```markdown
**Update {{MES_ANO}} — {{NOME_PROJECTO}}**

Caro {{NOME_CLIENTE}},

Segue o update de progresso referente a {{MES_ANO}}.

---

**Trabalho Concluido**

- {{TAREFA_1}}
- {{TAREFA_2}}
- {{TAREFA_3}}

**Metricas do Periodo**

| Metrica | Valor |
|---------|-------|
| Horas dedicadas | {{HORAS_TOTAL}}h |
| Tarefas concluidas | {{TAREFAS_CONCLUIDAS}} |
| Progresso geral | {{PROGRESSO_PERCENTAGEM}}% |

**Em Curso**

- {{ITEM_EM_CURSO_1}}
- {{ITEM_EM_CURSO_2}}

**Proximos Passos**

- {{PROXIMO_PASSO_1}} — previsto para {{DATA_1}}
- {{PROXIMO_PASSO_2}} — previsto para {{DATA_2}}

Qualquer questao, estamos disponiveis.

---
Descomplicar® | info@descomplicar.pt | 911 510 005
*Update gerado em {{DATA_HOJE}} | Projecto #{{PROJECTO_ID}}*
```

---

## Placeholders — Mapeamento Desk CRM

| Placeholder | Fonte Desk CRM | MCP Call |
|-------------|---------------|----------|
| `{{NOME_PROJECTO}}` | `project.name` | `get_project` |
| `{{NOME_CLIENTE}}` | `customer.firstname` | `search_customers` |
| `{{MES_ANO}}` | Calculado | `mcp-time` |
| `{{HORAS_TOTAL}}` | Timesheets do mes | `get_project_time_tracking` |
| `{{TAREFAS_CONCLUIDAS}}` | Tasks status=completed | `get_tasks` |
| `{{PROGRESSO_PERCENTAGEM}}` | `project.progress` | `get_project` |
| `{{TAREFA_1..N}` | Tasks recentes concluidas | `get_tasks` |
| `{{ITEM_EM_CURSO_1..N}` | Tasks status=in_progress | `get_tasks` |
| `{{PROXIMO_PASSO_1..N}` | Tasks status=not_started, por data | `get_tasks` |
| `{{DATA_1..N}` | `task.due_date` | `get_tasks` |
| `{{DATA_HOJE}}` | Hoje | `mcp-time` |
| `{{PROJECTO_ID}}` | `project.id` | `get_project` |

---

## Exemplo Preenchido

```
Update Fevereiro 2026 — Portal SFV-360

Caro Paulo Silva,

Segue o update de progresso referente a Fevereiro 2026.

Trabalho Concluido:
- Implementacao modulo de relatorios automaticos
- Integracao API energia solar (3 inversores)
- Correccao erro calculo producao acumulada

Metricas do Periodo:
- Horas dedicadas: 38h
- Tarefas concluidas: 8
- Progresso geral: 72%

Em Curso:
- Dashboard mobile (responsivo)
- Testes de carga base de dados

Proximos Passos:
- Entrega dashboard mobile — previsto para 15-03-2026
- Formacao utilizadores — previsto para 20-03-2026
```

---

## Notas de Uso

- Incluir apenas tarefas relevantes para o cliente (excluir internas/tecnicas sem impacto visivel)
- Se o progresso diminuiu ou estagnou, explicar o motivo de forma clara
- Proximos passos devem ter sempre datas concretas
- Maximo 5 items por seccao — sintese e preferida
- Se existem bloqueadores que dependem do cliente, destacar em negrito

---

*Template v1.0.0 | 2026-03-10 | Descomplicar®*