Files
localesp/openspec/changes/resenas-por-local/tasks.md
T
edgar.friendly 478943c58a
deploy-branch / deploy (push) Successful in 2m45s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m7s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
tests / Unitarias + componente + build (push) Failing after 3m2s
tests / Integración (Nominatim real, opt-in) (push) Skipped
openspec(resenas): marca 5.2 completada tras verificar despliegue
2026-10-11 23:04:46 +02:00

53 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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