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

5.9 KiB
Raw Permalink Blame History

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 (agrupado por comunidad) + 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. Las provincias se agrupan por comunidad autónoma con <optgroup>: PROVINCIAS_POR_COMUNIDAD es la fuente única y PROVINCIAS (listado plano que usan la búsqueda y los proveedores de ubicación) se deriva de ella, evitando listados desincronizados. El mismo desplegable agrupado se usa en la pasarela de propuesta. 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, siempre presente

Un solo botón que resetea búsqueda, categoría, provincia, favoritos y orden (y desactiva ubicación si estaba). Se renderiza siempre, deshabilitado cuando no hay filtros activos: al aparecer/desaparecer condicionalmente, su hueco robaba espacio al grupo de orden (alineado a la derecha con margin-left:auto) y lo desplazaba justo al pulsar «★ Mejor» o «A-Z». 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)