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.
This commit is contained in:
2026-11-01 12:21:40 +01:00
parent 76e19a3ab0
commit 2ec9259d19
10 changed files with 453 additions and 45 deletions
+39 -15
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 } 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);
@@ -165,14 +189,11 @@ export default function App() {
};
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))
&& (!filtroCategoria || l.categoria === filtroCategoria)
&& (!filtroSubcat || l.subcategoria === filtroSubcat)
&& (!filtroProvincia || l.provincia === filtroProvincia)
&& (!soloFavoritos || esFavorito(l.id));
})
.filter((l) => coincideBusqueda(l, busqueda)
&& (!filtroCategoria || l.categoria === filtroCategoria)
&& (!filtroSubcat || l.subcategoria === filtroSubcat)
&& (!filtroProvincia || l.provincia === filtroProvincia)
&& (!soloFavoritos || esFavorito(l.id)))
.sort((a, b) => {
if (orden === "distancia" && ubicacion) {
const da = a.lat && a.lng ? calcularDistanciaKm(ubicacion.lat, ubicacion.lng, a.lat, a.lng) : Infinity;
@@ -295,6 +316,8 @@ export default function App() {
soloFavoritos={soloFavoritos} setSoloFavoritos={setSoloFavoritos}
ubicacion={ubicacion} buscandoUbicacion={buscandoUbicacion} errorUbicacion={errorUbicacion}
pedirUbicacion={pedirUbicacion} limpiarUbicacion={limpiarUbicacion}
totalResultados={localesFiltrados.length} totalLocales={locales.length}
onLimpiar={limpiarFiltros}
/>
@@ -316,13 +339,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) => (
+56 -15
View File
@@ -38,18 +38,20 @@ export default function BarraFiltros({
orden, setOrden,
soloFavoritos, setSoloFavoritos,
ubicacion, buscandoUbicacion, errorUbicacion, pedirUbicacion, limpiarUbicacion,
totalResultados, totalLocales, onLimpiar,
}) {
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).
const textoConteo = () => {
if (totalLocales === 0) return "Todavía no hay locales publicados";
if (filtrando && totalResultados !== totalLocales) return `${totalResultados} de ${totalLocales} locales`;
return `${totalLocales} ${totalLocales === 1 ? "local" : "locales"}`;
};
return (
@@ -68,13 +70,43 @@ export default function BarraFiltros({
>
{/* Búsqueda + provincia compacta */}
<div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}>
<input
style={{ ...inputStyle, flex: 1, minWidth: 140 }}
placeholder="🔍 Buscar por nombre, dirección o provincia..."
value={busqueda}
onChange={(e) => setBusqueda(e.target.value)}
aria-label="Buscar por nombre, dirección o provincia"
/>
<div style={{ position: "relative", flex: 1, minWidth: 140 }}>
<input
style={{ ...inputStyle, paddingRight: busqueda ? 34 : undefined }}
placeholder="🔍 Nombre, dirección, categoría o provincia…"
value={busqueda}
onChange={(e) => setBusqueda(e.target.value)}
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 +117,15 @@ 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, color: "var(--color-text-tertiary)", lineHeight: 1.2 }}
>
{textoConteo()}
</p>
{/* Chips categorías */}
<div style={{ display: "flex", flexWrap: "wrap", gap: 6 }}>
{NOMBRES_CATEGORIAS.map((cat) => {
@@ -135,7 +176,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>
);
}
+34
View File
@@ -0,0 +1,34 @@
// Búsqueda libre del directorio, tolerante a tildes, mayúsculas y espacios.
//
// Reglas (deliberadamente simples y sin dependencias):
// - Se compara por palabras: TODAS las palabras de la consulta deben
// aparecer en algún campo del local ("bar toledo" no casa con un local de
// Toledo que no sea un bar).
// - Los campos participantes son los que anuncia la barra de filtros:
// nombre, provincia, categoría, subcategoría y dirección.
// - Consulta vacía -> todo casa (así el filtro no altera el listado).
import { normalizar, palabras } from "./texto.js";
export const CAMPOS_BUSQUEDA = [
"nombre",
"provincia",
"categoria",
"subcategoria",
"direccion",
];
// 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(" "));
}
// ¿Casa el local con la consulta? "malaga" encuentra "Málaga", "peluqueria"
// encuentra "Peluquería" y "la escalera" encuentra "Bar la escalera".
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));
}
+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) {