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

70 lines
3.4 KiB
Markdown
Raw Permalink 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.
# 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).