# 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).