Actualización primera semana de Septiembre

🚀 Changarro v0.11.0.beta — Métodos de Pago Flexibles, CLABE Interbancaria, Soporte macOS DMG & CI/CD Unificado

¡Nos alegra presentar la versión v0.11.0.beta de Changarro! Esta actualización impulsa la flexibilidad del negocio permitiendo habilitar múltiples métodos de pago (Efectivo, Tarjeta y Transferencia con CLABE), introduce el soporte nativo para macOS (.dmg) mediante Capacitor 8 + Electron, autohospeda fuentes e iconografía 100% offline y optimiza la automatización de publicaciones con un pipeline de CI/CD unificado en GitHub Actions.

---

✨ Novedades Principales

💳 1. Configuración de Métodos de Pago y Cobro Inteligente

• Múltiples formas de pago: Soporte para cobro en Efectivo, Tarjeta de débito/crédito y Transferencia Bancaria (SPEI).
• Efectivo por defecto: En instalaciones nuevas o restablecidas, el único método activo por defecto es Efectivo (cash: true). Tarjeta y Transferencia vienen desactivados y se habilitan desde Ajustes.
• Registro de CLABE Interbancaria: Campo dedicado en Ajustes para ingresar la CLABE/cuenta del negocio (transferClabe) cuando la opción de Transferencia está activa.
• Botón Inteligente de Cobro: El texto del botón de acción en la pantalla de cobro se adapta dinámicamente según el método seleccionado:
  • Efectivo: Cobrar / Cobrar (3) / Cobrando...
  • Tarjeta: Cobrado / Cobrado (3) / Cobrando...
  • Transferencia: Recibida / Recibida (3) / Procesando...
• CLABE grande y destacada: Durante cobros por transferencia, la CLABE se despliega destacada en negrita y fuente monoespaciada de 20px con botón para copiar a un toque.
• Pestañas dinámicas y fluidas: Los botones de selección de método de pago se expanden dinámicamente ocupando el 100% del ancho disponible sin dejar espacios vacíos.
• Compatibilidad con Respaldos: Toda la configuración de métodos de pago y CLABE es 100% exportable e importable en archivos JSON de respaldo.

---

🖥️ 2. Soporte Nativo macOS (.dmg) & Migración a Electron

• Migración a Capacitor 8 + Electron: Se eliminó la dependencia de Tauri 2 en favor de la integración nativa de Capacitor 8 para aplicaciones de escritorio.
• Compilación de paquetes .dmg: Nuevo comando npm run build:dmg para empaquetar ejecutable comprimido en formato ULFO (LZMA) para macOS.
• Generador automático de íconos: Script scripts/generate-icons-macos.py para construir activos de íconos .icns nativos a partir del vector SVG original.

---

⚡ 3. Autohospedaje Offline & Ajustes por Defecto

• Fuentes e Iconos Autohospedados: Integración de @fontsource/plus-jakarta-sans, @fontsource/atkinson-hyperlegible y material-symbols. Se eliminaron las llamadas a servidores CDN externos (Google Fonts), garantizando un funcionamiento offline perfecto.
• Ajustes desactivados por defecto: Tanto el IVA (taxEnabled: false) como el Escáner de Código de Barras (barcodeScannerEnabled: false) vienen desactivados por defecto en instalaciones limpias.
• Porcentaje de IVA Configurable: Campo de entrada en Ajustes para personalizar el porcentaje de IVA (ej. 0%, 8%, 16%), guardable en IndexedDB y compatible con exportación/importación.
• Cobro rápido en pantalla grande: En Inicio, al utilizar dispositivos con pantalla grande (desktops, laptops, tablets), se muestra un botón flotante Cobrar ($Total) ubicado justo debajo del botón de Venta Rápida cuando el carrito tiene productos.

---

🛠️ 4. Pipeline CI/CD Unificado en GitHub Actions

• Pipeline Encadenado (pipeline.yml): Unificación de flujos en una sola secuencia visual (Calidad de Código → Compilación Android & macOS → Publicar Release).
• Release Único Consolidado: Las compilaciones nativas generan y suben automáticamente los paquetes .apk, .aab y .dmg dentro de una misma publicación de Release en GitHub.

---

📱 ¿Cómo instalar o probar?

• macOS: Descarga e instala el paquete .dmg ejecutable adjunto a esta entrega.
• Android (APK / Bundle): Descarga el archivo .apk o .aab e instálalo en tu dispositivo.
• Web (SPA): Accede directamente desde tu navegador con persistencia local-first en IndexedDB.

---

Desarrollado con propósito 💜 por el equipo de Bendito Código para impulsar el comercio local en Latinoamérica.

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:
  1. 📊 Resumen de Ventas: KPIs, puntos clave, Top 10 productos y la gráfica de tendencia semanal incrustada como imagen PNG.
  2. 🛒 Detalle de Ventas: Registro completo transacción por transacción.
  3. 📦 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 CAMERA y VIBRATE agregados junto con declaraciones opcionales de hardware.
• GitHub Actions: Corregido el acceso a secretos con environment: prod en el flujo de firmado del bundle .aab y .apk de 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 .apk adjunto 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.