# 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. ## 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)) - [ ] 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 (en memoria o express-rate-limit; 429 al exceder) - [ ] 2.6 Extender `POST /api/locales/:id/reportar` para aceptar `resenaId` opcional (reporte de reseña) - [ ] 2.7 Admin bajo prefijo: `GET $PREFIX/resenas` (lista con datos completos) y `DELETE $PREFIX/resenas/:id` (borrado de moderación + recálculo) ## 3. Frontend - [ ] 3.1 Util `deviceId` persistente en localStorage (UUID v4, creación perezosa) en `src/utils/` - [ ] 3.2 Cliente API de reseñas en `src/api.js` (listar, enviar upsert, borrar propia) con el deviceId - [ ] 3.3 `StarRating` interactivo (modo edición: click 1–5) manteniendo el readOnly actual - [ ] 3.4 Componente `ResenasLocal` desplegable: cabecera "Reseñas (N) · ★media", carga perezosa al expandir, lista (huella, estrellas, comentario, fecha, marca "editada") y formulario inline (estrellas + textarea 500) - [ ] 3.5 Integrar en `LocalCard.jsx`: precargar el formulario con la reseña propia y ofrecer Actualizar/Borrar; reportar reseña ajena desde la lista - [ ] 3.6 Verificar que popup del mapa, orden "★ Mejor" y media global siguen correctos con la puntuación agregada (sin cambios de código previstos) ## 4. Tests - [ ] 4.1 `tests/unit/test-routes.spec.js` (o fichero nuevo `test-resenas.spec.js`): upsert (una por dispositivo), 400 sin puntuacion/fuera de rango/comentario >500, 404 local inexistente, filtro de palabras, recálculo de media al crear/editar/borrar (incl. borrado admin), reporte con resenaId, rate-limit 429 - [ ] 4.2 Tests de componente: `ResenasLocal` plegado/expandido, formulario con estrellas, precarga de la propia, envío y borrado - [ ] 4.3 Suite completa en verde: `./node_modules/.bin/vitest run` ## 5. Cierre - [ ] 5.1 README: documentar reseñas (contrato de la API pública, moderación, anonimato y su huella, rate-limit) - [ ] 5.2 Referenciar la issue #6 en el commit de cierre y verificar despliegue en prototipo-yb01.localesp.es