V VICTORIA

Victoria

Propuesta funcional y visual inicial para La Texcocana

Plataforma web responsiva para ventas, rutas e inventario
Versión inicial · 1 de agosto de 2026

Documento de visión · No constituye especificación técnica definitiva ni cotización

Cómo leer esta propuesta

Victoria conectará el inventario general con los camiones, las rutas, las visitas, las ventas y la conciliación en una sola operación auditable.

Confirmado forma parte del alcance conocido. Recomendación orienta la solución, pero requiere validación. Pendiente identifica decisiones abiertas.

1. Resumen ejecutivo

Victoria será el centro operativo digital de La Texcocana. Sustituirá funcionalmente el Excel con macros utilizado para clientes, productos, lotes, inventario, camiones, rutas, ventas, devoluciones, retornos, historiales y desempeño.

Trazabilidad

El inventario cambia mediante movimientos registrados; nunca por sobrescritura libre de saldos.

Control operativo

La ruta avanza por estados explícitos. Enviar el cierre congela la captura del vendedor.

Operación en campo

La PWA conserva datos esenciales y operaciones pendientes ante conexiones intermitentes.

Decisiones confiables

Indicadores, alertas, historiales y auditoría ofrecen una lectura común de la operación.

Alcance de esta entrega: propuesta funcional, dirección visual y mockups estáticos. No se ha desarrollado backend, base de datos, autenticación ni una aplicación funcional.

2. Situación actual

La operación se concentra en un archivo de Excel con macros. El modelo cubre necesidades esenciales, pero limita el acceso concurrente, la experiencia móvil, el gobierno dinámico de permisos, la evidencia de campo y una bitácora consistente.

Inventario generalCarga por loteRutaVisitas y ventasNo vendidoConciliaciónHistorial

3. Visión y alcance general

Almacén prepara y confirma la carga; supervisión asigna una lista ordenada de clientes; el vendedor opera desde navegador móvil; las ventas descuentan del camión por movimientos; el cierre congela la captura; personal autorizado concilia; dirección consulta resultados.

Confirmado Una operación, un inventario general, varios camiones, vendedores/choferes, clientes, productos, lotes, rutas, supervisores y usuarios administrativos o de almacén.

Pendiente Migración del Excel, reglas comerciales detalladas, parámetros geográficos y selección de tecnologías.

La identidad en rojo profundo, dorado, crema y neutros es provisional y deberá validarse con La Texcocana.

4. Usuarios, roles y permisos

Rol inicialResponsabilidadAlcance ilustrativo
Superadministrador VictoriaGobierno total; rol maestro protegidoTodos
Administrador generalConfiguración y operación transversalTodos según restricciones
Supervisor de vendedoresRutas, avance, excepciones y desempeñoAsignados o todos
Encargado de almacénLotes, existencias, cargas y conciliaciónInventario y rutas permitidas
Chofer/vendedorRuta, visitas, ventas y cierre propiosPropios/asignados
Dirección / consulta ejecutivaIndicadores e historialLectura
AuditorRevisión independienteHistorial según permiso

Los roles son plantillas editables. Cada permiso combina módulo + acción + alcance. Acciones: ver, crear, editar, eliminar, asignar, aprobar, iniciar, registrar, cancelar, cerrar, reabrir, ajustar, exportar, consultar historial, ver costos, ver ubicación y administrar configuración, usuarios o permisos. Alcances: propios, asignados, todos o sin acceso.

El servidor deberá validar todo permiso; ocultar una opción visual no constituye autorización. El rol maestro no puede eliminarse accidentalmente ni quedar sin usuarios. Todo cambio se audita.

5. Módulos funcionales

Gobierno

1 Acceso y seguridad · 2 Usuarios · 3 Roles y permisos · 36 Configuración general.

Catálogos

4 Productos y presentaciones · 5 Precios · 10 Camiones · 13 Clientes.

Inventario

6 Lotes · 7 Caducidades · 8 Inventario general · 9 Movimientos · 11 Cargas · 12 Inventario por camión.

Campo

14 Coordenadas · 15 QR · 16 Planeación · 17 Asignación · 18 Ruta ordenada · 19 Validación · 20 Registro de visitas.

Venta y devoluciones

21 Visitas sin venta · 22 Ventas · 23 Devoluciones · 24 No vendido · 25 Mermas e incidencias.

Cierre y control

26 Retornos a fábrica · 27 Cierre · 28 Conciliación · 35 Bitácora de auditoría.

Inteligencia

29 Historiales · 30 Alertas · 31 Reportes · 32 Rankings · 33 Insignias · 34 Exportaciones.

Resultados esperados

Existencia trazable, ejecución guiada, diferencias visibles, acceso adaptable y decisiones sustentadas.

