# Template: Revisao Mensal

**Tipo:** Revisao estrategica mensal com cliente
**Quando usar:** Fim de mes, reuniao mensal de acompanhamento, revisao de contrato
**Tom:** Estrategico, baseado em dados, orientado para decisao conjunta
**Extensao:** 2-3 paginas. O mais completo dos 4 templates

**Diferenca face ao client-update:** A revisao mensal inclui analise comparativa, discussao estrategica e decisoes para o mes seguinte. O update e apenas informativo.

---

## Estrutura do Template

### HTML (Desk CRM)

```html
<h4>Revisao Mensal — {{NOME_PROJECTO}} | {{MES_ANO}}</h4>
<p>
  <strong>Cliente:</strong> {{NOME_CLIENTE}} |
  <strong>Periodo:</strong> 01-{{MES_NUM}}-{{ANO}} a {{ULTIMO_DIA}}-{{MES_NUM}}-{{ANO}} |
  <strong>Elaborado por:</strong> Descomplicar®
</p>

<h4>1. Resumo Executivo</h4>
<p>{{PARAGRAFO_RESUMO_EXECUTIVO}}</p>

<table>
  <tr>
    <th>Metrica</th>
    <th>{{MES_ATUAL}}</th>
    <th>{{MES_ANTERIOR}}</th>
    <th>Variacao</th>
  </tr>
  <tr>
    <td>Horas trabalhadas</td>
    <td>{{HORAS_MES}}</td>
    <td>{{HORAS_MES_ANT}}</td>
    <td>{{VAR_HORAS}}</td>
  </tr>
  <tr>
    <td>Tarefas concluidas</td>
    <td>{{TAREFAS_MES}}</td>
    <td>{{TAREFAS_MES_ANT}}</td>
    <td>{{VAR_TAREFAS}}</td>
  </tr>
  <tr>
    <td>Progresso geral</td>
    <td>{{PROGRESSO_MES}}%</td>
    <td>{{PROGRESSO_MES_ANT}}%</td>
    <td>+{{VAR_PROGRESSO}}pp</td>
  </tr>
  <tr>
    <td>Valor entregue</td>
    <td>{{VALOR_MES}}EUR</td>
    <td>{{VALOR_MES_ANT}}EUR</td>
    <td>{{VAR_VALOR}}</td>
  </tr>
</table>

<h4>2. Trabalho Realizado</h4>

<h5>Entregas Concluidas</h5>
<ul>
  <li><strong>{{ENTREGA_1}}:</strong> {{DESCRICAO_ENTREGA_1}}</li>
  <li><strong>{{ENTREGA_2}}:</strong> {{DESCRICAO_ENTREGA_2}}</li>
  <li><strong>{{ENTREGA_3}}:</strong> {{DESCRICAO_ENTREGA_3}}</li>
</ul>

<h5>Tarefas por Area</h5>
<table>
  <tr>
    <th>Area</th>
    <th>Tarefas</th>
    <th>Horas</th>
  </tr>
  <tr>
    <td>{{AREA_1}}</td>
    <td>{{AREA_1_TAREFAS}}</td>
    <td>{{AREA_1_HORAS}}h</td>
  </tr>
  <tr>
    <td>{{AREA_2}}</td>
    <td>{{AREA_2_TAREFAS}}</td>
    <td>{{AREA_2_HORAS}}h</td>
  </tr>
</table>

<h4>3. Estado do Projecto</h4>
<table>
  <tr>
    <th>Componente</th>
    <th>Estado</th>
    <th>Notas</th>
  </tr>
  <tr>
    <td>{{COMPONENTE_1}}</td>
    <td>{{ESTADO_1}}</td>
    <td>{{NOTA_1}}</td>
  </tr>
  <tr>
    <td>{{COMPONENTE_2}}</td>
    <td>{{ESTADO_2}}</td>
    <td>{{NOTA_2}}</td>
  </tr>
</table>

<h4>4. Facturacao e Financeiro</h4>
<table>
  <tr>
    <th>Descricao</th>
    <th>Valor</th>
    <th>Data</th>
    <th>Estado</th>
  </tr>
  <tr>
    <td>{{FATURA_1_DESC}}</td>
    <td>{{FATURA_1_VALOR}}EUR</td>
    <td>{{FATURA_1_DATA}}</td>
    <td>{{FATURA_1_ESTADO}}</td>
  </tr>
</table>
<p>
  <strong>Facturado no mes:</strong> {{TOTAL_FACTURADO}}EUR |
  <strong>Recebido:</strong> {{TOTAL_RECEBIDO}}EUR |
  <strong>Pendente:</strong> {{TOTAL_PENDENTE}}EUR
</p>

<h4>5. Analise e Observacoes</h4>
<p>{{ANALISE_QUALITATIVA}}</p>

<h5>O que correu bem</h5>
<ul>
  <li>{{PONTO_POSITIVO_1}}</li>
  <li>{{PONTO_POSITIVO_2}}</li>
</ul>

<h5>O que pode melhorar</h5>
<ul>
  <li>{{PONTO_MELHORIA_1}}</li>
  <li>{{PONTO_MELHORIA_2}}</li>
</ul>

<h4>6. Plano para {{MES_SEGUINTE}}</h4>
<ul>
  <li>{{OBJECTIVO_1}} — responsavel: {{RESP_1}} — data: {{DATA_OBJ_1}}</li>
  <li>{{OBJECTIVO_2}} — responsavel: {{RESP_2}} — data: {{DATA_OBJ_2}}</li>
  <li>{{OBJECTIVO_3}} — responsavel: {{RESP_3}} — data: {{DATA_OBJ_3}}</li>
</ul>

<h5>Decisoes Necessarias</h5>
<ul>
  <li>{{DECISAO_1}} — pendente: {{PENDENTE_QUEM_1}}</li>
  <li>{{DECISAO_2}} — pendente: {{PENDENTE_QUEM_2}}</li>
</ul>

<h4>7. Proxima Revisao</h4>
<p>
  <strong>Data proposta:</strong> {{DATA_PROXIMA_REVISAO}} |
  <strong>Formato:</strong> {{FORMATO_REUNIAO}}
</p>

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

### Markdown (Email / Hub)

```markdown
# Revisao Mensal — {{NOME_PROJECTO}} | {{MES_ANO}}

