Estado del Sistema - El Cuaderno del Vendedor

1. Objetivo del Proyecto

"El Cuaderno del Vendedor" es una plataforma integral diseñada para optimizar la gestión diaria de los vendedores de la ONCE. Su misión es digitalizar procesos manuales, asegurar la integridad de los datos de ventas y proporcionar alertas tempranas para evitar pérdidas de información.

Automatización

Descarga automática de liquidaciones e inventarios desde el Portal ONCE.

Integridad

Base de datos local robusta para cuadre y corrección de tickets.

Alertas Inteligentes

Notificaciones proactivas para evitar olvidos críticos (ej. Stock Rascas HOY).

Accesibilidad

Nuevo modo de alto contraste para usuarios con dificultades visuales.

2. Estructura de la Aplicación

Página (.html)	Función Principal	Estado
index.html	Dashboard principal. Resumen de alertas, navegación y estado del día.	Activo v9.17 Adaptado Accesibilidad
scanner.html	Sistema OCR para digitalizar tickets de venta y cierre de caja.	Activo Adaptado Accesibilidad
rascas.html	Gestión de inventario instantáneo. Cálculo de ventas por diferencia (Stock Ayer - Stock Hoy).	Activo Adaptado Accesibilidad
config_rascas_test.html	Catálogo maestro de productos Rascas (Precio, Nombre, Stock Ideal).	Activo Adaptado Accesibilidad
7dias.html	Informe mensual con desglose diario de ventas y liquidación.	Activo Adaptado Accesibilidad
panel_de_ventas_test.html	Hub central para acceder a los registros detallados de ventas y cierres.	Activo Adaptado Accesibilidad
configuracion_test.html	Panel de control. Cupones, WhatsApp, Calendario y Accesibilidad.	Activo Adaptado Accesibilidad

3. Estructura de Datos (SQLite)

ventas_diarias

Registro principal de actividad financiera diaria.

fecha (PK)
venta_tarde, venta_manana
devolucion_tarde, devolucion_manana
parejas, tiras
TOTAL_venta_diaria ($)

inventario_rascas

Snapshot diario del stock de lotería instantánea.

fecha, producto (PK Compuesta)
cantidad (Stock Real)
activado, vendido, retirado
precio ($)

notificaciones_status_v2

Control de lectura y borrado de alertas.

id_notif (PK)
estado ('read' | 'dismissed')
updated_at (Timestamp)

configuracion_rascas

Maestro de productos y propiedades estáticas.

nombre_producto (PK)
precio_unitario
familia, stock_ideal

4. Historial de Versiones

v9.22 - Core de Ventas & Normalización

16 Enero 2026

Normalización de Nombres: Solución definitiva "Triplex" vs "Triplex de la ONCE". Ahora el sistema unifica los nombres para garantizar la comparación precisa en los desgloses de 7 Días.
Comparación 7 Días (Lógica Avanzada):

Lunes Liquidación vs Suma (Viernes + Sábado + Domingo) Ventas.
Martes Liquidación vs Lunes Ventas.
Viernes Liquidación vs Jueves Ventas.

Autocompletado de Datos Faltantes: Script de emergencia para rellenar ventas de días festivos (1 y 2 Enero) usando datos de liquidación para evitar discrepancias visuales.
Backup de Producción: Copia de seguridad del núcleo server_v2.py.

v9.21 - Auditoría de Accesibilidad Operativa

16 Enero 2026

Ventas Accesibles: Etiquetas ARIA en todos los inputs monetarios de venta_diaria.html y cierre_caja.html para asegurar lectura correcta por lectores de pantalla.
Roles Semánticos: Implementación estricta de role="banner" y role="main" en páginas de liquidación y cierre.
Interacción Accesible: Zonas de escaneo y selectores de fecha optimizados con atributos aria-label y tabindex.
Cobertura Completa: Finalización de mejoras en configuracion.html, config_rascas_test.html y liquidacion_test.html.

v9.20 - Optimización Móvil 7 Días & Backup CSS

16 Enero 2026