6. Flujo operativo completo

  1. Almacén registra o recibe inventario por producto, presentación, lote y caducidad.
  2. Supervisión crea la ruta, ordena clientes y asigna vendedor y camión.
  3. Almacén prepara cantidades específicas por lote y confirma la carga.
  4. La ruta pasa a Lista para iniciar y se descarga al dispositivo.
  5. El vendedor inicia; registra QR, ubicación puntual, visita y venta o motivo de no venta.
  6. Cada venta genera movimientos contra el inventario del camión.
  7. Al regresar, reporta no vendido e incidencias y revisa pendientes.
  8. Sin pendientes de sincronización, envía el cierre y queda bloqueado.
  9. Personal autorizado compara carga, ventas, movimientos y producto reportado/devuelto.
  10. Se documentan diferencias y ajustes; la ruta queda cerrada e histórica.

7. Rutas y visitas

La ruta es una lista ordenada de clientes. Un supervisor o usuario con permiso puede agregar, retirar y reordenar clientes antes del inicio. El vendedor consulta la secuencia asignada, pero no puede reorganizarla.

EstadoCapacidad del vendedorControl
BorradorNingunaEdición administrativa
AsignadaConsultarSin movimientos
Lista para iniciarIniciarCarga confirmada
En rutaVisitar, vender, registrar movimientos permitidosAuditoría activa
Cierre enviadoSolo consultarCaptura bloqueada; no puede retirar el cierre
En conciliaciónSolo consulta permitidaAjustes autorizados
CerradaHistorialReapertura especial auditada
CanceladaHistorialMotivo, usuario y fecha

Evidencia operativa de visita

Combina QR, coordenadas registradas y del dispositivo, distancia, precisión GPS, fecha/hora, usuario, sesión/dispositivo, conectividad y advertencias. Puede resultar válida, válida con advertencia, fuera de radio, con GPS impreciso, QR incorrecto o excepción autorizada.

No es una prueba infalsificable. Es evidencia operativa auditable. La ubicación se captura en eventos; no existe rastreo GPS continuo ni se reporta distancia real recorrida.

8. Reglas de inventario

  • El saldo es consecuencia del libro de movimientos.
  • Todo movimiento conserva producto, presentación, lote, cantidad, origen/destino, usuario, fecha, motivo y referencia.
  • Tipos: entrada, carga, carga adicional autorizada, venta, devolución, producto no vendido, merma, muestra habilitada, retorno y ajuste autorizado.
  • Los movimientos confirmados no se borran silenciosamente; se compensan o cancelan según permiso.
  • Lote y caducidad mantienen la trazabilidad hasta el cliente cuando corresponda.
  • FEFO es una recomendación pendiente de adopción y parametrización.

9. Cierre y conciliación

Antes de enviar, el vendedor revisa carga, ventas, otros movimientos, esperado y no vendido. El sistema advierte que el cierre bloquea modificaciones y no puede retirarse. Si existen operaciones pendientes de sincronización, el envío se impide.

cargado + cargas adicionales − ventas − salidas autorizadas − mermas = inventario esperado

Se contrasta el esperado con lo reportado/devuelto. Toda diferencia muestra producto, lote, unidades y valor cuando existan costos. Un ajuste exige permiso, motivo, valores anterior/nuevo, autor y aprobación. Cierres, ajustes y reaperturas permanecen en bitácora.

10. Offline y sincronización

La PWA contempla descarga de ruta, clientes, catálogo, precios e inventario de camión; caché esencial; almacenamiento local; IDs únicos; cola visible; captura de hora, coordenadas y precisión; reintentos; estados en línea, sin conexión, pendiente y sincronizado; revisión de conflictos y bitácora.

Recomendación Idempotencia en servidor, hora local y de recepción, sincronización por dependencia y resolución explícita de conflictos sensibles.

Límite: una PWA tolera intermitencia, pero el navegador puede restringir almacenamiento, segundo plano, cámara y GPS. No ofrece el mismo control offline que una app Android nativa.

11. Rankings e Insignias Victoria

Vendedor Victoria del Mes presenta oro, plata y bronce, distintivo temporal de perfil, historial, primeros lugares, meses en podio, mejor mes y racha. Reconocimientos sugeridos: Ruta Perfecta, Cero Diferencias, Mayor Efectividad, Cliente Recuperado, Producto Estrella y Racha Victoria.

El índice puede ponderar ventas contra objetivo, cumplimiento de visitas, efectividad, precisión de conciliación e incidencias. Los porcentajes serán configurables y el cálculo deberá ser transparente. El objetivo es reconocimiento empresarial sencillo, no convertir Victoria en un videojuego.

12. Indicadores y reportes

A. Ejecutivo

Ventas día/mes, unidades, objetivo, crecimiento, visitas, inventario y valor, caducidad, rutas activas, vendedores en ruta, diferencias y alertas.

B. Ventas

Por fecha, vendedor, ruta, cliente, camión, producto, presentación y lote; operaciones, ticket, crecimiento, meta, cancelaciones, descuentos y margen si existen costos.

