Files
localesp/tests/unit/busqueda.spec.js
T
edgar.friendly 232ef3fcda
deploy-branch / deploy (push) Successful in 2m59s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 3m25s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 3m14s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
feat(busqueda): búsqueda fuzzy por erratas, sólo como rescate
El fuzzy entra únicamente cuando la búsqueda normal no devuelve NADA, para no
ensuciar los resultados con falsos positivos.

- src/utils/busqueda.js: buscarLocales() en dos etapas.
  1. Exacta (todas las palabras aparecen), con puntuación de relevancia:
     3 si empiezan palabra ("bar" en «Bar Torrijos»), 2 si van a mitad
     ("bar" en «Albardón»).
  2. Aproximada, sólo si la 1 no devolvió nada: cada palabra a distancia de
     edición corta de alguna palabra del índice (Levenshtein con corte
     temprano). Umbral: sin fuzzy por debajo de 4 letras, 1 edición hasta 6,
     2 a partir de 7. "peluquera" → Peluquería, "torrjos" → Torrijos.
- App: filtra por el mapa de puntuaciones y ordena por relevancia primero,
  dejando el orden elegido como desempate.
- BarraFiltros: cuando los resultados son aproximados lo dice
  («1 de 4 · búsqueda aproximada») en el mismo role=status anunciado.
- scripts/entornos.env: alta del entorno de la rama.

Tests: 195/195 (10 nuevos) — umbrales, distancia con corte, cascada,
relevancia y que el fuzzy no se activa si hay coincidencias exactas.
2026-11-01 14:01:52 +01:00

202 lines
6.8 KiB
JavaScript

