Repository navigation
Nuevas funciones última semana de Junio
🚀 Changarro v0.7.0 — Modo Escáner Cajero, Reportes del Negocio & Exportación a Excel con Gráficas
¡Nos alegra presentar la versión v0.7.0 de Changarro! Esta actualización transforma la experiencia de cobro para comerciantes locales con la introducción del Modo Escáner Cajero estilo supermercado, una pantalla de Reporte del Negocio con datos clave en lenguaje amigable y la capacidad de Exportar a Excel (.xlsx) con gráficas visuales incrustadas.
✨ Novedades Principales
📷 1. Modo Escáner Cajero en Inicio
- Escaneo continuo estilo supermercado: La cámara se mantiene encendida lista para pasar productos rápidamente uno tras otro directamente desde la pestaña de Inicio.
- Pausa de 2 segundos entre lecturas: Previene el registro accidental del mismo producto dos veces seguidas.
- Feedback táctil y sonoro: Emite un pitido y una suave vibración háptica al agregar un producto al carrito.
- Marco iluminado para entornos oscuros: Visor rodeado de un marco suave que facilita la lectura de códigos de barras en locales con poca luz.
- Modo espejo nativo: La cámara refleja la imagen horizontalmente para un movimiento natural e intuitivo.
- Detección inteligente de hardware: El botón de linterna solo se muestra en dispositivos con hardware de flash LED físico.
- Manejo de productos no registrados: Si escaneas un código desconocido, un modal amigable te permite agregarlo como Venta Rápida o registrarlo de inmediato en tu Inventario.
- Preferencia en Ajustes: Puedes elegir en Configuración si prefieres que la pantalla de Inicio abra por defecto en la vista de Catálogo o en el Escáner Cajero.
📊 2. Pantalla "Reporte del Negocio" (Cuentas Claras)
- Acceso rápido: Disponible desde el menú desplegable (tres puntos
⋮) en la pantalla de Ventas. - Sin jerga técnica: Diseñado para comerciantes sin conocimientos contables o de BI.
- Datos clave (KPIs): Consulta de un vistazo tu Total Cobrado, Compras Atendidas, Ticket Promedio y la proporción de pago en Efectivo vs. Tarjeta.
- Cuentas Claras: Frases explicativas que te revelan tu Producto Estrella, tu Día Más Fuerte de la semana y tu Hora Pico de clientes.
- Gráficas visuales nítidas: Tendencia de ventas semanal en barras SVG (destacando el día más alto con una estrella ⭐️) y ranking visual del Top 5 de productos.
- Filtros rápidos de período: Alterna entre
[ Hoy ],[ Esta Semana ],[ Este Mes ]y[ Todo ].
📥 3. Exportación a Excel (.xlsx) con Gráfica Incrustada
- Libros de Excel con 3 pestañas estructuradas:
📊 Resumen de Ventas: KPIs, puntos clave, Top 10 productos y la gráfica de tendencia semanal incrustada como imagen PNG.🛒 Detalle de Ventas: Registro completo transacción por transacción.📦 Inventario: Catálogo completo con precios, categorías y códigos de barras.
- Diseño profesional: Colores alineados a la marca Serene Hearth, formato de moneda automático (
$#,##0.00) y ancho de columnas auto-ajustado. - Offline & Carga diferida (Lazy loading): La biblioteca de Excel se descarga únicamente al solicitar la exportación (0 KB adicionales en la carga inicial).
🛠️ 4. Mejoras Técnicas y CI/CD
- Android Manifest: Permisos nativos de
CAMERAyVIBRATEagregados junto con declaraciones opcionales de hardware. - GitHub Actions: Corregido el acceso a secretos con
environment: proden el flujo de firmado del bundle.aaby.apkde Android. - Pruebas unitarias: 31 pruebas unitarias pasadas con exito en Vitest.
📱 ¿Cómo instalar o probar?
- Web (PWA): Accede directamente desde tu navegador.
- Android (APK / Bundle): Descarga el archivo
.apkadjunto a esta entrega e instálalo en tu dispositivo.
Desarrollado con propósito 💜 por el equipo de Bendito Código para impulsar el comercio local en Latinoamérica.