16 Commits
Author SHA1 Message Date
edgar.friendly 5aeef0165d merge: PR #25 — búsqueda fuzzy por erratas, sólo como rescate
deploy-branch / deploy (push) Successful in 2m42s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 3m5s
tests / Integración (Nominatim real, opt-in) (push) Skipped
Etapa exacta con puntuación de relevancia (3 empieza palabra, 2 a mitad) y etapa aproximada (Levenshtein con corte) sólo si la exacta no devuelve nada. Umbrales: sin fuzzy <4 letras, 1 hasta 6, 2 desde 7. La barra avisa «búsqueda aproximada».

195/195 tests (10 nuevos).
2026-11-01 14:18:36 +01:00
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
edgar.friendly 76e19a3ab0 merge: PR #23 — filtros unificados y rediseño de reseñas (#23)
deploy-branch / deploy (push) Successful in 2m46s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 3m11s
tests / Integración (Nominatim real, opt-in) (push) Skipped
Trae prototipo-yb01-chips a master: barra de filtros unificada (sección
única, Limpiar global, provincias por comunidad, sin subcategorías) y
rediseño de la tarjeta de reseñas/portada.

Conflicto resuelto: .gitea/workflows/tests.yml se queda con la versión de
master, donde el build va antes de los tests (el smoke de la SPA necesita
dist/); el resto del fichero ya coincidía.

Verificado en local: build ok y 164/164 tests.
2026-11-01 12:02:39 +01:00
edgar.friendly df4e01a1a5 ci(tests): build antes de los tests para que pase el smoke de la SPA
deploy-branch / deploy (push) Successful in 2m41s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 3m10s
tests / Integración (Nominatim real, opt-in) (push) Skipped
El job ejecutaba `npm test` antes del build y `tests/unit/test-routes.spec.js`
espera `dist/index.html` (GET / -> fallback SPA). `dist/` está gitignored, así
que sin build previo el test falla siempre: master quedaba con CI en rojo.

Se reordena igual que en prototipo-yb01-chips y se corrige el comentario (el
prefijo admin ya no viene de /etc/localesp/<slug>.env sino de
scripts/entornos.env, vía scripts/entornos.alias.env).
2026-11-01 11:24:07 +01:00
edgar.friendly 8106f0b40c ci(config): master despliega en master.localesp.es y alias rama -> entorno
deploy-branch / deploy (push) Successful in 3m9s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m4s
tests / Integración (Nominatim real, opt-in) (push) Skipped
- scripts/entornos.env: alta de master=/administrador. LOCALESP_ADMIN_PREFIX
  es obligatoria; sin esta línea el build de master fallaba (y con él el
  despliegue).
- scripts/entornos.alias.env + EnvSlug::environment: mapping
  <slug-rama>=<slug-entorno> para cuando el DNS sólo tiene un subdominio
  (prototipo-ef -> prototipo-yb01.localesp.es). Sin alias se mantiene el
  comportamiento histórico <rama>.localesp.es.
- .gitea/workflows/deploy.yml: el prefijo admin del build se resuelve también
  con el alias, para que build y deploy coincidan siempre.
2026-11-01 11:15:27 +01:00
edgar.friendly ab79239541 merge: master pasa a contener prototipo-yb01 (el anterior master vive en prototipo-ef)
Sustituye la app de master por la de prototipo-yb01: nueva implementación
(locales, pendientes, reportes, reseñas, usuarios, config; 139 tests) frente
al prototipo anterior (businesses).

El contenido anterior de master queda íntegro en la rama prototipo-ef, que se
publica en prototipo-yb01.localesp.es (único subdominio libre configurado,
vía scripts/entornos.alias.env).

