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)
This commit is contained in:
@@ -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).
|
||||
Reference in New Issue
Block a user