feat(busqueda): búsqueda tolerante a tildes, conteo de resultados y estado vacío accionable #24

Merged
edgar.friendly merged 1 commits from feat/busqueda-tolerante into master 2026-11-01 12:33:28 +01:00
Owner

Alternativa A de simplificación de la UX de búsqueda: arreglar lo que hoy duele sin cambiar la estructura de la barra.

El problema (medido en el código)

App.jsx filtraba con toLowerCase().includes() sobre 5 campos, sin normalizar tildes:

  • peluqueria no encontraba «Peluquería Campos».
  • malaga no encontraría «Málaga».
  • Sin contador: escribir no daba ninguna señal de si la consulta se aplicó.
  • Sin forma de borrar solo la consulta (había que pulsar «✕ Limpiar» y perder también provincia, categoría…).
  • Estado vacío = un párrafo sin acción, lejos del punto donde el usuario se quedó atascado.

Cambios

Fichero Qué
src/utils/texto.js (nuevo) normalizar (minúsculas, sin tildes/diéresis, Ñ→N, espacios colapsados) y palabras. ProveedorUbicacion.normalizar ahora delega aquí: una sola definición de «texto comparable».
src/utils/busqueda.js (nuevo) coincideBusqueda(local, consulta): todas las palabras deben aparecer en nombre, provincia, categoría, subcategoría o dirección. Consulta vacía → todo casa.
BarraFiltros.jsx Contador con role="status" + aria-live («4 locales», «2 de 4 locales»); ✕ dentro del input para borrar solo la consulta (y Escape); placeholder que dice la verdad («Nombre, dirección, categoría o provincia»). El reseteo lo hace App.
EstadoVacioLista.jsx (nuevo) Estado vacío con motivo y salida: «�� Quitar filtros» y «➕ Proponer «‹término›»» (abre la pasarela con el nombre ya rellenado). Distingue sin publicados / favoritos / búsqueda sin resultados.
App.jsx Usa coincideBusqueda, expone limpiarFiltros y pasa totalResultados/totalLocales.
scripts/entornos.env Alta del entorno de la rama (el build de deploy-branch exige prefijo admin por slug).

Detalles de criterio:

  • El contador no anuncia «N de M» cuando lo único activo es el orden (ordenar no reduce resultados), para no dar una falsa impresión de filtrado.
  • El ✕ del input no toca provincia ni categoría: borra únicamente la consulta.

Verificación

  • 185/185 tests (21 nuevos): unitarios de normalizar/palabras/coincideBusqueda (tildes, Ñ, multi-palabra, campos nulos) y de componente para el conteo, el ✕/Escape y el estado vacío.
  • Build ok (vite build).
  • Prueba contra los datos reales de producción:
"escalera"     -> Bar la escalera
"GUADALAJARA"  -> Peluquería Campos | Bar la escalera
"tapas"        -> La taberna de Argensola | Bar la escalera
"peluqueria"   -> Peluquería Campos     ← antes no salía
"bar torrijos" -> Bar Torrijos

Fuera de alcance (siguiente paso)

Unificar la caja de búsqueda con el select de provincia (alternativa B) y valorar la barra colapsable con hoja de filtros (C). Con esto ya se puede medir cuántas búsquedas dan 0 resultados antes de decidir.

