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,42 @@
|
||||
# Tasks: Reseñas múltiples por local (issue #6)
|
||||
|
||||
> Decisiones de entrevista (2026-10-11): v1 anónima estilo 4chan (deviceId
|
||||
> en localStorage, huella corta por local), sección desplegable en la
|
||||
> tarjeta, "Anónimo #xxx" + fecha, tabla `resenas` + media agregada en
|
||||
> `locales.puntuacion`, publicación directa + reportes, rate-limit por IP.
|
||||
> Detalles de esquema y endpoints: design.md.
|
||||
|
||||
## 1. BD (server/db.js)
|
||||
|
||||
- [ ] 1.1 Crear tabla `resenas` (id, localId, deviceId, puntuacion 1–5 CHECK, comentario, fecha, fechaEdicion, UNIQUE(localId, deviceId))
|
||||
- [ ] 1.2 `ensureColumn("reportes", "resenaId", "TEXT")` para reportar reseñas concretas
|
||||
|
||||
## 2. Servidor (server/index.js)
|
||||
|
||||
- [ ] 2.1 Helper `recalcularMedia(localId)`: `UPDATE locales SET puntuacion = ROUND(AVG(resenas.puntuacion))` (0 si vacío)
|
||||
- [ ] 2.2 `GET /api/locales/:id/resenas` → 200 lista pública sin deviceId completo (huella corta por reseña: 3 hex de sha256(deviceId+localId))
|
||||
- [ ] 2.3 `POST /api/locales/:id/resenas` upsert: valida puntuacion 1–5 y comentario ≤500; 404 si el local no existe; filtro de palabras en el comentario; crea (201) o edita la propia (200, fechaEdicion); recalcula media
|
||||
- [ ] 2.4 `DELETE /api/locales/:id/resenas` con deviceId → borra la propia (200) y recalcula; 404 si no tiene reseña
|
||||
- [ ] 2.5 Rate-limit por IP en POST/DELETE de reseñas (en memoria o express-rate-limit; 429 al exceder)
|
||||
- [ ] 2.6 Extender `POST /api/locales/:id/reportar` para aceptar `resenaId` opcional (reporte de reseña)
|
||||
- [ ] 2.7 Admin bajo prefijo: `GET $PREFIX/resenas` (lista con datos completos) y `DELETE $PREFIX/resenas/:id` (borrado de moderación + recálculo)
|
||||
|
||||
## 3. Frontend
|
||||
|
||||
- [ ] 3.1 Util `deviceId` persistente en localStorage (UUID v4, creación perezosa) en `src/utils/`
|
||||
- [ ] 3.2 Cliente API de reseñas en `src/api.js` (listar, enviar upsert, borrar propia) con el deviceId
|
||||
- [ ] 3.3 `StarRating` interactivo (modo edición: click 1–5) manteniendo el readOnly actual
|
||||
- [ ] 3.4 Componente `ResenasLocal` desplegable: cabecera "Reseñas (N) · ★media", carga perezosa al expandir, lista (huella, estrellas, comentario, fecha, marca "editada") y formulario inline (estrellas + textarea 500)
|
||||
- [ ] 3.5 Integrar en `LocalCard.jsx`: precargar el formulario con la reseña propia y ofrecer Actualizar/Borrar; reportar reseña ajena desde la lista
|
||||
- [ ] 3.6 Verificar que popup del mapa, orden "★ Mejor" y media global siguen correctos con la puntuación agregada (sin cambios de código previstos)
|
||||
|
||||
## 4. Tests
|
||||
|
||||
- [ ] 4.1 `tests/unit/test-routes.spec.js` (o fichero nuevo `test-resenas.spec.js`): upsert (una por dispositivo), 400 sin puntuacion/fuera de rango/comentario >500, 404 local inexistente, filtro de palabras, recálculo de media al crear/editar/borrar (incl. borrado admin), reporte con resenaId, rate-limit 429
|
||||
- [ ] 4.2 Tests de componente: `ResenasLocal` plegado/expandido, formulario con estrellas, precarga de la propia, envío y borrado
|
||||
- [ ] 4.3 Suite completa en verde: `./node_modules/.bin/vitest run`
|
||||
|
||||
## 5. Cierre
|
||||
|
||||
- [ ] 5.1 README: documentar reseñas (contrato de la API pública, moderación, anonimato y su huella, rate-limit)
|
||||
- [ ] 5.2 Referenciar la issue #6 en el commit de cierre y verificar despliegue en prototipo-yb01.localesp.es
|
||||
Reference in New Issue
Block a user