**Cliente:** {{NOME_CLIENTE}} | **Periodo:** 01-{{MES_NUM}}-{{ANO}} a {{ULTIMO_DIA}}-{{MES_NUM}}-{{ANO}}

---

## 1. Resumo Executivo

{{PARAGRAFO_RESUMO_EXECUTIVO}}

| Metrica | {{MES_ATUAL}} | {{MES_ANTERIOR}} | Variacao |
|---------|--------------|-----------------|----------|
| Horas trabalhadas | {{HORAS_MES}} | {{HORAS_MES_ANT}} | {{VAR_HORAS}} |
| Tarefas concluidas | {{TAREFAS_MES}} | {{TAREFAS_MES_ANT}} | {{VAR_TAREFAS}} |
| Progresso geral | {{PROGRESSO_MES}}% | {{PROGRESSO_MES_ANT}}% | +{{VAR_PROGRESSO}}pp |
| Valor entregue | {{VALOR_MES}}EUR | {{VALOR_MES_ANT}}EUR | {{VAR_VALOR}} |

## 2. Trabalho Realizado

**Entregas concluidas:**
- **{{ENTREGA_1}}:** {{DESCRICAO_ENTREGA_1}}
- **{{ENTREGA_2}}:** {{DESCRICAO_ENTREGA_2}}
- **{{ENTREGA_3}}:** {{DESCRICAO_ENTREGA_3}}

## 3. Estado do Projecto

