feat(crm-ops): adiciona plugin crm-ops (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:08:32 +00:00
parent 83a69e681c
commit 81d1373977
61 changed files with 6037 additions and 0 deletions
@@ -0,0 +1,158 @@
+---
+name: crm-admin
+description: Administração e manutenção do Desk CRM. Gestão de utilizadores, permissões, campos personalizados, configuração de sistema e módulos Perfex.
+disable-model-invocation: true
+layer: wiki
+---
+
+# CRM Admin Specialist
+
+Skill para gestão e desenvolvimento Perfex CRM seguindo padrões Descomplicar®.
+
+## Quando Usar
+
+- Consultas de dados CRM (clientes, projectos, tarefas)
+- Relatórios e analytics de facturação
+- Desenvolvimento de módulos Perfex
+- Automação de processos CRM
+- Integração com sistemas externos
+
+## Protocolo Obrigatório
+
+### 1. MCP First (SEMPRE)
+Antes de qualquer operação, usar MCPs:
+```
+mcp__desk-crm-v3__get_customers - verificar dados existentes
+mcp__mem_search_memories "[contexto crm]"
+mcp__wikijs__search_pages "perfex crm [funcionalidade]"
+```
+
+### 2. Dados Reais Obrigatórios
+- NUNCA simular dados quando MCPs disponíveis
+- Usar mcp__desk-crm-v3__* para TODAS operações CRM
+- Validar IDs de clientes/projectos antes de modificar
+
+### 3. Segurança de Dados
+- NUNCA expor dados sensíveis de clientes em logs
+- Confirmar antes de operações destrutivas (delete)
+- Backup mental do estado antes de modificações bulk
+
+## MCPs Disponíveis - DeskCRM v3
+
+### Clientes
+```
+mcp__desk-crm-v3__get_customers      # Listar (filtros: search, active, country)
+mcp__desk-crm-v3__get_customer       # Detalhes (client_id)
+mcp__desk-crm-v3__create_customer    # Criar (company obrigatório)
+mcp__desk-crm-v3__update_customer    # Actualizar (client_id)
+mcp__desk-crm-v3__customer_analytics # Analytics (client_id, period)
+mcp__desk-crm-v3__search_customers   # Pesquisa multi-campo (query, fields)
+```
+
+### Projectos
+```
+mcp__desk-crm-v3__get_projects       # Listar (status, client_id, billing_type)
+mcp__desk-crm-v3__get_project        # Detalhes (project_id)
+mcp__desk-crm-v3__create_project     # Criar (name, client_id, billing_type)
+mcp__desk-crm-v3__update_project     # Actualizar (project_id)
+mcp__desk-crm-v3__project_analytics  # Analytics (period, status)
+```
+
+### Tarefas
+```
+mcp__desk-crm-v3__get_tasks          # Listar (status, assigned_to, rel_type)
+mcp__desk-crm-v3__get_task           # Detalhes (task_id)
+mcp__desk-crm-v3__create_task        # Criar (name obrigatório)
+mcp__desk-crm-v3__update_task        # Actualizar (task_id)
+mcp__desk-crm-v3__task_analytics     # Analytics (period, staff_id)
+```
+
+### Leads
+```
+mcp__desk-crm-v3__get_leads          # Listar (status, source, assigned)
+mcp__desk-crm-v3__create_lead        # Criar (name obrigatório)
+mcp__desk-crm-v3__update_lead        # Actualizar (lead_id)
+mcp__desk-crm-v3__convert_lead_to_customer  # Converter (lead_id)
+mcp__desk-crm-v3__lead_analytics     # Funil e conversões (report_type)
+```
+
+### Financeiro
+```
+mcp__desk-crm-v3__get_payments             # Pagamentos
+mcp__desk-crm-v3__get_estimates            # Orçamentos
+mcp__desk-crm-v3__financial_kpi_dashboard  # KPIs (period)
+mcp__desk-crm-v3__profit_loss_statement    # DRE (date_from, date_to)
+mcp__desk-crm-v3__cash_flow_statement      # Fluxo caixa
+mcp__desk-crm-v3__accounts_receivable_aging # Contas a receber
+```
+
+### Tickets/Suporte
+```
+mcp__desk-crm-v3__get_tickets        # Listar (status, priority, assigned)
+mcp__desk-crm-v3__create_ticket      # Criar (subject, message)
+mcp__desk-crm-v3__reply_ticket       # Responder (ticket_id, message)
+mcp__desk-crm-v3__ticket_analytics   # Analytics (period, department_id)
+```
+
+## Assinatura para Módulos
+
+```php
+<?php
+/**
+ * [Nome do Módulo/Ficheiro]
+ *
+ * @author Descomplicar® Crescimento Digital
+ * @link https://descomplicar.pt
+ * @copyright 2025 Descomplicar®
+ */
+```
+
+## Padrões de Relatórios
+
+Ao gerar relatórios, incluir:
+1. **Período**: Data início/fim claramente indicada
+2. **Totais**: Agregações relevantes
+3. **Top N**: Rankings quando aplicável
+4. **Comparação**: Com período anterior se relevante
+
+## Checklist Consultas
+
+- [ ] Usar MCPs para dados reais
+- [ ] Validar IDs antes de operações
+- [ ] Não expor dados sensíveis
+- [ ] Confirmar operações destrutivas
+- [ ] Apresentar dados formatados PT-PT
+
+---
+
+## Datasets Dify (Consulta Obrigatória)
+
+Em caso de dúvidas ou para aprofundar conhecimento, consultar os seguintes datasets via MCP:
+
+| Dataset | ID | Prioridade |
+|---------|----|-----------:|
+| **PerfexCRM** | `43354eb6-f0b2-40cc-aa53-44e375ab347c` | 1 |
+| **Vendas** | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | 2 |
+| **Gestão** | `22799925-8dc5-4a1f-92b9-233468a5048b` | 2 |
+| **Gestão de Processos** | `cae2a27e-f5bc-4d75-8a7a-9f83064f2512` | 3 |
+
+### Como Consultar
+
+```javascript
+// Pesquisar funcionalidades Perfex
+mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "43354eb6-f0b2-40cc-aa53-44e375ab347c",
+  query: "modulo facturas automaticas"
+})
+
+// Pesquisar técnicas de vendas
+mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
+  query: "pipeline vendas conversao"
+})
+```
+
+### Quando Consultar
+
+- Desenvolver módulos Perfex CRM
+- Configurar automações de