Igroup ERP Connector

🎯 Objetivo

Plataforma de integração que sincroniza automaticamente, nos dois sentidos, os dados entre sistemas ERP (Primavera, SAP, PHC) e marketplaces (Amazon, eBay, Shopify): produtos, stocks, preços e encomendas. Arquitetura extensível por adapters — adicionar um novo ERP ou marketplace é adicionar um adapter — assente em Node.js + Express sobre Oracle.

✅ Funcionalidades implementadas

Infraestrutura

• API REST em Express (porta 3003), pool de ligações Oracle, configuração por ambiente.
• Schema Oracle (CONNECTORS, PRODUCT_MAPPINGS, ORDER_MAPPINGS, SYNC_LOGS, API_USERS) com bootstrap idempotente que cria um utilizador/schema dedicado.

Integrações (adapters)

• ERP: Primavera, SAP, PHC. Marketplace: Amazon (SP-API), eBay, Shopify.
• Nota: são implementações reais, mas ainda não validadas contra as APIs reais dos fornecedores.

API e sincronização

• CRUD de conectores + teste de ligação; gestão de mapeamentos; histórico e sincronização manual.
• Jobs automáticos: produtos (stocks/preços) a cada 15 min; encomendas a cada 5 min, com prevenção de duplicação.

Já endurecido para produção Fase 1

• Autenticação JWT: login, rotas protegidas, papéis (admin/utilizador), seed de admin.
• Encriptação das credenciais dos conectores em repouso (AES-256-GCM).

Fundações Fase 0 concluída

• Controlo de versões (git) e arranque validado de ponta a ponta contra Oracle real.

◻ Em falta / por fazer

Resiliência e observabilidade resto da Fase 1

• Retry com exponential backoff nas chamadas externas.
• Circuit breaker para pausar conectores com falhas repetidas.
• Logs estruturados (pino), health check aprofundado (BD + jobs), validação de ambiente no arranque.

Qualidade e validação Fase 2–3

• Validar os adapters contra sandboxes/APIs reais (hoje não testados em produção).
• Dívida técnica: ligar SAP/PHC à configuração; estado/envio de encomenda ERP→marketplace (tracking); sincronização incremental (delta).
• Testes automatizados, contentorização (Docker) e CI/CD.

Funcionalidades avançadas Fase 4–5

• Webhooks em tempo real; dashboard "Torre de Controlo" com métricas; multi-tenant.
• Novos adapters (Sage, WooCommerce, etc.); cache/otimizações; documentação OpenAPI.

🧭 Próximos passos

1. Concluir a Fase 1: retry → circuit breaker → logs → health check → validação de ambiente.
2. Fase 2: validar adapters contra ambientes reais e saldar a dívida técnica.
3. Fase 3: testes automatizados + deploy containerizado + pipeline CI.