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.
- 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.