---
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
---

# 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__memory-supabase__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 vendas
- Optimizar processos de facturação
- Implementar workflows de gestão de clientes

---
**Versão**: 1.0.0 | **Autor**: Descomplicar®

---

## Instrumentação Automática

Esta skill grava métricas automaticamente para análise PDCA.

### Query para Gravar (executar no final)

```sql
INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/$SKILL_NAME', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```

---

**Instrumentação**: Activa | **Data**: 2026-02-03

---


## Quando NÃO Usar

- Para tarefas fora do domínio de especialização desta skill
- Quando outra skill mais específica está disponível
- Para operações que requerem aprovação manual obrigatória
- Quando os requisitos não estão claramente definidos


## Exemplos de Uso

### Exemplo 1: Caso Básico
```
User: [requisição simples relacionada com crm-admin]
Skill: [execução directa com validação]
Output: [resultado conciso e accionável]
```

### Exemplo 2: Caso Complexo
```
User: [requisição multi-passo ou complexa]
Skill:
  1. Análise dos requisitos
  2. Planeamento da abordagem
  3. Execução faseada
  4. Validação contínua
Output: [resultado detalhado com próximos passos]
```

### Exemplo 3: Caso com Dependências
```
User: [requisição que depende de outros sistemas]
Skill:
  1. Verificar dependências disponíveis
  2. Coordenar com skills/MCPs necessários
  3. Executar workflow integrado
Output: [resultado completo com referências]
```

---

## Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```

*Adicionar nova linha após cada erro corrigido.*