C. Rutas y visitas

Programadas, completas, cumplimiento, clientes, efectividad, horarios, tiempos, motivos, radio, precisión, QR, excepciones, orden planeado y distancia estimada.

D. Inventario general

Existencia, disponibilidad, valor, niveles, entradas, salidas, ajustes, mermas, diferencias, devoluciones, retornos, rotación y cobertura.

E. Lotes y caducidades

Activos, agotados, próximos, vencidos, días, valor en riesgo, ventas/devoluciones, desperdicio, trazabilidad, clientes y FEFO si se adopta.

F. Camiones

Carga, vendido, no vendido, devuelto, mermas, faltantes/sobrantes, esperado/reportado, diferencias, pendientes e historial.

G. Clientes

Activos, nuevos, recuperados, sin visitar, días desde compra, frecuencia, ticket, productos, visitas, motivos, crecimiento y mapa.

H. Vendedores

Ventas, unidades, objetivo, ruta, efectividad, ticket, clientes, devoluciones, mermas, diferencias, posición, insignias y evolución.

I. Devoluciones y mermas

Por producto, vendedor, cliente y motivo; retornos, daño, vencido, valor, tendencias, autorizaciones y tiempo de resolución.

J. Seguridad y auditoría

Accesos, intentos fallidos, permisos, usuarios, ventas, cancelaciones, ajustes, coordenadas, excepciones, cierres, exportaciones y antes/después.

13. Arquitectura técnica conceptual

Frontend web responsivo/PWA, backend con API, base relacional, autenticación, autorización en servidor, roles dinámicos, bitácora, registro transaccional de inventario, estados de ruta, almacenamiento local, sincronización, QR, geolocalización del navegador, navegación externa, alertas, Excel/PDF, respaldos, registros de errores y comunicaciones seguras.

Decisiones posteriores Proveedor cloud, framework, base de datos, servicio de mapas, autenticación y hosting. La arquitectura deberá permitir una app Android futura sin duplicar reglas de negocio.

14. Seguridad y auditoría

  • Mínimo privilegio y permisos efectivos visibles.
  • Autorización de servidor para toda operación sensible.
  • Comunicación cifrada y controles de sesión por definir.
  • Bitácora lógica append-only para permisos, inventario, ventas, coordenadas, rutas, cierres y exportaciones.
  • Antes/después y motivo en cambios, excepciones y ajustes.
  • Respaldo, recuperación, retención y monitoreo por definir.
  • Minimización de datos almacenados en dispositivos.

15. Experiencia en computadora y móvil

Computadora

Navegación por Inicio, Operación, Inventario, Clientes, Ventas, Reportes y Administración. Tablas, filtros y paneles privilegian planeación, supervisión, conciliación y análisis.

Móvil / PWA

Una tarea principal por pantalla, controles amplios y conectividad siempre visible. Ruta, validación, venta, inventario, sincronización, cierre y métricas forman flujos cortos.

16. Futuras ampliaciones

Una app Android nativa podrá evaluarse para jornadas completas sin conexión, persistencia reforzada, mejor cámara/GPS, controles adicionales sobre ubicación simulada, administración de dispositivos, impresión Bluetooth, firma o evidencias adicionales. También podrán evaluarse integraciones, optimización avanzada de rutas, pronóstico y analítica predictiva.

17. Exclusiones y supuestos

Exclusiones: backend, API, base de datos, autenticación real, cloud, despliegue, cuentas externas, app Android inicial, rastreo continuo, sucursales, regiones, equipos de vendedores, multiempresa, múltiples almacenes, migración del Excel y reglas fiscales/contables no suministradas.

Supuestos: un inventario general abastece camiones; cada ruta tiene vendedor y camión; lote/caducidad aplican cuando corresponde; los dispositivos permiten cámara, ubicación y almacenamiento; la conectividad y calidad de datos serán variables.

18. Preguntas abiertas

  1. ¿Cuáles son catálogo, unidades y conversiones oficiales?
  2. ¿Cómo operan precios, vigencias, descuentos y autorizaciones?
  3. ¿Se requiere crédito, cobranza, pagos, impuestos o facturación?
  4. ¿Qué radio, precisión y excepción validan una visita?
  5. ¿Cuáles son motivos oficiales y quién aprueba cada excepción?
  6. ¿FEFO será obligatorio o recomendado?
  7. ¿Cómo se definen objetivos y ponderaciones del ranking?
  8. ¿Los camiones se comparten y cómo se controlan relevos?
  9. ¿Se requieren comprobantes, impresión, firma o fotografía?
  10. ¿Qué parte del histórico de Excel se migrará?
  11. ¿Qué retención, respaldo y privacidad se requieren?
  12. ¿Qué volúmenes de usuarios, clientes, productos y transacciones se esperan?

19. Índice de mockups

Seleccione una miniatura para abrir el SVG a tamaño completo. Todos los nombres y datos son ficticios.