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

77 lines
5.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)