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

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.
This commit is contained in:
2026-11-01 12:21:40 +01:00
parent 76e19a3ab0
commit 2ec9259d19
10 changed files with 453 additions and 45 deletions
+34
View File
@@ -0,0 +1,34 @@
// Búsqueda libre del directorio, tolerante a tildes, mayúsculas y espacios.
//
// Reglas (deliberadamente simples y sin dependencias):
// - Se compara por palabras: TODAS las palabras de la consulta deben
// aparecer en algún campo del local ("bar toledo" no casa con un local de
// Toledo que no sea un bar).
// - Los campos participantes son los que anuncia la barra de filtros:
// nombre, provincia, categoría, subcategoría y dirección.
// - Consulta vacía -> todo casa (así el filtro no altera el listado).
import { normalizar, palabras } from "./texto.js";
export const CAMPOS_BUSQUEDA = [
"nombre",
"provincia",
"categoria",
"subcategoria",
"direccion",
];
// Texto normalizado de un local con todos sus campos buscables juntos. Se
// calcula por consulta: el directorio es pequeño y así no hay caché que
// invalidar cuando el admin edita un local.
export function indiceBusqueda(local) {
return normalizar(CAMPOS_BUSQUEDA.map((campo) => local?.[campo] || "").join(" "));
}
// ¿Casa el local con la consulta? "malaga" encuentra "Málaga", "peluqueria"
// encuentra "Peluquería" y "la escalera" encuentra "Bar la escalera".
export function coincideBusqueda(local, consulta) {
const terminos = palabras(consulta);
if (terminos.length === 0) return true;
const indice = indiceBusqueda(local);
return terminos.every((termino) => indice.includes(termino));
}
+23
View File
@@ -0,0 +1,23 @@
// Normalización de texto compartida por búsqueda y emparejamiento de
// provincias: minúsculas, sin tildes (NFD + eliminación de diacríticos) y con
// los espacios colapsados. La Ñ se reduce a N ("A Coruña" → "a coruna"), que
// es justo lo que se quiere para comparar sin que el usuario tenga que escribir
// acentos ni mayúsculas.
// Texto comparable: "Málaga " y "malaga" -> "malaga".
export function normalizar(texto) {
return String(texto ?? "")
.toLowerCase()
.normalize("NFD")
.replace(/[\u0300-\u036f]/g, "")
.replace(/\s+/g, " ")
.trim();
}
// Palabras de una consulta ya normalizadas y sin vacíos:
// " Bar Pepe " -> ["bar", "pepe"]. Una consulta vacía devuelve [].
export function palabras(texto) {
const normalizado = normalizar(texto);
if (!normalizado) return [];
return normalizado.split(" ");
}
+6 -7
View File
@@ -18,6 +18,7 @@
// campos que conocen (hoy lat/lng/nombre/provincia/direccion), de modo que
// añadir campos nuevos en el futuro (teléfono, horarios…) no rompe nada.
import { PROVINCIAS } from "../../constants/provincias.js";
import { normalizar } from "../texto.js";
export default class ProveedorUbicacion {
// Identificador del proveedor; cada subclase debe sobrescribirlo.
@@ -51,14 +52,12 @@ export default class ProveedorUbicacion {
// ── Helpers compartidos por todos los proveedores ────────────────────────
// Normaliza un texto: minúsculas, sin tildes y sin espacios extremos. Se usa
// para comparar provincias y etiquetas sin depender de acentos.
// Normaliza un texto: minúsculas, sin tildes y con espacios colapsados. Se
// usa para comparar provincias y etiquetas sin depender de acentos. La
// implementación vive en utils/texto.js: búsqueda y ubicación comparten una
// única definición de "texto comparable".
static normalizar(texto) {
return (texto || "")
.toLowerCase()
.normalize("NFD")
.replace(/[\u0300-\u036f]/g, "")
.trim();
return normalizar(texto);
}
normalizar(texto) {