- 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)
3.2 KiB
3.2 KiB
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 enlocales.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/resenasupsert: 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/resenascon 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/reportarpara aceptarresenaIdopcional (reporte de reseña) - 2.7 Admin bajo prefijo:
GET $PREFIX/resenas(lista con datos completos) yDELETE $PREFIX/resenas/:id(borrado de moderación + recálculo)
3. Frontend
- 3.1 Util
deviceIdpersistente en localStorage (UUID v4, creación perezosa) ensrc/utils/ - 3.2 Cliente API de reseñas en
src/api.js(listar, enviar upsert, borrar propia) con el deviceId - 3.3
StarRatinginteractivo (modo edición: click 1–5) manteniendo el readOnly actual - 3.4 Componente
ResenasLocaldesplegable: 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 nuevotest-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:
ResenasLocalplegado/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