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

name, description, author, version, quality_score, user_invocable, desk_task, allowed-tools

name	description	author	version	quality_score	user_invocable	desk_task	allowed-tools
ecommerce	Skill especializada em estratégia e arquitectura de e-commerce, cobrindo desde a escolha de plataforma até optimização de conversão.	Descomplicar® Crescimento Digital	2.0.0	55	true	null	Task

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

---

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

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

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

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

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

/metrics /ecommerce

---

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