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

O Agente/Developer identifica a Tarefa Master no CRM via desk.project.
Inicia o timer: mcp__desk-project-minimal__start_task_timer(task_id=XXXX).
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)

Parar o timer no CRM.
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]."
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.

2.4 KiB Raw Blame History