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