Desenvolvimento e Integração de Aplicativo Móvel para Loja de Peças de Bicicleta com Conteúdo

📋 DESCRIÇÃO do projeto
preciso de um desenvolvedor fullstack especializado para finalizar a integração entre meu aplicativo pwa na base44 (react/jsx + tailwind) e minha loja e-commerce na nuvemshop. O aplicativo já está 70% desenvolvido, mas falta a integração crítica com a API da Nuvemshop para sincronização em tempo real de produtos, pedidos e clientes.

📊 contexto atual:
app base44: https://felipe-fitter-e-commerce-02f0b6ce.base44.app/store

Loja Nuvemshop: www.felipefitter.com.br

Status: App funcional, mas sem sincronização real com a loja

🎯 objetivo principal:
implementar integração completa e robusta entre as duas plataformas, permitindo:

sincronização automática de produtos

gerenciamento de pedidos em tempo real

clientes sincronizados

sistema de carrinho funcional

checkout integrado

🔧 requisitos técnicos específicos
1. INTEGRAÇÃO nuvemshop api
javascript
// o desenvolvedor precisará implementar:
- autenticação oauth 2.0 com tokens permanentes
- API Client com rate limiting (Leaky Bucket: 2 req/segundo)
- Webhooks para eventos em tempo real (order/paid, product/updated)
- Sincronização bidirecional de dados
2. tecnologias utilizadas
text
frontend (base44):
• react/jsx
• tailwind css
• base44 sdk (@base44/react)
• indexeddb para offline

backend (base44 functions):
• serverless endpoints
• webhook handlers
• queue system para sync

api externa:
• nuvemshop rest api (2025-03)
• oauth 2.0 authentication
3. FUNCIONALIDADES A IMPLEMENTAR
A. Sistema de Autenticação ✅
javascript
// Já implementado parcialmente, precisa finalizar:
- Login/Logout com Base44 Auth
- Refresh token automático
- Proteção de rotas
B. Sincronização de Produtos 🔄
javascript
// crítico: atualmente os produtos estão hardcoded
- sync automático via api nuvemshop
- paginação (200 produtos/página)
- cache estratégico
- atualização em tempo real via webhooks
c. Carrinho de Compras 🛒
javascript
// Parcialmente implementado, precisa:
- Persistência entre sessões
- Sincronização com Nuvemshop cart
- Modo offline com IndexedDB
- Cálculo de fretes integrado
D. Checkout Completo 💳
javascript
// Atualmente apenas WhatsApp (B2B)
- Implementar checkout B2C
- Múltiplos métodos (PIX, cartão, boleto)
- Integração com gateways de pagamento
- Confirmação automática de pedidos
E. Service Worker & PWA 📱
javascript
// Código existe mas não está ativo
- Ativar Service Worker
- Cache estratégico
- Background sync
- Push notifications
📁 ARQUITETURA DO PROJETO
Entidades Base44 (já existentes):
text
Product:
- nuvemshop_id (string)
- name (string)
- price (number)
- stock (number)
- images (json)

Cart:
- user_id (string)
- items (json)
- status (string)

Order:
- nuvemshop_order_id (string)
- customer_data (json)
- items (json)
- total (number)
- status (string)
Endpoints a criar:
text
POST /api/nuvemshop/sync-products
POST /api/nuvemshop/webhook-handler
GET /api/nuvemshop/orders
POST /api/nuvemshop/create-order