feat(resenas): reseñas anónimas múltiples por local (issue #6)
deploy-branch / deploy (push) Successful in 2m56s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m14s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m6s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped

Una reseña por dispositivo (UNIQUE localId+deviceId, upsert editable),
puntuación 1-5 + comentario ≤500, publicación directa con filtro de
palabras server-side y reportes con resenaId; borrado admin desde el
panel. locales.puntuacion pasa a ser la media (ROUND) recalculada en
cada escritura; GET /api/locales añade totalResenas.

Identidad v1 anónima estilo 4chan: deviceId en localStorage, huella
corta por local (sha256(deviceId:localId)), nunca se expone el deviceId.
Anti-boicot base: rate-limit por IP (10/h, configurable con
LOCALESP_RESENAS_RATELIMIT_MAX, 429+Retry-After). UI: sección plegable
"Reseñas (N) · ★media" en la tarjeta con formulario inline.

Suite: 132/132 (+18 tests: rutas, rate-limit y componente).
This commit is contained in:
2026-10-11 23:01:25 +02:00
parent dd6febf8b0
commit 38ea2830fb
14 changed files with 893 additions and 34 deletions
+32 -1
View File
@@ -21,12 +21,43 @@ seguridad real).
| `$ADMIN_PREFIX/locales/:id` | DELETE |
| `$ADMIN_PREFIX/reportes` | GET |
| `$ADMIN_PREFIX/reportes/:id/descartar` | POST |
| `$ADMIN_PREFIX/resenas` | GET |
| `$ADMIN_PREFIX/resenas/:id` | DELETE |
Siguen siendo públicas (las usa la web): `GET /api/locales`,
`POST /api/propuestas`, `POST /api/check-duplicado`,
`POST /api/locales/:id/confirmar`, `POST /api/locales/:id/reportar` y
`POST /api/locales/:id/confirmar`, `POST /api/locales/:id/reportar`,
`GET/POST /api/locales/:id/resenas`, `DELETE /api/locales/:id/resenas` y
`GET/POST /api/config/filtro_palabras`.
## Reseñas por local (issue #6)
Cada local publicado tiene **reseñas anónimas múltiples**: una por
dispositivo, editable y borrable por su autor; `locales.puntuacion` es la
**media** (redondeo de SQLite) de las reseñas vigentes y se recalcula al
crear/editar/borrar.
- **Identidad anónima:** `deviceId` aleatorio persistido en `localStorage`
(sin cuentas ni datos personales, "estilo 4chan"). Cada reseña se muestra
como `Anónimo #xxx` con una huella corta derivada de
`sha256(deviceId:localId)`: estable dentro del local, no reversible y no
rastreable entre locales. El deviceId completo nunca sale del servidor.
- **Contrato público:** `GET /api/locales/:id/resenas` (admite `?deviceId=`
para marcar la propia), `POST /api/locales/:id/resenas`
(`{ deviceId, puntuacion 1–5, comentario ≤500 }`, upsert: crea 201 o edita
200) y `DELETE /api/locales/:id/resenas?deviceId=…` (borra la propia).
`GET /api/locales` incluye `totalResenas` por local.
- **Moderación:** publicación directa; el filtro de palabras se aplica al
comentario server-side. Una reseña concreta se reporta con
`POST /api/locales/:id/reportar` añadiendo `resenaId`; el admin la borra
desde el panel (pestaña Reportes → «Borrar reseña», también vía
`DELETE $ADMIN_PREFIX/resenas/:id`).
- **Anti-abuso:** rate-limit por IP en las escrituras de reseñas (por defecto
10/hora, configurable con `LOCALESP_RESENAS_RATELIMIT_MAX`; responde 429
con `Retry-After`) más la unicidad por dispositivo. El DDoS volumétrico se
mitiga en el borde (proxy/CDN), no en la app. Las cuentas de usuario
quedarán como trabajo futuro (migración deviceId→userId prevista).
### Configuración
`LOCALESP_ADMIN_PREFIX` es **obligatoria, sin valor por defecto y la única