// Búsqueda tolerante: tildes, mayúsculas, palabras múltiples y campos.
import { describe, expect, it } from "vitest";
import {
buscarLocales,
coincideBusqueda,
distanciaEdicion,
distanciaMaxima,
indiceBusqueda,
CAMPOS_BUSQUEDA,
PUNTUACION_APROXIMADA,
PUNTUACION_A_MITAD_PALABRA,
PUNTUACION_PRINCIPIO_PALABRA,
} from "../../src/utils/busqueda.js";
import { normalizar, palabras } from "../../src/utils/texto.js";
const BAR = {
id: "1",
nombre: "Bar la escalera",
provincia: "Guadalajara",
categoria: "Restauración",
subcategoria: "Tapas y raciones",
direccion: "C. Alcaldes de la Villa, El Casar",
};
const PELUQUERIA = {
id: "2",
nombre: "Peluquería Campos",
provincia: "Málaga",
categoria: "Servicios",
subcategoria: "",
direccion: "C. Larios 3",
};
describe("normalizar", () => {
it("quita tildes, diéresis y mayúsculas", () => {
expect(normalizar("Málaga")).toBe("malaga");
expect(normalizar("PELUQUERÍA")).toBe("peluqueria");
expect(normalizar("C. Güell")).toBe("c. guell"); // diéresis fuera
});
it("reduce la Ñ a N y colapsa espacios", () => {
expect(normalizar("A Coruña")).toBe("a coruna");
expect(normalizar(" Bar Pepe ")).toBe("bar pepe");
});
it("tolera null, undefined y vacío", () => {
expect(normalizar(null)).toBe("");
expect(normalizar(undefined)).toBe("");
expect(normalizar(" ")).toBe("");
});
});
describe("palabras", () => {
it("separa la consulta en términos normalizados", () => {
expect(palabras(" Bar Pepe ")).toEqual(["bar", "pepe"]);
expect(palabras("MÁLAGA")).toEqual(["malaga"]);
});
it("consulta vacía no aporta términos", () => {
expect(palabras("")).toEqual([]);
expect(palabras(" ")).toEqual([]);
});
});
describe("coincideBusqueda", () => {
it("encuentra sin tildes ni mayúsculas (el caso que fallaba)", () => {
expect(coincideBusqueda(PELUQUERIA, "malaga")).toBe(true);
expect(coincideBusqueda(PELUQUERIA, "peluqueria")).toBe(true);
expect(coincideBusqueda(PELUQUERIA, "PELUQUERÍA")).toBe(true);
});
it("consulta vacía casa con todo (no filtra)", () => {
expect(coincideBusqueda(BAR, "")).toBe(true);
expect(coincideBusqueda(BAR, " ")).toBe(true);
});
it("exige que aparezcan TODAS las palabras", () => {
expect(coincideBusqueda(BAR, "bar escalera")).toBe(true);
expect(coincideBusqueda(BAR, "bar pizzeria")).toBe(false);
});
it("busca en provincia, categoría, subcategoría y dirección", () => {
expect(coincideBusqueda(BAR, "guadalajara")).toBe(true);
expect(coincideBusqueda(BAR, "restauracion")).toBe(true);
expect(coincideBusqueda(BAR, "tapas")).toBe(true);
expect(coincideBusqueda(BAR, "alcaldes")).toBe(true);
});
it("no casa cuando el término no está en ningún campo", () => {
expect(coincideBusqueda(BAR, "sevilla")).toBe(false);
});
it("es tolerante a espacios sobrantes y a varias palabras separadas", () => {
expect(coincideBusqueda(BAR, " BAR escalera ")).toBe(true);
});
it("soporta locales con campos nulos sin romper", () => {
const pobre = { id: "3", nombre: "Sin datos" };
expect(coincideBusqueda(pobre, "sin")).toBe(true);
expect(coincideBusqueda(pobre, "madrid")).toBe(false);
});
});
describe("indiceBusqueda", () => {
it("junta y normaliza todos los campos buscables", () => {
const indice = indiceBusqueda(PELUQUERIA);
expect(indice).toContain("peluqueria campos");
expect(indice).toContain("malaga");
expect(indice).toContain("larios");
expect(CAMPOS_BUSQUEDA).toHaveLength(5);
});
});
describe("distanciaMaxima", () => {
it("no tolera erratas en términos cortos y sí en los largos", () => {
expect(distanciaMaxima("bar")).toBe(0);
expect(distanciaMaxima("bars")).toBe(1);
expect(distanciaMaxima("torrijos")).toBe(2);
});
});
describe("distanciaEdicion", () => {
it("calcula la distancia mínima de edición", () => {
expect(distanciaEdicion("torrijos", "torrijos")).toBe(0);
expect(distanciaEdicion("torrjos", "torrijos")).toBe(1);
expect(distanciaEdicion("peluquera", "peluqueria")).toBe(1);
});
it("corta en cuanto supera el máximo pedido", () => {
expect(distanciaEdicion("abc", "xyz", 1)).toBe(2); // max + 1: descartado
});
});
describe("buscarLocales — cascada exacta y aproximada", () => {
const ALBARDON = {
id: "3",
nombre: "El Albardón",
provincia: "Madrid",
categoria: "Restauración",
subcategoria: "",
direccion: "",
};
const TORRIJOS = {
id: "4",
nombre: "Bar Torrijos",
provincia: "Guadalajara",
categoria: "Restauración",
subcategoria: "Tapas y raciones",
direccion: "",
};
const TODOS = [BAR, PELUQUERIA, ALBARDON, TORRIJOS];
it("sin consulta devuelve todo con la puntuación máxima", () => {
const { puntuaciones, aproximada } = buscarLocales(TODOS, " ");
expect(puntuaciones.size).toBe(4);
expect([...puntuaciones.values()].every((p) => p === PUNTUACION_PRINCIPIO_PALABRA)).toBe(true);
expect(aproximada).toBe(false);
});
it("puntúa mejor cuando la palabra empieza palabra", () => {
const { puntuaciones, aproximada } = buscarLocales(TODOS, "bar");
// "Bar la escalera" empieza por "bar"; "El Albardón" sólo lo contiene
expect(puntuaciones.get(BAR.id)).toBe(PUNTUACION_PRINCIPIO_PALABRA);
expect(puntuaciones.get(ALBARDON.id)).toBe(PUNTUACION_A_MITAD_PALABRA);
expect(puntuaciones.has(PELUQUERIA.id)).toBe(false);
expect(aproximada).toBe(false);
});
it("no activa el fuzzy si la búsqueda exacta encuentra algo", () => {
const { puntuaciones, aproximada } = buscarLocales(TODOS, "peluqueria");
expect(puntuaciones.size).toBe(1);
expect(puntuaciones.get(PELUQUERIA.id)).toBe(PUNTUACION_PRINCIPIO_PALABRA);
expect(aproximada).toBe(false);
});
it("tolera erratas cuando no hay ninguna coincidencia exacta", () => {
const { puntuaciones, aproximada } = buscarLocales(TODOS, "peluquera");
expect(puntuaciones.get(PELUQUERIA.id)).toBe(PUNTUACION_APROXIMADA);
expect(aproximada).toBe(true);
});
it("tolera erratas en una palabra de una consulta de varias", () => {
const { puntuaciones, aproximada } = buscarLocales(TODOS, "bar torrjos");
expect(puntuaciones.get(TORRIJOS.id)).toBe(PUNTUACION_APROXIMADA);
expect(puntuaciones.has(BAR.id)).toBe(false); // "escalera" no está cerca de "torrjos"
expect(aproximada).toBe(true);
});
it("no hace fuzzy con términos cortos (evita falsos positivos)", () => {
const { puntuaciones, aproximada } = buscarLocales(TODOS, "br");
expect(puntuaciones.size).toBe(0);
expect(aproximada).toBe(false);
});
it("sin coincidencias devuelve un mapa vacío y no marca aproximada", () => {
const { puntuaciones, aproximada } = buscarLocales(TODOS, "zapateria");
expect(puntuaciones.size).toBe(0);
expect(aproximada).toBe(false);
});
});