claude-plugins/negocio/skills/ecommerce/SKILL.md

---
name: ecommerce
description: Estratégia e arquitectura de e-commerce, desde a escolha de plataforma até optimização de conversão.
---

# Skill /ecommerce - E-commerce Strategy & Architecture

Skill especializada em estratégia e arquitectura de e-commerce, cobrindo desde a escolha de plataforma até optimização de conversão.

## Sintaxe

```
/ecommerce [operacao] [contexto]
```

**Operações:**
- `analise` - Análise de projecto e-commerce existente ou novo
- `plataforma` - Recomendação de plataforma (WooCommerce vs Shopify vs custom)
- `funil` - Análise e optimização do funil de conversão
- `integracao` - Planeamento de integrações (ERP, pagamentos, logística)
- `pricing` - Estratégia de preços e promoções

## Quando Usar

- Cliente quer abrir loja online
- Optimizar conversão de e-commerce existente
- Integração com ERP/facturação/logística
- Migração entre plataformas
- Estratégia omnichannel

---

## Contexto NotebookLM

ANTES de executar, consultar notebooks para contexto especializado:

| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| E-commerce Prático | 226e384e | Sempre |
| E-Commerce Portugal | 8a430cf2 | Para contexto mercado PT |

```
mcp__notebooklm__notebook_query({
  notebook_id: "226e384e-d4bc-48f4-bb82-7927360436cc",
  query: "<adaptar ao contexto do pedido do utilizador>"
})
```

```
mcp__notebooklm__notebook_query({
  notebook_id: "8a430cf2-ed99-413d-b4bf-a1400deaf49e",
  query: "<adaptar ao contexto do mercado português>"
})
```

Integrar insights do NotebookLM nas recomendações e decisões.

### Procedimentos Relacionados
- Investigação de Mercado disponível em `/media/ealmeida/Dados/Hub/06-Operacoes/Knowledge-Base/Investigacao-Mercado/ecommerce_portugal/` (12 ficheiros)

---

## Protocolo de Execução

### 1. Discovery (SEMPRE começar aqui)

**Questões chave:**
```
Modelo de negócio:
- [ ] B2C, B2B ou D2C?
- [ ] Único vendedor ou marketplace?
- [ ] Produtos físicos ou digitais?

Catálogo:
- [ ] Quantos SKUs?
- [ ] Variações por produto (tamanhos, cores)?
- [ ] Stock centralizado ou múltiplos armazéns?

Volume esperado:
- [ ] Ticket médio?
- [ ] Pedidos/mês estimados?
- [ ] Sazonalidade?

Integrações:
- [ ] ERP existente (PHC, Primavera, SAP)?
- [ ] Gateway pagamento preferido?
- [ ] Transportadoras (CTT, DPD, GLS)?
```

### 2. Escolha de Plataforma

**Matriz de Decisão:**

| Critério | WooCommerce | Shopify | Custom |
|----------|-------------|---------|--------|
| **Custo inicial** | 1.100€ (eCommerceWP) | ~200€/mês | 5.000€+ |
| **Escalabilidade** | Até 5k pedidos/mês | Ilimitado | Ilimitado |
| **Customização** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **Integrações PT** | ⭐⭐⭐⭐ (MB, CTT, Moloni) | ⭐⭐ | ⭐⭐⭐⭐⭐ |
| **Manutenção** | Média (WordPress) | Baixa (hosted) | Alta |
| **Time to market** | 7-9 semanas | 4-6 semanas | 3-6 meses |

**Recomendação Descomplicar:**
- **< 1.000 SKUs + orçamento < 3k** → eCommerceWP (WooCommerce)
- **> 1.000 SKUs + escalabilidade prioritária** → Shopify Plus
- **Processos únicos + integração ERP complexa** → Custom Laravel + Vue

### 3. Arquitectura Técnica

```
┌─────────────┐
│   FRONTEND  │  CDN (Cloudflare)
│   (Site)    │  Cache (Varnish/Redis)
└──────┬──────┘
       │
┌──────▼──────┐
│     API     │  REST/GraphQL
│  (Backend)  │  Rate limiting
└──────┬──────┘
       │
┌──────▼──────────────────┐
│     INTEGRAÇÕES         │
├─────────────────────────┤
│ Pagamentos (Stripe/MB)  │
│ Facturação (Moloni)     │
│ Stock (ERP)             │
│ Envios (CTT/DPD)        │
│ Marketing (GA4/Meta)    │
└─────────────────────────┘
```

### 4. Funil de Conversão

**Benchmarks e Optimizações:**

