# 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) - [x] 1.1 Crear tabla `resenas` (id, localId, deviceId, puntuacion 1–5 CHECK, comentario, fecha, fechaEdicion, UNIQUE(localId, deviceId)) - [x] 1.2 `ensureColumn("reportes", "resenaId", "TEXT")` para reportar reseñas concretas ## 2. Servidor (server/index.js) - [x] 2.1 Helper `recalcularMedia(localId)`: `UPDATE locales SET puntuacion = ROUND(AVG(resenas.puntuacion))` (0 si vacío) - [x] 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` - [x] 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 - [x] 2.4 `DELETE /api/locales/:id/resenas` con deviceId → borra la propia (200) y recalcula; 404 si no tiene reseña - [x] 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) - [x] 2.6 Extender `POST /api/locales/:id/reportar` para aceptar `resenaId` opcional (404 si la reseña no existe en ese local) - [x] 2.7 Admin bajo prefijo: `GET $PREFIX/resenas` (lista con localNombre) y `DELETE $PREFIX/resenas/:id` (borrado de moderación + recálculo) - [x] (extra) `GET /api/locales` incluye `totalResenas` por local (para plegar "Reseñas (N)" sin expandir) ## 3. Frontend - [x] 3.1 Util `deviceId` persistente en localStorage (`src/utils/dispositivo.js`; UUID v4 con fallback, tolerante a almacenamiento no disponible) - [x] 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` - [x] 3.3 `StarRating` interactivo: ya existía (`onChange` con role="radio"); usado tal cual en el formulario - [x] 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 - [x] 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) - [x] 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 - [x] 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` - [x] 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 - [x] 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 - [x] 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` - [x] 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