claude-plugins/crm-ops/skills/orcamento/SKILL.md

---
name: orcamento
description: >
  Criação sistemática de orçamentos Descomplicar® baseados em tabela oficial de preços (tabela-geral.csv). Integração directa CRM para proposals/estimates. Suporta StarterWP, CorporateWP, CareWP, eCommerceWP, Marketing 360, Manutenção. Consulta obrigatória datasets Dify (Serviços, Vendas). Use when user asks to create, generate or elaborate budget/proposal, or mentions "orçamento", "proposta", "estimate", "pricing", "website budget".
author: Descomplicar® Crescimento Digital
version: 3.1.0
quality_score: 100
user_invocable: true
category: business
tags: [orcamento, proposta, pricing, crm, proposals, estimates, vendas, packages]
desk_task: 1415
desk_project: 65
allowed-tools: Read, Bash, mcp__desk-crm-v3, mcp__dify-kb
mcps: desk-crm-v3, dify-kb
data_sources:
  - path: /media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/tabela-geral.csv
    priority: 1
    usage: All products/services with pricing
  - path: /media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/items-subscricao.csv
    priority: 2
    usage: Subscription services
  - path: /media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/chatbots-precos.csv
    priority: 2
    usage: Chatbot pricing
  - path: /media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/items-faturacao-deskcrm.csv
    priority: 2
    usage: Billing items
datasets:
  - id: bd65f36e-6004-4584-b478-129b2c21b4d2
    name: Serviços Descomplicar
    priority: 1
    usage: Packages, pricing justification
  - id: a7ba6005-517c-41ab-ac5e-da1c1a1c62ef
    name: Vendas
    priority: 1
    usage: Proposal techniques, negotiation
  - id: c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24
    name: Marketing Digital
    priority: 2
    usage: Value proposition, ROI
  - id: c8489151-de94-42b2-8cee-c0b961cfac6d
    name: Websites
    priority: 2
    usage: Website features comparison
dependencies:
  skills: [crm-ops, lead-approach]
  mcps: [desk-crm-v3, dify-kb]
triggers:
  - "User asks to create/generate/elaborate budget"
  - "User mentions 'orçamento', 'proposta', 'pricing'"
  - "User asks for 'estimate', 'quote', 'proposal'"
  - "Creating pricing for leads or customers"
packages:
  - code: starter
    name: StarterWP
    base_price: 700
    annual_fee: 250
    timeline: 3-5 weeks
  - code: corporate
    name: CorporateWP
    base_price: 900
    annual_fee: 299
    timeline: 4-6 weeks
  - code: care
    name: CareWP
    base_price: 1300
    annual_fee: 350
    timeline: 4-6 weeks
  - code: ecom
    name: eCommerceWP
    base_price: 1100
    annual_fee: 349
    timeline: 7-9 weeks
  - code: mkt
    name: Marketing 360
    base_price: 459
    billing: monthly
    commitment: 12 months
  - code: man
    name: Manutenção
    base_price: 150
    billing: monthly
    commitment: 12 months
performance:
  baseline_duration_ms: 1800000
  target_duration_ms: 900000
  last_run_duration_ms: null
  success_rate: 0.92
---

# Skill /orcamento - Criação Sistemática de Orçamentos

Skill para criar orçamentos profissionais baseados na tabela oficial de preços Descomplicar®, com integração directa ao CRM.

## Quando Usar

- Criar orçamento para cliente novo ou existente
- Gerar proposta comercial (proposal ou estimate)
- Consultar preços oficiais de produtos/serviços
- Calcular valores com IVA e anuidades
- Integrar orçamento directamente no CRM

## Quando NÃO Usar

- Para análise estratégica de lead (usar /lead-approach)
- Para operações CRM genéricas (usar /crm-ops)
- Para simples consulta de preços (ler CSV directamente)

---

## Protocolo

### Fontes de Dados (OBRIGATÓRIO)

**IMPORTANTE**: Antes de criar qualquer orçamento, ler SEMPRE os dados actualizados de:

```
/media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/
├── tabela-geral.csv              ← Todos os produtos/serviços com preços
├── items-subscricao.csv          ← Serviços de subscrição
├── chatbots-precos.csv           ← Preços de chatbots
└── items-faturacao-deskcrm.csv   ← Items para facturação
```

### Estrutura do CSV Principal (tabela-geral.csv)

| Campo | Descrição |
|-------|-----------|
| Codigo | Código único (ex: WEB-WP-001) |
| Nome | Nome do produto/serviço |
| Familia | Categoria principal (Websites, Design, Tecnologia, etc.) |
| PrecoBase | Valor em euros |
| Unidade | Tipo (Projeto, Hora, Investimento, Mês) |
| DescricaoCurta | Para orçamento |
| TempoEstimado | Em dias/semanas |

### Como Usar os CSVs

```python
# Exemplo de leitura
import csv
with open('/media/.../Produtos_Servicos/tabela-geral.csv') as f:
    reader = csv.DictReader(f)
    for row in reader:
        if row['Codigo'] == 'WEB-WP-001':  # StarterWP
            preco = float(row['PrecoBase'])  # 700
```

