feat(busqueda): búsqueda fuzzy por erratas, sólo como rescate
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
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.
This commit is contained in:
@@ -150,6 +150,11 @@ describe("BarraFiltros", () => {
|
||||
|
||||
renderBarra({ totalResultados: 0, totalLocales: 0 });
|
||||
expect(screen.getByRole("status").textContent).toMatch(/todavía no hay locales publicados/i);
|
||||
cleanup();
|
||||
|
||||
// Resultados de la etapa fuzzy: se avisa explícitamente
|
||||
renderBarra({ busqueda: "peluquera", totalResultados: 1, aproximada: true });
|
||||
expect(screen.getByRole("status").textContent).toBe("1 de 4 · búsqueda aproximada");
|
||||
});
|
||||
|
||||
it("El ✕ del buscador aparece solo con texto y borra únicamente la consulta", () => {
|
||||
|
||||
@@ -1,7 +1,17 @@
|
||||
// Búsqueda tolerante: tildes, mayúsculas, palabras múltiples y campos.
|
||||
import { describe, expect, it } from "vitest";
|
||||
|
||||
import { coincideBusqueda, indiceBusqueda, CAMPOS_BUSQUEDA } from "../../src/utils/busqueda.js";
|
||||
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 = {
|
||||
@@ -101,3 +111,91 @@ describe("indiceBusqueda", () => {
|
||||
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);
|
||||
});
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user