Mejoras en 7dias.html (Móvil): Cabecera compacta con fecha y liquidación en línea.
Desglose de Ventas Estricto: Separación visual de Ventas TPV, Ventas ONCE y Liquidación en vista móvil.
Backup de Estilos: Creación de accessibilityv2.css como punto de restauración seguro.
Botones Táctiles: Estandarización de targets de 48px en todas las vistas de configuración.
Mejora Accesibilidad Datos: Incorporación de regiones semánticas (banner, main) y etiquetas ARIA descriptivas en datos.html.

v9.19 - Refactorización de Fechas y Spinner Accesible

16 Enero 2026

Nuevo Selector de Fecha (Spinner): Reemplazo de selectores nativos por componentes personalizados "tipo tambor" (Día/Mes/Año) para máxima accesibilidad y facilidad de uso táctil.
Accesibilidad Mejorada: Anuncios auditivos (Screen Reader) al cambiar valores en el selector.
Facada Visual: Implementación de patrón "Visual Mask" para inputs de fecha, unificando la estética en toda la app.
Soporte Global: Extendido a Cierre, Ventas, Rascas, Liquidación y Devoluciones.

v9.18 - Adaptación Global Mobile First

16 Enero 2026

Adaptación Responsiva: Transformación de tablas a "Card Views" en móvil para eliminar scroll horizontal.
Archivos actualizados: cierre_caja.html, liquidacion.html, venta_diaria.html, gestion_documental.html, panel_de_ventas_test.html, resumen.html.
Mejora Táctil: Botones y controles ampliados a mín. 48x48px.

v9.17 - Accesibilidad & High Contrast

16 Enero 2026

Nuevo: Modo Invidente (Alto Contraste) en Configuración.
CSS Externo dedicado (css/accessibility.css).
Persistencia de preferencias via localStorage.

Archivos modificados:
- css/accessibility.css (Nuevo)
- js/notifications.js (Loader)

v9.16 - Documentación y Refinamiento

15 Enero 2026

Creación de página de Estado del Sistema (info.html).
Actualización de enlaces en Dashboard.
Mejora visual de iconos de notificación.

v9.15 - UX Layout

Reubicación del icono de notificaciones junto a la fecha.
Limpieza de cabecera en Dashboard.

v9.14 - Core Notificaciones

Refactorización total JS (Global Scope).
Solución a "markAsRead is not defined".
Nueva tabla BD notificaciones_status_v2 para persistencia real.
Barra de progreso visual en descargas.

5. FASE 2: Adaptación Global "Mobile First" (BASE UNIVERSAL)

Objetivo: Garantizar que toda la aplicación sea perfectamente usable en móvil para CUALQUIER usuario (estándar o invidente).

Revisión de Layout y Viewport

Verificar <meta name="viewport"> correcto.
Eliminar anchos fijos (width: 900px) → anchos fluidos (w-full).
Cero Scroll Horizontal: Ajuste estricto al ancho del dispositivo.

Usabilidad Táctil Estándar

Regla de Oro: Elementos interactivos mín. 48x48px.
Separación mínima de 8px entre botones.
Menús verticales en móvil para mejor alcance.

En Progreso

6. FASE FINAL: Expansión SaaS & IA ( Roadmap )

Visión Futura: "El Cuaderno" como Servicio (SaaS)

Transformación de la herramienta personal en una plataforma multi-vendedor en la nube.

Estrategia de Soporte Técnico (Workflow)

Asistente IA (In-App)

Primer nivel de atención. Una IA integrada guía al usuario invidente y resuelve dudas operativas ("¿Cómo cierro caja?", "¿Qué rasca falta?").

Escalado a WhatsApp

Si la IA no puede resolverlo, genera un Ticket de Incidencia y lo envía a un WhatsApp de Soporte para intervención humana (Admin).

PythonAnywhere Host

Despliegue escalable en la nube para acceso remoto 24/7.

Super-Administrador

Panel de control Master para gestionar usuarios y cerrar tickets.

Nota Arquitectura: Requiere reestructuración profunda de BD para soportar Multi-Tenancy (UserID FKs).