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
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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user