feat(tarjeta): rediseño de usabilidad — descripción arriba, vista previa de reseñas y barra de acciones
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

- 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).
This commit is contained in:
2026-10-11 23:21:22 +02:00
parent 478943c58a
commit ebbd7b696e
17 changed files with 724 additions and 188 deletions
@@ -0,0 +1,69 @@
# 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).