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.
77 lines
5.9 KiB
Markdown
77 lines
5.9 KiB
Markdown
# 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)
|