🔗 Nexus

← Volver a notas
25 KB 30/09/2026 12:15
🔗

Hoseg Dashboard — App móvil privada (Android + iOS) · Evaluación previa


1. Punto de partida (lo que YA existe)

Aspecto Hoy
Frontend React 18 + Vite (SPA), react-router, recharts. frontend/dist servido por Express
Backend Node 24 (Express 5) + SQLite (node:sqlite), Docker (node:24-slim) en Zeta
Auth JWT expira en 12 h (SECRET en env). Login POST /api/auth/login (correo+password, bcrypt)
Permisos Roles admin/usuario + permisos por menú (menus.js, requireMenu 403)
Módulos Diario · Categorías · Modelos · Margen · Valorizado · Registro por días · Reportes (5, programables) · Configuración (puntos/mapeo/metas/usuarios/costos)
CORS app.use(cors()) → abierto (permite el webview de la app)
TLS Caddy + Let's Encrypt (headers de seguridad; Permissions-Policy bloquea camera() a nivel web)
Responsive Parcial: drawer móvil, tablas con scroll, vista semanal en Registro. No hay manifest PWA ni service worker
Repo github.com/dannyelito/hoseg-dashboard (privado) · deploy por rsync (Zeta NO es clon git)

Conclusión: la web está lista para envolverse; falta la capa móvil (shell, sesión larga, features nativos, distribución).


2. Enfoque técnico — 3 opciones

A) Capacitor sobre el React actual ✅ RECOMENDADA

B) PWA (Add to Home Screen)

C) React Native / reescritura nativa

Recomendación: Capacitor + 3-4 features nativos (obligatorio para Apple 4.2, ver §4).


3. Distribución privada — cómo se hace realmente

Android (Google Play)

iOS (App Store)

Formularios/leyes que pide cada tienda


4. ⚠️ El riesgo #1: Apple Guideline 4.2 (minimum functionality)

Apple rechaza apps que son "solo una web empaquetada". El dashboard es web → hay que agregar valor nativo real antes de enviar. Candidatos (elegir 3-4):

Feature nativo Valor Notas
🔔 Push notifications Reporte diario / ventas del día / alerta de meta / stock bajo Requiere Firebase (FCM) + APNs (los certificados ya se tocan en Apple Developer)
🔐 Biometría / Face ID / PIN Login rápido y seguro Guardar token en Keychain/Keystore
📤 Compartir nativo (share sheet) Compartir reporte por WhatsApp/correo @capacitor/share
📶 Modo offline (caché de lectura) Ver últimos datos sin red + "sin conexión"
📷 Cámara / escáner de SKU Inventario: escanear código @capacitor/camera (+ ojo con Permissions-Policy camera=())
📊 Charts nativos Mejor rendimiento Opcional

Google Play tiene una política similar pero más laxa.

Plan B si Apple rechaza: TestFlight o PWA mientras.


5. Qué NECESITAMOS (checklist de prerrequisitos)

Cuentas / accesos

Materiales de tienda

Decisiones de negocio


6. Decisiones de diseño / UX (preguntas para Daniel)

  1. Alcance: ¿app completa (los 8 módulos) o foco móvil (Reporte Diario, Resumen, Inventario, Comisiones) y dejar lo pesado (Detallado/Excel, Configuración) solo web?
  2. Login: reusar usuarios del dashboard + biometría/PIN. Hoy el token dura 12 h → para móvil conviene sesión larga (p. ej. 30-90 días + refresh) o "mantener sesión iniciada".
  3. Push: ¿qué avisos y a quién?
  4. Ventas del día (ya existe por WhatsApp 22:30) · alerta de cumplimiento de meta · stock bajo/por agotarse · resumen semanal por supervisor.
  5. Offline: ¿solo lectura con caché, o online estricto? (recomendado: caché de lectura + aviso).
  6. Features nativos a incluir (los 3-4 de §4): ¿cuáles apruebas?
  7. Branding: nombre en tienda, ícono, ¿tema oscuro?, ¿solo español? ¿tablets?
  8. Comportamiento con versiones: ¿forzar actualización cuando el backend cambie (versión mínima)? (recomendado: endpoint /api/app/version).
  9. ¿Exportar Excel dentro de la app o solo ver reportes (descarga web)?

7. Estructura técnica propuesta

Repo / carpetas

