h-bitosInfantiles/STATUS.md

STATUS — Rachita

Estado vivo del desarrollo. Actualizar al cerrar cada hito o sesión de trabajo. Si retomas en un chat nuevo: lee CLAUDE.md (arquitectura/convenciones), PRD-Rachita.md (requisitos) y este archivo (dónde vamos), en ese orden.

Última actualización: 2026-07-04 (sesión 3) — SPRINT 1 COMPLETO (3/3 módulos verificados en dispositivo)

---

Sprint 1 — progreso

Módulo	Estado	Notas
1. Onboarding / Selección de avatar	✅ Hecho y verificado en dispositivo real	Compose + MVVM + DataStore; mascotas 100 % Canvas
2. Dashboard de hábitos + racha	✅ Hecho y verificado en dispositivo real, punta a punta	Toggle → contador → racha → XP → banner → persistencia tras force-stop
3. Monitoreo de batería (overlay <20 % + bloqueo en carga)	✅ Hecho y verificado en dispositivo real, punta a punta	CA-01..05 y BA-01..03 validados con batería simulada (dumpsys battery)

Verificado en dispositivo (2026-07-03, Huawei HBP-LX9, Android 12)

• Onboarding completo: título, 4 tarjetas, mascotas animadas, badge, CTA, persistencia y navegación.
• Fuentes Baloo 2 / Nunito cargan vía Downloadable Fonts (el equipo tiene Google Play Services).
• Dashboard punta a punta: gate de arranque, seed de 3 hábitos, tarjetas con check animado + "¡Hecho!", contador "te quedan N", racha 0→1 con V del viernes palomeada, banner "¡Racha asegurada hoy! 🔥", XP 0→30/500, mensaje celebratorio de la mascota, chip de batería real (verde cargando), singular/plural de racha, y persistencia completa tras force-stop + relanzamiento.

🔎 Lecciones EMUI de esta sesión (para futuras pruebas en este equipo)

• El header original (Row con Alignment.Bottom + SpaceBetween + texto con composable-en-template) medía ~270 dp fantasma SOLO en este dispositivo → la lista quedaba en altura 0 y las tarjetas ni se componían. Diagnóstico vía uiautomator dump (bounds de semántica), no vía screenshots.
• Los taps de adb input tap a <40 px del borde inferior se los come la zona de gestos de EMUI.
• adb shell settings put global stay_on_while_plugged_in 7 activado para que no se bloquee la pantalla durante desarrollo (revertir con valor 0 cuando termine el sprint).

Decisiones de producto tomadas en sesión 2

• Racha v1 (DA-11): se pierde completa al fallar un día; congelador pospuesto a v1.1 (recomendación del PRD §16.1).
• Horarios por hábito: el subtítulo ("A las 9:00 pm") es copy descriptivo; todo hábito cuenta antes de medianoche.
• XP: derivado 100 % de logs (10 XP por hábito hecho, nivel cada 500) — reversible y sin drift, igual que la racha. Sin tabla de recompensas aún (pregunta abierta §16.5).
• Racha mostrada: incluye hoy en cuanto se completa todo (feedback inmediato); desmarcar la revierte.

Historial de commits relevantes

• 6f5bca6 chore(android): scaffold Gradle KTS + version catalog + manifest + recursos base
• 1b5a1f7 feat(theme): paleta PRD §6 + Baloo 2/Nunito + shapes
• ae8f6b7 feat(onboarding): pantalla de avatar + mascotas Canvas + DataStore + NavHost
• 3f7602e fix(nav): placeholder de Dashboard con contenido visible (un Surface vacío parecía "pantalla en blanco" en pruebas)
• 28f2359 feat(habits): Room (Habit/HabitLog) + StreakCalculator + 6 tests
• 33de656 feat(battery): BatteryStatusMonitor (callbackFlow sobre sticky broadcast)
• 1d34b78 feat(dashboard): módulo 2 completo — 3 columnas, checks animados, confeti, gate
• 0eb4133 fix(dashboard): header a prueba de EMUI + weight en lista + singular de racha
• 5ca619b feat(ui): layout adaptativo — portrait compacto (<600dp) verificado en teléfono; tablet conserva 3 columnas

Entorno de build (esta Mac)

