49 lines
2.4 KiB
Markdown
49 lines
2.4 KiB
Markdown
---
|
|
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.
|