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,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)
|
||||
Reference in New Issue
Block a user