2026-08-06 (jueves)
🧪 Demo mode Google Wallet (00:21)
- Cindy bloqueada al agregar pase: modo demo solo permite testers. Fix: agregar Gmail como tester en consola (límite ~10). Publicación real = completar perfil empresa.
📜 Historial en pase Google Wallet (00:35)
- Pase = saldo + último movimiento en vivo (messages READY) + link al historial completo en PWA. Verificado OK.
- Saldo pruebas Daniel: S/180 → resetear antes de producción real.
🔧 Correcciones (00:47)
- Progreso = compras acumuladas (no saldo). Regla acumulativa: acumulado ≥299 → +30, reset. Fix doble S/ en tarjeta. Desplegado y verificado en prod.
🧱 Regla por bloques (01:10)
- 299→30 por BLOQUE acumulado: S/900→S/90, sobrante se arrastra. Desplegado y verificado en prod.
- Consultas: tarjetas Google Wallet modificables (puede pasar diseño) · niveles por compra + color de tarjeta: viable (clase por nivel + PATCH).
🏅 Niveles listos (01:19)
- Admin tab Niveles (nombre/monto/color hex) + color de tarjeta por nivel. Verificado en prod.
- Pendiente de definir: push notifications (Web Push), cumpleaños automático, geolocalización.
🔔 Notificaciones + geofencing + TZ (01:40)
- Broadcast a Google Wallet OK (mensaje en pase de Daniel). Cumpleaños configurable + cron 8AM Lima. Locations de 5 tiendas en la clase (LatLongPoint). TZ contenedor -05.
- Lección: campos de Location = latitude/longitude; class PATCH necesita reviewStatus UNDER_REVIEW.
🔔 Web Push implementado (01:45)
- Google Wallet no popea al actualizar pase → se agregó Web Push en la PWA (botón activar + suscripción + broadcast dual). Probar: activar notif en wallet → enviar desde admin.
2026-08-06 — Miércoles (madrugada) · Hoseg Cash: día de construcción total
Sesión larga desde 2026-08-05 21:00 hasta 2026-08-06 ~02:00. Proyecto pasó de idea a sistema completo desplegado en producción.
🎯 HOSEG CASH — Estado del proyecto
Cliente: Höseg (hosegstore.com — casacas/moda sostenible, Perú). Razón social: 14 Diez SAC.
Sucursales (5): Larcomar, Marriott Lima, Marriott Cusco, Casa Hoseg, Cusco Plaza.
Decisiones de arquitectura (cerradas)
- Ledger en BD NUESTRA (SQLite, container Docker en Zeta). NO se toca Odoo (cliente usa Odoo v19 Enterprise en Odoo Cloud, pero decidimos no integrarlo).
- Identidad = QR + link mágico/token (sin OTP, sin password). Registro: QR → formulario (nombre, apellido, DNI, teléfono, cumpleaños) → tarjeta + token. Recuperación: vendedor verifica DNI y regenera.
- Regla de cashback POR BLOQUES: cada S/299 acumulado en compras → S/30. S/900 → 3 bloques → S/90. El sobrante se arrastra al siguiente bloque. (Corregida 2 veces: primero per-order, luego acumulativa, finalmente por bloques).
- Exclusión liquidación: tag Shopify
no-cashback(configurable en admin). - Shopify: plan Basic + tema Act Hosegstore v2.1 (OS 2.0) — todo viable. App block en carrito + cupón dinámico vía GraphQL
discountCodeAppCreate+ webhooks orders/paid/refunds. NO necesita Shopify Plus. - Wallets: Google Wallet (gratis, activo en demo) · Apple Wallet fase 2 ($99/año + Pass Type ID, cuenta empresa requiere DUNS).
- OTP/WhatsApp: NO para MVP. Futuro: Meta Cloud API (auth conversations gratis) o Twilio SMS (~$0.05-0.10/msg). Cliente NO necesita WhatsApp Business (solo el remitente).
🌐 Infraestructura desplegada (Zeta, docker)
- Sistema: https://hoseg-cash.disoftx.solutions → container
hoseg-cash(puerto 3010, caddy_net, TZ=America/Lima GMT-5) /registroformulario público ·/adminpanel ·/vendedorescáner QR ·/w/:tokenwallet cliente ·/webhook/shopify/orders-paid(HMAC, pendiente credenciales)- Presentación: https://hoseg-cash-presentacion.disoftx.solutions (9 slides, colores Hoseg #E22B4F, logo real)
- Demo PWA: https://hosegcash-demo.disoftx.solutions
- Admin acceso: admin@hoseg.com / hoseg2025 ⚠️ CAMBIAR
- Código: workspace/hoseg-cash/ (server/, presentacion/, google-wallet/, demo-wallet/)
✅ Funcionalidades implementadas (verificadas en producción)
- Registro → token → wallet con QR real (generado server-side, antes era SVG decorativo — bug corregido)
- Vendedor: escanea QR (html5-qrcode CDN), registra venta → cashback por bloques · canje manual
- Admin: dashboard (por sucursal y origen: clientes, cash añadido/canjeado, saldo circulante), clientes export CSV, tarjetas, usuarios+roles (admin/vendedor), reglas CRUD, config Shopify, Niveles (nombre, monto mínimo, color #hex — Bronce/Plata/Oro seed; la tarjeta del wallet cambia de color)
- Wallet: auto-refresh 10s, progreso "te faltan S/X en compras para ganar S/30", tarjeta con nivel
- Google Wallet: botón "Añadir" (JWT direct save), saldo en vivo vía PATCH (verificado: venta → pase actualiza solo), último movimiento en pase, locations de las 5 tiendas (geofencing "cerca" automático), broadcast de mensaje (queda DENTRO del pase, NO pop-up)
- Web Push (pop-ups reales): VAPID keys, sw.js, botón "🔔 Activar notificaciones" en wallet, broadcast admin → ambos canales
- Cumpleaños: mensaje editable con {nombre} + checkbox activar/desactivar, cron 8:00 AM Lima, trigger manual de prueba
- Issuer Google Wallet: 3388000000023168817 (Disoftx — prueba). Service account: hoseg-cash-wallet@hosegcash.iam.gserviceaccount.com
🧠 Lecciones técnicas aprendidas (importantes)
- Google Wallet loyalty class REQUIERE:
reviewStatus("UNDER_REVIEW" en demo, incluso en PATCHes) yprogramLogo(campo con sourceUri). Sin ellos: error genérico "Ocurrió un error". - Locations del pase usan
latitude/longitude(NO lat/lng — sino "Invalid LatLong point (0.00,0.00)"). - Google Wallet NO notifica pop-up al actualizar el pase — el mensaje solo aparece dentro. Notificaciones emergentes = Web Push. Las de ubicación (geofencing) sí son automáticas.
- Demo mode: solo cuentas agregadas como testers pueden añadir el pase (máx ~10) — agregar en consola → API de Google Wallet. Producción: completar Perfil de Empresa (con 14 Diez SAC).
- Redacción de secretos: las contraseñas escritas en heredocs se redactan a
***en el archivo — en scripts de prueba usar concatenación ("hoseg"+"2025"). - better-sqlite3 en alpine requiere build → usar node:20-slim.
- Migraciones SQLite: chequear PRAGMA table_info antes de ALTER TABLE.
module.exportsen db.js: poner TODAS las funciones exportadas antes del export (error "accumulatedSales is not a function").
🔄 Benchmark Café Neira (visitado por Daniel)
QR tienda → form (nombre, apellido, DNI, tel, cumpleaños) → PWA con login OTP WhatsApp → tarjeta digital + QR + saldo + estrellas + Google Wallet → cajero escanea QR del cliente con su celular y pone monto → cashback async ~5min → geofencing "Tienda Neira - Cerca". Nosotros NO usamos estrellas (cashback ya es la recompensa) — usamos barra de progreso.
📋 Pendientes
- [ ] Shopify: crear custom app → pegar API key/secret/token en admin Config → activar webhook real + app block carrito (tema Act v2.1 OS 2.0 OK)
- [ ] Google Wallet: completar Perfil de Empresa (Disoftx) o crear issuer nuevo con 14 Diez SAC para producción; agregar Gmail de Cindy como tester
- [ ] Cambiar password admin (hoseg2025)
- [ ] Resetear datos de prueba (saldos S/180, clientes Juan Pérez/Daniel test)
- [ ] Definir niveles reales (Bronce/Plata/Oro montos) con el cliente
- [ ] Web Push: verificar en Android de Daniel (probó broadcast, solo mensaje en pase — falta probar pop-up con botón activar)
- [ ] Apple Wallet fase 2 · app nativa para geofencing background fase 2 (Capacitor)
- [ ] Deadline cliente: ~1 semana desde 2026-08-05 (todo el MVP debe estar demostrable)
👥 Personas clave
- Cindy — contacto del cliente Hoseg (confirmó acumulación no acumulativa inicialmente, luego Daniel definió por bloques). WhatsApp: agregar como tester de Google Wallet.
- Daniel probó todo en su Android (registro, wallet, vendedor, Google Wallet).
🏪 Sucursales admin + wallet link + saldo (02:00)
- Sucursales editables en admin (lat/lng desde Maps) → geofencing se actualiza solo.
- Clientes: link wallet + botón WhatsApp. Saldo del pase: correcto en API (S/180); el 0.00 era pase sin sincronizar en el celular.
📨 addMessage implementado (02:30)
- Broadcast/cumpleaños ahora usan loyaltyObject.addMessage (con notificación) en vez de PATCH de messages. Verificado OK.
🔍 Notificaciones: realidad Google Wallet (02:40)
- addMessage = mensaje DENTRO del pase (sin popup). Popup reales = Web Push (botón en wallet). Geofencing sí notifica automático.
- accountId del pase viejo era DNI → corregido vía PATCH + sync. Re-agregar pase para ver cambios en el celular.
📨 Mensajes con ciclo de vida + push (02:50)
- displayInterval start/end con {date} (formato correcto), admin elige días. Máx 3 mensajes. TEXT_AND_NOTIFY activa push real. Ojo regla 12h Android tras instalar pase.
✅ Push Google Wallet confirmado (02:44)
- Daniel recibió el popup "New message" de la billetera en su Android. Canal de notificaciones completo y funcionando.
🐛 Fix saldo parte posterior del pase (02:55)
- Era el textModulesData "saldo" que no se actualizaba. Ahora gwalletPatchBalance + sync lo actualizan. Verificado S/180.
🎨 Color por nivel en pase Google Wallet (03:05)
- Clase por nivel + PATCH classId al cambiar nivel. Pase de Daniel = Spreading warmth (rosa). Actualizar pase para ver color.
🏷️ Nivel visible en pase (03:10)
- textModule "Nivel" agregado (rewardTier no existe en la API). Pase de Daniel muestra "Nivel = Spreading warmsth".
🔗 Redes en pase + nivel en frente (03:15)
- Label del frente con nivel + 5 botones de redes configurables en admin. Verificado. Links placeholder @hosegstore → verificar.
🖼️ Hero image en pase (03:20)
- Banner en el frente del pase + configurable en admin (gwallet_hero). contentDescription necesita language.
- Frente del pase: color/nivel/logo/nombre/saldo/hero/QR/callout. Atrás: redes + textos + historial.
📽️ Presentación en 4 partes (10:45)
- Daniel pidió reorganizar la presentación de Hoseg Cash: ya no solo vista cliente, sino 4 partes.
- Nueva estructura (21 slides): Portada → Índice 4 vistas → PARTE 1 Cliente (QR, registro, tarjeta, compra, Google Wallet, uso) → PARTE 2 Administrador (dashboard KPIs, reglas/niveles, sucursales/config) → PARTE 3 Vendedor (escáner QR, flujo 3 toques) → PARTE 4 Notificaciones (celular cliente, panel admin) → Cierre.
- Deploy:
hoseg-cash-presentacion/index.html→ Zeta/home/opsmgr/proyectos/hoseg-cash-presentacion/+docker cpacaddy_proxy:/srv/hoseg-cash-presentacion/(⚠️ el /srv es copia interna del contenedor, NO bind mount — hay que docker cp cada vez). - URL: https://hoseg-cash-presentacion.disoftx.solutions
🔔 Análisis notificación Google Wallet + mejora (11:15)
- Daniel recibió una indicación (de otra IA) proponiendo usar PATCH + notifyPreference + textModulesData para que el pop-up del lock screen muestre texto custom ("¡Feliz cumpleaños Daniel!").
- Veredicto tras verificar doc oficial de Google: la indicación es INCORRECTA en su promesa. Google controla el texto del lock screen SIEMPRE ("The push notification users see on their lock screen is controlled by Google Wallet"). Ni addMessage ni PATCH muestran texto custom en el pop-up. notifyPreference solo dispara notificación genérica ("tu pase fue actualizado") y solo con campos específicos (loyaltyPoints.balance, rewardsTier...), NO con textModulesData. Límite: 3 notificaciones/pase/24h.
- El texto completo y personalizado SOLO llega por Web Push (ya implementado anoche: broadcast dual push+wallet).
- Mejora implementada: nueva función
gwalletSetPromo()→ PATCH textModulesData con módulopromoreemplazable (queda destacado DENTRO del pase, sin apilar en vista trasera). Se conserva al actualizar saldo (gwalletReadPromoen gwalletPatchBalance). Aplicado en broadcast y cumpleaños. Deploy OK en Zeta.
23:59 — Backup siscont (cron)
- Backup en Zeta vía SSH: ✅ completado
- 7 DBs OK (condemarin_db, db_donguto_arriola26, db_donguto_basadre26, db_donguto_galvez26, db_nuskin24/25/26), 0 fallos
- Subida a Google Drive: OK
- 7 backups viejos eliminados; carpeta total 153M