Files
edgar.friendly ebbd7b696e
deploy-branch / deploy (push) Successful in 2m45s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m3s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 2m59s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
feat(tarjeta): rediseño de usabilidad — descripción arriba, vista previa de reseñas y barra de acciones
- La descripción del local pasa a bloque propio ENCIMA de las reseñas
- Reseñas: carga al montar con 2 visibles sin expandir; expansión con
  animación (grid-template-rows 0fr→1fr, 350ms) que revela todas + el
  formulario; pista "Ver las N reseñas" cuando hay más de 2
- Barra inferior a ancho completo: Comentar (expande+enfoca) · Reportar
  (formulario controlado) · Marcar (favorito, corazón fuera de cabecera,
  aria-pressed) · Compartir (antes en cabecera); fecha pequeñita encima
- openspec: archiva resenas-por-local (spec principal creado por sync) y
  abre tarjeta-local-rediseno (specs de tarjeta-local + resenas modificada)

Suite: 138/138 (+6 netos).
2026-10-11 23:21:22 +02:00

3.4 KiB
Raw Permalink Blame History

Proposal: Reseñas múltiples por local (issue #6)

Why

La issue #6 pide que los comentarios y las valoraciones sean múltiples por local: una reseña por usuario, editable. Hoy un local tiene una única puntuacion (entero histórico, casi siempre 0) mostrada como estrellas read-only, sin reseñas. Una pestaña de reseñas por local da voz a quien usa la web y convierte la puntuación en una media real. Decidido en entrevista: v1 anónima estilo 4chan (huella de dispositivo, sin cuentas, cuentas en un futuro), publicación directa con filtro y reportes, y la media se agrega en locales.puntuacion.

What Changes

  • Nueva tabla resenas: una por (local, dispositivo) — restricción UNIQUE; puntuacion 1–5 obligatoria y comentario opcional (≤500 caracteres); editable (misma fila, fechaEdicion) y borrable por su autor.
  • locales.puntuacion pasa a ser la media de las reseñas (entero redondeado), recalculada al crear/editar/borrar una reseña; sin reseñas sigue en 0.
  • Identidad anónima por dispositivo: deviceId aleatorio en localStorage (sin datos personales). Cada reseña se muestra como "Anónimo #xxx" con huella corta derivada del deviceId (estilo 4chan), nunca el deviceId completo.
  • Endpoints públicos: GET /api/locales/:id/resenas, POST /api/locales/:id/resenas (crear o editar la propia: upsert), DELETE /api/locales/:id/resenas (borrar la propia, identificándose con el deviceId). Admin bajo prefijo: listar y borrar reseñas abusivas ($PREFIX/resenas).
  • Rate-limiting por IP en las escrituras de reseñas (defensa base anti-boicot; el DDoS volumétrico se mitiga en el borde, fuera de alcance).
  • Filtro de palabras prohibidas aplicado al comentario; flujo de reportes extendido para poder reportar una reseña concreta (columna resenaId nullable en reportes) y que el admin la borre.
  • UI: sección desplegable en la propia tarjeta del local — "Reseñas (N) · ★ media" que expande la lista y el formulario inline (estrellas interactivas + comentario). La propia reseña del dispositivo aparece como editable/borrable.

Capabilities

New Capabilities

  • resenas-por-local: reseñas anónimas múltiples por local — una por dispositivo, editables; media agregada en la puntuación del local; publicación directa con filtro, reportes y rate-limit; UI desplegable en la tarjeta.

Modified Capabilities

(vacío — la pasarela no cambia: la puntuación sigue sin formar parte de la propuesta de local; las reseñas viven sobre locales publicados)

Impact

  • BD (server/db.js): tabla resenas + ensureColumn("reportes", "resenaId", ...). Sin migración destructiva.
  • Servidor (server/index.js): endpoints públicos y admin de reseñas, recálculo de media, rate-limit en memoria por IP, filtro de palabras en comentarios, reporte de reseñas.
  • Frontend: deviceId en localStorage (util nuevo), componente desplegable de reseñas integrado en LocalCard.jsx (y StarRating interactivo en el formulario). El popup del mapa y el orden "★ Mejor" consumen puntuacion ya agregada: sin cambios.
  • Tests: rutas (upsert, unicidad, media, rate-limit, filtro, admin) y componentes (desplegable, formulario, editar/borrar propia).
  • Futuro (no en este cambio): migración deviceId→userId cuando lleguen las cuentas (el diseño lo deja preparado).