Hoseg Dashboard — App móvil privada (Android + iOS) · Evaluación previa
- Registrado: 2026-09-15 (pedido de Daniel: "hagamos la evaluación… dime qué necesitamos, qué debemos saber antes de desarrollar, preguntas de diseño, estructura")
- Estado: 🟡 Evaluación (NO iniciado desarrollo)
- Objetivo: app nativa Android + iOS, distribución privada por link (no descubrible en tienda), con login propio.
- Base: web actual — https://hoseg-dashboard.disoftx.solutions (React 18 + Vite · Node/Express + SQLite · Docker en Zeta)
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
- Envuelve
frontend/disten un contenedor nativo (Android/iOS) y expone APIs nativas al JS. - Pros: ~1 sola base de código; reusa TODA la UI y el backend tal cual; ya lo usamos en Fideliza/Hoseg Cash; build iOS en la nube (Codemagic) sin Mac.
- Contras: hay que "subir de nivel" la UX móvil (tablas anchas, charts) y añadir features nativos para pasar la revisión de Apple.
B) PWA (Add to Home Screen)
- Pros: costo $0, sin tiendas, se instala desde el navegador.
- Contras: en iOS las push requieren iOS 16.4+ y permiso explícito; sin link "de tienda"; no hay "app privada" como tal. Sirve como plan B mientras se aprueba lo nativo.
C) React Native / reescritura nativa
- Contras: duplicar toda la UI y lógica; costo alto; no aporta nada que Capacitor no dé aquí. Descartada.
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)
- Internal testing (hasta 100 testers) o Closed testing → link de opt-in + whitelist de correos. No aparece en búsqueda pública.
- Cuenta de desarrollador Play ya pagada ($25, 2026-09-06) — hoy es cuenta personal.
- ⚠️ Las cuentas personales nuevas (post 13-nov-2023) exigen 12 testers durante 14 días para habilitar el paso a Producción. No aplica si nos quedamos en Internal/Closed (nuestro caso).
- Alternativa empresa: Managed Google Play (app privada solo en dispositivos gestionados) — requiere MDM.
iOS (App Store)
- Unlisted App Distribution ← recomendada: la app sí pasa revisión y vive en la App Store, pero no es descubrible; se instala solo con link directo. Se solicita (formulario: motivo, audiencia, regiones). Una vez aprobada es permanente (no se puede volver a pública).
- Alternativas: TestFlight (link; hasta 10k externos; builds expiran cada 90 días) · Apple Business Manager – Custom Apps (solo organizaciones con ABM).
- Cuenta Apple Developer YA EXISTE (pagada 25/08, aprobada 30/08) → Team ID
8L4B4YB2Q8(creada para Hoseg Rewards/Apple Wallet). - ⚠️ Confirmar si esa cuenta es Individual (a nombre de Daniel) u Organización. El seller name en la tienda = nombre de la persona si es individual (a organización requiere D-U-N-S).
Formularios/leyes que pide cada tienda
- Apple: App Privacy (declaración de datos), export compliance (cifrado), demo account para el revisor, política de privacidad (URL), screenshots (6.7"/6.5"/5.5"), edad, ícono.
- Google: Data safety, content rating, política de privacidad, ficha (ícono, feature graphic, screenshots), AAB firmado.
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
- [x] Google Play ($25 pagado 06-09, personal) → definir si se queda personal o se pasa a organización.
- [x] Apple Developer ($99/año pagado 25-08, Team ID
8L4B4YB2Q8) → confirmar Individual vs Organización. - [ ] Codemagic (u otro CI cloud para iOS sin Mac) — plan (tiene free tier de minutos; macOS consume más).
- [ ] Acceso a App Store Connect + Play Console.
- [ ] Firebase (proyecto FCM) para push Android.
Materiales de tienda
- [ ] Nombre de la app (¿"Hoseg Dashboard" o "Hoseg"?) + bundle IDs (ej.
com.hoseg.dashboard). - [ ] Ícono (1024×1024) + splash + screenshots varias resoluciones.
- [ ] Descripción corta/larga, categoría, política de privacidad (URL), correo de soporte.
- [ ] Cuenta demo para el revisor de Apple (usuario de prueba).
Decisiones de negocio
- [ ] ¿Quién es el publisher legal? Hoseg / 14 Diez SAC vs Disoftx Solutions (afecta el seller name, la titularidad de las cuentas y a futuro quién las controla).
- [ ] Lista de usuarios con acceso (correos) → pista Android + links iOS.
- [ ] ¿Reusamos los usuarios del dashboard? (recomendado: sí) — requiere subir la sesión a largo plazo (§6).
6. Decisiones de diseño / UX (preguntas para Daniel)
- 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?
- 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".
- Push: ¿qué avisos y a quién?
- Ventas del día (ya existe por WhatsApp 22:30) · alerta de cumplimiento de meta · stock bajo/por agotarse · resumen semanal por supervisor.
- Offline: ¿solo lectura con caché, o online estricto? (recomendado: caché de lectura + aviso).
- Features nativos a incluir (los 3-4 de §4): ¿cuáles apruebas?
- Branding: nombre en tienda, ícono, ¿tema oscuro?, ¿solo español? ¿tablets?
- Comportamiento con versiones: ¿forzar actualización cuando el backend cambie (
versión mínima)? (recomendado: endpoint/api/app/version). - ¿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)
- API: se mantiene en
https://hoseg-dashboard.disoftx.solutions(CORS ya abierto). La app empaqueta el dist (no usaserver.urlremoto → mejor para Apple y para offline).
Cambios en backend (nuevos)
POST /api/app/device→ registrar device token (tabladispositivos: user_id, plataforma, token, updated_at).- Servicio de push (FCM + APNs) para los avisos elegidos.
GET /api/app/version→ versión mínima soportada (force-update).- Sesión larga: refresh token o expiración extendida (hoy 12 h).
- (Opcional) endpoint de escaneo de SKU para inventario.
Cambios en frontend (nuevos)
- Session storage → almacenamiento seguro (
capacitor-secure-storage/ Keychain/Keystore) en vez delocalStorage. - Ajustes UX móvil de las vistas clave (charts, tablas anchas), splash/status bar, biometría.
- Plugins:
@capacitor/push-notifications,preferences,splash-screen,status-bar,share,camera(si aplica), biometría.
Build / distribución
- Codemagic workflow:
npm run build(frontend) →npx cap sync→ Gradle (AAB) / Xcode (IPA). - Android → subir AAB a Internal testing → correos whitelist.
- iOS → subir IPA a App Store Connect → solicitar Unlisted → link directo.
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)
- Cuentas: Apple $99/año ✅ (ya pagada) · Play $25 ✅ (ya pagada) · Codemagic desde $0 (macOS consume más minutos) · Firebase $0.
- Esfuerzo (Capacitor): shell + sesión + biometría + 1 push ≈ corto; pulido móvil por vista y distribución/revisión son el grueso.
- Riesgo de tiempo real: la revisión de Apple (unlisted) puede pedir iteraciones por 4.2.
10. Plan por fases (propuesto)
- Fase 0 — Decisiones + cuentas: cerrar §5 y §6; verificar Apple (Individual/Org), crear proyecto Firebase.
- Fase 1 — Shell Capacitor: envolver
dist, sesión larga + biometría, splash/íconos. Build interno Android (APK directo para probar) + TestFlight iOS. - Fase 2 — Features nativos + UX móvil: push (ventas/meta/stock), share, caché offline; pulido de las 3-4 vistas clave.
- Fase 3 — Distribución privada: Android Internal/Closed con correos de Hoseg; iOS solicitar Unlisted y compartir link.
- Fase 4 — Mantenimiento: updates, versión mínima forzada, SDKs anuales.
11. Preguntas concretas (bloqueantes para arrancar)
- ¿Quién es el publisher (Hoseg/14 Diez vs Disoftx)? ¿La cuenta Apple queda a nombre de quién?
- La cuenta Apple
8L4B4YB2Q8¿es Individual (Daniel) u Organización? - Alcance: ¿app completa o foco móvil (qué módulos entran)?
- Push: ¿cuáles y a quién?
- Offline: ¿sí o no?
- Lista de correos que deben poder instalar (Android pista cerrada).
- ¿Apruebas Capacitor como enfoque? ¿Y las 3-4 features nativos?
- Nombre + ícono de la app.
🔔 FCM (push) — configurado (2026-09-15)
- Proyecto Firebase hoseg-dashboard (nº 973687176571), cuenta
d.iturrizaga@gmail.com. - Apps: Android
1:973687176571:android:5821004fc8de27bf7611de· iOS1:973687176571:ios:92f05071fb3639e47611de(idcom.hoseg.dashboard). - Credenciales en
credentials/firebase-hoseg/(google-services.json, GoogleService-Info.plist, service-account-fcm.json). Verificado:messages:sendOK. - ⏳ Pendiente manual: subir APNs Key .p8 en Firebase → Cloud Messaging → iOS (Team ID
8L4B4YB2Q8). - Plan por fases (§10): Fase 1 = shell Capacitor, APK de prueba + TestFlight.
Anexos / referencias
- Web y módulos:
wiki/proyectos/hoseg-dashboard.md - Stack app + cuentas (referencia Fideliza):
wiki/proyectos/fideliza-saas.md(Capacitor + Codemagic sin Mac) - Apple/Play en proyectos Wallet:
wiki/proyectos/hoseg-cash.md,wiki/proyectos/hoseg-cash-arquitectura.md
🐞 Fix 2026-09-16 — Descargas dentro de la app
- Síntoma: en el APK, "Descargar" un reporte no dejaba el archivo en ninguna parte visible.
- Causa: el WebView de Capacitor/Android ignora las descargas por
<a download href="blob:…">. - Solución:
frontend/src/download.js(guardarArchivo) → en nativo escribe el xlsx enDirectory.Cachey abre el diálogo nativo de Compartir/Guardar (@capacitor/filesystem+@capacitor/share); en web mantiene la descarga clásica + toast con el nombre del archivo. - Aplicado a los 8 exports (metas, detallado, plantilla costos, ventas, comisiones, resumen diario, inventario, variantes).
- APK 1.0.1 (versionCode 2) · link
https://hoseg-dashboard.disoftx.solutions/descargas/hoseg-dashboard-1.0.1.apk· commit8f0b6df.
🔔 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.
- Tipos del catálogo:
ventas_dia(22:30, resumen del día + % meta) ·meta(20:00, tiendas <80% de meta) ·stock_bajo(08:00, ≤3 unid,STOCK_BAJO_UMBRAL) ·comisiones(al enviarse el reporte programado) ·cierre_semanal(domingos 09:00). - Defaults por rol: admin → ventas_dia, meta, comisiones, cierre_semanal · usuario → ventas_dia, comisiones.
- Backend:
src/notificaciones.js,src/notifEventos.js,src/routes/notificaciones.js; tablasdispositivosynotif_log; columnasusuarios.notif_autorizados/notif_prefs; menúnotificaciones. - API:
GET /estado·PUT /prefs·POST/DELETE /device·POST /test·GET/PUT /admin/usuarios[/:id]. - App: pantalla "Notificaciones" (toggles con auto-guardado, horario silencioso, envío de prueba, matriz admin) + registro del token FCM al iniciar sesión en la app.
- Distribución: APK 1.1.0 —
https://hoseg-dashboard.disoftx.solutions/descargas/hoseg-dashboard-1.1.0.apk. - Pendiente: APNs key .p8 en Firebase (iOS) · definir si el umbral de stock bajo por SKU/categoría · push en iOS requiere build en Codemagic.
🔐 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)
- Keystore:
~/keys/hoseg-dashboard-upload.jks(dir~/keyscon perms700, archivo600). - Tipo PKCS12, RSA 2048, validez 10000 días (certs expiran ~2054), alias
hoseg-upload. - SHA-256 del certificado:
8D:DB:31:C0:6F:78:5B:0C:EA:E7:C0:15:D9:43:0A:C0:24:A7:FC:57:94:EF:86:CF:D2:6C:82:66:D4:E1:31:FE - Credenciales (store/key password + alias + rutas):
credentials/hoseg-dashboard-android-keystore.json(chmod600). ⚠️ Respaldar keystore + credenciales: si se pierden NO se pueden publicar updates en Play. mobile/android/key.properties(gitignored) apunta al keystore.mobile/android/.gitignoreignorakey.properties,*.jks,*.keystore.
Config de firma
mobile/android/app/build.gradle→signingConfigs.releaseleekey.properties;buildTypes.releasela usa.minifyEnabled false(sin cambios) para no romper push/Firebase (google-services.jsonintacto).- Commit:
290e275endannyelito/hoseg-dashboard(solobuild.gradle+.gitignore; sin secretos).
Requisito de entorno (importante)
- Capacitor 8 compila con Java 21 (
sourceCompatibility 21en los plugins). El host tiene JDK 21 en/home/admin/jdk21/jdk-21.0.12.1+1(eljavapor defecto es 17 → el build falla con "Cannot find a Java installation … languageVersion=21"). - Android SDK en
/home/admin/android-sdk(build-tools 35/36, platform android-36, licenses aceptadas).
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
- AAB
HosegDashboard-1.1.0-release.aab— 4,876,272 bytes (4.7 MB) — sha25650c176bf1ec8ba271cc04873323cef801454b382251c91c2c9d237d5f667893a - APK
HosegDashboard-1.1.0-release.apk— 5,245,075 bytes (5.1 MB) — sha25602dbe0a2ed8aa960c7c9d88f3d164d86ee7d6bab2b459dd471136289074c7a80 - Firma verificada:
jarsigner -verify→ jar verified (signerHOSEG-UP);apksigner verifyAPK → certCN=Hoseg Dashboard, OU=Mobile, O=Hoseg, L=Lima, ST=Lima, C=PE(mismo SHA-256 de arriba). No se usó la debug key.
Pasos siguientes — Play Console (pista interna/cerrada)
- Play Console → app
com.hoseg.dashboard(o crear la app si no existe) → Testing → Internal testing (o Closed testing) → crear release. - 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. - Completar ficha: nombre, ícono, gráficos, descripción, política de privacidad, cuestionario de contenido, Data safety.
- Añadir correos a la lista de testers de la pista → compartir el link de opt-in (no aparece en búsqueda pública).
- ⚠️ Cuentas personales nuevas: el paso a Producción exige 12 testers × 14 días; no aplica si nos quedamos en Internal/Closed.
- 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)
- versionCode 4 · versionName 1.2.0 (Capacitor 8,
com.hoseg.dashboard). - Incluye todo lo nuevo de la web: menú Inventario, módulo Proveedor (scope por marca), gráficos, fixes de UI (sidebar/footer) y de seguridad.
- Build:
npx cap sync android+JAVA_HOME=/home/admin/jdk21/jdk-21.0.12.1+1 ./gradlew bundleRelease assembleRelease. - Artefactos (en
entregables/): HosegDashboard-1.2.0-release.aab— 4.9 MB — sha256d7778ef04a2f128aa971332e75703d96a363a14594ab9f8cedf117bf659b4b4b—jar verified.HosegDashboard-1.2.0-release.apk— 5.3 MB — sha25670609b2edae3fca6f3539c9041c563628169c7a3b1241f6f8382abc615d5ade1.- Descarga pública arreglada:
https://hoseg-dashboard.disoftx.solutions/descargas/hoseg-dashboard-1.2.0.apk(antes el catch-all del SPA devolvía HTML en/descargas/*). El APK va enfrontend/public/descargas/(gitignored) y se sirve con content-typeapplication/vnd.android.package-archive. - Commit
7ccfa73. - iOS: pendiente — no se puede compilar en el VPS Linux (requiere macOS/Xcode). Opciones: Codemagic (nube) o Mac.
🍎 iOS — Codemagic FUNCIONANDO (2026-09-27)
- App Codemagic:
hoseg-dashboard(6ab984c1cbc0a33c0a11165b) · team6ab077bca8f43f97e7776b4a· projectTypeios-app· settingsSourcefile. - Integración Apple: tarjeta Developer Portal → key name
hoseg_appstore(App Store Connect API key, Key ID5C94YYTU74, rol App Manager). - Credenciales: grupo
code-signingconCERTIFICATE_PRIVATE_KEY(clave RSA 2048 generada por Nexus →credentials/hoseg-ios-dist-key). codemagic.yaml(workflowios-testflight): node 22 · xcode latest ·integrations.app_store_connect: hoseg_appstore·groups: [code-signing].- Firma por CLI:
keychain initialize→app-store-connect fetch-signing-files "$BUNDLE_ID" --type IOS_APP_STORE --create→keychain add-certificates→xcode-project use-profiles. - Build:
xcode-project build-ipa --project mobile/ios/App/App.xcodeproj --scheme App. - Publishing:
app_store_connect: auth: integration+submit_to_testflight: true. - Build #12 = finished ✅ (commit
171d636): artefactoApp.ipa(1.5 MB) + tarea "App Store Connect distribution" (upload a TestFlight). - LECCIONES CLAVE:
ios_signing(distribution_type + bundle_identifier) NO crea certificados: solo usa los subidos a Code Signing Identities. Con la cuenta vacía →No matching profiles found.- Sin
keychain initialize→Command CodeSign failed ... errSecInternalComponent. - El YAML solo acepta
integrations.app_store_connect(noapple_developer_portal). - API de Codemagic (
x-auth-token):GET /apps,GET /team/{id},GET /builds?appId=,POST /builds {appId,workflowId,branch}, y logs por step:buildActions[].subactions[].logUrl.
Token encredentials/codemagic-token.txt. ⚠️ da 401 intermitente → reintentar.
📘 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.