Alternativa **A** de simplificación de la UX de búsqueda: arreglar lo que hoy duele sin cambiar la estructura de la barra. ## El problema (medido en el código) `App.jsx` filtraba con `toLowerCase().includes()` sobre 5 campos, sin normalizar tildes: - `peluqueria` **no** encontraba «Peluquería Campos». - `malaga` **no** encontraría «Málaga». - Sin contador: escribir no daba ninguna señal de si la consulta se aplicó. - Sin forma de borrar solo la consulta (había que pulsar «✕ Limpiar» y perder también provincia, categoría…). - Estado vacío = un párrafo sin acción, lejos del punto donde el usuario se quedó atascado. ## Cambios | Fichero | Qué | |---|---| | `src/utils/texto.js` (nuevo) | `normalizar` (minúsculas, sin tildes/diéresis, Ñ→N, espacios colapsados) y `palabras`. `ProveedorUbicacion.normalizar` ahora **delega** aquí: una sola definición de «texto comparable». | | `src/utils/busqueda.js` (nuevo) | `coincideBusqueda(local, consulta)`: **todas** las palabras deben aparecer en nombre, provincia, categoría, subcategoría o dirección. Consulta vacía → todo casa. | | `BarraFiltros.jsx` | Contador con `role="status"` + `aria-live` («4 locales», «2 de 4 locales»); **✕ dentro del input** para borrar solo la consulta (y `Escape`); placeholder que dice la verdad («Nombre, dirección, categoría o provincia»). El reseteo lo hace `App`. | | `EstadoVacioLista.jsx` (nuevo) | Estado vacío con motivo y salida: «�� Quitar filtros» y «➕ Proponer «‹término›»» (abre la pasarela con el nombre ya rellenado). Distingue sin publicados / favoritos / búsqueda sin resultados. | | `App.jsx` | Usa `coincideBusqueda`, expone `limpiarFiltros` y pasa `totalResultados`/`totalLocales`. | | `scripts/entornos.env` | Alta del entorno de la rama (el build de `deploy-branch` exige prefijo admin por slug). | Detalles de criterio: - El contador **no** anuncia «N de M» cuando lo único activo es el orden (ordenar no reduce resultados), para no dar una falsa impresión de filtrado. - El ✕ del input no toca provincia ni categoría: borra únicamente la consulta. ## Verificación - **185/185 tests** (21 nuevos): unitarios de `normalizar`/`palabras`/`coincideBusqueda` (tildes, Ñ, multi-palabra, campos nulos) y de componente para el conteo, el ✕/Escape y el estado vacío. - Build ok (`vite build`). - Prueba contra los datos reales de producción: ``` "escalera" -> Bar la escalera "GUADALAJARA" -> Peluquería Campos | Bar la escalera "tapas" -> La taberna de Argensola | Bar la escalera "peluqueria" -> Peluquería Campos ← antes no salía "bar torrijos" -> Bar Torrijos ``` ## Fuera de alcance (siguiente paso) Unificar la caja de búsqueda con el select de provincia (alternativa B) y valorar la barra colapsable con hoja de filtros (C). Con esto ya se puede medir cuántas búsquedas dan 0 resultados antes de decidir.
edgar.friendly added 1 commit 2026-11-01 12:21:56 +01:00
feat(busqueda): búsqueda tolerante a tildes, conteo de resultados y estado vacío accionable
deploy-branch / deploy (push) Successful in 2m46s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 3m15s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 3m16s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
2ec9259d19
Alternativa A de simplificación de la UX de búsqueda.

- src/utils/texto.js: normalizador compartido (minúsculas, sin tildes,
  espacios colapsados) + tokenizador por palabras. ProveedorUbicacion ahora
  delega aquí en vez de duplicar la implementación.
- src/utils/busqueda.js: reglas de la búsqueda libre. Se comparan TODAS las
  palabras de la consulta contra nombre, provincia, categoría, subcategoría y
  dirección. Antes era un `includes` con toLowerCase(): "peluqueria" no
  encontraba "Peluquería" y "malaga" no encontraba "Málaga".
- BarraFiltros: conteo de resultados con aria-live ("4 locales" / "2 de 4
  locales", sin anunciar como filtro el simple orden), ✕ dentro del input que
  borra solo la consulta (y Escape), placeholder que refleja de verdad lo que
  se busca. El reseteo de filtros pasa a App, que es dueña del estado.
- EstadoVacioLista (nuevo): el listado vacío explica el motivo y ofrece salida
  —«✕ Quitar filtros» y «➕ Proponer «‹término›»», que abre la pasarela con el
  nombre ya rellenado— en lugar del párrafo suelto sin acción.
- scripts/entornos.env: alta del entorno de la rama (el build de deploy-branch
  exige prefijo admin por slug).

Tests: 185/185 (21 nuevos) — unitarios de la búsqueda y de componente para el
conteo, el ✕/Escape y el estado vacío. Build ok.
edgar.friendly merged commit 56de0af7cc into master 2026-11-01 12:33:28 +01:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: edgar.friendly/localesp#24