Files
localesp/openspec/changes/resenas-por-local/proposal.md
T
edgar.friendly dd6febf8b0 openspec: archiva pasarela-descripcion-opcional (sync aplicado) y abre resenas-por-local (issue #6)
- 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)
2026-10-11 15:45:57 +02:00

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