Estrategia de Gestión Multi-Sucursal: ThreeTrackr ↔ Shopify

Resumen Ejecutivo

Este documento define la estrategia de sincronización de inventario entre ThreeTrackr (multi-sucursal) y Shopify (single/multi location).

Situación Actual (v1 - IMPLEMENTADO)

ThreeTrackr

  • Multi-Sucursal: Plan GROW+ permite múltiples branches/sucursales
  • Inventario Distribuido: Cada sucursal tiene su propio inventario
  • Transferencias Internas: Movimientos de inventario entre sucursales
  • Control Granular: Tracking detallado por ubicación

Shopify

  • Single Location: Solo sincroniza con la PRIMERA location de Shopify
  • Inventario Agregado: Suma de todas las sucursales de ThreeTrackr
  • Limitación: No se sincronizan múltiples locations individualmente

Flujo de Sincronización Actual

ThreeTrackr suma el inventario de todas las sucursales y lo envía a la primera location de Shopify como inventario total.

Implicaciones y Recomendaciones

Para el Usuario Final

Configuración Recomendada (Óptima)

Shopify con 1 Location (Principal/Única) que recibe el inventario agregado de ThreeTrackr.

Ventajas:

  • Sincronización simple y confiable
  • Sin conflictos de inventario
  • Fácil de entender y gestionar
  • Shopify muestra inventario total disponible

Configuración NO Recomendada (Problemas)

Shopify con múltiples locations donde solo la primera se sincroniza.

Problemas:

  • Desface de inventario en Shopify
  • Locations adicionales quedan desactualizadas
  • Confusión para el usuario
  • Reportes incorrectos en Shopify

Para el Desarrollador

El código actual obtiene solo la primera location de Shopify y envía el inventario total (suma de todas las branches) a esa location.

Futuro: Sync Multi-Location (v2 - TODO)

Objetivo

Sincronizar cada sucursal de ThreeTrackr con una location específica de Shopify.

Requisitos

  • Plan: ELITE (configuración avanzada)
  • Shopify: Múltiples locations configuradas
  • Mapeo: Branch → Location (configuración manual)

Flujo Propuesto

Cada sucursal de ThreeTrackr se mapea individualmente a una location específica de Shopify, permitiendo sincronización granular.

Funcionalidades Necesarias

1. Configuración de Mapeo

Interface para mapear branches de ThreeTrackr a locations de Shopify con configuración de cuál es la primary.

2. UI de Configuración

Interfaz para configurar el mapeo entre sucursales y locations con opción de sincronización automática.

3. Adapter Actualizado

Nuevo método para sincronizar inventario por location específica en lugar de solo la primera location.

4. Manejo de Transferencias

Cuando se hace transferencia entre branches en ThreeTrackr, actualizar ambas locations correspondientes en Shopify.

Complejidad Estimada

  • Backend: 3-5 días
  • Frontend: 2-3 días
  • Testing: 2 días
  • Documentación: 1 día
  • TOTAL: ~2 semanas

Comparación de Estrategias

Aspecto v1 (Actual) v2 (Futuro)
Complejidad Baja Alta
Plan Requerido GROW+ ELITE
Shopify Locations 1 (recomendado) Múltiples
Inventario Agregado Individual por location
Transferencias Solo en ThreeTrackr Sync con Shopify
Configuración Automática Manual (mapeo)
Casos de Uso 90% usuarios 10% casos avanzados

Checklist de Implementación (v2)

Backend

  • Crear tabla branch_location_mapping en BD
  • Implementar servicio de mapeo
  • Actualizar adapters de Shopify
  • Manejar eventos de transferencias
  • Agregar validaciones

Frontend

  • Crear UI de configuración de mapeo
  • Agregar selector de locations de Shopify
  • Mostrar estado de sincronización por location
  • Agregar toggles de control
  • Documentación in-app

Testing

  • Unit tests para mapeo
  • Integration tests con Shopify API
  • E2E tests de transferencias
  • Tests de fallback (location no encontrada)

Documentación

  • Actualizar docs técnicas
  • Crear guía de usuario
  • Video tutorial
  • FAQ sobre multi-location

Bug Tracking

Issues Conocidos (v1)

1. Múltiples Locations en Shopify

  • Descripción: Si usuario tiene >1 location, solo la primera se usa
  • Impacto: Medio
  • Workaround: Recomendar tener solo 1 location
  • Solución Permanente: v2 (multi-location sync)

2. Desface de Inventario en Re-Sync

  • Descripción: Después de transferencias internas
  • Impacto: Alto
  • Workaround: Modal de confirmación con warnings
  • Estado: MITIGADO

Decisiones de Arquitectura

¿Por qué empezar con v1 (single location)?

Razones Técnicas:

  • Simplicidad: Más fácil de implementar y mantener
  • Menos Bugs: Menos superficie de error
  • Rendimiento: Menos llamadas a Shopify API

Razones de Negocio:

  • 90% de casos de uso: Mayoría de usuarios tiene 1 location en Shopify
  • Time to Market: Lanzar funcionalidad básica rápido
  • Aprendizaje: Entender patrones de uso antes de v2

¿Cuándo implementar v2?

Triggers:

  • >30% de usuarios con múltiples locations en Shopify
  • Demanda de clientes ELITE
  • Competencia ofrece la funcionalidad
  • ROI positivo proyectado

Notas Adicionales

Para el Equipo de Soporte

  • Mensaje clave: "ThreeTrackr maneja múltiples sucursales, pero sincroniza el inventario total con tu location principal de Shopify"
  • FAQ: Mantener solo 1 location en Shopify para mejor gestión
  • Escalación: Si cliente ELITE necesita multi-location, escalar a producto

Para el Equipo de Producto

  • Métrica: Medir cuántos usuarios tienen >1 location en Shopify
  • Feedback: Recolectar pain points sobre limitación actual
  • Roadmap: v2 en Q3 2025 (tentativo)

Última actualización: 2025-01-13

Autor: Equipo ThreeTrackr

Versión: 1.0

Estado: ACTIVO