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

3.2 KiB
Raw Blame History

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