Por Qué los Favoritos No Pueden Ser una Columna en Gasolineras

Image of the author

Germán Bustamante @germanbustamante

Pantalla de favoritos de Fuelio en Android, mostrando una estación marcada con su insignia de precio más barato

Por Qué los Favoritos No Pueden Ser una Columna en Gasolineras

Fuelio cachea gasolineras en Room para que la lista siga funcionando offline y repinte al instante desde disco antes de que la llamada de red siquiera responda. La forma obvia de añadir un flag de “favorito” parecía trivial: añadir isFavorite: Boolean a GasStationEntity, alternarlo al tocar, listo en una tarde.

No lo publiqué así, y el motivo está por completo en cómo se refresca la propia caché.

El patrón de escritura que hace insegura a una columna

GasStationRepositoryImpl.getGasStationsByLocation es stale-while-revalidate: emite lo que haya en caché para esa provincia de inmediato, y luego pide a la red la lista actual y reemplaza la caché — no la fusiona, la reemplaza:

@Transaction
suspend fun replaceGasStationsByProvince(provinceId: String, gasStations: List<GasStationEntity>) {
    deleteGasStationsByProvince(provinceId)
    insertGasStations(gasStations)
}

Es deliberado: las estaciones que cerraron o que el feed de origen dejó de listar no deberían quedarse para siempre en la caché. Pero significa que cada fila de esa provincia se destruye y reconstruye en cada refresh exitoso — incluido cualquier booleano que le hubiera atornillado encima. Marcas una estación como favorita, haces pull-to-refresh unos minutos después, y la estrella desaparece en silencio. No hay crash, no hay error — solo una estación guardada por el usuario que olvida en silencio que estaba guardada, con un calendario atado al timing de red del que el usuario no tiene ninguna visibilidad.

El arreglo: una tabla que el refresh nunca toca

Los favoritos viven en su propia tabla, indexada solo por el ID de la estación:

@Entity(tableName = "favorite_stations")
data class FavoriteStationEntity(@PrimaryKey val gasStationId: String, val addedAt: Long)

Leerlos de vuelta es un simple join contra lo que haya cacheado ahora mismo:

@Query(
    """
    SELECT gs.* FROM GasStationEntity gs
    INNER JOIN favorite_stations f ON gs.id = f.gasStationId
    ORDER BY f.addedAt DESC
    """,
)
fun observeFavoriteStations(): Flow<List<GasStationEntity>>

replaceGasStationsByProvince puede borrar y reinsertar filas de GasStationEntity tantas veces como quiera — favorite_stations nunca se toca, así que el favorito sobrevive a cada refresh, cada cambio de provincia, cada reinicio de la app.

El trade-off que el join te obliga a admitir

Un INNER JOIN solo devuelve filas que existen en ambos lados. Un favorito cuya provincia todavía no se ha cargado — o cuya estación de verdad ha desaparecido del feed de origen — simplemente no aparecerá. Ese es el comportamiento correcto, pero es un hueco real entre “tienes 5 favoritos” y “puedes ver ahora mismo 5 favoritos”, y el error fácil aquí es dejar que el join oculte esa diferencia en silencio.

En vez de eso, convertí el hueco en un valor de primera clase en lugar de un desajuste de conteo silencioso:

data class FavoriteStationsResult(val stations: List<GasStationBO>, val totalFavoriteCount: Int) {
    val unresolvedCount: Int get() = (totalFavoriteCount - stations.size).coerceAtLeast(0)
}

La pantalla de favoritos muestra unresolvedCount como un banner en vez de simplemente renderizar una lista más corta y confiar en que nadie note que faltan tres estaciones que marcó el mes pasado. Es el mismo instinto que dio forma al resto del manejo de errores de este repositorio: GasStationsResult lleva un flag explícito isFromCache en vez de dejar que quien lo consume lo adivine, y un refresh en segundo plano fallido va a un banner de datos obsoletos en vez de vaciar una pantalla que ya tiene contenido. Una vez decides que el límite de la caché es algo que hay que comunicarle a la UI en vez de ocultárselo, el hueco de favoritos es solo una instancia más de la misma regla, no un caso especial.

Conclusiones