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.
5.3 KiB
Design: barra-filtros-locales
Context
src/App.jsx (web pública, ~456 líneas) pinta hoy tres bloques de configuración antes del contenido:
- Chips de categoría (con conteo por categoría y «✕ limpiar» solo de categoría).
- 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). - 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
- Extracción neutra (
BarraFiltrosrenderizando lo mismo) → verificar tests. - Retirada del select de subcategoría; orden segmentado; provincia compacta + búsqueda.
- 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)