chore: ignora graphify-out gerado

2026-10-28 15:59:30 +00:00
parent 0ff519f554
commit 75041136d2
26 changed files with 3023 additions and 1 deletions
@@ -0,0 +1,48 @@
+---
+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.