```
🔍 VISITANTES (tráfego)
   │
   ├─ Bounce Rate < 40% (target)
   │  ► Home clara e rápida (< 2s)
   │  ► Proposta de valor visível
   ▼
📦 PRODUTO (categoria/pesquisa)
   │
   ├─ Add to Cart Rate > 8%
   │  ► Fotos profissionais (min 5 por produto)
   │  ► Descrições completas
   │  ► Reviews e avaliações
   │  ► Stock e prazo entrega visíveis
   ▼
🛒 CARRINHO
   │
   ├─ Cart Abandonment < 70%
   │  ► Recuperação automática (CartRecovery)
   │  ► Custos envio antecipados
   │  ► Checkout em 1 página
   ▼
💳 CHECKOUT
   │
   ├─ Completion Rate > 50%
   │  ► Guest checkout permitido
   │  ► MB Way + Multibanco + Cartão
   │  ► Campos mínimos
   ▼
✅ COMPRA
   │
   ├─ Repeat Rate > 20%
   │  ► Email pós-compra (obrigado)
   │  ► Programa fidelização
   │  ► Recomendações personalizadas
   ▼
🔁 RECOMPRA
```

**Triggers de Abandono (CartRecovery):**
- Email 1h depois: "Esqueceu algo?"
- Email 24h depois: "Ainda disponível" + urgência
- Email 48h depois: Desconto 5-10%

---

## Integrações Essenciais

### Pagamentos (Portugal)

| Gateway | Custo | Tempo Integração | Usar Quando |
|---------|-------|------------------|-------------|
| **MB Way + Multibanco** | Gratuito (IFTHENPAY) | 2h | Obrigatório PT |
| **Stripe** | 1.4% + 0.25€ | 4h | Cartões internacionais |
| **PayPal** | 3.4% + 0.35€ | 1h | Compradores sem cartão |

### Facturação

| Sistema | Custo | Integração | Notas |
|---------|-------|-----------|-------|
| **Moloni** | 15€/mês | API (MCP disponível) | Recomendado Descomplicar |
| **InvoiceXpress** | 20€/mês | API | Mais features |
| **Manual** | Grátis | - | Só para < 10 pedidos/mês |

### Logística

| Transportadora | API | Tracking | Custo Setup |
|----------------|-----|----------|-------------|
| **CTT Expresso** | ✅ | ✅ | 0€ (conta empresa) |
| **DPD Portugal** | ✅ | ✅ | 0€ |
| **GLS** | ✅ | ✅ | 0€ |
| **InPost** | ✅ | ✅ (lockers) | 0€ |

**Recomendação:** Múltiplas opções + cálculo automático no checkout.

### Marketing & Analytics

```javascript
// Stack completo e-commerce
Google Analytics 4 (obrigatório)
Meta Pixel (Facebook/Instagram Ads)
Google Tag Manager (gestão tags)
Hotjar/Microsoft Clarity (heatmaps)
Klaviyo/Mailchimp (email marketing)
```

---

## Métricas Chave (KPIs)

### Conversão

| Métrica | Benchmark | Como Medir |
|---------|-----------|------------|
| **Conversion Rate** | 2-3% | Compras / Visitantes |
| **Add to Cart Rate** | 8-12% | Adicionar carrinho / Views produto |
| **Cart Abandonment** | 65-70% | Carrinhos abandonados / Total |
| **Checkout Completion** | 50-60% | Compras / Início checkout |

### Receita

| Métrica | Fórmula | Target |
|---------|---------|--------|
| **AOV** (Avg Order Value) | Receita / Nº pedidos | Sector-dependent |
| **CLV** (Customer Lifetime Value) | AOV × Compras médias × Margem | > 3× CAC |
| **CAC** (Customer Acquisition Cost) | Investimento marketing / Novos clientes | < 1/3 CLV |
| **Repeat Purchase Rate** | Clientes repetentes / Total clientes | > 20% |

### Operacional

```
- Stock turnover: Vendas / Stock médio (> 6× ano)
- Order fulfillment time: < 24h
- Return rate: < 5%
- Customer support tickets/order: < 10%
```

---

## Checklist Lançamento E-commerce

**Pré-Lançamento:**
```
[ ] Catálogo completo (fotos + descrições + preços)
[ ] Stock actualizado e sincronizado
[ ] Políticas publicadas (devolução, privacidade, T&C)
[ ] Gateways pagamento testados (transações reais)
[ ] Envios configurados e custos correctos
[ ] Emails transaccionais personalizados
[ ] SSL activo em todo o site
[ ] Mobile responsive verificado
```

