## Qué cambia
<!-- En una o dos frases. -->
## Por qué
<!-- Issue relacionado o motivación. -->
## Notas para el revisor
- [ ] La app arranca con `npm run dev`.
- [ ] No he añadido dependencias innecesarias.
- [ ] He seguido la estructura existente.
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.
- 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.
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.
- 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 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.
- 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).
- 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
- 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
- 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)
- 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
- 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
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)
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
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
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
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.
- 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)
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).
- 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).
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).
- 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
- 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
Cerrada sin merge: su contenido ya está en master (merge ab79239, el árbol de master es idéntico al de prototipo-yb01) y el master anterior vive en la rama prototipo-ef, publicada en prototipo-yb01.localesp.es.
Cerrada sin merge: su contenido ya está en `master` (merge ab79239, el árbol de `master` es idéntico al de `prototipo-yb01`) y el master anterior vive en la rama `prototipo-ef`, publicada en prototipo-yb01.localesp.es.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Qué cambia
Por qué
Notas para el revisor
npm run dev.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.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).d5f014d786to9b24953a5eCerrada sin merge: su contenido ya está en
master(mergeab79239, el árbol demasteres idéntico al deprototipo-yb01) y el master anterior vive en la ramaprototipo-ef, publicada en prototipo-yb01.localesp.es.Pull request closed