Files
edgar.friendly ebbd7b696e
deploy-branch / deploy (push) Successful in 2m45s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m3s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 2m59s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
feat(tarjeta): rediseño de usabilidad — descripción arriba, vista previa de reseñas y barra de acciones
- 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).
2026-10-11 23:21:22 +02:00

5.0 KiB
Raw Permalink Blame History

Tasks: Reseñas múltiples por local (issue #6)

Decisiones de entrevista (2026-10-11): v1 anónima estilo 4chan (deviceId en localStorage, huella corta por local), sección desplegable en la tarjeta, "Anónimo #xxx" + fecha, tabla resenas + media agregada en locales.puntuacion, publicación directa + reportes, rate-limit por IP. Detalles de esquema y endpoints: design.md.

Estado: implementado y verificado. ./node_modules/.bin/vitest run → 132/132 en verde (19 ficheros), con 18 tests nuevos: 9 de rutas en test-resenas.spec.js (upsert, contrato 400/404, filtro, media, reportes y moderación admin), 1 de rate-limit 429 en test-resenas-ratelimit.spec.js y 6 de componente en ResenasLocal.spec.jsx (mockeando api.js). Extra no previsto en las tareas y añadido para cubrir el escenario del spec «borrado admin desde el panel»: botón «🗑 Borrar reseña» en la pestaña Reportes del AdminPanel (borra la reseña y descarta el aviso).

1. BD (server/db.js)

  • 1.1 Crear tabla resenas (id, localId, deviceId, puntuacion 1–5 CHECK, comentario, fecha, fechaEdicion, UNIQUE(localId, deviceId))
  • 1.2 ensureColumn("reportes", "resenaId", "TEXT") para reportar reseñas concretas

2. Servidor (server/index.js)

  • 2.1 Helper recalcularMedia(localId): UPDATE locales SET puntuacion = ROUND(AVG(resenas.puntuacion)) (0 si vacío)
  • 2.2 GET /api/locales/:id/resenas → 200 lista pública sin deviceId completo (huella corta por reseña: 3 hex de sha256(deviceId+localId)); ?deviceId= marca esPropia
  • 2.3 POST /api/locales/:id/resenas upsert: valida puntuacion 1–5 y comentario ≤500; 404 si el local no existe; filtro de palabras en el comentario; crea (201) o edita la propia (200, fechaEdicion); recalcula media
  • 2.4 DELETE /api/locales/:id/resenas con deviceId → borra la propia (200) y recalcula; 404 si no tiene reseña
  • 2.5 Rate-limit por IP en POST/DELETE de reseñas (mapa en memoria, ventana 1h, LOCALESP_RESENAS_RATELIMIT_MAX configurable, 429 + Retry-After)
  • 2.6 Extender POST /api/locales/:id/reportar para aceptar resenaId opcional (404 si la reseña no existe en ese local)
  • 2.7 Admin bajo prefijo: GET $PREFIX/resenas (lista con localNombre) y DELETE $PREFIX/resenas/:id (borrado de moderación + recálculo)
  • (extra) GET /api/locales incluye totalResenas por local (para plegar "Reseñas (N)" sin expandir)

3. Frontend

  • 3.1 Util deviceId persistente en localStorage (src/utils/dispositivo.js; UUID v4 con fallback, tolerante a almacenamiento no disponible)
  • 3.2 Cliente API de reseñas en src/api.js (listar con deviceId, enviar upsert, borrar propia, obtenerResenas/borrarResenaAdmin de moderación) + re-exports en firebase.js; reportarLocal acepta resenaId
  • 3.3 StarRating interactivo: ya existía (onChange con role="radio"); usado tal cual en el formulario
  • 3.4 Componente ResenasLocal desplegable: cabecera "★media · Reseñas (N)", carga perezosa al expandir, lista (huella, estrellas, comentario, fecha, marca "editada", ⚑ reportar ajenas) y formulario inline (estrellas + textarea 500 + Publicar/Actualizar + Borrar mi reseña); errores (filtro/429) como alerta
  • 3.5 Integrar en LocalCard.jsx (sustituye la fila de estrellas read-only; la media y el total se actualizan en local tras escribir) + botón «🗑 Borrar reseña» en el AdminPanel (pestaña Reportes, para reportes con resenaId)
  • 3.6 Popup del mapa, orden "★ Mejor" y media global consumen local.puntuacion (ahora media agregada): sin cambios, verificado por revisión de código (los tres leen el mismo campo)

4. Tests

  • 4.1 tests/unit/test-resenas.spec.js: upsert (una por dispositivo), 400 sin puntuacion/fuera de rango/comentario >500/deviceId inválido, 404 local inexistente, filtro de palabras server-side, recálculo de media al crear/editar/borrar (ROUND: 4.5→5, 2.5→3), reporte con resenaId, listado/borrado admin con recálculo, totalResenas en /api/locales
  • 4.2 tests/component/ResenasLocal.spec.jsx: plegado sin cargar, expansión con carga perezosa (huella, estrellas, deviceId en localStorage), envío con estrellas+comentario, precarga de la propia (Actualizar/Borrar), reporte de ajena con resenaId, aviso de error del servidor
  • 4.3 Suite completa en verde: ./node_modules/.bin/vitest run → 132/132 (+tests/unit/test-resenas-ratelimit.spec.js: 429 con Retry-After, DELETE limitado, lectura disponible)

5. Cierre

  • 5.1 README: sección «Reseñas por local (issue #6)» (contrato público, moderación, anonimato y huella, rate-limit) + rutas admin nuevas en la tabla + .env.example con LOCALESP_RESENAS_RATELIMIT_MAX
  • 5.2 Referenciar la issue #6 en el commit de cierre y verificar despliegue en prototipo-yb01.localesp.es — commit 38ea283 (ref. issue #6 en el título); verificado en producción: bundle nuevo con la sección de reseñas, totalResenas en los 3 locales, GET …/resenas 200 (vacío), 404s correctos y $PREFIX/resenas 200