Files
localesp/openspec/changes/resenas-por-local/tasks.md
T
edgar.friendly dd6febf8b0 openspec: archiva pasarela-descripcion-opcional (sync aplicado) y abre resenas-por-local (issue #6)
- spec principal pasarela-proponer-local sincronizado con el delta
  (descripción opcional, orden de 6 pantallas, filtro sobre descripción)
- cambio archivado en archive/2026-10-11-pasarela-descripcion-opcional
- nuevo cambio resenas-por-local: reseñas anónimas estilo 4chan, media
  agregada, publicación directa + reportes, rate-limit (artefactos 4/4)
2026-10-11 15:45:57 +02:00

43 lines
3.2 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.
## 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