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:
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-10-12
|
||||
@@ -0,0 +1,76 @@
|
||||
# Design: barra-filtros-locales
|
||||
|
||||
## Context
|
||||
|
||||
`src/App.jsx` (web pública, ~456 líneas) pinta hoy tres bloques de configuración antes del contenido:
|
||||
|
||||
1. **Chips de categoría** (con conteo por categoría y «✕ limpiar» solo de categoría).
|
||||
2. **Grid de 4 controles**: input de búsqueda + `<select>` subcategoría (deshabilitado sin categoría) + `<select>` provincia (50 opciones) + `<select>` orden (Reciente/★/A-Z/Cerca).
|
||||
3. **Fila de botones**: «Cerca de mí»/«Ubicación activada ✕» y «Favoritos (N)».
|
||||
|
||||
En la vista de mapa solo se ven los chips de categoría: los demás filtros aplican pero no son accesibles desde esa vista. El estado de los filtros vive en `App.jsx` (`filtroCategoria`, `filtroSubcat`, `filtroProvincia`, `busqueda`, `orden`, `soloFavoritos`, `ubicacion`) y la derivación `localesFiltrados` se comparte con el mapa. `AppMovil.jsx` es código muerto (nadie lo importa): fuera de alcance.
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:**
|
||||
- Una única sección de filtrado que reúna todos los controles en filas compactas.
|
||||
- Orden con control segmentado (icono + texto), sin select.
|
||||
- Búsqueda por texto que también matchee provincia.
|
||||
- Barra de filtros visible y funcional en lista y mapa.
|
||||
- Mantener intactos los criterios de filtrado (refactor de presentación, no de lógica).
|
||||
|
||||
**Non-Goals:**
|
||||
- No cambiar los criterios de filtrado ni la API.
|
||||
- No tocar contadores de portada (#4), tarjeta del local ni pasarela de propuesta.
|
||||
- No decidir el futuro de las subcategorías: issue #22 (aquí simplemente no tienen control en la barra).
|
||||
- No persistir filtros en la URL (anotado como mejora futura; hoy tampoco se persisten).
|
||||
- No eliminar `AppMovil.jsx` (muerto) — se registra en #12.
|
||||
|
||||
## Decisions
|
||||
|
||||
### D1 — Componente `BarraFiltros.jsx` con estado en `App.jsx`
|
||||
Extraer toda la UI de filtrado a `src/components/BarraFiltros.jsx`. `App.jsx` conserva el estado y `localesFiltrados` (la derivación la usan lista y mapa). *Alternativa descartada*: mover también el estado al componente obligaría a elevarlo de nuevo para el mapa.
|
||||
|
||||
### D2 — Estructura de la barra: tres filas dentro de una sola tarjeta
|
||||
Una sección visual única (fondo secundario, borde, radio) con filas:
|
||||
```
|
||||
🔍 Buscar nombre, dirección o provincia… [📍 Todas las provincias ▾]
|
||||
🍽️ Restauración (5) 🛍️ Comercio (3) ✂️ Estética (2) 🔧 Servicios 📌 Otros
|
||||
♥ Favoritos (3) 📍 Cerca de mí · [🕒 Reciente | ★ | A-Z | 📍] ✕ Limpiar
|
||||
```
|
||||
*Alternativa descartada*: una sola fila compacta — no cabe ni en desktop ni en móvil sin ocultar opciones.
|
||||
|
||||
### D3 — Sin control de subcategoría (decisión de diseño)
|
||||
La barra no incluye ningún control de subcategoría: los subtipos (~20 por categoría) se replantean como producto en la issue #22, así que no se les construye UI nueva aquí. El estado `filtroSubcat` queda sin control que lo fije (valor por defecto `""`) y el criterio de filtrado permanece intacto para quien lo invoque; si #22 concluye en eliminación, se retira estado y lógica allí.
|
||||
|
||||
### D4 — Provincia: desplegable compacto + búsqueda por texto
|
||||
Se mantiene el `<select>` de provincia como **desplegable compacto** en la fila de búsqueda (única excepción al «sin desplegables», decisión explícita) y la búsqueda por texto pasa a matchear también provincia. *Alternativa descartada*: chips solo de provincias con locales — se descartó por preferencia de mantener el selector completo de 50 provincias en poco espacio.
|
||||
|
||||
### D5 — Orden segmentado con icono + texto
|
||||
Control segmentado `[🕒 Reciente | ★ | A-Z | 📍]`: icono + texto, claro y autoexplicativo. «📍 Más cerca» solo se muestra con ubicación activa, igual que hoy.
|
||||
|
||||
### D6 — Barra compartida lista y mapa (confirmado)
|
||||
La sección completa se renderiza **en ambas vistas** (encima de las pestañas Lista/Mapa), porque el mapa ya filtra por los mismos criterios: elimina la asimetría actual. La leyenda de colores del mapa se mantiene dentro del contenedor del mapa.
|
||||
|
||||
### D7 — «✕ Limpiar» único global
|
||||
Un solo botón que resetea búsqueda, categoría, provincia, favoritos y orden (y desactiva ubicación si estaba). Desaparece el «✕ limpiar» solo-categoría (pulsar de nuevo el chip de categoría ya la deselecciona, como hoy).
|
||||
|
||||
### D8 — Chips de categoría mantienen su conteo
|
||||
El conteo por categoría es feedback útil y ya existe; no forma parte de #4 (que apunta a los contadores de portada).
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- [El select de provincia rompe la coherencia «todo chips»] → se asume como excepción consciente (D4); compensado con búsqueda por provincia.
|
||||
- [Cambiar UI sin cambiar criterios puede romper tests acoplados al markup] → refactor neutro inicial (extraer sin rediseñar) verificado con los tests actuales antes de sustituir controles.
|
||||
- [Regresión visual en móvil] → probar anchos estrechos (~360 px); targets ≥36–44 px.
|
||||
|
||||
## Migration Plan
|
||||
|
||||
1. Extracción neutra (`BarraFiltros` renderizando lo mismo) → verificar tests.
|
||||
2. Retirada del select de subcategoría; orden segmentado; provincia compacta + búsqueda.
|
||||
3. Unificación visual + extensión al mapa + «✕ Limpiar» global.
|
||||
Rollback trivial: es solo capa de presentación, revertir el commit.
|
||||
|
||||
## Open Questions
|
||||
|
||||
(ninguna pendiente: las cuatro dudas de diseño quedaron resueltas — D3 sin subcategorías → issue #22, D4 provincia compacta, D5 orden segmentado, D6 barra en ambas vistas)
|
||||
@@ -0,0 +1,36 @@
|
||||
# Proposal: unificar-filtros-iu
|
||||
|
||||
> Resuelve la issue #3 (Unificar filtros y botones de filtrado en la IU).
|
||||
|
||||
## Why
|
||||
|
||||
La vista de lista tiene hoy **tres barras de configuración** apiladas (chips de categorías, fila de búsqueda + 3 desplegables, fila de botones de ubicación/favoritos) que complican la UX innecesariamente: mucha superficie vertical antes del primer local, controles repartidos y desplegables que ocultan opciones (subcategoría, provincia, orden) y que en móvil son incómodos.
|
||||
|
||||
## What Changes
|
||||
|
||||
- Una **sección única de filtrado** («barra de filtros») que agrupa: búsqueda, categorías, provincia, favoritos, cercanía y orden.
|
||||
- **El orden pasa a un control segmentado** (icono + texto) y desaparece el `<select>` de orden; la **búsqueda por texto pasa a buscar también por provincia**.
|
||||
- **La provincia mantiene un desplegable compacto** (única excepción al «sin desplegables», decisión de diseño).
|
||||
- **Sin control de subcategoría** en la barra: los subtipos se replantean como producto en la issue #22.
|
||||
- La barra se muestra **también en la vista de mapa** (hoy ahí solo llegan los chips de categoría y el resto de filtros no es accesible), ya que el mapa ya respeta los mismos criterios.
|
||||
- **Botón único «✕ limpiar»** que resetea todos los filtros de golpe (hoy solo existe para la categoría).
|
||||
- Extracción del estado y controles de filtro de `App.jsx` a un componente `BarraFiltros`.
|
||||
|
||||
### No cambia
|
||||
- Los **criterios de filtrado** (misma selección ⇒ mismos resultados): la lógica de `localesFiltrados` se mantiene.
|
||||
- La API, la tarjeta del local (`tarjeta-local`), la pasarela de propuesta ni los contadores de portada (issue #4, fuera de alcance).
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
- `barra-filtros-locales`: sección única de búsqueda y filtrado del directorio (texto, categoría, provincia, favoritos, cercanía y orden), compartida por las vistas de lista y mapa.
|
||||
|
||||
### Modified Capabilities
|
||||
|
||||
(ninguna: ninguna spec existente cubre los filtros del listado; `tarjeta-local` y demás no cambian sus requisitos)
|
||||
|
||||
## Impact
|
||||
|
||||
- **Código**: `src/App.jsx` (se sustituyen la fila de chips + grid de selects + fila de botones por `BarraFiltros`), nuevo `src/components/BarraFiltros.jsx`, estilos en `src/styles/`.
|
||||
- **Tests**: verificar que los tests existentes de filtrado siguen en verde (criterios intactos); añadir cobertura del nuevo componente si procede.
|
||||
- **Riesgo bajo**: cambio confinado a la capa de presentación; sin cambios de API ni de datos.
|
||||
@@ -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
|
||||
@@ -0,0 +1,24 @@
|
||||
# Tasks: unificar-filtros-iu
|
||||
|
||||
## 1. Refactor neutro: extraer la UI de filtros
|
||||
|
||||
- [x] 1.1 Crear `src/components/BarraFiltros.jsx` recibiendo por props el estado de filtros y sus setters actuales de `App.jsx` (búsqueda, categoría, subcategoría, provincia, orden, favoritos, ubicación), renderizando exactamente los controles actuales (chips + grid de selects + fila de botones)
|
||||
- [x] 1.2 Sustituir en `App.jsx` las tres barras por `<BarraFiltros …/>` y verificar con los tests existentes que no hay cambios de comportamiento
|
||||
|
||||
## 2. Sustituir controles según el diseño
|
||||
|
||||
- [ ] 2.1 Retirar el control de subcategoría (el select actual desaparece sin reemplazo; los subtipos se replantean en la issue #22)
|
||||
- [ ] 2.2 Provincia: mantener el select como desplegable compacto junto al campo de búsqueda + ampliar la búsqueda por texto para que también matchee provincia
|
||||
- [ ] 2.3 Orden: control segmentado con icono + texto (🕒 Reciente / ★ / A-Z / 📍 Más cerca, este último condicionado a ubicación activa)
|
||||
|
||||
## 3. Unificar en una sola sección
|
||||
|
||||
- [ ] 3.1 Envolver todas las filas en una única sección visual (tarjeta con fondo secundario y filas compactas: búsqueda, categorías, subcategorías contextuales, provincias, acciones + orden)
|
||||
- [ ] 3.2 Añadir «✕ Limpiar» global que resetee todos los filtros y desactive la ubicación; retirar el «✕ limpiar» solo-categoría
|
||||
- [ ] 3.3 Mostrar la sección de filtrado también en la vista de mapa (encima de las pestañas), manteniendo la leyenda de colores dentro del contenedor del mapa
|
||||
|
||||
## 4. Verificación
|
||||
|
||||
- [ ] 4.1 Tests: mantener/ajustar los tests de filtrado y cubrir la nueva barra (búsqueda por provincia, orden segmentado, limpiar global)
|
||||
- [ ] 4.2 Comprobar anchos estrechos (~360 px) y accesibilidad: `aria-pressed` en chips, `aria-label` en búsqueda y orden segmentado, foco visible
|
||||
- [ ] 4.3 Verificar en la vista de mapa que los marcadores responden a los mismos filtros que la lista
|
||||
Reference in New Issue
Block a user