**Marketing:**
```
[ ] Google Analytics 4 instalado e a rastrear
[ ] Meta Pixel activo
[ ] Google Merchant Center configurado
[ ] SEO básico (títulos, meta descriptions, structured data)
[ ] Sitemap XML enviado
```

**Operacional:**
```
[ ] Teste end-to-end (compra completa)
[ ] Processo de fulfillment documentado
[ ] Equipa treinada (gestão pedidos + suporte)
[ ] Plano de contingência (stock out, pagamentos falhados)
```

---

## Integração com Descomplicar

### Pacote eCommerceWP

**Incluído (1.100€ setup + 349€/ano):**
- WooCommerce configurado
- MB Way + Multibanco (IFTHENPAY)
- 3 gateways envio
- Integração Moloni (facturação)
- 50 produtos configurados
- Google Analytics 4
- Meta Pixel

**Add-ons Comuns:**
```
ShopBuilder: 5€/produto extra (> 50)
CartRecovery: 190€ setup + 90€/ano
Subscriptions: 150€ (produtos recorrentes)
Marketplaces (Amazon/eBay): 300€ integração
```

### Workflow Projecto

```
1. Discovery (2-3h)
   - Questionário cliente
   - Análise concorrência
   - Proposta plataforma

2. Planeamento (1 semana)
   - Arquitectura técnica
   - Mapeamento integrações
   - Wireframes checkout

3. Desenvolvimento (4-6 semanas)
   - Setup plataforma
   - Design frontend
   - Configuração produtos
   - Testes pagamentos

4. Lançamento (1 semana)
   - Migração dados (se aplicável)
   - Testes finais
   - Formação cliente
   - Go-live
```

---

## Consultar Datasets Dify

**SEMPRE antes de propor solução:**

| Dataset | ID | Query Exemplo |
|---------|----|--------------:|
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | "funil conversao ecommerce optimizacao" |
| **Vendas** | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | "estrategia pricing loja online" |
| **Desenvolvimento WebSites** | `c8489151-de94-42b2-8cee-c0b961cfac6d` | "woocommerce gateways pagamento portugal" |
| **Serviços Descomplicar** | `bd65f36e-6004-4584-b478-129b2c21b4d2` | "pacote ecommerce funcionalidades" |

### Como Consultar

```javascript
// Estratégia de conversão
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
  query: "optimizar taxa conversao checkout abandono carrinho",
  retrieval_mode: "hybrid_search",
  top_k: 5
});

// Pricing e margens
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
  query: "estrategia precos markup ecommerce",
  retrieval_mode: "hybrid_search",
  top_k: 5
});
```

---

## MCPs Utilizados

```
mcp__desk-crm-v3__get_projects       # Verificar projectos e-commerce
mcp__desk-crm-v3__create_estimate    # Orçamento eCommerceWP
mcp__dify-kb__dify_kb_retrieve_segments  # Conhecimento estratégico
mcp__moloni__*                       # Integração facturação
mcp__web-fetch__*                    # Análise concorrência
```

---

## Exemplos de Uso

### 1. Novo Projecto E-commerce
```
/ecommerce analise
→ Discovery interactivo
→ Consulta Dify KB (benchmarks sector)
→ Recomendação plataforma
→ Proposta Descomplicar (orçamento)
```

### 2. Optimização Conversão
```
/ecommerce funil
→ Análise métricas actuais (GA4)
→ Identificação bottlenecks
→ Recomendações prioritizadas (quick wins)
→ Plano implementação
```

### 3. Integrações
```
/ecommerce integracao
→ Levantamento sistemas existentes
→ Mapeamento fluxos dados
→ Proposta arquitectura
→ Timeline e custos
```

---

## Agentes Recomendados

Para análises complexas, delegar a agentes:

```javascript
// Estratégia marketing
Task({
  subagent_type: "marketing-planning-expert",
  model: "sonnet",
  prompt: "Analisar funil e-commerce [URL]. Propor optimizações conversion rate."
});

// Arquitectura técnica
Task({
  subagent_type: "php-fullstack-engineer",
  model: "sonnet",
  prompt: "Integração WooCommerce → Moloni → CTT API. Arquitectura e fluxo."
});
```

---

## Instrumentação Automática

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

### Baseline

| Métrica | Valor |
|---------|-------|
| Tempo baseline | 40 min |
| Tempo target | 20 min |
| Melhoria esperada | -50% |

### 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', '/ecommerce', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```

### Ver Métricas

```bash
/metrics /ecommerce
```

---

**Versão**: 2.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
**Instrumentação**: Activa