• NO hay Android Studio. JDK: /opt/homebrew/opt/openjdk@17 (el cask temurin@17 no registró bien; exportar JAVA_HOME explícito siempre).
• SDK: /opt/homebrew/share/android-commandlinetools (platforms 34+35, build-tools 34, platform-tools). app/local.properties ya apunta ahí (no versionado).
• Build: cd app && JAVA_HOME=/opt/homebrew/opt/openjdk@17 ./gradlew assembleDebug
• Instalar en dispositivo: mismo comando con installDebug. adb en /opt/homebrew/share/android-commandlinetools/platform-tools/adb.
• ⚠️ installDebug falla intermitente si el teléfono bloquea la pantalla → adb shell input keyevent KEYCODE_WAKEUP y reintentar.
• compileSdk 35 / targetSdk 34 / minSdk 26 — androidx.core 1.15 exige compilar contra 35; NO "corregirlo" a 34.

Decisiones tomadas

• Fuentes por Downloadable Fonts (Google Fonts provider), sin .ttf empaquetados. Ojo: Font(googleFont=...) se importa de androidx.compose.ui.text.googlefonts.Font.
• Mascotas vectoriales por código en MascotIllustrations.kt; estados tired/sleep se agregan con el módulo de batería.
• Avatar "Mi dibujo" usa Photo Picker (PickVisualMedia) — cero permisos de almacenamiento. Recorte orgánico (AV-02) pendiente de pulido.
• AV-08 (nombre configurable): ViewModel ya persiste childName, pero el onboarding no tiene campo de texto (el prototipo lo trata como prop, default "Lucía").

Deuda / pulido pendiente

1. Avatar personalizado ("Mi dibujo") aún no se muestra como imagen (falta Coil o similar en el catálogo); hoy cae al marco punteado. Recorte orgánico AV-02 pendiente.
2. Layout apretado en teléfono → resuelto con layout adaptativo (breakpoint 600 dp): portrait compacto en una columna, tablet conserva el diseño del PRD. Nota: el PRD pedía landscape-only en tablet; la orientación quedó desbloqueada — si se quiere volver a fijar SOLO en tablets, hacerlo por configuración en runtime, no en manifest. Menú de navegación no aparece en el layout compacto (destinos aún placeholder).
3. confettiOn (DA-05) hoy está fijo en true; se conecta cuando exista pantalla de Ajustes con gate parental. Confeti no confirmado visualmente en captura (el trigger sí disparó — banner y mensaje aparecieron); confirmar a ojo en dispositivo.
4. Campo de nombre en onboarding (AV-08): el ViewModel ya lo persiste; falta el input en UI.

Resultado de la prueba del módulo 3 en dispositivo (2026-07-04)

• CA-01 ✓ candado aparece solo al conectar USB (verificado 2 veces). CA-02 ✓ mascota dormida (ojos cerrados + Z) en cápsula con glow y estrellas. CA-03 ✓ "Cargando · N%" real.
• CA-04 ✓ "Ya la desconecté" nunca desbloquea con el cable puesto; con dumpsys battery unplug el candado cae solo (la verificación es estructural, no del botón).
• BA-01/02 ✓ overlay al 18 % sobre el dashboard con mascota cansada y % en negritas coral.
• BA-03 ✓ en vivo: descartado en banda 20 → reapareció al caer a 14 % (banda 15).
• CA-05 ✓ al 100 %: mascota despierta + "¡Desperté a tope de energía!".
• Escape "salir (debug)" ✓ (solo builds debug). Rollover de día ✓ ("Sábado 4 de julio", hábitos reseteados).
• Comandos de simulación: dumpsys battery unplug / set level N / reset.

Próximos pasos (en orden)

1. Pulido menor: texto "Conectar cargador" se parte en 2 líneas apretadas en portrait; sudor de la mascota cansada poco visible en tamaños chicos.
2. Sprint 2 (orden CLAUDE.md §3.1): Museo (subir dibujo) → Galería → Rachas en equipo → Alertas → Widgets.
3. Backend .NET 10 + deploy PapuTec (CLAUDE.md §4), CI Gitea Actions — necesario para Rachas en equipo.

Detalles de implementación del módulo 3 (para retomar)

• ui/battery/: BatteryUxViewModel (estados None/LowBattery/Charging), LowBatteryOverlay, ChargingLockScreen; host en MainActivity.BatteryUxHost sobre el NavHost.
• CA-04 es estructural: la pantalla de bloqueo se quita SOLO cuando BatteryStatusMonitor emite desconexión real; el botón nunca desbloquea.
• BA-03: LowBatteryPolicy (dominio puro, 7 tests) — descartar en banda 20 silencia hasta caer a 15, etc. Conectar el cargador resetea el ciclo.
• Mascota: MascotMood.Idle/Tired/Sleep en MascotIllustrations.kt (sudor menta, Z's con stagger de 3).
• Escape de desarrollo: "salir (debug)" solo BuildConfig.DEBUG (el equipo de pruebas vive conectado por USB).