Files
edgar.friendly 8a7c755ace feat(filtros): agrupa las provincias del desplegable por comunidad autónoma
PROVINCIAS_POR_COMUNIDAD (17 comunidades, 50 provincias) pasa a ser la
fuente única y PROVINCIAS se deriva de ella, así ningún listado queda
desincronizado. El desplegable de filtros y el de la pasarela de
propuesta usan <optgroup> con el nombre de la comunidad.

148/148 tests y build en verde.
2026-10-13 23:31:25 +02:00

4.7 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, con las provincias agrupadas por comunidad autónoma (<optgroup>), 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: Provincias agrupadas por comunidad autónoma

  • WHEN se abre el desplegable de provincia
  • THEN las provincias aparecen agrupadas bajo el nombre de su comunidad autónoma, y las 50 provincias están presentes una sola vez

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. El botón SHALL estar siempre presente —deshabilitado cuando no hay filtros activos— para que su aparición o desaparición no desplace al resto de controles.

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

Scenario: Sin desplazamiento al activar un filtro

  • WHEN se activa o desactiva un filtro (p. ej. el orden «★ Mejor» o «A-Z»)
  • THEN la posición del resto de controles de la barra no cambia, porque «✕ Limpiar» ya ocupaba su hueco (deshabilitado si no había filtros)

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