DESCRIPCIÓN GENERAL
Buscamos desarrollador full-stack (o equipo pequeño) para construir una plataforma web conectada a un motor de datos en tiempo real ya contratado (tercero vía API). El alcance es todo el sitio: frontend, backend, usuarios, billetera y operaciones.
No se desarrolla el motor. Solo la integración.
⸻
ALCANCE PRINCIPAL
• Sitio web completo (mobile-first)
• Registro y login con teléfono + OTP SMS
• Billetera digital (depósitos, saldo en tiempo real, retiros)
• Integración de pagos (Paystack)
• Consumo de datos en tiempo real (API externa)
• Panel de interacción tipo carrito/orden
• Historial de actividad (ganancias/pérdidas)
• Sistema de promociones y referidos
• Panel de administración
• Sección comunitaria y contenido
⸻
PÁGINAS CLAVE
Públicas:
• Home (hero, eventos en vivo, promos, trust)
• Catálogo de eventos
• Feed en vivo
• Promociones
• Resultados
• Registro / Login
• FAQ / uso responsable
Autenticadas:
• Dashboard (saldo + actividad)
• Billetera (transacciones)
• Depósito / Retiro
• Entradas activas
• Historial
• Perfil (seguridad + verificación)
Extra:
• Comunidad (leaderboard, referidos)
• Contenido (videos/análisis)
• Admin (usuarios, transacciones, promos)
⸻
MOBILE-FIRST (CRÍTICO)
• Diseño base: 375px
• Navegación inferior (5 tabs)
• Panel tipo drawer en móvil
• Touch mínimo: 44x44px
• Carga < 3s en 3G
• Core Web Vitals optimizados
• Imágenes WebP + lazy load
• Sin autoplay en móvil
⸻
BILLETERA Y PAGOS
• Saldo en tiempo real
• Wallet principal + bonos separados
• Depósitos vía Paystack (webhooks)
• Retiros automáticos (API transferencia)
• Registro completo de transacciones
• Motor de bonos (reglas + expiración)
⸻
PANEL DE INTERACCIÓN
• Persistente en toda la app
• Desktop: sidebar / Mobile: drawer
• Modo simple y múltiple
• Cálculo en tiempo real
• Validación de saldo antes de enviar
• Confirmación con ID único
⸻
PROMOCIONES Y REFERIDOS
• Bono de bienvenida
• Sistema de referidos
• Bonos por multi-entrada
• Seguro parcial en fallos
• Código único por usuario
• Motor de reglas (condiciones + expiración)
⸻
RENDIMIENTO Y ESCALABILIDAD
• API <200ms cache / <800ms DB
• Soporte: 5,000 usuarios concurrentes
• Arquitectura stateless
• Escalable horizontalmente
• Colas para retiros/notificaciones
• Índices en DB optimizados
⸻
SEGURIDAD
• bcrypt (12 rounds)
• JWT + refresh tokens
• Rate limiting
• Validación de inputs
• Webhook verification (Paystack)
• HTTPS obligatorio
• Secrets en .env
• Logs de auditoría
⸻
INTEGRACIÓN (PROVEEDOR EXTERNO)
• Servicio dedicado (/lib/provider/)
• Sin llamadas directas desde UI
• Mock API durante desarrollo
• Provider conecta post-entrega
• No se desarrolla lógica del motor
Endpoints incluyen:
• Eventos, feeds en vivo, detalles
• Envío de interacción
• Estado de entradas
• Resultados (webhook)
⸻
ENTREGABLES
• Plataforma funcional (staging)
• Código en GitHub
• DB + datos de prueba
• Mock API
• Documentación + .env.example
• Admin panel
• Guía de deploy
• 1 semana soporte post-entrega
Estándares:
• TypeScript (sin any)
• Zod validation
• Manejo de errores/loading
• API consistente
• Código limpio + README completo
⸻
PERFIL IDEAL
Requerido:
• Next.js + TypeScript (proyectos reales)
• Paystack (obligatorio)
• Fintech/e-commerce experience
• UX mobile-first
• PostgreSQL + Prisma
• Integración APIs
• Deploy (Vercel o similar)
Plus:
• WebSockets / real-time
• UI/UX completo
• Alta concurrencia
Show More