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

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