Convergencia Motos — Un ecommerce que entiende el negocio real

Tienda online + taller integrado, hecho a la medida para un taller de motos Hero en Medellín.

El problema que resolvemos

Cuando un cliente llega a Convergencia Motos con su Hero Xpulse, Splendor o Hunk, hay dos necesidades en paralelo:

1. Comprar repuestos o accesorios — filtros, bujías, cascos, guayas, todo lo que su moto necesita.
2. Dejar la moto en el taller — desde un cambio de aceite hasta una reparación completa.

La mayoría de ecommerce resuelven solo lo primero. Nosotros construimos una plataforma que integra las dos líneas de negocio sin que el administrador tenga que manejar 5 herramientas distintas.

┌─────────────────────────────────────────────────────────────┐
│                    CONVERGENCIA MOTOS                       │
├────────────────────────┬────────────────────────────────────┤
│                        │                                    │
│    🛒 ECOMMERCE        │    🔧 TALLER (sub-app interna)    │
│                        │                                    │
│  • Catálogo Hero       │  • Recepción de motos             │
│  • Carrito + pagos     │  • Escaneo de licencia (OCR)      │
│  • Seguimiento orden   │  • Cotización y diagnóstico       │
│  • Rastreo por email   │  • Galería de fotos del proceso   │
│  • Pagos Wompi         │  • Chat con el cliente            │
│    (Nequi, tarjeta,    │  • PDF de orden firmada           │
│     Bancolombia, PSE)  │  • Vista pública para el cliente  │
│                        │    (sin login)                    │
└────────────────────────┴────────────────────────────────────┘

🛒 El ecommerce — lo que el cliente ve

Recorrido del comprador

 Landing → Catálogo → Producto → Carrito → Checkout → Pago Wompi → Confirmación
    │         │          │          │          │           │              │
    │         │          │          │          │           │              ▼
    │         │          │          │          │           │        ✉ Email con
    │         │          │          │          │           │        link de rastreo
    │         │          │          │          │           │
    └─────────┴──────────┴──────────┴──────────┴───────────┘
           Navegación sin fricción, optimizada para móvil

Lo que hace diferente al ecommerce

Pagos multi-método con Wompi

• Tarjeta de crédito/débito
• Nequi (pago asincrónico vía push en el celular)
• Bancolombia Transfer
• PSE (cualquier banco colombiano)

Envío inteligente

• Tarifas dinámicas configurables desde el panel admin
• Envío gratis al superar cierto monto (configurable)
• Cotización en tiempo real según la ciudad/departamento de destino
• Zonas con tarifas específicas + integración con Envia API

Experiencia de tracking de orden

• Cliente recibe un email con un link único
• Página pública de rastreo sin necesidad de login (para compras como invitado)
• Auto-refresh mientras el pago se procesa (crítico para Nequi, que puede tardar minutos)
• Notificaciones por email en cada cambio de estado: pagado, enviado, entregado

Promociones en vivo

• Banners configurables desde admin
• Descuentos por producto con fecha de inicio/fin
• Popup de promoción que aparece al cliente (configurable)
• Cupones con reglas personalizadas

Recuperación de carrito abandonado

Si un cliente deja productos en el carrito y se va, recibe un recordatorio por email automático. Reduce abandono y recupera ventas que se hubieran perdido.

🔧 El taller — la sub-app interna

Esta es la parte que ningún ecommerce estándar ofrece. El equipo del taller usa una app dentro del mismo dominio pero con su propio flujo, diseñada para el día a día operativo.

Flujo de recepción de una moto

┌──────────────┐   ┌──────────────┐   ┌──────────────┐   ┌──────────────┐
│   CLIENTE    │   │   VEHÍCULO   │   │    ORDEN     │   │  SEGUIMIENTO │
│              │ → │              │ → │              │ → │              │
│ • Datos      │   │ • 📷 Foto de │   │ • Servicios  │   │ • Estados    │
│ • Teléfono   │   │   licencia   │   │ • Precios    │   │ • Fotos del  │
│ • Email      │   │ • OCR auto-  │   │ • Firma      │   │   proceso    │
│              │   │   llena datos│   │   digital    │   │ • Chat       │
└──────────────┘   └──────────────┘   └──────────────┘   └──────────────┘

Características que aceleran el trabajo del taller

Escaneo OCR de licencia de tránsito

Operario abre la orden desde el computador → se genera un QR en pantalla → operario escanea el QR con el celular → toma foto de la licencia → Google Cloud Vision API lee los datos (placa, motor, chasis, propietario) → el computador auto-llena el formulario en tiempo real.

Elimina 3-5 minutos de digitación manual por moto y evita errores de transcripción.

 💻 Desktop                📱 Móvil del operario
 ┌──────────┐              ┌──────────┐
 │  Nueva   │   genera     │  Foto de │
 │  orden   │────QR───────▶│ licencia │
 │          │              │          │
 │  Form    │◀──OCR result─│  Sube a  │
 │  auto-   │              │  backend │
 │  lleno   │              │          │
 └──────────┘              └──────────┘
       ▲                         │
       └────────Redis pub/sub────┘
       (la foto se procesa con Google Vision
        y el desktop recibe el resultado)

Vista pública para el cliente

• Al crear la orden, se genera un link único (UUID como token)
• Cliente abre ese link desde su celular SIN cuenta
• Ve: estado actual de su moto, fotos del proceso, totales, firma digital
• Puede chatear con el taller directamente desde ahí

Galería de fotos del proceso

• Mecánicos suben fotos del antes/durante/después del trabajo
• Cliente las ve en su vista pública
• Transparencia total: el cliente confía porque ve lo que pasa

PDF de orden de ingreso firmada

