Sobre este proyecto
it-programming / web-development
Abierto
Contexto general del proyecto
Descripción del Proyecto: Buscamos un desarrollador full-stack experimentado para tomar un prototipo avanzado de una plataforma de comercio electrónico multivendedor y llevarlo a producción. La plataforma, llamada Komka Conect, está diseñada para facilitar las interacciones B2B y B2C entre fabricantes, distribuidores, revendedores ("paseros" o couriers de frontera) y clientes finales, con un fuerte enfoque en la replicación de catálogos, dropshipping, directorios comerciales y operaciones logísticas simplificadas. Estado Actual del Prototipo (Frontend con Next.js y Lógica Simulada): Actualmente, contamos con un prototipo frontend robusto desarrollado con Next.js (App Router), React, TypeScript, ShadCN UI, Tailwind CSS y Genkit (para funcionalidades de IA simuladas). Este prototipo incluye: Interfaz de Usuario Completa: Se han diseñado y maquetado la mayoría de las interfaces de usuario para todas las secciones principales: Landing page moderna y responsiva. Sistema de registro y login por roles (con CAPTCHA simulado). Marketplace de productos con filtros. Páginas de detalle de producto. Formularios de carga de productos detallados y por categorías (general, calzado, indumentaria, electrónicos, alimentos/bebidas, perfumes/cosméticos) con lógica de entrada única en idioma del usuario. Proceso de checkout con simulación de múltiples carritos (un pago por vendedor) y cálculo de tarifa de servicio. Simulación de métodos de pago (transferencia bancaria con validación por IA simulada, MercadoPago, AstroPay, Pix, tarjeta). Directorios públicos (socios comerciales, agentes de aduana, transportistas) con perfiles y búsqueda. Panel de administración global con UI para gestión de usuarios (verificación simulada, impersonación), tiendas, catálogo global, códigos de conexión, finanzas (comisiones, tarifas), dropshipping, moderación de directorios, plantillas de notificación, logs de seguridad, y configuración general. Dashboard del vendedor/proveedor con gestión de tienda (info, visibilidad, temas y colores simulados, logo/banner simulados), gestión de códigos de conexión propios, gestión de proveedores conectados, replicación de productos (con personalización de márgenes, imágenes y textos simulada), visualización de pedidos y reporte de ventas (con carga simulada de documentos). Dashboard del "Pasero" (Courier) con configuración de tarifas (por unidad/bulto/pallet), gestión de códigos de conexión propios y gestión de solicitudes de pase (aceptar, rechazar, actualizar estado, cargar comprobante simulado, generar QR simulado). Simulación de flujo de cliente para solicitar servicio de pasero, seleccionando pedidos y paseros conectados, con cálculo de costos. Tiendas satélite (configuración de UI para nombre, subdominio simulado, tema, logo/banner, ocultar navegación global) con simulación de vista. Lógica Simulada: La mayoría de las funcionalidades del backend (guardado en base de datos, procesamiento de pagos reales, notificaciones reales, sincronización de stock real, etc.) Están simuladas en el frontend usando localStorage, datos de ejemplo (mockData), y toasts para indicar acciones. Internacionalización (i18n): Sistema implementado con React Context para inglés, español y portugués. Las traducciones principales están incrustadas en el contexto para mayor estabilidad en el entorno de desarrollo actual, pero se pueden mover a archivos .json externos. IA (Genkit): Flujos de Genkit implementados para traducción automática de textos (funcional con la API de Gemini) y validación de comprobantes de pago (funcional con la API de Gemini para análisis de imágenes). Trabajos Necesarios (Responsabilidades del Freelancer): El objetivo principal es convertir este prototipo frontend en una aplicación web de producción completamente funcional. Esto implicará: Desarrollo del Backend: Elegir y configurar una solución de backend/base de datos (preferiblemente Firebase o Supabase, pero abiertos a otras opciones si están bien justificadas para Node.js/PostgreSQL). Diseñar e implementar el esquema de la base de datos para todos los modelos de datos (usuarios, productos, tiendas, pedidos, directorios, códigos de conexión, configuraciones, etc.). Desarrollar APIs RESTful o GraphQL para todas las funcionalidades del frontend. Implementar la lógica de negocio del lado del servidor para todas las funcionalidades simuladas en el prototipo, incluyendo: Autenticación segura y gestión de sesiones por roles. CRUD completo para usuarios, productos, tiendas, pedidos, listados de directorio, etc. Sistema de replicación de productos real con herencia de datos y personalización. Sincronización de stock y precios (potencialmente con webhooks o tareas programadas). Lógica de precios mayoristas, minoristas y ofertas. Cálculo y aplicación de comisiones y tarifas de servicio. Sistema de códigos de conexión funcional. Flujo de solicitudes de pase para paseros (creación, gestión de estados, notificaciones). Gestión de tiendas satélite. Sistema de verificación de usuarios (almacenamiento seguro de documentos). Integración con pasarelas de pago reales (MercadoPago, AstroPay, Pix, Stripe para tarjetas), incluyendo la implementación de pagos divididos (o una solución de marketplace) para que los vendedores reciban su parte y la plataforma sus comisiones. Integración Frontend-Backend: Reemplazar todas las llamadas a mockData y localStorage con llamadas a las APIs del backend. Refactorizar las acciones de servidor de Next.js para que interactúen con el backend. Implementar la subida real de archivos (imágenes, documentos) a un servicio de almacenamiento (Firebase Storage, Supabase Storage, etc.). Funcionalidades de IA con Genkit: Asegurar que los flujos de Genkit para traducción y validación de imágenes estén correctamente integrados y optimizados para producción. Potencialmente expandir el uso de IA a otras áreas (ej. Asistente de carga de productos desde texto WhatsApp, moderación de contenido). Notificaciones y Comunicación: Implementar un sistema de notificaciones en tiempo real (ej. Usando Firebase Cloud Messaging o similar) para alertas de pedidos, mensajes, etc. Integrar la funcionalidad de "Contactar al Vendedor" con un sistema de mensajería interna real o asegurar una buena integración con WhatsApp. Seguridad y Despliegue: Implementar medidas de seguridad robustas (autenticación, autorización, protección contra vulnerabilidades comunes). Configurar el entorno de producción y desplegar la aplicación (ej. En Vercel, Firebase Hosting, o el proveedor de nube elegido). Configurar DNS para el dominio principal y los subdominios de tiendas satélite. Pruebas y Optimización: Escribir pruebas unitarias e de integración para el backend. Realizar pruebas E2E para los flujos críticos. Optimizar el rendimiento del frontend y backend. Habilidades Requeridas: Experiencia Avanzada en Next.js y React. Dominio de TypeScript. Sólida experiencia en desarrollo backend con Node.js. Experiencia demostrable con Firebase (Firestore, Functions, Storage, Auth) O Supabase (PostgreSQL, Functions, Storage, Auth). Se valorará la capacidad de recomendar la mejor opción. Experiencia con APIs RESTful/GraphQL. Conocimiento de sistemas de autenticación y autorización (JWT, OAuth). Experiencia en el diseño y gestión de bases de datos (SQL y/o NoSQL). Experiencia con pasarelas de pago y, idealmente, con sistemas de pago dividido o marketplace. Comprensión de los principios de PWA. (Deseable) Experiencia con Genkit o SDKs de IA generativa (Gemini/Vertex AI). (Deseable) Experiencia con Tailwind CSS y ShadCN UI. Buenas prácticas de desarrollo, código limpio y bien documentado. Excelentes habilidades de comunicación y capacidad para trabajar de forma independiente. Entregables Esperados: Una plataforma web completamente funcional y desplegada, basada en el prototipo frontend existente. Código fuente completo y bien documentado para frontend y backend. Configuración de la base de datos. Instrucciones para el despliegue y mantenimiento. Para Aplicar: Por favor, envía tu propuesta incluyendo: Tu experiencia relevante con las tecnologías mencionadas. Ejemplos de proyectos similares que hayas completado. Tu enfoque sugerido para el desarrollo del backend y la elección de la base de datos (Firebase vs. Supabase, u otra alternativa justificada). Una estimación aproximada de tiempo y costo para el proyecto completo. Tu disponibilidad. Estamos buscando un colaborador a largo plazo para este y potencialmente futuros proyectos. ¡Esperamos tu propuesta!
Categoría Programación y Tecnología
Subcategoría Programación Web
¿Cuál es el alcance del proyecto? Cambio mediano
¿Es un proyecto o una posición? Un proyecto
Actualmente tengo Tengo el diseño
Disponibilidad requerida Según se necesite
Integraciones de API Payment Processor (Paypal, Stripe, etc.)
Roles necesarios Programador
Plazo de Entrega: No definido
Habilidades necesarias