🔗 Nexus

← Volver a notas
8 KB 27/09/2026 19:55
🔗

Hoseg Rewards — App móvil del wallet (Android + iOS) · Diseño v1

Creado: 2026-09-27 · Estado: 🟡 Diseño (pendiente confirmar 3 decisiones) · Pedido de Daniel: "una sola app, solo wallet (no admin/vendedor); quiero las dos opciones (web wallet + app wallet); las notificaciones llegan mejor en app; así ya existe app en Android e iOS".

Base técnica actual: hoseg-cash (Node/Express + SQLite en Zeta, puerto 3010) · https://hoseg-cash.disoftx.solutions
Playbook a reutilizar: wiki/manuales/publicar-app-movil-capacitor.md (Capacitor → Play + Codemagic/TestFlight). Caso ya resuelto: Hoseg Dashboard.


1. Alcance decidido

Superficie Hoy Con la app
Wallet cliente (/w/:token) PWA web PWA + APP nativa (Android/iOS) ← lo nuevo
Registro (/registro, QR de tienda) Web Web (sin cambios)
Vendedor (/vendedor) Web Web (sin cambios)
Admin (/admin) Web Web (sin cambios)

2. Arquitectura propuesta

Cliente ──┬─ PWA (wallet)      ─┐
          └─ APP (Capacitor)    ─┼─► API REST hoseg-cash (Zeta, mismo backend)
Vendedor ─── web /vendedor      ─┤
Admin ────── web /admin         ─┘

3. Puntos de diseño (y mi recomendación)

3.1 Entrada a la app (lo más delicado)

Hoy el cliente entra por link mágico /w/<token> (sin contraseña). En la app hay que resolverlo:
- Deep links (universal links): si el cliente toca su link y tiene la app → abre la app con su token. (Requiere apple-app-site-association + assetlinks.json.)
- Escanear QR: botón en la app para escanear el QR de la tarjeta (que ya generamos) o el QR de la tienda (registro).
- Pegar el enlace: fallback simple.
- ✅ Recomendado v1: deep links + escáner QR + "pegar enlace". El registro sigue en la web (QR de tienda).

3.2 Notificaciones (el motivo principal)

3.3 Features nativos (valor real + lo que Apple exige, guía 4.2)

3.4 Fases

  1. F1 — Shell: Capacitor + wallet + entrada por QR/deep link + ambos botones de wallet. (≈2-3 días)
  2. F2 — Push: FCM/APNs + tabla de dispositivos + envíos (cashback/promo/cumpleaños). (≈2 días)
  3. F3 — Pulido: biometría, offline/refresh, íconos/splash, QA en device. (≈1-2 días)
  4. F4 — Publicación: Android prueba interna + iOS TestFlight (con el Playbook). (≈1 día)

Total estimado: ~1 a 1,5 semanas (reutilizando todo lo ya construido).


4. Decisiones pendientes (para cerrar el diseño)

  1. Push: ¿unificamos todo en FCM (app + PWA) o la PWA se queda con el web-push actual? → Recomiendo unificar en FCM.
  2. Nombre e ícono de la app: ¿"Hoseg Rewards" con el logo de Hösėg? ¿App ID com.hoseg.rewards?
  3. Biometría/PIN para abrir la app: ¿sí o no? → Recomiendo sí (opcional para el cliente).
  4. APNs key: hay que subir la .p8 a Firebase (mismo trámite pendiente de Hoseg Dashboard) para que iOS reciba push.
  5. Fideliza: ¿esta app queda solo para Hoseg, o se piensa como base de Fideliza (una app por negocio)? → define si el código se hace genérico desde el inicio.

5. Requisitos ya cubiertos


6. Decisiones confirmadas (2026-09-27) y build de prueba

Confirmado por Daniel:
- Una sola app, solo wallet del cliente (admin/vendedor siguen web).
- Se mantienen las dos opciones: wallet web (PWA) y app — la app se suma, no reemplaza.
- El link lo manda la vendedora (como hoy).
- El QR de la tarjeta sigue siendo para que el vendedor lo escanee (la app del cliente solo muestra el QR, no escanea).
- NO poner aún el botón "Instalar app" en la web wallet (queda para después).
- Push nativo = el motivo principal de la app.

Entrada a la app (modelo): el link de la vendedora abre la app si está instalada (deep link / App Links) → si no, la web. Fallback: pegar el enlace dentro de la app. La app guarda el token y abre directo.

🧪 Build de prueba v0.1 (Android)

Pendiente (siguiente iteración): App Links (deep link automático: assetlinks.json + apple-app-site-association), push nativo (FCM/APNs), íconos/splash definitivos, iOS.

🔗 App Links (deep link) — v0.2

🔔 Push nativo (FCM) — v0.3 (2026-09-27)