hoseg-dashboard/
├─ backend/            (igual; + rutas nuevas de app)
├─ frontend/           (React actual; + ajustes móviles)
└─ mobile/             ← NUEVO (Capacitor)
   ├─ capacitor.config.*  (appId com.hoseg.dashboard, webDir ../frontend/dist)
   ├─ android/            (proyecto Gradle)
   └─ ios/                (proyecto Xcode)

Cambios en backend (nuevos)

Cambios en frontend (nuevos)

Build / distribución


8. Riesgos y mitigaciones

Riesgo Mitigación
Apple 4.2 (web empaquetada) 3-4 features nativos + notas de revisión; plan B TestFlight/PWA
Token 12 h → molesta en móvil Refresh token / sesión larga + biometría
Cuenta Apple Individual vs Organización Definir antes de publicar (cambiar seller name después es engorroso; organización exige D-U-N-S)
Permissions-Policy: camera=() en Caddy Ajustar el header si se usa cámara en el webview
SDKs iOS obligatorios Xcode 26 / iOS 26+ (Apple exige SDKs recientes)
Datos sensibles en el teléfono No guardar credenciales; token en secure storage; HTTPS; (opc.) certificate pinning
Duplicar UI Con Capacitor se reusa la web → riesgo bajo

9. Costos y esfuerzo (estimado)


10. Plan por fases (propuesto)


11. Preguntas concretas (bloqueantes para arrancar)

  1. ¿Quién es el publisher (Hoseg/14 Diez vs Disoftx)? ¿La cuenta Apple queda a nombre de quién?
  2. La cuenta Apple 8L4B4YB2Q8 ¿es Individual (Daniel) u Organización?
  3. Alcance: ¿app completa o foco móvil (qué módulos entran)?
  4. Push: ¿cuáles y a quién?
  5. Offline: ¿sí o no?
  6. Lista de correos que deben poder instalar (Android pista cerrada).
  7. ¿Apruebas Capacitor como enfoque? ¿Y las 3-4 features nativos?
  8. Nombre + ícono de la app.

🔔 FCM (push) — configurado (2026-09-15)

Anexos / referencias


🐞 Fix 2026-09-16 — Descargas dentro de la app


🔔 Push con preferencias por usuario — IMPLEMENTADO (2026-09-16)

Diseño aprobado por Daniel: catálogo de avisos (admin) + preferencias por usuario, sin filtro por punto de venta.


🔐 Build de release firmado (AAB + APK) — 2026-09-20

Firma de upload de Google Play generada y build de release firmado. Versión actual: versionCode 3 · versionName 1.1.0 (Capacitor 8, applicationId com.hoseg.dashboard).

Firma (keystore de upload)

Config de firma

Requisito de entorno (importante)

Comandos para recompilar

cd ~/.openclaw/workspace/proyectos/hoseg-dashboard
# 1) web assets
cd frontend && npm install && npm run build && cd ..
# 2) sync Capacitor
cd mobile && npm install && npx cap sync android && cd android
# 3) build firmado (JAVA_HOME=JDK21)
export ANDROID_HOME=/home/admin/android-sdk
export JAVA_HOME=/home/admin/jdk21/jdk-21.0.12.1+1
export PATH="$JAVA_HOME/bin:$PATH"
./gradlew bundleRelease assembleRelease

Salidas:
- AAB: mobile/android/app/build/outputs/bundle/release/app-release.aab
- APK: mobile/android/app/build/outputs/apk/release/app-release.apk
- Copias entregables: proyectos/hoseg-dashboard/entregables/HosegDashboard-1.1.0-release.{aab,apk}

Para subir de versión: editar versionCode/versionName en mobile/android/app/build.gradle y recompilar.

Artefactos de esta build

Pasos siguientes — Play Console (pista interna/cerrada)

  1. Play Console → app com.hoseg.dashboard (o crear la app si no existe) → Testing → Internal testing (o Closed testing) → crear release.
  2. Subir el .aab. Aceptar los avisos de firma (Play App Signing: la upload key que subimos firma el upload; Google gestiona la app signing key). Como es la primera subida, elegir enrolar en Play App Signing.
  3. Completar ficha: nombre, ícono, gráficos, descripción, política de privacidad, cuestionario de contenido, Data safety.
  4. Añadir correos a la lista de testers de la pista → compartir el link de opt-in (no aparece en búsqueda pública).
  5. ⚠️ Cuentas personales nuevas: el paso a Producción exige 12 testers × 14 días; no aplica si nos quedamos en Internal/Closed.
  6. Para actualizar builds: mismo keystore de upload + subir versionCode mayor.

