---
layer: wiki
type: Document
tags: [projecto, modelo, organizacao, protocolo]
title: Protocolo Crm
description: >-
  No ecossistema Descomplicar®, a gestão de projectos segue uma hierarquia de granularidade distinta:
timestamp: 2026-05-13T11:01:24.047410+00:00
---
# PROTOCOLO-CRM.md — Integração Lean Gitea & Desk CRM

## Princípio Fundamental: O Contentor de Tempo
No ecossistema Descomplicar®, a gestão de projectos segue uma hierarquia de granularidade distinta:
- **Desk CRM**: É o **Contentor de Tempo e Custos**. Utiliza-se apenas uma (ou poucas) "Tarefa Master" para registar horas e dar visibilidade financeira.
- **Gitea**: É a **Oficina Técnica**. É aqui que reside a complexidade granular (Issues, Milestones, Projects).

## 1. Mapeamento de Entidades

| Entidade Desk CRM | Entidade Gitea | Finalidade |
| :--- | :--- | :--- |
| **Tarefa Master** | Repositório / Milestones | Registo de horas (Timer) e Faturação. |
| **Comentário de Task** | Resumo de Sessão | Visibilidade para o Cliente/Gestor. |
| **(Inexistente)** | **Issues / Pull Requests** | Detalhe técnico, bugs e histórico de código. |

## 2. Fluxo Operacional Simplificado

### A. Início da Sessão
1. O Agente/Developer identifica a **Tarefa Master** no CRM via `desk.project`.
2. Inicia o timer: `mcp__desk-project-minimal__start_task_timer(task_id=XXXX)`.
3. Toda a exploração de tarefas granulares é feita no Gitea.

### B. Durante a Execução
- As discussões técnicas, especificações de bugs e estados de desenvolvimento (To Do/Done) ocorrem exclusivamente nas **Issues** e **Projects** do Gitea.

### C. Final da Sessão (Obrigatório)
1. Parar o timer no CRM.
2. Adicionar um comentário de fecho no CRM que faça a ponte entre os mundos:
   *"Concluída sessão de desenvolvimento. No Gitea, foram fechadas as Issues #10 e #11 relativas à Milestone [Nome]."*
3. Actualizar o `MEMORY.md` local.

## 3. Onde Documentar o Quê?

- **Hub (`06-Operacoes/`)**: Padrões que se aplicam a TODOS os projectos (ex: "Como configurar um servidor").
- **Gitea Wiki**: Documentação específica deste código (ex: "Esquema da API deste projecto").
- **`MEMORY.md`**: Registo cronológico da vida do repositório.

## 4. Conclusão
Este protocolo elimina a necessidade de duplicar o quadro de tarefas do Gitea no Desk CRM. O CRM mantém-se limpo, focado em resultados e tempo, enquanto o Gitea retém toda a riqueza técnica.