5.0 KiB
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 enlocales.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 entest-resenas.spec.js(upsert, contrato 400/404, filtro, media, reportes y moderación admin), 1 de rate-limit 429 entest-resenas-ratelimit.spec.jsy 6 de componente enResenasLocal.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=marcaesPropia - 2.3
POST /api/locales/:id/resenasupsert: 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/resenascon 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_MAXconfigurable, 429 + Retry-After) - 2.6 Extender
POST /api/locales/:id/reportarpara aceptarresenaIdopcional (404 si la reseña no existe en ese local) - 2.7 Admin bajo prefijo:
GET $PREFIX/resenas(lista con localNombre) yDELETE $PREFIX/resenas/:id(borrado de moderación + recálculo) - (extra)
GET /api/localesincluyetotalResenaspor local (para plegar "Reseñas (N)" sin expandir)
3. Frontend
- 3.1 Util
deviceIdpersistente 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/borrarResenaAdminde moderación) + re-exports enfirebase.js;reportarLocalaceptaresenaId - 3.3
StarRatinginteractivo: ya existía (onChangecon role="radio"); usado tal cual en el formulario - 3.4 Componente
ResenasLocaldesplegable: 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,totalResenasen/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.exampleconLOCALESP_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,totalResenasen los 3 locales,GET …/resenas200 (vacío), 404s correctos y$PREFIX/resenas200