📦 Publicación (2026-09-20)

Definiciones de Daniel:
- La app es de Disoftx (hecha para 14 Diez/Hoseg).
- Play Console: ya pagado (persona natural — Daniel Iturrizaga).
- Apple Developer: ya pagado (persona natural — Daniel Iturrizaga).
- Developer name público = Daniel Iturrizaga (persona natural).

Build de release (hecho):
- entregables/HosegDashboard-1.1.0-release.aab (4.7 MB · sha256 50c176bf…6893a) — firmado, jar verified.
- entregables/HosegDashboard-1.1.0-release.apk (5.2 MB) — para side-load.
- Keystore de upload: ~/keys/hoseg-dashboard-upload.jks · credenciales en credentials/hoseg-dashboard-android-keystore.json (chmod 600).
⚠️ Conservar el keystore: si se pierde, no se pueden publicar actualizaciones en Play.

Assets de tienda (generados):
- entregables/store/icon-512.png · entregables/store/feature-1024x500.png

Bloqueante: acceso a las consolas de Daniel (invitar usuario o subir él con guía).
iOS: requiere build vía Codemagic (sin Mac) o Mac; por definir.

📦 Release Android 1.2.0 (2026-09-27)

🍎 iOS — Codemagic FUNCIONANDO (2026-09-27)


📘 Playbook reutilizable

Todo el proceso (Capacitor → Android → Play → iOS/Codemagic → TestFlight), con los errores y sus soluciones, quedó documentado en:
wiki/manuales/publicar-app-movil-capacitor.md (Cerebro → Manuales).
Usarlo como punto de partida para cualquier app nueva.

🚀 Release 1.3.0 (2026-09-30)

Qué incluye: módulo Inventario del dashboard con columna Cantidad + fila expandible (stock en vivo por almacén/sucursal desde Odoo). (Commits cd7e5ca, 8b6867a.)

Versiones: Android versionCode 5 / versionName 1.3.0 · iOS MARKETING_VERSION 1.3.0 / CURRENT_PROJECT_VERSION 2 · ITSAppUsesNonExemptEncryption=NO (evita el prompt de compliance). Commit del bump: 3d070e0.

Android (build local en Omni):
- JDK21 /home/admin/jdk21/jdk-21.0.12.1+1 · SDK /home/admin/android-sdk · ./gradlew bundleRelease assembleRelease.
- Artefactos (en entregables/):
- HosegDashboard-1.3.0-release.aab — 4.9 MB — sha256 202fb61b9b0c1b822fd6ffd641180b78f495b5ee6c9842b49b0bf90ff09d1102
- HosegDashboard-1.3.0-release.apk — 5.3 MB — sha256 2bbd20d4847cd5526ad4a42f50df5fe38da106eb858ea34c36b6caa9f74671c3
- Verificado: apksigner verify → firmado con upload key (8D:DB:31:C0:…) · aapt dump badging → versionCode 5 / 1.3.0.
- Descarga pública: https://hoseg-dashboard.disoftx.solutions/descargas/hoseg-dashboard-1.3.0.apk (HTTP 200, content-type application/vnd.android.package-archive).
- ⚠️ Lección: NO dejar frontend/public/descargas/ cuando se hace npx cap sync: el APK/AAB (~10 MB) termina dentro de la app (el bundle pasó de 4.9 MB a 14 MB). Hay que borrar frontend/dist/descargas y frontend/public/descargas antes del sync y subir el APK al server por scp aparte.

iOS (Codemagic):
- Build 6abd42a776bc640cb0cc6c08 (workflow ios-testflight, branch master) → finished ✅ en 3 min (17:11→17:14 UTC).
- Artefacto App.ipa v1.3.0 (build 2) · tarea "App Store Connect distribution" (upload a TestFlight).
- entregables/HosegDashboard-1.3.0-release.ipa (1.55 MB, sha256 a3b2ace9cffb34c05871e58350d3b1bfd50faa31b102214d26a5aa3dab6c8f6b).
- Descarga del IPA vía API: la URL de artefacto responde 302 → GCS; usar curl -L -H "x-auth-token: $TOKEN".

Pendiente: subir el AAB a Play Console (prueba interna) y confirmar el procesamiento en TestFlight.