Files
localesp/openspec/changes/unificar-filtros-iu/proposal.md
T
edgar.friendly 2169f1c64d 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.
2026-10-13 00:06:23 +02:00

37 lines
2.5 KiB
Markdown

# Proposal: unificar-filtros-iu
> Resuelve la issue #3 (Unificar filtros y botones de filtrado en la IU).
## Why
La vista de lista tiene hoy **tres barras de configuración** apiladas (chips de categorías, fila de búsqueda + 3 desplegables, fila de botones de ubicación/favoritos) que complican la UX innecesariamente: mucha superficie vertical antes del primer local, controles repartidos y desplegables que ocultan opciones (subcategoría, provincia, orden) y que en móvil son incómodos.
## What Changes
- Una **sección única de filtrado** («barra de filtros») que agrupa: búsqueda, categorías, provincia, favoritos, cercanía y orden.
- **El orden pasa a un control segmentado** (icono + texto) y desaparece el `<select>` de orden; la **búsqueda por texto pasa a buscar también por provincia**.
- **La provincia mantiene un desplegable compacto** (única excepción al «sin desplegables», decisión de diseño).
- **Sin control de subcategoría** en la barra: los subtipos se replantean como producto en la issue #22.
- La barra se muestra **también en la vista de mapa** (hoy ahí solo llegan los chips de categoría y el resto de filtros no es accesible), ya que el mapa ya respeta los mismos criterios.
- **Botón único «✕ limpiar»** que resetea todos los filtros de golpe (hoy solo existe para la categoría).
- Extracción del estado y controles de filtro de `App.jsx` a un componente `BarraFiltros`.
### No cambia
- Los **criterios de filtrado** (misma selección ⇒ mismos resultados): la lógica de `localesFiltrados` se mantiene.
- La API, la tarjeta del local (`tarjeta-local`), la pasarela de propuesta ni los contadores de portada (issue #4, fuera de alcance).
## Capabilities
### New Capabilities
- `barra-filtros-locales`: sección única de búsqueda y filtrado del directorio (texto, categoría, provincia, favoritos, cercanía y orden), compartida por las vistas de lista y mapa.
### Modified Capabilities
(ninguna: ninguna spec existente cubre los filtros del listado; `tarjeta-local` y demás no cambian sus requisitos)
## Impact
- **Código**: `src/App.jsx` (se sustituyen la fila de chips + grid de selects + fila de botones por `BarraFiltros`), nuevo `src/components/BarraFiltros.jsx`, estilos en `src/styles/`.
- **Tests**: verificar que los tests existentes de filtrado siguen en verde (criterios intactos); añadir cobertura del nuevo componente si procede.
- **Riesgo bajo**: cambio confinado a la capa de presentación; sin cambios de API ni de datos.