Estatus

Aprobado y Aplicado - última revisión: streaming incremental con offset aleatorio

Contexto

La gestión de playlists pasó por dos generaciones:

1. Primera generación: un género mapeaba a una sola playlist. El acoplamiento estaba en AppNavigation, la variedad era baja y la arquitectura no era extensible.
2. Segunda generación: un género mapea múltiples playlists. La carga es paralela, pero bloqueaba la UI hasta tener los 50 tracks completos (3–10+ s en condiciones reales) porque paginaba cada playlist al completo antes de renderizar nada.

Este ADR documenta la solución actual que resuelve el problema de latencia mediante carga incremental con streaming, sin introducir caché local ni nuevas dependencias.

Decisión

Reemplazar la llamada bloqueante a getMultiPlaylistTracks por un Flow que emite resultados parciales a medida que cada playlist responde. La pantalla de swipe se muestra en cuanto hay 5 tracks disponibles; el resto del mazo crece en segundo plano.

Principios del diseño

• Una sola página por playlist: en lugar de paginar toda la playlist, se pide un bloque de 50 tracks. Esto elimina los 20–60 llamadas a la API que generaba la paginación completa de 10 playlists.
• Offset aleatorio: el bloque se pide en una página seleccionada al azar entre {0, 50, 100, 150}, garantizando variedad entre sesiones sin coste adicional. Si la playlist es más corta que el offset elegido, se reintenta automáticamente con offset = 0.
• Semáforo aumentado: de Semaphore(3) a Semaphore(6), que sigue siendo seguro dentro del límite de ~30 req/s de Spotify pero reduce el cuello de botella.
• Append sin reshuffle: la primera playlist en llegar baraja sus tracks y siembra la lista. Las siguientes solo añaden al final. El usuario nunca ve el mazo reordenarse mientras swipea.
• Preview de Deezer en paralelo: el enriquecimiento de URLs de audio (necesario porque Spotify deprecó preview_url) pasa de un bucle secuencial a 5 peticiones paralelas con Semaphore(5), y se dispara solo para los tracks recién incorporados.

Componentes clave

GenrePlaylistProvider.kt