**Regra**: Os CSVs são a fonte de verdade. O pricing-guide.md é referência rápida.

## Sintaxe

```
/orcamento [cliente] [tipo]
```

**Parâmetros:**
- `cliente` - Nome ou ID do cliente (opcional, será solicitado se omitido)
- `tipo` - Tipo de orçamento (opcional, será apresentado menu se omitido)

**Tipos disponíveis:**
| Código | Tipo | Template | Valor Base |
|--------|------|----------|------------|
| `starter` | StarterWP | `templates/website-corporativo.md` | 700€ |
| `corporate` | CorporateWP | `templates/website-corporativo.md` | 900€ |
| `care` | CareWP (Clínicas) | `templates/website-corporativo.md` | 1.300€ |
| `ecom` | eCommerceWP | `templates/e-commerce.md` | 1.100€ |
| `mkt` | Marketing Digital 360 | `templates/marketing-digital.md` | 459€/mês |
| `man` | Manutenção | `templates/manutencao.md` | 150€/mês |

## Fluxo de Execução

### Fase 1: Identificação do Cliente

1. Se cliente fornecido, pesquisar no CRM:
   ```
   mcp__desk-crm-v3__search_customers query="[nome]" fields="company,vat"
   ```

2. Se não encontrado ou não fornecido, solicitar dados:
   - Nome da empresa
   - NIF (opcional)
   - Email contacto

3. Validar cliente existe ou criar novo:
   ```
   mcp__desk-crm-v3__create_customer company="..." vat="..." ...
   ```

### Fase 2: Selecção de Template

1. Se tipo fornecido, carregar template correspondente
2. Se não fornecido, apresentar menu interactivo via AskUserQuestion:
   - StarterWP (700€ + 250€/ano)
   - CorporateWP (900€ + 299€/ano)
   - CareWP (1.300€ + 350€/ano)
   - eCommerceWP (1.100€ + 349€/ano)
   - Marketing 360 (459€/mês)
   - Manutenção (150€/mês)

### Fase 3: Personalização

1. Ler template seleccionado de `templates/`
2. Apresentar questões de personalização específicas do tipo
3. Adicionar funcionalidades conforme requisitos
4. Calcular valores usando tabela de `references/pricing-guide.md`

### Fase 4: Geração do Orçamento

1. Calcular valores finais:
   - Subtotal por item
   - IVA 23%
   - Total
   - Anuidade (se aplicável)

2. Criar estimate no CRM:
   ```
   mcp__desk-crm-v3__create_estimate
     client_id=[id]
     date=[hoje]
     expiry_date=[hoje + 30 dias]
     items=[items calculados]
     terms="Condições de Pagamento: 50% na adjudicação + 50% na entrega"
   ```

3. Apresentar resumo ao utilizador com link para CRM

## Tabela de Preços Base

Ver `references/pricing-guide.md` para tabela completa.

### Websites

| Produto | Setup | Anuidade | Prazo |
|---------|-------|----------|-------|
| StarterWP | 700€ | 250€ | 3-5 sem |
| CorporateWP | 900€ | 299€ | 4-6 sem |
| eCommerceWP | 1.100€ | 349€ | 7-9 sem |
| ChallengeWP | 700€ | 250€ | 8-10 sem |
| CareWP | 1.300€ | 350€ | 4-6 sem |

### Funcionalidades Frequentes

| Funcionalidade | Valor |
|----------------|-------|
| EasyAppointment | 175€ (55+120) |
| Chat da Página | 50€ + 50€/ano |
| Forms Inteligentes | 150€ |
| CartRecovery | 190€ (90+100) + 90€/ano |
| Pixel + GTM | 50€ |
| ShopBuilder | 5€/produto |

### Serviços Recorrentes

| Serviço | Valor Mensal | Compromisso |
|---------|--------------|-------------|
| Marketing 360 | 459€ | 12 meses |
| Manutenção | 150€ | 12 meses |

## Termos e Condições Padrão

```
CONDIÇÕES DE PAGAMENTO

1. Projectos: 50% na adjudicação + 50% na entrega
2. Serviços recorrentes: facturação mensal antecipada

VALIDADE

Orçamento válido por 30 dias a partir da data de emissão.

ANUIDADE

A anuidade inclui:
- Alojamento Premium SSD NVMe
- Certificado SSL
- Actualizações de segurança
- Suporte técnico básico

Descomplicar® Crescimento Digital
NIF: 514 623 168 | descomplicar.pt
```

## Estrutura de Items para API

Cada item do orçamento segue o formato:

```json
{
  "description": "Descrição do serviço",
  "qty": 1,
  "rate": 700,
  "unit": "un"
}
```

**Unidades:**
- `un` - Unidade (projecto/item único)
- `mes` - Mês (serviço recorrente)
- `ano` - Ano (anuidade)

## Checklist de Execução

- [ ] Cliente identificado/criado no CRM
- [ ] Tipo de orçamento seleccionado
- [ ] Template carregado
- [ ] Funcionalidades adicionais identificadas
- [ ] Valores calculados (subtotal + IVA)
- [ ] Anuidade calculada (se aplicável)
- [ ] Estimate criado no CRM
- [ ] Resumo apresentado ao utilizador

