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

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:
2026-11-01 14:01:52 +01:00
parent 56de0af7cc
commit 232ef3fcda
6 changed files with 240 additions and 14 deletions
+5
View File
@@ -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", () => {
+99 -1
View File
@@ -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);
});
});