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.
This commit is contained in:
2026-10-13 00:06:23 +02:00
parent ac566a9655
commit 2169f1c64d
5 changed files with 206 additions and 0 deletions
@@ -0,0 +1,68 @@
# 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