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.
77 lines
4.7 KiB
Markdown
77 lines
4.7 KiB
Markdown
# 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
|