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.
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).
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.
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.
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).
- 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.
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.
- 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.
- LocalCard: las estrellas de la media van arriba a la derecha, a la
altura del título; el formulario de reseña se monta DEBAJO de la barra
y solo al pulsar «Comentar», que queda en estado activo (aria-pressed).
- ResenasLocal pasa a ser presentacional: el cajón animado revela SOLO
el resto de reseñas y el control de ampliar/plegar es de ancho completo
y va debajo de ellas (Ver las N reseñas / Ver menos).
- Nuevo hook useResenas (dueño único del estado: lista, total, media,
reseña propia, envío, borrado, reporte, error) y nuevo FormularioResena
controlado. Desaparece el ref imperativo comentar().
- Tarjetas de comentario con padding uniforme y texto sin margen interno.
- StarRating exporta TAMANO_ESTRELLAS (14) y lo usan media, tarjetas e
input: un único tamaño.
- Botones con hover/activo a superficie completa por clases CSS
(.btn-hover, .btn-hover.activo, .btn-sobre-tarjeta, .btn-primario,
.btn-verde); se retiran los background inline que anulaban el hover.
164/164 tests y build en verde.
Deltas de tarjeta-local (media en la cabecera, formulario de reseña bajo
la barra de acciones, respuesta visual de los botones) y de
resenas-por-local (la sección pierde media y formulario, expande solo
reseñas y su control pasa a ancho completo bajo ellas).
PROVINCIAS_POR_COMUNIDAD (17 comunidades, 50 provincias) pasa a ser la
fuente única y PROVINCIAS se deriva de ella, así ningún listado queda
desincronizado. El desplegable de filtros y el de la pasarela de
propuesta usan <optgroup> con el nombre de la comunidad.
148/148 tests y build en verde.
Al pulsar «★ Mejor» o «A-Z» el botón aparecía justo a continuación del
grupo segmentado (alineado a la derecha con margin-left:auto) y le
robaba espacio, desplazando los botones recién pulsados. Ahora el botón
se renderiza siempre y se deshabilita sin filtros, de modo que reserva
su hueco y la fila no reflúye.
Actualiza spec (escenario sin desplazamiento), design (D7) y pruebas.
- 7 pruebas del componente: sección única, sin subcategoría, buscador
por provincia, chips con conteo/aria-pressed, orden segmentado
(distancia solo con ubicación), Limpiar global y favoritos.
- Foco visible en la barra vía :focus-visible (inputStyle anula el
outline por defecto en inputs/selects).
- Verificado que los marcadores del mapa usan localesFiltrados.
146/146 tests y build en verde.
- Las tres filas (búsqueda+provincia, categorías, acciones+orden) viven
en una sola tarjeta sobre las pestañas Lista/Mapa.
- «✕ Limpiar» resetea búsqueda, categoría, provincia, favoritos y
orden, y desactiva la ubicación; visible solo cuando hay filtros.
- Se corrige una variable CSS inexistente (var(--color-background) →
--color-background-secondary) en el orden segmentado.
139/139 tests y build (con LOCALESP_ADMIN_PREFIX) en verde.
- El select de subcategoría desaparece sin reemplazo (subtipos
replanteados en #22); el estado queda fijado a "".
- Provincia: desplegable compacto junto a la búsqueda (única excepción
al sin-desplegables, decisión de diseño D4); el buscador ya matcheaba
provincia, ahora lo comunica el placeholder.
- Orden: control segmentado [🕒 Reciente|★ Mejor|A-Z|📍 Más cerca],
distancia solo con ubicación activa.
Barra única de filtrado sin select de orden ni subcategorías (subtipos
replanteados en #22), provincia compacta + búsqueda por texto, barra
visible en lista y mapa. Decisiones de diseño documentadas en design.md.
- 15px → 12px 12px 8px (punto medio tras el ajuste manual a 15)
- el formulario delinea las estrellas con un soporte de línea (lineHeight
26px): con lineHeight 0 la caja mide 0 y el glifo se solapaba con
'Deja tu reseña'; además gap 6→8
- spec principal nuevo tarjeta-local (estructura + barra de acciones)
- resenas-por-local actualizado: vista previa de 3 en grid, cierre por
tres vías, acciones por tarjeta (Borrar propias / Reportar ajenas)
- cambio archivado en archive/2026-10-11-tarjeta-local-rediseno
Feedback de usuario tras el rediseño:
- Cierre por tres vías (antes solo un chevron poco visible): "Comentar"
ahora ALTERNA (abre con foco / cierra), botón "Cerrar" en el formulario
y chevron de la cabecera (chevron agrandado)
- Reseñas en GRID: 3 primeras en fila ocupando el ancho de la tarjeta
(auto-fit minmax(120px,1fr)); al expandir, el resto en el mismo grid;
comentario con line-clamp 3 y fecha corta para cabir "estrechadas"
- Menos cajas anidadas: el formulario es plano (solo border-top), sin
caja propia dentro de la zona expandida
- Acciones por tarjeta de reseña: "Borrar" en las propias (etiqueta
«Tú»), "Reportar" en las ajenas con estado ✅; fuera el botón
"Borrar mi reseña" del formulario (redundante)
Suite: 139/139 (toggle de cierre por las tres vías, grid de 3 con la
4ª oculta, borrar/reportar por tarjeta, comentar() alterna).
- La descripción del local pasa a bloque propio ENCIMA de las reseñas
- Reseñas: carga al montar con 2 visibles sin expandir; expansión con
animación (grid-template-rows 0fr→1fr, 350ms) que revela todas + el
formulario; pista "Ver las N reseñas" cuando hay más de 2
- Barra inferior a ancho completo: Comentar (expande+enfoca) · Reportar
(formulario controlado) · Marcar (favorito, corazón fuera de cabecera,
aria-pressed) · Compartir (antes en cabecera); fecha pequeñita encima
- openspec: archiva resenas-por-local (spec principal creado por sync) y
abre tarjeta-local-rediseno (specs de tarjeta-local + resenas modificada)
Suite: 138/138 (+6 netos).
Una reseña por dispositivo (UNIQUE localId+deviceId, upsert editable),
puntuación 1-5 + comentario ≤500, publicación directa con filtro de
palabras server-side y reportes con resenaId; borrado admin desde el
panel. locales.puntuacion pasa a ser la media (ROUND) recalculada en
cada escritura; GET /api/locales añade totalResenas.
Identidad v1 anónima estilo 4chan: deviceId en localStorage, huella
corta por local (sha256(deviceId:localId)), nunca se expone el deviceId.
Anti-boicot base: rate-limit por IP (10/h, configurable con
LOCALESP_RESENAS_RATELIMIT_MAX, 429+Retry-After). UI: sección plegable
"Reseñas (N) · ★media" en la tarjeta con formulario inline.
Suite: 132/132 (+18 tests: rutas, rate-limit y componente).
- spec principal pasarela-proponer-local sincronizado con el delta
(descripción opcional, orden de 6 pantallas, filtro sobre descripción)
- cambio archivado en archive/2026-10-11-pasarela-descripcion-opcional
- nuevo cambio resenas-por-local: reseñas anónimas estilo 4chan, media
agregada, publicación directa + reportes, rate-limit (artefactos 4/4)
Nueva pantalla "Descripción" (paso 5 de 6, opcional, máx. 200 caracteres)
entre Tipo específico y Revisión. La descripción viaja en la propuesta
(trim; vacía → ausente/NULL), el filtro de palabras prohibidas la cubre y
el resumen la muestra. Backend/BD ya la soportaban: cambio frontend-only.
Incluye el archivo del cambio hide-admin-route y la propuesta
openspec del nuevo cambio. Suite: 114/114.
La config de prefijo admin pasa del host (/etc/localesp/<slug>.env) al
repo, para que viaje con el código que despliega y se revise en PRs:
- scripts/entornos.env: mapping <slug>=<prefijo> (prototipo-yb01=
/administrador; master y prototipo-yb01-ef como plantilla comentada)
- env.sh: servicio Config::admin_prefix lee el mapping; require_config
falla con mensaje claro si la rama no tiene entrada; Env::deploy
regenera <dest>/.env desde el repo (el servidor lo autocarga)
- deploy.yml: el build exporta el prefijo del mapping antes de compilar
La ruta fija /admin del enrutador SPA mostraba el panel sin importar el
prefijo configurado. Ahora AdminPanel se monta solo cuando el pathname
coincide con la raíz de LOCALESP_ADMIN_PREFIX (misma variable única que
backend, build y API): con /administrador, el panel queda en
/administrador y /admin pasa a mostrar la web pública.
- src/main.jsx: enrutado por ADMIN_RUTA derivada del prefijo
- README y artefactos openspec (spec/design) actualizados
El build ahora exige LOCALESP_ADMIN_PREFIX (sin valor por defecto), así
que el CI necesita saber el prefijo de cada entorno de rama:
- deploy.yml: el paso de build carga /etc/localesp/<slug>.env del host
(Slug::from de lib/env.sh) y falla con mensaje claro si no existe
- env.sh: Env::require_config valida la config, y Env::deploy la copia
a <dest>/.env, que el servidor autocarga (sobrevive a rsync --delete)
- tests.yml: el smoke-build usa un prefijo placeholder (/admin-ci);
comprueba que el build funciona, no la configuración del entorno
Cambio openspec hide-admin-route: las rutas de administración se montan
bajo LOCALESP_ADMIN_PREFIX (única variable, obligatoria, sin valor por
defecto) y las rutas históricas /api/... dejan de existir (404 natural).
- server: autocarga de .env (sin pisar el entorno) y fail-fast claro si
falta LOCALESP_ADMIN_PREFIX; reportar/confirmar siguen públicas
- frontend: src/api.js usa el prefijo expuesto por Vite (envPrefix);
npm run build falla sin la variable; proxy de dev la lee vía loadEnv
- .env.example como template único de configuración
- tests: 109/109 en verde (rutas bajo prefijo, 404s históricos y
fail-fast sin configurar)
- openspec: artefactos del cambio sincronizados (design/spec/tasks)
- Nuevo PasoDatosLocal con nombre, provincia y dirección (ahora editable)
en la misma pantalla, con aviso cuando vienen de la inferencia
- El wizard pasa de 6 a 5 pasos: Ubicación → Datos del local → Categoría
→ Tipo específico → Resumen
- Eliminados PasoNombre y PasoProvincia (absorbidos)
- Spec principal actualizada al nuevo orden de pantallas
- vitest 4 traía vite 8 anidado con esbuild 0.28: el lockfile quedaba
incompleto para npm ci y el npm 10.8.2 del runner fallaba con
"Missing @esbuild/* from lock file" / EBADPLATFORM. vitest 3 usa el
vite 5 del proyecto como peer: sin árbol anidado, esbuild solo 0.21.5
- jsdom 30 exige Node >=22.22 (el runner tiene 20.20): bajado a jsdom 26
- tests.yml sobre el runner real (self-hosted, Node del sistema) en vez
de ubuntu-latest, que no existe como label
- aserciones de max()/calc() tolerantes a la serialización de jsdom 26
- Mueve el cambio (36/36 tareas, 4/4 artefactos) a changes/archive/
- Crea las specs principales de boton-flotante-proponer-local,
pasarela-proponer-local y proveedores-ubicacion (con Purpose)
- FAB y aviso PWA flanquean la columna central (720px): right/left
max(16px, calc((100vw - 720px)/2 + 16px)) para acompañar al contenido
en pantallas anchas sin pegarse al borde de la ventana
- FAB de 64px en PC (54 en móvil); PWA abajo a la izquierda en PC y móvil
- Nuevo BotonProponerArriba (solo PC): píldora "Proponer local" arriba a
la derecha, alineada al cuerpo, que abre la misma pasarela
- Campo universal de ubicación (Google Maps/Waze/OSM/coordenadas/dirección)
sobre proveedores extensibles (src/utils/ubicacion) con resolver e inferencia
inversa Nominatim (nombre/provincia pre-rellenados, alias cooficiales)
- FAB flotante abajo a la derecha que abre la pasarela en un modal accesible
(Escape, foco contenido, responsive); sin descripción ni puntuación;
avisos de duplicado y filtro de palabras dentro del modal
- Aviso PWA reposicionado: tarjeta abajo a la izquierda en móvil,
botón compacto arriba a la izquierda en PC (no tapa el FAB)
- Suite de pruebas: 88 unitarias/componente (vitest + RTL, offline) y
10 de integración (supertest + SQLite :memory: y Nominatim real opt-in)
- CI: workflow de Gitea Actions con npm test + build en push/PR e
integración manual
- Añade sistema de avisos tipo snackbar (Toast.jsx + useToast.js) con
auto-cierre, animación de entrada y estilos info/éxito/error.
- LocalCard: feedback visual al añadir/quitar un local de favoritos.
- AdminPanel: sustituye los alert() por toasts al aprobar, rechazar,
eliminar locales, descartar avisos y guardar el filtro de palabras;
además saluda con un toast tras iniciar sesión o crear cuenta.
- App: el contenedor del mapa Leaflet queda siempre montado (oculto con
CSS) y se llama a invalidateSize() al volver a la pestaña de mapa;
así el mapa ya no se rompe al navegar entre vistas (antes obligaba
a recargar la página).
El objetivo de estos cambios es, por un lado, mantener los datos
actualizados y, por otro, mejorar la experiencia para quienes lo usan:
- Fiabilidad: los locales se pueden confirmar ("Sigue aquí") y
reportar (cerrado, datos incorrectos...), y se avisa de duplicados
antes de publicar, para que el contenido no se quede obsoleto ni
repetido.
- Usabilidad: autocompletado al proponer, favoritos, "cerca de mí",
compartir fichas, enlaces a Waze y una política de privacidad
visible, para que sea más sencillo aportar y encontrar locales.
- Extrae App.jsx en módulos reutilizables: constants/ (categorias,
provincias), utils/geo, styles/shared, hooks/usePwaInstall y
components/ (StarRating, LocalCard, CampoUbicacion, BannerMovil,
CategoriaBadge)
- AdminPanel reutiliza constantes y componentes compartidos y corrige
la limpieza de suscripciones de Firebase al desmontar
- Añade logos de marca (logo-localesp.png + @2x) y regenera los iconos
PWA con tamaños menores
- sw.js: sube la caché del shell a v2 e incluye los nuevos iconos y logos
El commit anterior (a3fd928) referenciaba /manifest.webmanifest,
/sw.js, /favicon-32.png y /apple-touch-icon.png en index.html y
main.jsx, pero los archivos no existían: el fallback SPA los servía
como index.html (200 text/html), así que la PWA no era instalable y
parecía que el desplegue no había actualizado.
Se añaden en public/ (Vite los copia a dist/ raíz):
- manifest.webmanifest: nombre, theme_color #8B0000, iconos any/maskable.
- sw.js: cache del shell con stale-while-revalidate (sirve cache al
instante y revalida en segundo plano) + network-first para /api/.
Versión de caché localesp-shell-v1.
- Iconos: favicon-32, apple-touch-icon (180), icon-192, icon-512 y
icon-512-maskable.
- Mapeo campos en base de datos: ubicacion→provincia, telefono→subcategoria,
email→direccion, web→enlaceGoogleMaps y añadido puntuacion.
- Migración suave (ensureColumn) para añadir las nuevas columnas sin perder
datos existentes si la DB ya existía con el esquema antiguo.
- Actualización de rutas del servidor para guardar/leer los nuevos campos y
convertir el NULL a valor nulo por defecto en puntuacion.
- Soporte PWA: añadido meta tags (manifest, theme-color, apple-touch-icon) y
registro de service worker para instalación del app y shell offline.
Añade la automatización de despliegue a esta rama (no la tenía):
- .gitea/workflows/deploy.yml: build + deploy on push, teardown on delete.
- scripts/lib/env.sh + deploy.sh + teardown.sh: lib OOP (Env + SystemdUnit/
NginxVhost/TlsCert) y entrypoints finos.
El código de la app NO se modifica. Traído path-scoped desde master (6cc326e).
Cada push a prototipo-yb01 publicará la app en prototipo-yb01.localesp.es.
- 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.