| Componente | Estado | Notas |
|------------|--------|-------|
| {{COMPONENTE_1}} | {{ESTADO_1}} | {{NOTA_1}} |
| {{COMPONENTE_2}} | {{ESTADO_2}} | {{NOTA_2}} |

## 4. Facturacao

| Descricao | Valor | Estado |
|-----------|-------|--------|
| {{FATURA_1_DESC}} | {{FATURA_1_VALOR}}EUR | {{FATURA_1_ESTADO}} |

**Facturado:** {{TOTAL_FACTURADO}}EUR | **Recebido:** {{TOTAL_RECEBIDO}}EUR | **Pendente:** {{TOTAL_PENDENTE}}EUR

## 5. O que correu bem / O que melhorar

**Positivo:**
- {{PONTO_POSITIVO_1}}
- {{PONTO_POSITIVO_2}}

**Melhoria:**
- {{PONTO_MELHORIA_1}}
- {{PONTO_MELHORIA_2}}

## 6. Plano {{MES_SEGUINTE}}

- {{OBJECTIVO_1}} — {{RESP_1}} — {{DATA_OBJ_1}}
- {{OBJECTIVO_2}} — {{RESP_2}} — {{DATA_OBJ_2}}
- {{OBJECTIVO_3}} — {{RESP_3}} — {{DATA_OBJ_3}}

**Decisoes necessarias:**
- {{DECISAO_1}} — pendente: {{PENDENTE_QUEM_1}}

## 7. Proxima Revisao

**Data proposta:** {{DATA_PROXIMA_REVISAO}} | **Formato:** {{FORMATO_REUNIAO}}

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

---

## Placeholders — Mapeamento Desk CRM

| Placeholder | Fonte | MCP Call |
|-------------|-------|----------|
| `{{HORAS_MES}}` | Timesheets do mes | `get_project_time_tracking` |
| `{{HORAS_MES_ANT}}` | Timesheets mes anterior | `get_project_time_tracking` (range) |
| `{{TAREFAS_MES}}` | Tasks concluidas no mes | `get_tasks` (filtro data) |
| `{{PROGRESSO_MES}}` | `project.progress` actual | `get_project` |
| `{{TOTAL_FACTURADO}}` | Soma facturas do mes | `get_invoices` |
| `{{TOTAL_RECEBIDO}}` | Facturas pagas | `get_invoices` (status=paid) |
| `{{TOTAL_PENDENTE}}` | Facturas pendentes | `get_invoices` (status=unpaid) |

### Estados de Componente

| Estado | Significado |
|--------|-------------|
| Concluido | Entregue e aceite |
| Em curso | Desenvolvimento activo |
| Pendente | Nao iniciado, na fila |
| Em revisao | Aguarda aprovacao cliente |
| Em pausa | Aguarda input externo |
| Bloqueado | Dependencia nao resolvida |

---

## Paragrafo de Resumo Executivo — Guia

O resumo executivo deve responder a 3 questoes em 3-4 frases:

1. **O que foi feito este mes?** (resultados concretos)
2. **Onde estamos no projecto?** (progresso, prazo)
3. **O que e mais importante para o mes seguinte?** (foco)

Exemplo:
```
Em Fevereiro 2026, concluimos a integracao com a API de energia solar
e o modulo de relatorios automaticos, elevando o progresso do projecto
para 72%. O projecto mantem-se dentro do prazo previsto para entrega
final a 31-03-2026. Em Marco, o foco sera o dashboard mobile e a
formacao de utilizadores.
```

---

## Notas de Uso

- O paragrafo de resumo executivo e o elemento mais lido — escrever com cuidado
- Comparacao com mes anterior so incluir se os dados forem reais (nao simular)
- "O que pode melhorar" nao e critica — e comprometimento de melhoria continua
- Decisoes necessarias devem ter dono claro (Descomplicar ou Cliente)
- Propor sempre data para proxima revisao — nao deixar em aberto

---

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