Avance del proyecto Mi Tienda SM · versión 0.19.0
Avance del proyecto
Mi Tienda SM
Avance general estimado
1Resumen ejecutivo
Mi Tienda SM está diseñado para sustituir progresivamente a SICAR y centralizar toda la operación de Vaqueros SM en un solo sistema.
- Punto de venta
- Inventario por sucursal
- Catálogo y variantes
- Clientes
- Empleados, roles y permisos
- Caja y cortes
- Devoluciones y cambios
- Traspasos entre tiendas
- Etiquetas y códigos de barras
- Tickets impresos y digitales
- Integración SICAR y WooCommerce
- Reportes, apartados y lealtad
El sistema ya cuenta con una base técnica y de seguridad sólida, catálogo funcional, clientes, usuarios e inventario inicial conectado.
2Estado actual del sistema
- Publicado en Vercel
- Conectado a Supabase
- Aplicación web instalable
- Adaptado a teléfono, iPad y computadora
- Protegido mediante inicio de sesión
- Preparado para múltiples sucursales
- Ambientes separados de producción y pruebas
- Validación automática antes de publicar cambios
3Avance por módulos
| Módulo | Avance | % | Estado |
|---|---|---|---|
| Infraestructura y calidad | 100% | Terminado | |
| Seguridad, empleados y roles | 100% | Terminado | |
| Catálogo y productos | 100% | Falta validación física | |
| Etiquetas y códigos | 90% | Falta prueba con hardware | |
| Clientes e identidad digital | 85% | Núcleo terminado | |
| Inventario | 40% | En desarrollo | |
| Punto de venta | 15% | Interfaz existente; backend pendiente | |
| Apartados, crédito y puntos | 15% | Identidad lista; reglas pendientes | |
| Reportes y tickets digitales | 15% | Interfaz preliminar | |
| Caja y cortes | 10% | Interfaz inicial | |
| Devoluciones y cambios | 10% | Especificado | |
| Migración de SICAR | 5% | Diseño listo; archivo pendiente | |
| Integración con WooCommerce | 5% | Campos listos; conexión pendiente | |
| Compras y proveedores | 0% | Fase posterior |
Los porcentajes son estimaciones de implementación funcional, no sólo de diseño visual.
terminados
y auditable
y bitácora
sucursales
4Infraestructura y calidad — 100%
Ya está construida la base técnica necesaria para desarrollar el sistema con seguridad.
- Next.js y TypeScript
- PostgreSQL en Supabase
- Despliegue automático en Vercel
- Repositorio central en GitHub
- Producción separada de pruebas
- Migraciones versionadas
- Pruebas automatizadas
- Validación de formato, tipos y compilación
- Pruebas en teléfono, iPad y computadora
- Ramas, revisiones y PR
- Documentación permanente
Actualmente existen 33 migraciones versionadas de base de datos.
5Seguridad, sucursales y empleados — 100%
Estructura de seguridad preparada para operación real, con cuatro roles definidos.
- Inicio de sesión con Supabase Auth
- Empleados con cuentas individuales
- Sucursales independientes y asignación por sucursal
- Permisos granulares y restricciones desde la base
- Principio de mínimo privilegio
- Bitácora de acciones sensibles
- PIN de supervisor para operaciones delicadas
- Bloqueo temporal tras varios intentos incorrectos
Un cajero no puede otorgarse permisos, cambiar precios o consultar sucursales no autorizadas únicamente modificando la interfaz.
6Clientes e identidad digital — 85%
Ya se desarrolló la base del módulo de clientes, con tarjeta digital, QR real y código de barras CODE128.
- Registro y edición de clientes
- Búsqueda por nombre, teléfono, correo o socio
- Detección de teléfonos duplicados
- Normalización de números mexicanos
- Número de socio con dígito verificador
- Asociación desde el carrito del POS
- Consentimiento de privacidad y marketing
- PWA de cliente en /mi
- Acceso sin contraseña por correo
- Tarjeta digital con QR y CODE128
- Número de socio sin conexión
- Cada cliente ve sólo su tarjeta
Pendiente
- Dominio exclusivo para clientes
- Proveedor de SMS
- Personalizar correos
- Validar QR y código con lectores reales
- Historial de compras
- Puntos, recompensas, crédito y apartados
7Catálogo y productos — 100% en software
El catálogo ya se encuentra conectado a la base de datos, con matriz completa de talla × color.
- Alta de productos, marcas y categorías
- Costos y precios
- Productos activos e inactivos
- Variantes por talla y color
- Productos de talla única
- Matriz de combinaciones
- Agregar variantes a productos existentes
- Permisos separados para precio y costo
- Selección múltiple
- Cambio de precios por lote
- Activación por lote
- Carga masiva CSV y XLSX
- Validación previa antes de guardar
- Confirmación atómica de la carga
- Prevención de duplicados
- Identidades internas protegidas
- Campos para SICAR y WooCommerce
La implementación evita que una misma talla y color aparezcan dos veces dentro del mismo producto, incluso si dos operaciones intentan registrarla simultáneamente.
8Códigos, cámara y etiquetas — 90%
- Generación automática de códigos
- Códigos adicionales del proveedor
- Conservación de códigos anteriores
- Búsqueda por código
- Escaneo con cámara desde Productos
- Respaldo compatible con Safari e iPhone
- Linterna cuando el dispositivo lo permite
- Cierre automático tras la lectura
- Plantillas de etiquetas en base
- Configuración de medidas físicas
- Impresión individual y masiva
- Reimpresión sin cambiar identidad
Pendiente de validación física
9Inventario — 40%
La primera parte del inventario ya está terminada y desplegada: existencias por sucursal y libro inmutable de movimientos.
- Existencias separadas por sucursal
- Cantidad física, reservada y disponible
- Libro inmutable de movimientos
- Historial por producto y sucursal
- Ajustes de inventario
- Conteo rápido
- Motivo obligatorio por ajuste
- Registro del empleado responsable
- Fecha y hora del movimiento
- Validación de permisos y sucursal
- Protección contra operaciones simultáneas
- Consulta automática de diferencias
Ninguna existencia puede modificarse directamente: todo cambio debe generar un movimiento auditable.
Pendiente dentro de inventario
- Conteos físicos formales
- Conteos por sección o categoría
- Congelamiento durante conteos
- Aprobación de diferencias
- Traspasos entre sucursales
- Preparación y recepción de mercancía
- Ubicación virtual en tránsito
- Diferencias al recibir
- Cancelaciones de traspasos
- Operación sin conexión
10Punto de venta — 15%
La interfaz visual del POS ya existe y está adaptada para uso táctil, pero el motor definitivo de ventas todavía no se encuentra conectado.
Interfaz táctil completa
Búsqueda de productos, carrito, selección de cliente, resumen de venta, navegación en teléfono/iPad/computadora, vista previa de ticket y pantallas de cobro.
Motor de ventas real
Venta guardada en base, folio único, precio leído del servidor, descuentos con autorización, pagos mixtos, prevención de doble cobro, descuento automático de inventario y ticket real.
11Caja, devoluciones y compras
Interfaz inicial
Contemplará cajas físicas, apertura de turno, fondo inicial, entradas y salidas, total esperado vs. contado, diferencia, corte por cajero y sucursal, y prevención de ventas sin caja abierta.
Especificado
Devolución total o parcial, cambio de talla o color, cobro de diferencias, cancelación autorizada, motivo obligatorio y movimiento inverso de inventario.
Fase posterior
Proveedores, órdenes de compra, recepción total o parcial, diferencias, costos de compra e impresión de etiquetas desde la recepción.
La venta original nunca se eliminará ni se modificará. Las correcciones se registrarán mediante operaciones compensatorias. Igualmente, una orden de compra no aumentará existencias hasta que la mercancía sea recibida físicamente.
12Apartados, crédito y lealtad — 15%
La identidad del cliente y su tarjeta digital ya están construidas. Falta definir e implementar las reglas comerciales.
- Apartados y enganche inicial
- Abonos y saldo pendiente
- Fecha de vencimiento
- Mercancía reservada
- Cancelación y liberación
- Historial de compras
- Puntos y recompensas
- Descuento de cumpleaños
- Niveles de cliente
- Crédito y límite autorizado
Estas funciones no deben programarse definitivamente hasta que Vaqueros SM confirme sus reglas de negocio.
13Tickets y reportes — 15%
La vista previa e impresión básica del ticket existen; el ticket digital y los reportes reales dependen de que las ventas estén conectadas.
- Ticket impreso real y ticket de regalo sin precios
- Enlace digital seguro por comprobante
- Compartir desde el menú del teléfono
- Envío por WhatsApp, mensaje o correo
- Registro de cuándo y por qué medio se compartió
- Reimpresión desde el historial
- Ventas por día, periodo, sucursal, cajero y producto
- Inventario disponible, bajo y sin existencia
Compartir por WhatsApp podrá funcionar sin contratar un proveedor: el sistema abrirá la conversación con mensaje y enlace preparados. El envío automático por SMS o correo requerirá elegir un proveedor.
14Migración SICAR e integración WooCommerce — 5%
La arquitectura está preparada en ambos casos, pero el importador no se puede construir y validar hasta recibir una exportación de muestra de SICAR.
Herramienta controlada
Reconoce cómo SICAR representa tallas y colores, importa códigos heredados, sincroniza el catálogo periódicamente y puede ejecutarse varias veces sin duplicar información.
Campos ya reservados
Identificadores de producto y variante listos. Pendiente el acceso seguro, definir qué sistema es dueño del catálogo, sincronizar precios y existencias, y auditar sincronizaciones.
Las credenciales de WooCommerce nunca se colocarán en el navegador ni en el código público.
15Seguridad, calidad y dispositivos
Construida desde el inicio
RLS en Supabase, roles separados, mínimo privilegio, secretos fuera del frontend, validación del lado servidor, movimientos históricos inmutables y ambientes separados.
Validación automática
Formato, revisión estática, TypeScript, pruebas unitarias y de integración, compilación de producción, instalación de la base desde cero y pruebas de concurrencia con conexiones reales.
Teléfono, iPad y PC
Barra inferior táctil más grande, espacios seguros para PWA, scroll completo, tablas convertidas en tarjetas en móvil, modales que no tapan la navegación y áreas táctiles amplias.
Aunque alguien intente llamar directamente a la base de datos, debe contar con sesión, permiso y acceso a la sucursal.
16Lo que falta para el piloto operativo
Para que una sucursal pueda operar completamente con Mi Tienda SM falta terminar:
17Información requerida de Vaqueros SM
Para evitar programar reglas incorrectas se necesita confirmar:
- Exportación de muestra de SICAR
- Tipo de código utilizado actualmente
- Escalas de tallas de sombreros, texanas y cinturones
- Quién puede autorizar traspasos
- Manejo de diferencias al recibir
- Si habrá apartados desde la apertura
- Plazo y enganche de apartados
- Reglas de crédito
- Reglas de puntos y recompensas
- Política de descuentos
- Política de devoluciones y cambios
- Métodos de pago permitidos
- Método para calcular costos
- Contenido del ticket de regalo
- Envío automático por SMS o correo
- Lista de empleados, roles y cajas
- Modelo de impresora y lector
18Estrategia recomendada para la apertura
La estrategia de menor riesgo permite validar ventas reales sin interrumpir la operación principal.
La segunda sucursal inicia con Mi Tienda SM
Arranca directamente en el nuevo sistema.
La sucursal actual continúa con SICAR
Temporalmente, sin interrumpir la operación principal.
El catálogo se mantiene sincronizado
Durante todo el periodo de convivencia entre ambos sistemas.
Se validan ventas reales en la nueva sucursal
Detectando ajustes necesarios en operación real.
La primera sucursal cambia después
Una vez estabilizado el sistema, con SICAR disponible como respaldo durante el piloto.
19Siguientes etapas de trabajo
Con el catálogo terminado y M3 iniciado, el trabajo técnico restante para el alcance operativo esencial se agrupa en cuatro etapas. El orden es el previsto; los tiempos se definirán conforme avance el desarrollo.
| Orden | Etapa |
|---|---|
| 1 | Terminar inventario y traspasos |
| 2 | POS, pagos y caja |
| 3 | Devoluciones y cambios |
| 4 | Importador y validación de SICAR |
El avance depende de recibir la exportación de SICAR, tener disponible la impresora y el lector, resolver las decisiones de negocio y poder realizar pruebas reales con personal y mercancía. El módulo de POS y caja no debe acelerarse artificialmente porque controla dinero, inventario y cierres diarios.
20Próximas entregas
Traspasos entre sucursales
Estados de preparación, tránsito y recepción · mercancía en ubicación virtual "En tránsito" · diferencias de recepción · auditoría completa.
Conteos físicos formales
Revisión de diferencias · conteos por sección · control de operaciones simultáneas · recuperación y sincronización.
Ventas reales y caja
Pagos mixtos · descuentos · caja · cortes · tickets · impresión.
✓Conclusión
Mi Tienda SM ya dejó de ser únicamente un diseño visual. Actualmente cuenta con una infraestructura funcional, segura y preparada para crecer.
La siguiente parte concentra los procesos más importantes para la operación diaria: inventario completo, traspasos, ventas, pagos y caja.
Es construir un sistema más sencillo, seguro y adaptado a la manera real de trabajar de Vaqueros SM.
Avance general aproximado: 45%
×