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
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.
202 lines
6.8 KiB
JavaScript
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);
|
|
});
|
|
});
|