Files
localesp/openspec/changes/unificar-filtros-iu/specs/barra-filtros-locales/spec.md
T
edgar.friendly 2169f1c64d openspec(filtros): cambio unificar-filtros-iu para la issue #3
Barra única de filtrado sin select de orden ni subcategorías (subtipos
replanteados en #22), provincia compacta + búsqueda por texto, barra
visible en lista y mapa. Decisiones de diseño documentadas en design.md.
2026-10-13 00:06:23 +02:00

3.9 KiB

Spec Delta: barra-filtros-locales

ADDED Requirements

Requirement: Sección única de filtrado

El sistema SHALL mostrar una única sección de filtrado que agrupe búsqueda por texto, categorías, provincia, favoritos, cercanía y orden, en lugar de barras de configuración separadas.

Scenario: Lista con una sola sección de filtros

  • WHEN se carga la web pública en la vista de lista
  • THEN todos los controles de filtrado (búsqueda, categorías, provincia, favoritos, cercanía y orden) aparecen dentro de una misma sección visual, sin filas de configuración duplicadas ni sueltas

Scenario: Misma sección en la vista de mapa

  • WHEN se cambia a la vista de mapa
  • THEN la sección de filtrado sigue visible y operativa, y los marcadores del mapa responden a los mismos filtros que la lista

Requirement: Sin control de subcategoría

La sección de filtrado SHALL no ofrecer ningún control de subcategoría; el filtrado por subtipos queda fuera de esta barra (replanteado en la issue #22) y su ausencia no altera los resultados por defecto.

Scenario: La barra no ofrece subtipos

  • WHEN se selecciona una categoría principal
  • THEN no aparece ningún control de subcategoría y la lista se filtra solo por la categoría elegida

Requirement: Filtro de provincia compacto y búsqueda

El sistema SHALL mantener el filtro de provincia como desplegable compacto junto al campo de búsqueda, y la búsqueda por texto SHALL encontrar también locales por su provincia.

Scenario: Filtrar provincia con el desplegable compacto

  • WHEN se elige una provincia en el desplegable
  • THEN la lista (y el mapa) se reducen a los locales de esa provincia

Scenario: Buscar por provincia

  • WHEN se escribe el nombre de una provincia en el campo de búsqueda
  • THEN la lista se reduce a los locales de esa provincia

Requirement: Orden con control segmentado

El sistema SHALL presentar el orden como control segmentado con icono y texto (Reciente / ★ Mejor / A-Z / 📍 Más cerca), sin desplegable; la opción «Más cerca» solo SHALL estar disponible con ubicación activa.

Scenario: Cambiar el orden sin desplegable

  • WHEN se pulsa «★» en el control segmentado
  • THEN la lista se reordena por mejor puntuación sin abrir ningún menú

Scenario: Orden por distancia condicionado

  • WHEN no hay ubicación activa
  • THEN la opción «📍 Más cerca» no se muestra en el control segmentado

Requirement: Acciones rápidas en la barra

La sección de filtrado SHALL incluir el conmutador de favoritos y el botón de cercanía («Cerca de mí» / «Ubicación activada ✕»), accesibles desde la propia barra.

Scenario: Favoritos desde la barra

  • WHEN se pulsa el chip «Favoritos» en la sección de filtrado
  • THEN la lista (y el mapa) muestran solo los locales marcados como favoritos, y el chip refleja el estado activo

Scenario: Cercanía y orden por distancia

  • WHEN se activa «Cerca de mí»
  • THEN el orden «Más cerca» pasa a estar disponible y la distancia se muestra en las tarjetas

Requirement: Limpiar todos los filtros

El sistema SHALL ofrecer un único botón «Limpiar» que resetee búsqueda, categoría, provincia, favoritos y orden, y desactive la ubicación si estaba activa.

Scenario: Limpiar de una vez

  • WHEN hay varios filtros activos y se pulsa «✕ Limpiar»
  • THEN todos los filtros vuelven a su estado por defecto y la lista muestra todos los locales publicados

Requirement: Criterios de filtrado intactos

El cambio es de presentación: dada la misma selección de filtros, el conjunto de locales resultante SHALL ser idéntico al anterior al cambio.

Scenario: Sin regresión en los resultados

  • WHEN se aplican los mismos valores de filtro que antes del cambio (texto, categoría, provincia, favoritos, orden)
  • THEN la lista de locales resultante es exactamente la misma que producía la UI anterior