• Al recibir la moto, se genera un PDF con los datos + firma digital del cliente
• Queda archivada como respaldo legal
• Ambas partes tienen el documento

Chat cliente-taller

• El cliente puede preguntar algo desde su vista pública
• El mecánico responde desde el panel del taller
• Reduce llamadas telefónicas y deja historial escrito

Arquitectura — cómo está construido

No usamos una plataforma SaaS cerrada. Todo es código propio, construido para durar y escalar.

┌─────────────────────────────────────────────────────────────────┐
│                         FRONTEND                                │
│                 Next.js 14 + TypeScript + Tailwind              │
│                                                                 │
│   /                    /admin               /taller             │
│   (tienda pública)     (panel admin)        (app del taller)    │
└─────────────────────────────┬───────────────────────────────────┘
                              │
                        HTTPS / REST
                              │
┌─────────────────────────────▼───────────────────────────────────┐
│                          BACKEND                                │
│                   NestJS + TypeORM + JWT                        │
│                                                                 │
│   ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐       │
│   │ Órdenes  │  │  Pagos   │  │  Taller  │  │  Email   │       │
│   │          │  │  Wompi   │  │          │  │ (Resend) │       │
│   └──────────┘  └──────────┘  └──────────┘  └──────────┘       │
│   ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐       │
│   │Inventario│  │  Envíos  │  │ Cupones  │  │Reportes  │       │
│   │(multi-   │  │ Dinámico │  │          │  │ admin    │       │
│   │ bodega)  │  │          │  │          │  │          │       │
│   └──────────┘  └──────────┘  └──────────┘  └──────────┘       │
└───────────┬─────────────────┬───────────────────┬───────────────┘
            │                 │                   │
   ┌────────▼────────┐ ┌──────▼──────┐   ┌────────▼────────┐
   │   PostgreSQL    │ │    Redis    │   │ Google Cloud    │
   │ (datos de       │ │  (cache +   │   │    Vision       │
   │  órdenes,       │ │  sesiones + │   │  (OCR licencias)│
   │  productos,     │ │  OCR)       │   └─────────────────┘
   │  taller)        │ │             │
   └─────────────────┘ └─────────────┘

Servicios externos

Lo que hace al proyecto robusto

1. Pagos confiables end-to-end

El pago no se da por hecho cuando el cliente da clic. Tenemos múltiples mecanismos de confirmación:

Cliente paga ─┬─▶ Wompi webhook ──▶ Actualiza orden a PAID ──▶ Email de confirmación
              │
              ├─▶ Redirect a /checkout/success ──▶ Verifica pago
              │
              └─▶ Reconciliación manual (admin) ──▶ Consulta Wompi → sincroniza

Si algún mecanismo falla, otros lo respaldan. La orden no se marca pagada hasta que Wompi confirma. El cliente no recibe "Orden Confirmada" antes de pagar.

2. Inventario multi-bodega

Convergencia tiene productos en diferentes ubicaciones físicas. El sistema sabe:

• Cuánto hay en cada bodega
• Cuánto está reservado (para órdenes pendientes de pago)
• Cuándo avisar al admin para reabastecer

Reservas automáticas al crear orden, liberación automática si el pago falla.

3. Seguridad y permisos

• Admin: acceso a todo
• Cliente registrado: sus propias órdenes, lista de deseos, direcciones guardadas
• Invitado: puede comprar sin cuenta, rastrea por email + ID de orden
• Taller: panel separado con sus propios permisos

JWT + guards en cada endpoint crítico.

4. Emails transaccionales profesionales

No se usa SMTP casero — va por Resend con plantillas React Email renderizadas server-side:

• Bienvenida al registrar cuenta
• Confirmación de orden (solo cuando se paga)
• Actualización de estado (procesando, enviado, entregado)
• Pago rechazado con instrucciones
• Recuperación de contraseña
• Productos de nuevo en stock
• Carrito abandonado
• Promociones
• Orden del taller creada

Todos con el branding de Convergencia y link de tracking único.

Dashboard admin — las métricas que importan

┌─────────────────────────────────────────────────────────────┐
│  📊 Dashboard                                                │
├─────────────────────────────────────────────────────────────┤
│  Ventas de hoy:      $1.234.000                             │
│  Órdenes del mes:    87 (+23% vs mes anterior)              │
│  Tasa de aprobación: 96.5%                                  │
│  Productos bajos:    5 (requieren reabastecer)              │
├─────────────────────────────────────────────────────────────┤
│  🗺 Mapa de clientes por departamento                       │
│  [mapa de Colombia con puntos donde hay clientes]           │
└─────────────────────────────────────────────────────────────┘

Todo lo que el dueño necesita ver para tomar decisiones, en una sola pantalla:

• Ingresos del día/semana/mes
• Órdenes por estado (pendientes, pagadas, enviadas)
• Tasa de aprobación de pagos
• Inventario con alertas de stock bajo
• Mapa de clientes por ciudad
• Productos más vendidos

Qué viene

• Reportes exportables a Excel/PDF para contabilidad
• Variantes de producto (tallas, colores) para accesorios
• Múltiples direcciones guardadas por cliente
• Integración con transportadoras (rastreo automático de guías)
• Campañas segmentadas por historial de compra

Por qué un ecommerce a la medida

Una plantilla genérica (Shopify, Wix) funcionaría para vender productos. Pero no maneja:

• El flujo del taller con OCR y firma digital
• Tarifas de envío dinámicas por zona colombiana
• Pagos con Nequi y PSE integrados de forma nativa
• Dashboard de inventario multi-bodega
• Chat directo cliente-mecánico

Construir a la medida significa que el software se adapta al negocio, no al revés.