Author SHA1 Message Date
edgar.friendly 232ef3fcda 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.
2026-11-01 14:01:52 +01:00
edgar.friendly 56de0af7cc merge: PR #24 — búsqueda tolerante, conteo de resultados y estado vacío accionable
deploy-branch / deploy (push) Successful in 2m37s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 3m12s
tests / Integración (Nominatim real, opt-in) (push) Skipped
Búsqueda tolerante a tildes y mayúsculas (utils/texto.js + utils/busqueda.js), conteo de resultados con aria-live, ✕/Escape en el input y estado vacío accionable con «Quitar filtros» y «Proponer ‹término›».

185/185 tests (21 nuevos).
2026-11-01 12:33:27 +01:00
edgar.friendly 2ec9259d19 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.
2026-11-01 12:21:40 +01:00
10 changed files with 679 additions and 45 deletions
+2
View File
@@ -8,4 +8,6 @@
# Nuevos entornos: añade una línea con el slug de tu rama.
prototipo-yb01=/administrador
master=/administrador
feat-busqueda-tolerante=/administrador
feat-busqueda-fuzzy=/administrador
# prototipo-yb01-ef=/administrador
+47 -12
View File
@@ -11,6 +11,8 @@ import BotonFlotante from "./components/BotonFlotante.jsx";
import BotonProponerArriba from "./components/BotonProponerArriba.jsx";
import ModalPasarela from "./components/ModalPasarela.jsx";
import BarraFiltros from "./components/BarraFiltros.jsx";
import EstadoVacioLista from "./components/EstadoVacioLista.jsx";
import { coincideBusqueda, buscarLocales } from "./utils/busqueda.js";
import useFavoritos from "./hooks/useFavoritos.js";
import useUbicacion from "./hooks/useUbicacion.js";
@@ -92,6 +94,28 @@ export default function App() {
setPosibleDuplicado(null);
};
// Desde el estado vacío del listado: abre la pasarela con el término buscado
// ya puesto como nombre del local, que es justo lo que el usuario iba
// buscando (y no encontró).
const abrirPasarelaConNombre = (texto) => {
const nombre = (texto || "").trim();
if (nombre) setForm((f) => ({ ...f, nombre }));
abrirPasarela();
};
// Limpiar filtros vive aquí porque el estado es de App: así lo puede usar
// tanto la barra como el estado vacío del listado, sin duplicar el reseteo.
const limpiarFiltros = () => {
setBusqueda("");
setFiltroCategoria("");
setFiltroProvincia("");
setSoloFavoritos(false);
setOrden("fecha");
if (ubicacion) limpiarUbicacion();
};
const hayFiltros = Boolean(busqueda || filtroCategoria || filtroProvincia || soloFavoritos || orden !== "fecha" || ubicacion);
// Cerrar la pasarela descarta el borrador en curso
const cerrarPasarela = () => {
setPasarelaAbierta(false);
@@ -164,16 +188,23 @@ export default function App() {
guardarPropuesta(posibleDuplicado.lat, posibleDuplicado.lng);
};
// Búsqueda en cascada (exacta -> prefijo -> aproximada). Las puntuaciones
// se usan para (a) filtrar y (b) ordenar por relevancia; `aproximada`
// avisa en la barra de que los resultados vienen de la etapa fuzzy.
const { puntuaciones: puntuacionesBusqueda, aproximada } = buscarLocales(locales, busqueda);
const localesFiltrados = locales
.filter((l) => {
const q = busqueda.toLowerCase();
return (!q || l.nombre.toLowerCase().includes(q) || l.provincia.toLowerCase().includes(q) || (l.categoria || "").toLowerCase().includes(q) || (l.subcategoria || "").toLowerCase().includes(q) || (l.direccion || "").toLowerCase().includes(q))
.filter((l) => puntuacionesBusqueda.has(l.id)
&& (!filtroCategoria || l.categoria === filtroCategoria)
&& (!filtroSubcat || l.subcategoria === filtroSubcat)
&& (!filtroProvincia || l.provincia === filtroProvincia)
&& (!soloFavoritos || esFavorito(l.id));
})
&& (!soloFavoritos || esFavorito(l.id)))
.sort((a, b) => {
// Con consulta, primero lo más relevante (exacto > prefijo > aproximado)
// y el orden elegido como desempate.
const porRelevancia = (puntuacionesBusqueda.get(b.id) || 0) - (puntuacionesBusqueda.get(a.id) || 0);
if (porRelevancia !== 0) return porRelevancia;
if (orden === "distancia" && ubicacion) {
const da = a.lat && a.lng ? calcularDistanciaKm(ubicacion.lat, ubicacion.lng, a.lat, a.lng) : Infinity;
const db = b.lat && b.lng ? calcularDistanciaKm(ubicacion.lat, ubicacion.lng, b.lat, b.lng) : Infinity;
@@ -295,6 +326,9 @@ export default function App() {
soloFavoritos={soloFavoritos} setSoloFavoritos={setSoloFavoritos}
ubicacion={ubicacion} buscandoUbicacion={buscandoUbicacion} errorUbicacion={errorUbicacion}
pedirUbicacion={pedirUbicacion} limpiarUbicacion={limpiarUbicacion}
totalResultados={localesFiltrados.length} totalLocales={locales.length}
aproximada={Boolean(busqueda) && aproximada}
onLimpiar={limpiarFiltros}
/>
@@ -316,13 +350,14 @@ export default function App() {
Cargando locales...
</div>
) : localesFiltrados.length === 0 ? (
<div style={{ textAlign: "center", padding: "3rem", color: "var(--color-text-tertiary)" }}>
<div style={{ fontSize: 40, marginBottom: 12 }} aria-hidden="true">🏘️</div>
<p style={{ margin: 0, fontWeight: 500 }}>
{locales.length === 0 ? "Todavía no hay locales publicados" : soloFavoritos ? "Aún no tienes favoritos guardados" : "No hay locales que coincidan"}
</p>
<p style={{ margin: "6px 0 0", fontSize: 13 }}>{soloFavoritos ? "Pulsa el corazón ♥ en un local para guardarlo aquí" : "Sé el primero en proponer uno — el administrador lo revisará y publicará"}</p>
</div>
<EstadoVacioLista
totalLocales={locales.length}
soloFavoritos={soloFavoritos}
hayFiltros={hayFiltros}
busqueda={busqueda}
onLimpiar={limpiarFiltros}
onProponer={abrirPasarelaConNombre}
/>
) : (
<div style={{ display: "grid", gap: 10 }}>
{localesFiltrados.map((local) => (
+59 -11
View File
@@ -38,18 +38,22 @@ export default function BarraFiltros({
orden, setOrden,
soloFavoritos, setSoloFavoritos,
ubicacion, buscandoUbicacion, errorUbicacion, pedirUbicacion, limpiarUbicacion,
totalResultados, totalLocales, onLimpiar, aproximada = false,
}) {
const conteosCat = NOMBRES_CATEGORIAS.reduce((acc, c) => { acc[c] = locales.filter((l) => l.categoria === c).length; return acc; }, {});
const opcionesOrden = ubicacion ? [...OPCIONES_ORDEN, OPCION_ORDEN_DISTANCIA] : OPCIONES_ORDEN;
const hayFiltros = busqueda || filtroCategoria || filtroProvincia || soloFavoritos || orden !== "fecha" || ubicacion;
const filtrando = Boolean(busqueda || filtroCategoria || filtroProvincia || soloFavoritos || ubicacion);
const limpiarTodo = () => {
setBusqueda("");
setFiltroCategoria("");
setFiltroProvincia("");
setSoloFavoritos(false);
setOrden("fecha");
if (ubicacion) limpiarUbicacion();
// Feedback de la búsqueda: sin esto el usuario no sabe si la consulta se
// aplicó o si simplemente no hay nada. Solo cuenta como "N de M" cuando hay
// un filtro activo que pueda reducir el listado (ordenar no reduce). Si los
// resultados vienen de la etapa fuzzy, se dice explícitamente.
const textoConteo = () => {
if (totalLocales === 0) return "Todavía no hay locales publicados";
if (aproximada) return `${totalResultados} de ${totalLocales} · búsqueda aproximada`;
if (filtrando && totalResultados !== totalLocales) return `${totalResultados} de ${totalLocales} locales`;
return `${totalLocales} ${totalLocales === 1 ? "local" : "locales"}`;
};
return (
@@ -68,13 +72,43 @@ export default function BarraFiltros({
>
{/* Búsqueda + provincia compacta */}
<div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}>
<div style={{ position: "relative", flex: 1, minWidth: 140 }}>
<input
style={{ ...inputStyle, flex: 1, minWidth: 140 }}
placeholder="🔍 Buscar por nombre, dirección o provincia..."
style={{ ...inputStyle, paddingRight: busqueda ? 34 : undefined }}
placeholder="🔍 Nombre, dirección, categoría o provincia…"
value={busqueda}
onChange={(e) => setBusqueda(e.target.value)}
aria-label="Buscar por nombre, dirección o provincia"
onKeyDown={(e) => {
if (e.key === "Escape" && busqueda) {
e.preventDefault();
setBusqueda("");
}
}}
aria-label="Buscar por nombre, dirección, categoría o provincia"
/>
{busqueda && (
<button
type="button"
onClick={() => setBusqueda("")}
aria-label="Borrar búsqueda"
style={{
position: "absolute",
right: 4,
top: "50%",
transform: "translateY(-50%)",
border: "none",
background: "none",
cursor: "pointer",
padding: 6,
fontSize: 13,
lineHeight: 1,
color: "var(--color-text-tertiary)",
}}
>
✕
</button>
)}
</div>
<select style={{ ...inputStyle, width: "auto", flexShrink: 0 }} value={filtroProvincia} onChange={(e) => setFiltroProvincia(e.target.value)} aria-label="Filtrar por provincia">
<option value="">📍 Todas las provincias</option>
{Object.entries(PROVINCIAS_POR_COMUNIDAD).map(([comunidad, provincias]) => (
@@ -85,6 +119,20 @@ export default function BarraFiltros({
</select>
</div>
{/* Conteo de resultados: se anuncia en cada cambio de filtros. */}
<p
role="status"
aria-live="polite"
style={{
margin: 0,
fontSize: 12,
lineHeight: 1.2,
color: aproximada ? "#8A6D3B" : "var(--color-text-tertiary)",
}}
>
{textoConteo()}
</p>
{/* Chips categorías */}
<div style={{ display: "flex", flexWrap: "wrap", gap: 6 }}>
{NOMBRES_CATEGORIAS.map((cat) => {
@@ -135,7 +183,7 @@ export default function BarraFiltros({
{/* Siempre presente (deshabilitado sin filtros): así reserva su hueco
y no desplaza a los controles vecinos al activarse un filtro. */}
<button onClick={limpiarTodo} disabled={!hayFiltros}
<button onClick={onLimpiar} disabled={!hayFiltros}
aria-label="Limpiar todos los filtros"
style={{ ...estiloChip, background: "none", border: "0.5px solid var(--color-border-secondary)", color: "var(--color-text-tertiary)", cursor: hayFiltros ? "pointer" : "default", opacity: hayFiltros ? 1 : 0.4 }}>
✕ Limpiar
+73
View File
@@ -0,0 +1,73 @@
// Estado vacío del listado. Antes era un párrafo suelto sin acción: si una
// búsqueda no devolvía nada, el usuario tenía que volver arriba, limpiar a mano
// y adivinar. Ahora el propio estado vacío ofrece salida: quitar los filtros o
// proponer ese local que no aparece (con el término buscado ya rellenado).
export default function EstadoVacioLista({
totalLocales,
soloFavoritos,
hayFiltros,
busqueda,
onLimpiar,
onProponer,
}) {
const termino = (busqueda || "").trim();
const sinPublicados = totalLocales === 0;
const titulo = sinPublicados
? "Todavía no hay locales publicados"
: soloFavoritos
? "Aún no tienes favoritos guardados"
: termino
? `No hay locales que coincidan con «${termino}»`
: "No hay locales que coincidan";
const ayuda = sinPublicados
? "Sé el primero en proponer uno — el administrador lo revisará y publicará"
: soloFavoritos
? "Pulsa el corazón ♥ en un local para guardarlo aquí"
: termino
? "Prueba con otras palabras o propón tú ese local"
: "Prueba a quitar algún filtro";
const estiloAccion = {
borderRadius: 20,
padding: "7px 14px",
fontSize: 13,
cursor: "pointer",
border: "0.5px solid var(--color-border-secondary)",
background: "var(--color-background-primary)",
color: "var(--color-text-secondary)",
};
return (
<div
style={{ textAlign: "center", padding: "3rem 1rem", color: "var(--color-text-tertiary)" }}
role="status"
>
<div style={{ fontSize: 40, marginBottom: 12 }} aria-hidden="true">
{sinPublicados ? "🏘️" : "🔍"}
</div>
<p style={{ margin: 0, fontWeight: 500 }}>{titulo}</p>
<p style={{ margin: "6px 0 0", fontSize: 13 }}>{ayuda}</p>
{(hayFiltros || termino) && (
<div style={{ display: "flex", gap: 8, justifyContent: "center", flexWrap: "wrap", marginTop: 16 }}>
{hayFiltros && (
<button type="button" onClick={onLimpiar} style={estiloAccion} aria-label="Quitar todos los filtros">
✕ Quitar filtros
</button>
)}
{termino && (
<button
type="button"
onClick={() => onProponer(termino)}
style={{ ...estiloAccion, borderColor: "#8B0000", color: "#8B0000" }}
>
➕ Proponer «{termino}»
</button>
)}
</div>
)}
</div>
);
}
+138
View File
@@ -0,0 +1,138 @@
// Búsqueda libre del directorio: tolerante a tildes, mayúsculas, palabras
// incompletas y erratas, en cascada y sin dependencias.
//
// Dos etapas:
// 1. EXACTA — todas las palabras de la consulta aparecen en el índice del
// local. Dentro de esta etapa se ordena por relevancia: 3 si además cada
// palabra empieza una palabra del índice ("bar" en «Bar Torrijos»), 2 si
// sólo aparece a mitad de palabra ("bar" en «Albardón»).
// 2. APROXIMADA (fuzzy) — sólo si la etapa 1 no devolvió NADA: cada palabra
// está a distancia de edición corta de alguna palabra del índice
// ("peluquera" → Peluquería). Así el fuzzy nunca ensucia los resultados
// normales, y la UI puede avisar de que son aproximados.
//
// Nota: no hace falta una etapa de "prefijo" separada — un prefijo de una
// palabra ya es una subcadena del índice, así que la etapa 1 lo cubre y sólo
// se usa para puntuar mejor los aciertos desde el principio de palabra.
import { normalizar, palabras } from "./texto.js";
export const CAMPOS_BUSQUEDA = [
"nombre",
"provincia",
"categoria",
"subcategoria",
"direccion",
];
export const PUNTUACION_PRINCIPIO_PALABRA = 3;
export const PUNTUACION_A_MITAD_PALABRA = 2;
export const PUNTUACION_APROXIMADA = 1;
// 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(" "));
}
// Palabras del índice, para comprobar si un término empieza palabra.
function palabrasIndice(indice) {
return indice ? indice.split(" ") : [];
}
// ¿Casa el local con la consulta? "malaga" encuentra "Málaga", "peluqueria"
// encuentra "Peluquería" y "la escalera" encuentra "Bar la escalera".
// Sólo etapa exacta: la cascada completa vive en buscarLocales().
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));
}
// Distancia de edición máxima tolerada para un término. Los términos cortos
// (< 4 letras) no admiten erratas: "bar" no debería parecerse a "bur".
export function distanciaMaxima(termino) {
if (termino.length >= 7) return 2;
if (termino.length >= 4) return 1;
return 0;
}
// Levenshtein con corte temprano: si la distancia supera `max`, devuelve
// max + 1 sin terminar de calcular (suficiente para descartar).
export function distanciaEdicion(a, b, max = Infinity) {
if (a === b) return 0;
if (Math.abs(a.length - b.length) > max) return max + 1;
let previa = [];
for (let j = 0; j <= b.length; j += 1) previa[j] = j;
for (let i = 1; i <= a.length; i += 1) {
const actual = [i];
let minimoFila = i;
for (let j = 1; j <= b.length; j += 1) {
const coste = a[i - 1] === b[j - 1] ? 0 : 1;
actual[j] = Math.min(previa[j] + 1, actual[j - 1] + 1, previa[j - 1] + coste);
if (actual[j] < minimoFila) minimoFila = actual[j];
}
if (minimoFila > max) return max + 1;
previa = actual;
}
return previa[b.length];
}
// Puntuación de la etapa exacta: null si alguna palabra no aparece.
function puntuarExacta({ indice, palabrasDelIndice }, terminos) {
if (!terminos.every((termino) => indice.includes(termino))) return null;
const todasAlPrincipio = terminos.every((termino) =>
palabrasDelIndice.some((palabra) => palabra.startsWith(termino)),
);
return todasAlPrincipio ? PUNTUACION_PRINCIPIO_PALABRA : PUNTUACION_A_MITAD_PALABRA;
}
// Puntuación de la etapa aproximada: null si alguna palabra está demasiado
// lejos de todas las del índice.
function puntuarAproximada({ indice, palabrasDelIndice }, terminos) {
const casa = terminos.every((termino) => {
const max = distanciaMaxima(termino);
if (max === 0) return indice.includes(termino);
return palabrasDelIndice.some((palabra) => distanciaEdicion(termino, palabra, max) <= max);
});
return casa ? PUNTUACION_APROXIMADA : null;
}
// Busca en el directorio y devuelve, para cada local que casa, su puntuación
// de relevancia (3 empieza palabra, 2 a mitad de palabra, 1 aproximada).
// `aproximada` indica que los resultados salen de la etapa fuzzy y la UI debe
// avisarlo.
export function buscarLocales(locales, consulta) {
const terminos = palabras(consulta);
const puntuaciones = new Map();
if (terminos.length === 0) {
locales.forEach((local) => puntuaciones.set(local.id, PUNTUACION_PRINCIPIO_PALABRA));
return { puntuaciones, aproximada: false };
}
const indices = locales.map((local) => {
const indice = indiceBusqueda(local);
return { local, indice, palabrasDelIndice: palabrasIndice(indice) };
});
for (const { local, ...resto } of indices) {
const puntuacion = puntuarExacta(resto, terminos);
if (puntuacion !== null) puntuaciones.set(local.id, puntuacion);
}
// El fuzzy sólo entra si la búsqueda normal no devolvió absolutamente nada.
if (puntuaciones.size === 0) {
for (const { local, ...resto } of indices) {
const puntuacion = puntuarAproximada(resto, terminos);
if (puntuacion !== null) puntuaciones.set(local.id, puntuacion);
}
return { puntuaciones, aproximada: puntuaciones.size > 0 };
}
return { puntuaciones, aproximada: false };
}
+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) {
+57 -8
View File
@@ -16,6 +16,7 @@ function renderBarra(over = {}) {
soloFavoritos: false, setSoloFavoritos: vi.fn(),
ubicacion: null, buscandoUbicacion: false, errorUbicacion: "",
pedirUbicacion: vi.fn(), limpiarUbicacion: vi.fn(),
totalResultados: 4, totalLocales: 4, onLimpiar: vi.fn(),
...over,
};
const utils = render(<BarraFiltros {...props} />);
@@ -28,7 +29,7 @@ describe("BarraFiltros", () => {
it("Sección única con búsqueda, provincia, categorías y acciones rápidas", () => {
const { container } = renderBarra();
expect(screen.getByRole("region", { name: /filtros de locales/i })).toBeTruthy();
expect(screen.getByLabelText(/buscar por nombre, dirección o provincia/i)).toBeTruthy();
expect(screen.getByLabelText(/buscar por nombre/i)).toBeTruthy();
expect(screen.getByLabelText(/filtrar por provincia/i)).toBeTruthy();
expect(screen.getByRole("button", { name: /restauración/i })).toBeTruthy();
expect(screen.getByRole("button", { name: /favoritos/i })).toBeTruthy();
@@ -65,8 +66,9 @@ describe("BarraFiltros", () => {
it("El buscador comunica el filtrado por provincia y notifica los cambios", () => {
const { props } = renderBarra();
const input = screen.getByLabelText(/buscar por nombre, dirección o provincia/i);
const input = screen.getByLabelText(/buscar por nombre/i);
expect(input.getAttribute("placeholder")).toMatch(/provincia/i);
expect(input.getAttribute("placeholder")).toMatch(/categoría/i);
fireEvent.change(input, { target: { value: "Madrid" } });
expect(props.setBusqueda).toHaveBeenCalledWith("Madrid");
});
@@ -100,7 +102,7 @@ describe("BarraFiltros", () => {
expect(conUbicacion.props.setOrden).toHaveBeenCalledWith("fecha");
});
it("«✕ Limpiar» está siempre presente: deshabilitado sin filtros y resetea con ellos", () => {
it("«✕ Limpiar» está siempre presente: deshabilitado sin filtros y delega en App con ellos", () => {
renderBarra();
// Presente desde el principio (reserva su hueco: activar un filtro no
// desplaza al grupo de orden que el usuario acaba de pulsar)
@@ -119,12 +121,59 @@ describe("BarraFiltros", () => {
const activo = screen.getByRole("button", { name: /limpiar todos los filtros/i });
expect(activo.disabled).toBe(false);
fireEvent.click(activo);
// El reseteo vive en App (lo comparten la barra y el estado vacío)
expect(props.onLimpiar).toHaveBeenCalledTimes(1);
});
it("Muestra el conteo de resultados y distingue filtrar de ordenar", () => {
renderBarra();
expect(screen.getByRole("status").textContent).toBe("4 locales");
cleanup();
renderBarra({ busqueda: "bar", totalResultados: 2 });
expect(screen.getByRole("status").textContent).toBe("2 de 4 locales");
cleanup();
// Ordenar no reduce: sigue siendo el total
renderBarra({ orden: "puntuacion", totalResultados: 4 });
expect(screen.getByRole("status").textContent).toBe("4 locales");
cleanup();
// Un filtro que no reduce nada tampoco se anuncia como "N de M"
renderBarra({ filtroProvincia: "Madrid", totalResultados: 4 });
expect(screen.getByRole("status").textContent).toBe("4 locales");
cleanup();
renderBarra({ totalResultados: 1, totalLocales: 1 });
expect(screen.getByRole("status").textContent).toBe("1 local");
cleanup();
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", () => {
renderBarra();
expect(screen.queryByRole("button", { name: /borrar búsqueda/i })).toBeNull();
cleanup();
const { props } = renderBarra({ busqueda: "pizza", filtroProvincia: "Madrid" });
fireEvent.click(screen.getByRole("button", { name: /borrar búsqueda/i }));
expect(props.setBusqueda).toHaveBeenCalledWith("");
// No toca el resto de filtros
expect(props.setFiltroProvincia).not.toHaveBeenCalled();
expect(props.onLimpiar).not.toHaveBeenCalled();
});
it("Escape en el buscador limpia la consulta", () => {
const { props } = renderBarra({ busqueda: "pizza" });
fireEvent.keyDown(screen.getByLabelText(/buscar por nombre/i), { key: "Escape" });
expect(props.setBusqueda).toHaveBeenCalledWith("");
expect(props.setFiltroCategoria).toHaveBeenCalledWith("");
expect(props.setFiltroProvincia).toHaveBeenCalledWith("");
expect(props.setOrden).toHaveBeenCalledWith("fecha");
expect(props.setSoloFavoritos).toHaveBeenCalledWith(false);
expect(props.limpiarUbicacion).toHaveBeenCalled();
});
it("Activar el orden no cambia el número de botones de la fila de acciones (sin reflujo)", () => {
+66
View File
@@ -0,0 +1,66 @@
// @vitest-environment jsdom
// Estado vacío del listado: debe explicar qué pasa y ofrecer salida (quitar
// filtros / proponer el local que se buscaba).
import { afterEach, describe, expect, it, vi } from "vitest";
import { cleanup, fireEvent, render, screen } from "@testing-library/react";
import EstadoVacioLista from "../../src/components/EstadoVacioLista.jsx";
function renderVacio(over = {}) {
const props = {
totalLocales: 4,
soloFavoritos: false,
hayFiltros: true,
busqueda: "bar pepe",
onLimpiar: vi.fn(),
onProponer: vi.fn(),
...over,
};
render(<EstadoVacioLista {...props} />);
return props;
}
afterEach(cleanup);
describe("EstadoVacioLista", () => {
it("cita el término buscado y ofrece quitar filtros y proponer", () => {
const props = renderVacio();
expect(screen.getByText(/no hay locales que coincidan con «bar pepe»/i)).toBeTruthy();
fireEvent.click(screen.getByRole("button", { name: /quitar todos los filtros/i }));
expect(props.onLimpiar).toHaveBeenCalled();
fireEvent.click(screen.getByRole("button", { name: /proponer «bar pepe»/i }));
expect(props.onProponer).toHaveBeenCalledWith("bar pepe");
});
it("sin término de búsqueda propone el mensaje genérico y no ofrece proponer", () => {
const props = renderVacio({ busqueda: "", filtroProvincia: "Madrid" });
expect(screen.getByText(/no hay locales que coincidan$/i)).toBeTruthy();
expect(screen.queryByRole("button", { name: /proponer/i })).toBeNull();
fireEvent.click(screen.getByRole("button", { name: /quitar todos los filtros/i }));
expect(props.onLimpiar).toHaveBeenCalled();
});
it("sin filtros no muestra acciones", () => {
renderVacio({ hayFiltros: false, busqueda: "" });
expect(screen.queryByRole("button")).toBeNull();
});
it("en favoritos explica cómo guardarlos", () => {
renderVacio({ soloFavoritos: true, busqueda: "", hayFiltros: true });
expect(screen.getByText(/aún no tienes favoritos guardados/i)).toBeTruthy();
expect(screen.getByText(/pulsa el corazón/i)).toBeTruthy();
});
it("sin locales publicados invita a proponer el primero y no ofrece quitar filtros", () => {
renderVacio({ totalLocales: 0, hayFiltros: false, busqueda: "" });
expect(screen.getByText(/todavía no hay locales publicados/i)).toBeTruthy();
expect(screen.getByText(/sé el primero en proponer uno/i)).toBeTruthy();
expect(screen.queryByRole("button", { name: /quitar todos los filtros/i })).toBeNull();
});
});
+201
View File
@@ -0,0 +1,201 @@
// 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);
});
});