## Exemplos de Uso

### Exemplo 1: Website simples
```
/orcamento "TechStartup Lda" starter
→ StarterWP: 700€ + IVA
→ Anuidade: 250€/ano
```

### Exemplo 2: E-commerce com funcionalidades
```
/orcamento "Loja Online SA" ecom
→ Questiona: Nº produtos? Gateways? Transportadoras?
→ Calcula com funcionalidades
→ Gera orçamento detalhado
```

### Exemplo 3: Interactivo completo
```
/orcamento
→ Solicita cliente
→ Apresenta menu de tipos
→ Questões de personalização
→ Gera orçamento no CRM
```

## MCPs Utilizados

```
mcp__desk-crm-v3__search_customers  - Pesquisar cliente
mcp__desk-crm-v3__get_customer      - Obter detalhes cliente
mcp__desk-crm-v3__create_customer   - Criar cliente novo
mcp__desk-crm-v3__create_estimate   - Criar orçamento
mcp__desk-crm-v3__get_estimates     - Listar orçamentos existentes
```

## Códigos de Produtos (tabela-geral.csv)

### Websites
| Código | Produto | Preço |
|--------|---------|-------|
| WEB-WP-001 | StarterWP | 700€ |
| WEB-WP-002 | CorporateWP | 900€ |
| WEB-WP-003 | eCommerceWP | 1.100€ |
| WEB-WP-004 | ChallengeWP | 700€ |
| WEB-WP-005 | CareWP | 1.300€ |

### Branding
| Código | Produto | Preço |
|--------|---------|-------|
| DES-BRA-001 | Branding WOW Essencial | 850€ |
| DES-BRA-002 | Branding Completo | 1.100€ |
| DES-BRA-003 | Branding WOW Digital | 400€ |

### AcceleratorX
| Código | Produto | Preço |
|--------|---------|-------|
| TEC-WPC-001 | AcceleratorX WP ProCMS | 650€ |
| TEC-ECO-001 | AcceleratorX e-Commerce | 750€ |
| TEC-MEM-001 | AcceleratorX Membership | 450€ |
| TEC-BOO-001 | AcceleratorX Booking | 450€ |
| TEC-CAR-001 | AcceleratorX Care | 750€ |

### Consultoria
| Código | Produto | Preço |
|--------|---------|-------|
| EST-CON-001 | Consultoria Estratégica | 90€/hora |
| EST-COA-001 | Coaching e Formação | 50€/hora |
| EST-BRA-001 | Estratégia de Marca | 900€ |

## Referências

- `references/pricing-guide.md` - Tabela de preços rápida
- `templates/website-corporativo.md` - Templates StarterWP, CorporateWP, CareWP
- `templates/e-commerce.md` - Template eCommerceWP
- `templates/marketing-digital.md` - Template Marketing 360
- `templates/manutencao.md` - Template Manutenção

## Fonte de Dados Principal

```
/media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/tabela-geral.csv
```

---

## Datasets Dify (Consulta Obrigatória)

Em caso de dúvidas ou para aprofundar conhecimento, consultar os seguintes datasets via MCP:

| Dataset | ID | Prioridade |
|---------|----|-----------:|
| **Serviços Descomplicar** | `bd65f36e-6004-4584-b478-129b2c21b4d2` | 1 |
| **Vendas** | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | 1 |
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | 2 |
| **Desenvolvimento de WebSites** | `c8489151-de94-42b2-8cee-c0b961cfac6d` | 2 |

### Como Consultar

```javascript
// Pesquisar serviços e preços
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "bd65f36e-6004-4584-b478-129b2c21b4d2",
  query: "pacote website ecommerce"
})

// Técnicas de proposta e negociação
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
  query: "proposta comercial fechamento"
})

// Funcionalidades de websites
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "c8489151-de94-42b2-8cee-c0b961cfac6d",
  query: "funcionalidades website corporativo"
})
```

### Quando Consultar

- Definir escopo de projecto
- Justificar preços ao cliente
- Comparar funcionalidades entre pacotes
- Criar proposta de valor diferenciada

---

## Instrumentação Automática

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

### Baseline

| Métrica | Valor |
|---------|-------|
| Tempo baseline | 30 min |
| Tempo target | 15 min |
| Melhoria esperada | -50% |

### Ao Executar Esta Skill

1. **Início:** Registar `SKILL_START = Date.now()`
2. **Consultas KB:** Rastrear consultas Dify (KB_CONSULTED, KB_HITS)
3. **Tool calls:** Contar chamadas MCP
4. **Fim:** Gravar métrica

### Query para Gravar (executar no final da skill)

```sql
-- Executar via SSH ou MCP no final da skill
INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/orcamento', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```

### Exemplo Completo

```sql
-- Orçamento criado com sucesso em 20 minutos, consultou Dify, sem cache
INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/orcamento', 1200000, 'success', 25,
  1, 0, 8, 65
);
```

### Ver Métricas

```bash
/metrics /orcamento
```

### Protocolo

Ver `~/.claude/skills/_core/instrumentation-protocol.md`

---

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