Se hace como merge con estrategia 'ours' + read-tree para conservar la
historia de master como primer padre y dejar el árbol exactamente igual al
de prototipo-yb01.
2026-11-01 11:14:47 +01:00
edgar.friendly 24cce5dbb9 fix(resenas,portada): quita el recuento de reseñas y los tres contadores
deploy-branch / deploy (push) Failing after 2s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 3m12s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
tests / Unitarias + componente + build (push) Successful in 3m9s
tests / Integración (Nominatim real, opt-in) (push) Skipped
- ResenasLocal: desaparece la cabecera «Reseñas (N)» que iba encima de
  las tarjetas; el único control de expansión es el botón de ancho
  completo bajo las reseñas («Ver las N reseñas» / «Ver menos»).
- Tarjetas de reseña: las estrellas llevan soporte de línea y padding
  superior para que el hueco de arriba iguale al del resto del contenido.
- App: se eliminan los tres contadores del principio de la página
  (Locales · Provincias · Media ★) y las variables que solo los
  alimentaban (issue #4).

CI: en .gitea/workflows/tests.yml el build de producción pasa a correr
ANTES de las pruebas. La suite incluye un smoke de la SPA servida
(GET / → dist/index.html) y `dist/` está gitignored, así que sin build
previo esa prueba recibía 404 en el runner (hasta ahora el artefacto lo
generaba el job de deploy, que en esta rama falla por no tener entrada
en scripts/entornos.env).

164/164 tests y build en verde.
2026-10-14 00:37:18 +02:00
edgar.friendly 6cc326e8ac refactor(scripts): lib de despliegue OOP (Env + colaboradores)
deploy-branch / deploy (push) Successful in 2m14s
deploy-branch / teardown (push) Skipped
- scripts/lib/env.sh: modelo OOP. Env (aggregate root) compone las entidades
  SystemdUnit, NginxVhost y TlsCert, más servicios estáticos (Slug, Host,
  Port, Artifacts, Deps, Logger). Instancias = arrays asociativos globales
  accedidos vía nameref (local -n); la composición vive en Env::new.
- deploy.sh / teardown.sh: pasan a ser entrypoints finos (~33 líneas) que
  sourcean lib/env.sh. Comparten una única fuente de verdad para "qué es un
  entorno", eliminando la duplicación de slugify y el regex de vhost.
- Comportamiento idéntico al procedural: heredocs de systemd/nginx son
  byte-idénticos; orquestación de deploy y teardown verificados end-to-end.

Requiere bash >= 4.3 (namerefs), ya cubierto en el host runner.
2026-08-01 18:08:01 +02:00
edgar.friendly 6323fe8f0e Merge branch 'cicd-test': CI/CD de despliegue por rama
deploy-branch / deploy (push) Successful in 2m31s
deploy-branch / teardown (push) Skipped
2026-08-01 16:07:39 +02:00
edgar.friendly adb2b4dfe4 ci: layout unificado /opt/localesp/<rama>; migrados entornos legacy
deploy-branch / deploy (push) Successful in 2m12s
deploy-branch / teardown (push) Skipped
2026-07-24 09:56:13 +02:00
edgar.friendly 98b19aa3a2 fix(ci): habilitar gcc-toolset-12 (C++20) para better-sqlite3; reutilizar node_modules
deploy-branch / deploy (push) Successful in 2m36s
deploy-branch / teardown (push) Skipped
2026-07-24 09:03:59 +02:00
edgar.friendly 27166eb3f4 ci: despliegue por rama en <rama>.localesp.es (Gitea Actions + host runner)
deploy-branch / deploy (push) Failing after 1m38s
deploy-branch / teardown (push) Skipped
2026-07-24 08:54:52 +02:00
edgar.friendly e08d959cf9 Despliegue en VPS 2026-06-07 21:25:45 +02:00
edgar.friendly c06300833b Primer prototipo 2026-05-20 14:05:55 +02:00
14 changed files with 720 additions and 53 deletions
+2 -1
View File
@@ -37,7 +37,8 @@ jobs:
# scripts/entornos.env mapea <slug>=<prefijo admin>, que el build # scripts/entornos.env mapea <slug>=<prefijo admin>, que el build
# incrusta en el bundle. Sin entrada para la rama, falla (sin default). # incrusta en el bundle. Sin entrada para la rama, falla (sin default).
. scripts/lib/env.sh . scripts/lib/env.sh
slug="$(Slug::from "$BRANCH")" # El alias rama->entorno manda también aquí (entornos.alias.env).
slug="$(EnvSlug::environment "$(Slug::from "$BRANCH")" .)"
prefix="$(Config::admin_prefix "$slug" scripts/entornos.env)" || { prefix="$(Config::admin_prefix "$slug" scripts/entornos.env)" || {
echo "::error::Falta entrada '$slug=' en scripts/entornos.env — añádela y relanza" >&2 echo "::error::Falta entrada '$slug=' en scripts/entornos.env — añádela y relanza" >&2
exit 1 exit 1
+8 -5
View File
@@ -25,17 +25,20 @@ jobs:
source /opt/rh/gcc-toolset-12/enable 2>/dev/null || echo "WARN: gcc-toolset-12 no encontrado" source /opt/rh/gcc-toolset-12/enable 2>/dev/null || echo "WARN: gcc-toolset-12 no encontrado"
npm ci npm ci
- name: Pruebas unitarias y de componente (offline)
run: npm test
- name: Build de producción - name: Build de producción
# Smoke build: el prefijo real lo aporta cada entorno en deploy.yml # Va ANTES de las pruebas: la suite incluye un smoke de la SPA servida
# (config /etc/localesp/<slug>.env del host). Aquí basta un valor # (GET / -> dist/index.html) y `dist/` está gitignored, así que el
# artefacto tiene que existir cuando corre `npm test`.
# El prefijo real lo resuelve deploy.yml desde scripts/entornos.env
# (con alias en scripts/entornos.alias.env); aquí basta un valor
# cualquiera: se comprueba que el build funciona, no la configuración. # cualquiera: se comprueba que el build funciona, no la configuración.
env: env:
LOCALESP_ADMIN_PREFIX: /admin-ci LOCALESP_ADMIN_PREFIX: /admin-ci
run: npm run build run: npm run build
- name: Pruebas unitarias y de componente (offline)
run: npm test
integracion: integracion:
name: Integración (Nominatim real, opt-in) name: Integración (Nominatim real, opt-in)
runs-on: self-hosted runs-on: self-hosted
+9
View File
@@ -0,0 +1,9 @@
# entornos.alias.env — alias rama -> entorno (una línea: <slug-rama>=<slug-entorno>)
#
# Por defecto cada rama publica en <slug-rama>.localesp.es. Con un alias, la
# rama comparte HOST, unit systemd, puerto y vhost con otro entorno, que es lo
# que hace falta cuando el DNS sólo tiene configurado un subdominio.
#
# prototipo-ef -> se publica en prototipo-yb01.localesp.es (único subdominio
# disponible), ocupando el entorno prototipo-yb01.
prototipo-ef=prototipo-yb01
+3 -1
View File
@@ -7,5 +7,7 @@
# #
# Nuevos entornos: añade una línea con el slug de tu rama. # Nuevos entornos: añade una línea con el slug de tu rama.
prototipo-yb01=/administrador prototipo-yb01=/administrador
# master=/administrador master=/administrador
feat-busqueda-tolerante=/administrador
feat-busqueda-fuzzy=/administrador
# prototipo-yb01-ef=/administrador # prototipo-yb01-ef=/administrador
+21 -1
View File
@@ -25,6 +25,7 @@
DOMAIN="localesp.es" DOMAIN="localesp.es"
PORT_BASE=8082 # 8080/8081 son entornos legacy PORT_BASE=8082 # 8080/8081 son entornos legacy
ENV_CONFIG_FILE="scripts/entornos.env" # mapping slug=prefijo admin (fichero del repo) ENV_CONFIG_FILE="scripts/entornos.env" # mapping slug=prefijo admin (fichero del repo)
ENV_ALIAS_FILE="scripts/entornos.alias.env" # mapping slug-rama=slug-entorno (fichero del repo)
LOGGER_TAG="env" LOGGER_TAG="env"
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
@@ -50,6 +51,25 @@ Slug::from() {
printf '%s' "$branch" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//' printf '%s' "$branch" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//'
} }
# ---------------------------------------------------------------------------
# EnvSlug — servicio estático: alias rama -> entorno.
# ---------------------------------------------------------------------------
# scripts/entornos.alias.env mapea <slug-rama>=<slug-entorno>. Con alias, la
# rama reutiliza host, unit, puerto, destino y vhost del entorno indicado; sin
# alias, el entorno es la propia rama (comportamiento histórico).
EnvSlug::environment() {
local slug="$1"
local root="${2:-.}"
local alias
alias="$(grep -E "^[[:space:]]*${slug}[[:space:]]*=" "$root/$ENV_ALIAS_FILE" 2>/dev/null | tail -1 | cut -d= -f2- | tr -d '[:space:]')"
if [ -n "$alias" ]; then
printf '%s' "$alias"
else
printf '%s' "$slug"
fi
}
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
# Host — servicio estático: IP pública y resolución DNS. # Host — servicio estático: IP pública y resolución DNS.
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
@@ -394,7 +414,7 @@ Env::new() {
s[branch]="$branch" s[branch]="$branch"
s[root]="$root" s[root]="$root"
s[slug]="$(Slug::from "$branch")" s[slug]="$(EnvSlug::environment "$(Slug::from "$branch")" "$root")"
if [ -z "${s[slug]}" ]; then if [ -z "${s[slug]}" ]; then
Logger::error "slug vacío para la rama '$branch'" Logger::error "slug vacío para la rama '$branch'"
exit 2 exit 2
+50 -15
View File
@@ -11,6 +11,8 @@ import BotonFlotante from "./components/BotonFlotante.jsx";
import BotonProponerArriba from "./components/BotonProponerArriba.jsx"; import BotonProponerArriba from "./components/BotonProponerArriba.jsx";
import ModalPasarela from "./components/ModalPasarela.jsx"; import ModalPasarela from "./components/ModalPasarela.jsx";
import BarraFiltros from "./components/BarraFiltros.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 useFavoritos from "./hooks/useFavoritos.js";
import useUbicacion from "./hooks/useUbicacion.js"; import useUbicacion from "./hooks/useUbicacion.js";
@@ -92,6 +94,28 @@ export default function App() {
setPosibleDuplicado(null); 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 // Cerrar la pasarela descarta el borrador en curso
const cerrarPasarela = () => { const cerrarPasarela = () => {
setPasarelaAbierta(false); setPasarelaAbierta(false);
@@ -164,16 +188,23 @@ export default function App() {
guardarPropuesta(posibleDuplicado.lat, posibleDuplicado.lng); 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 const localesFiltrados = locales
.filter((l) => { .filter((l) => puntuacionesBusqueda.has(l.id)
const q = busqueda.toLowerCase(); && (!filtroCategoria || l.categoria === filtroCategoria)
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)) && (!filtroSubcat || l.subcategoria === filtroSubcat)
&& (!filtroCategoria || l.categoria === filtroCategoria) && (!filtroProvincia || l.provincia === filtroProvincia)
&& (!filtroSubcat || l.subcategoria === filtroSubcat) && (!soloFavoritos || esFavorito(l.id)))
&& (!filtroProvincia || l.provincia === filtroProvincia)
&& (!soloFavoritos || esFavorito(l.id));
})
.sort((a, b) => { .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) { if (orden === "distancia" && ubicacion) {
const da = a.lat && a.lng ? calcularDistanciaKm(ubicacion.lat, ubicacion.lng, a.lat, a.lng) : Infinity; 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; 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} soloFavoritos={soloFavoritos} setSoloFavoritos={setSoloFavoritos}
ubicacion={ubicacion} buscandoUbicacion={buscandoUbicacion} errorUbicacion={errorUbicacion} ubicacion={ubicacion} buscandoUbicacion={buscandoUbicacion} errorUbicacion={errorUbicacion}
pedirUbicacion={pedirUbicacion} limpiarUbicacion={limpiarUbicacion} 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... Cargando locales...
</div> </div>
) : localesFiltrados.length === 0 ? ( ) : localesFiltrados.length === 0 ? (
<div style={{ textAlign: "center", padding: "3rem", color: "var(--color-text-tertiary)" }}> <EstadoVacioLista
<div style={{ fontSize: 40, marginBottom: 12 }} aria-hidden="true">🏘️</div> totalLocales={locales.length}
<p style={{ margin: 0, fontWeight: 500 }}> soloFavoritos={soloFavoritos}
{locales.length === 0 ? "Todavía no hay locales publicados" : soloFavoritos ? "Aún no tienes favoritos guardados" : "No hay locales que coincidan"} hayFiltros={hayFiltros}
</p> busqueda={busqueda}
<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> onLimpiar={limpiarFiltros}
</div> onProponer={abrirPasarelaConNombre}
/>
) : ( ) : (
<div style={{ display: "grid", gap: 10 }}> <div style={{ display: "grid", gap: 10 }}>
{localesFiltrados.map((local) => ( {localesFiltrados.map((local) => (
+63 -15
View File
@@ -38,18 +38,22 @@ export default function BarraFiltros({
orden, setOrden, orden, setOrden,
soloFavoritos, setSoloFavoritos, soloFavoritos, setSoloFavoritos,
ubicacion, buscandoUbicacion, errorUbicacion, pedirUbicacion, limpiarUbicacion, 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 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 opcionesOrden = ubicacion ? [...OPCIONES_ORDEN, OPCION_ORDEN_DISTANCIA] : OPCIONES_ORDEN;
const hayFiltros = busqueda || filtroCategoria || filtroProvincia || soloFavoritos || orden !== "fecha" || ubicacion; const hayFiltros = busqueda || filtroCategoria || filtroProvincia || soloFavoritos || orden !== "fecha" || ubicacion;
const filtrando = Boolean(busqueda || filtroCategoria || filtroProvincia || soloFavoritos || ubicacion);
const limpiarTodo = () => { // Feedback de la búsqueda: sin esto el usuario no sabe si la consulta se
setBusqueda(""); // aplicó o si simplemente no hay nada. Solo cuenta como "N de M" cuando hay
setFiltroCategoria(""); // un filtro activo que pueda reducir el listado (ordenar no reduce). Si los
setFiltroProvincia(""); // resultados vienen de la etapa fuzzy, se dice explícitamente.
setSoloFavoritos(false); const textoConteo = () => {
setOrden("fecha"); if (totalLocales === 0) return "Todavía no hay locales publicados";
if (ubicacion) limpiarUbicacion(); 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 ( return (
@@ -68,13 +72,43 @@ export default function BarraFiltros({
> >
{/* Búsqueda + provincia compacta */} {/* Búsqueda + provincia compacta */}
<div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}> <div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}>
<input <div style={{ position: "relative", flex: 1, minWidth: 140 }}>
style={{ ...inputStyle, flex: 1, minWidth: 140 }} <input
placeholder="🔍 Buscar por nombre, dirección o provincia..." style={{ ...inputStyle, paddingRight: busqueda ? 34 : undefined }}
value={busqueda} placeholder="🔍 Nombre, dirección, categoría o provincia…"
onChange={(e) => setBusqueda(e.target.value)} value={busqueda}
aria-label="Buscar por nombre, dirección o provincia" 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"> <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> <option value="">📍 Todas las provincias</option>
{Object.entries(PROVINCIAS_POR_COMUNIDAD).map(([comunidad, provincias]) => ( {Object.entries(PROVINCIAS_POR_COMUNIDAD).map(([comunidad, provincias]) => (
@@ -85,6 +119,20 @@ export default function BarraFiltros({
</select> </select>
</div> </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 */} {/* Chips categorías */}
<div style={{ display: "flex", flexWrap: "wrap", gap: 6 }}> <div style={{ display: "flex", flexWrap: "wrap", gap: 6 }}>
{NOMBRES_CATEGORIAS.map((cat) => { {NOMBRES_CATEGORIAS.map((cat) => {
@@ -135,7 +183,7 @@ export default function BarraFiltros({
{/* Siempre presente (deshabilitado sin filtros): así reserva su hueco {/* Siempre presente (deshabilitado sin filtros): así reserva su hueco
y no desplaza a los controles vecinos al activarse un filtro. */} 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" 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 }}> 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 ✕ 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 // 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. // añadir campos nuevos en el futuro (teléfono, horarios…) no rompe nada.
import { PROVINCIAS } from "../../constants/provincias.js"; import { PROVINCIAS } from "../../constants/provincias.js";
import { normalizar } from "../texto.js";
export default class ProveedorUbicacion { export default class ProveedorUbicacion {
// Identificador del proveedor; cada subclase debe sobrescribirlo. // Identificador del proveedor; cada subclase debe sobrescribirlo.
@@ -51,14 +52,12 @@ export default class ProveedorUbicacion {
// ── Helpers compartidos por todos los proveedores ──────────────────────── // ── Helpers compartidos por todos los proveedores ────────────────────────
// Normaliza un texto: minúsculas, sin tildes y sin espacios extremos. Se usa // Normaliza un texto: minúsculas, sin tildes y con espacios colapsados. Se
// para comparar provincias y etiquetas sin depender de acentos. // 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) { static normalizar(texto) {
return (texto || "") return normalizar(texto);
.toLowerCase()
.normalize("NFD")
.replace(/[\u0300-\u036f]/g, "")
.trim();
} }
normalizar(texto) { normalizar(texto) {
+57 -8
View File
@@ -16,6 +16,7 @@ function renderBarra(over = {}) {
soloFavoritos: false, setSoloFavoritos: vi.fn(), soloFavoritos: false, setSoloFavoritos: vi.fn(),
ubicacion: null, buscandoUbicacion: false, errorUbicacion: "", ubicacion: null, buscandoUbicacion: false, errorUbicacion: "",
pedirUbicacion: vi.fn(), limpiarUbicacion: vi.fn(), pedirUbicacion: vi.fn(), limpiarUbicacion: vi.fn(),
totalResultados: 4, totalLocales: 4, onLimpiar: vi.fn(),
...over, ...over,
}; };
const utils = render(<BarraFiltros {...props} />); 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", () => { it("Sección única con búsqueda, provincia, categorías y acciones rápidas", () => {
const { container } = renderBarra(); const { container } = renderBarra();
expect(screen.getByRole("region", { name: /filtros de locales/i })).toBeTruthy(); 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.getByLabelText(/filtrar por provincia/i)).toBeTruthy();
expect(screen.getByRole("button", { name: /restauración/i })).toBeTruthy(); expect(screen.getByRole("button", { name: /restauración/i })).toBeTruthy();
expect(screen.getByRole("button", { name: /favoritos/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", () => { it("El buscador comunica el filtrado por provincia y notifica los cambios", () => {
const { props } = renderBarra(); 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(/provincia/i);
expect(input.getAttribute("placeholder")).toMatch(/categoría/i);
fireEvent.change(input, { target: { value: "Madrid" } }); fireEvent.change(input, { target: { value: "Madrid" } });
expect(props.setBusqueda).toHaveBeenCalledWith("Madrid"); expect(props.setBusqueda).toHaveBeenCalledWith("Madrid");
}); });
@@ -100,7 +102,7 @@ describe("BarraFiltros", () => {
expect(conUbicacion.props.setOrden).toHaveBeenCalledWith("fecha"); 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(); renderBarra();
// Presente desde el principio (reserva su hueco: activar un filtro no // Presente desde el principio (reserva su hueco: activar un filtro no
// desplaza al grupo de orden que el usuario acaba de pulsar) // 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 }); const activo = screen.getByRole("button", { name: /limpiar todos los filtros/i });
expect(activo.disabled).toBe(false); expect(activo.disabled).toBe(false);
fireEvent.click(activo); 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.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)", () => { 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);
});
});