Victoria
Propuesta funcional y visual inicial para La Texcocana
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.
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.
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 inicial | Responsabilidad | Alcance ilustrativo |
|---|---|---|
| Superadministrador Victoria | Gobierno total; rol maestro protegido | Todos |
| Administrador general | Configuración y operación transversal | Todos según restricciones |
| Supervisor de vendedores | Rutas, avance, excepciones y desempeño | Asignados o todos |
| Encargado de almacén | Lotes, existencias, cargas y conciliación | Inventario y rutas permitidas |
| Chofer/vendedor | Ruta, visitas, ventas y cierre propios | Propios/asignados |
| Dirección / consulta ejecutiva | Indicadores e historial | Lectura |
| Auditor | Revisión independiente | Historial 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.
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
- Almacén registra o recibe inventario por producto, presentación, lote y caducidad.
- Supervisión crea la ruta, ordena clientes y asigna vendedor y camión.
- Almacén prepara cantidades específicas por lote y confirma la carga.
- La ruta pasa a Lista para iniciar y se descarga al dispositivo.
- El vendedor inicia; registra QR, ubicación puntual, visita y venta o motivo de no venta.
- Cada venta genera movimientos contra el inventario del camión.
- Al regresar, reporta no vendido e incidencias y revisa pendientes.
- Sin pendientes de sincronización, envía el cierre y queda bloqueado.
- Personal autorizado compara carga, ventas, movimientos y producto reportado/devuelto.
- 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.
| Estado | Capacidad del vendedor | Control |
|---|---|---|
| Borrador | Ninguna | Edición administrativa |
| Asignada | Consultar | Sin movimientos |
| Lista para iniciar | Iniciar | Carga confirmada |
| En ruta | Visitar, vender, registrar movimientos permitidos | Auditoría activa |
| Cierre enviado | Solo consultar | Captura bloqueada; no puede retirar el cierre |
| En conciliación | Solo consulta permitida | Ajustes autorizados |
| Cerrada | Historial | Reapertura especial auditada |
| Cancelada | Historial | Motivo, 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 esperadoSe 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
- ¿Cuáles son catálogo, unidades y conversiones oficiales?
- ¿Cómo operan precios, vigencias, descuentos y autorizaciones?
- ¿Se requiere crédito, cobranza, pagos, impuestos o facturación?
- ¿Qué radio, precisión y excepción validan una visita?
- ¿Cuáles son motivos oficiales y quién aprueba cada excepción?
- ¿FEFO será obligatorio o recomendado?
- ¿Cómo se definen objetivos y ponderaciones del ranking?
- ¿Los camiones se comparten y cómo se controlan relevos?
- ¿Se requieren comprobantes, impresión, firma o fotografía?
- ¿Qué parte del histórico de Excel se migrará?
- ¿Qué retención, respaldo y privacidad se requieren?
- ¿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.
Ventas, rutas, inventario y alertas.
Orden, asignación y mapa conceptual.
Esperado, reportado y ajustes auditados.
Módulo, acción y alcance.
Secuencia asignada y progreso.
QR y ubicación puntual.
Confirmación y bloqueo.
10 vistas de escritorio y 8 vistas móviles.