feat(negocio): adiciona plugin negocio (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:09:26 +00:00
parent 3b59df032b
commit b446fe25fe
43 changed files with 2716 additions and 0 deletions
@@ -0,0 +1,195 @@
+---
+name: ecommerce
+description: Estratégia e arquitectura de e-commerce, desde a escolha de plataforma até optimização de conversão.
+layer: wiki
+---
+
+# 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 |