feat(tarjeta): rediseño de usabilidad — descripción arriba, vista previa de reseñas y barra de acciones
deploy-branch / deploy (push) Successful in 2m45s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m3s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 2m59s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
deploy-branch / deploy (push) Successful in 2m45s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m3s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 2m59s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
- La descripción del local pasa a bloque propio ENCIMA de las reseñas - Reseñas: carga al montar con 2 visibles sin expandir; expansión con animación (grid-template-rows 0fr→1fr, 350ms) que revela todas + el formulario; pista "Ver las N reseñas" cuando hay más de 2 - Barra inferior a ancho completo: Comentar (expande+enfoca) · Reportar (formulario controlado) · Marcar (favorito, corazón fuera de cabecera, aria-pressed) · Compartir (antes en cabecera); fecha pequeñita encima - openspec: archiva resenas-por-local (spec principal creado por sync) y abre tarjeta-local-rediseno (specs de tarjeta-local + resenas modificada) Suite: 138/138 (+6 netos).
This commit is contained in:
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-10-11
|
||||
@@ -0,0 +1,141 @@
|
||||
# Design: Reseñas múltiples por local (issue #6)
|
||||
|
||||
## Context
|
||||
|
||||
La issue #6 pide comentarios y valoraciones múltiples por local (una reseña
|
||||
por usuario, editable). Entrevista con el usuario (2026-10-11):
|
||||
|
||||
- **Identidad v1: anónima estilo 4chan** — huella de dispositivo, sin
|
||||
cuentas; "ya añadiremos cuentas". Preocupación explícita: boicots y DDoS.
|
||||
- **UI: sección desplegable en la propia tarjeta** del local.
|
||||
- **Display del reseñador: "Anónimo" con inicial/huella** + fecha.
|
||||
- **Modelo de datos: tabla `resenas` + media agregada en `locales.puntuacion`**
|
||||
(elegido en la primera ronda de entrevista).
|
||||
- **Moderación: publicación directa + reportes** (como el flujo actual de
|
||||
reportes de locales).
|
||||
|
||||
Estado actual: sin autenticación alguna (tabla `users` vacía de código);
|
||||
`locales.puntuacion` es un entero único casi siempre 0 (estrellas read-only
|
||||
en `LocalCard`, media global y orden "★ Mejor" en `App.jsx`); `reportes`
|
||||
tiene flujo admin completo (listar/descartar); filtro de palabras
|
||||
centralizado en `config.filtro_palabras`.
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:**
|
||||
- Una reseña por dispositivo y local, editable y borrable por su autor.
|
||||
- Media de reseñas visible donde ya hay estrellas, sin tocar consumidores.
|
||||
- Resistencia base al boicot de contenido (rate-limit, unicidad, filtro,
|
||||
moderación) manteniendo cero fricción (sin registro).
|
||||
- Anonimato sin datos personales, con huella corta legible por local.
|
||||
|
||||
**Non-Goals:**
|
||||
- Cuentas de usuario / login (futuro; diseño prepara la migración).
|
||||
- Reseñas anónimas firmadas criptográficamente o prueba-de-trabajo (se
|
||||
valoran como endurecimiento posterior si hay abuso real).
|
||||
- Moderación previa (cola de aprobación) — se publican directamente.
|
||||
- Mitigación de DDoS volumétrico (borde/infra: proxy con rate-limit,
|
||||
fail2ban o CDN delante; fuera de este cambio).
|
||||
- Editar la `descripcion` del local ni tocar la pasarela.
|
||||
|
||||
## Decisions
|
||||
|
||||
1. **`deviceId` aleatorio en `localStorage` como identidad v1** (UUID v4).
|
||||
Anónimo, cero fricción, sin PII. Se envía en el POST/DELETE (el servidor
|
||||
no puede fiarse de él para autenticar, pero sí para la unicidad y la
|
||||
propiedad lógica de la reseña). *Alternativa descartada:* huella
|
||||
derivada del request (IP+UA): frágil (IP dinámica) y colisiona en redes
|
||||
compartidas (CGNAT móviles muy comunes en España).
|
||||
|
||||
2. **Esquema: tabla `resenas` con `UNIQUE(localId, deviceId)`.**
|
||||
```sql
|
||||
CREATE TABLE IF NOT EXISTS resenas (
|
||||
id TEXT PRIMARY KEY,
|
||||
localId TEXT NOT NULL,
|
||||
deviceId TEXT NOT NULL,
|
||||
puntuacion INTEGER NOT NULL CHECK (puntuacion BETWEEN 1 AND 5),
|
||||
comentario TEXT,
|
||||
fecha TEXT DEFAULT CURRENT_TIMESTAMP,
|
||||
fechaEdicion TEXT,
|
||||
UNIQUE (localId, deviceId)
|
||||
);
|
||||
```
|
||||
Editar = `UPDATE` de la misma fila (+`fechaEdicion`). "Una por usuario"
|
||||
se garantiza por constraint, no por código. `reportes` gana
|
||||
`resenaId TEXT` nullable (`ensureColumn`, sin migración destructiva).
|
||||
*Futuro cuentas:* columna `userId` nullable + migración
|
||||
deviceId→userId; el UNIQUE se mueve a (localId, userId) cuando exista.
|
||||
|
||||
3. **Media agregada en `locales.puntuacion`.** Tras cada
|
||||
crear/editar/borrar: `UPDATE locales SET puntuacion = ROUND(AVG(...))`
|
||||
(0 si no quedan reseñas). Así `LocalCard`, el popup del mapa, el orden
|
||||
"★ Mejor" y la media global consumen el campo tal cual, sin cambios.
|
||||
*Alternativa descartada:* media calculada en cada lectura (obliga a
|
||||
tocar todos los consumidores y las queries de listado).
|
||||
|
||||
4. **API REST siguiente la convención del repo:**
|
||||
- `GET /api/locales/:id/resenas` → 200 lista pública (sin deviceId
|
||||
completo: solo huella corta por reseña).
|
||||
- `POST /api/locales/:id/resenas` `{ deviceId, puntuacion, comentario }`
|
||||
→ **upsert** (201 crea; 200 actualiza la propia). Simplifica el
|
||||
cliente: un solo botón "Publicar/Actualizar".
|
||||
- `DELETE /api/locales/:id/resenas?deviceId=...` → 200 borra la propia.
|
||||
- `$PREFIX/resenas` → 200 lista admin; `DELETE $PREFIX/resenas/:id` →
|
||||
200 borra (moderación), recalcula media.
|
||||
- Reporte de reseña: reusa `POST /api/locales/:id/reportar` con
|
||||
`{ motivo, comentario, resenaId }`.
|
||||
|
||||
5. **Hucha corta estilo 4chan por local:** `#` + 3 primeros hex del
|
||||
sha256(deviceId + localId). Estable por local (permite seguir el hilo de
|
||||
un "anónimo" dentro del mismo local), no reversible al deviceId y no
|
||||
rastreable entre locales. *Alternativa descartada:* huella global —
|
||||
permitiría perfilar a un anónimo entre todos los locales.
|
||||
|
||||
6. **Anti-boicot por capas (todo server-side, en memoria):**
|
||||
- `express-rate-limit` (o tabla simple en memoria si se prefiere cero
|
||||
dependencias) sobre POST/DELETE de reseñas: p. ej. 10/hora por IP.
|
||||
- Unicidad (localId, deviceId) — un dispositivo no inflaba la media.
|
||||
- Filtro de palabras en el comentario + `maxLength` 500.
|
||||
- Moderación reactiva: reportes visibles en el panel → borrado admin.
|
||||
*Registro de la razón por la que NO PoW/HMAC-token en v1:* complejidad
|
||||
de implementación y UX; con rate-limit + unicidad + moderación el
|
||||
coste de un boicot coordinado ya no es trivial. Endurecemos si pasa.
|
||||
|
||||
7. **UI: desplegable en `LocalCard`.** Cabecera "Reseñas (N) · ★media"
|
||||
clicable que expande `<ResenasLocal>`: lista (huella, estrellas,
|
||||
comentario, fecha, "editada") + formulario inline (StarRating
|
||||
interactivo + textarea 500 + Publicar/Actualizar/Borrar). Carga perezosa
|
||||
(solo al expandir). *Alternativa descartada:* modal de detalle — más
|
||||
navegación para el caso de uso dominante (leer reseñas al comparar).
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- [deviceId en localStorage es falsificable → boicot con N dispositivos
|
||||
artificiales] → rate-limit por IP + unicidad + reportes + borrado admin;
|
||||
endurecimiento posterior (PoW/cuentas) si se materializa.
|
||||
- [Media secuestrable por primeros votantes] → es la naturaleza de una
|
||||
media; con volumen se corrige sola y la moderación cubre abuso evidente.
|
||||
- [localStorage compartido/borrado → el usuario pierde su reseña] →
|
||||
aceptable en v1 anónima (sin identidad portátil); las cuentas lo
|
||||
resolverán.
|
||||
- [Escribir en `locales` desde el endpoint de reseñas acopla tablas] →
|
||||
recálculo centralizado en un helper `recalcularMedia(localId)` usado por
|
||||
todas las vías (crear/editar/borrar/admin).
|
||||
- [Comentario publicado sin revisión previa] → elegido por el usuario;
|
||||
mitigado por filtro de palabras, reportes y borrado admin inmediato.
|
||||
|
||||
## Migration Plan
|
||||
|
||||
Solo aditivo (CREATE TABLE + ensureColumn): desplegar y ya. Las
|
||||
`puntuacion` históricas (mayormente 0) pasan a significar "sin reseñas";
|
||||
si algún local tuviera puntuación manual heredada, se mantiene hasta la
|
||||
primera reseña (decisión documentada; no hay camino de datos conocido con
|
||||
puntuaciones manuales). Rollback = revert; la tabla queda huérfana sin
|
||||
efecto.
|
||||
|
||||
## Open Questions
|
||||
|
||||
- ¿Rate-limit exacto (10/hora/IP es un punto de partida razonable)? Se
|
||||
ajusta tras ver tráfico real.
|
||||
- ¿Tope de longitud del comentario 500? Alineado con la filosofía "corto"
|
||||
de la descripción de la pasarela (200) pero algo más holgado.
|
||||
@@ -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).
|
||||
@@ -0,0 +1,95 @@
|
||||
# Delta Spec: resenas-por-local (nueva capacidad)
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Una reseña por dispositivo y local
|
||||
El sistema SHALL permitir como máximo una reseña por dispositivo y local; enviar una reseña cuando ya existe una del mismo dispositivo SHALL actualizar (editar) la existente en lugar de crear una duplicada.
|
||||
|
||||
#### Scenario: Primera reseña
|
||||
- **WHEN** un dispositivo envía `puntuacion` (1–5) y un comentario opcional a un local sin reseña previa suya
|
||||
- **THEN** la reseña se crea con fecha y queda visible en la lista del local
|
||||
|
||||
#### Scenario: Reenvío edita la existente
|
||||
- **WHEN** un dispositivo que ya reseñó un local envía de nuevo una reseña para ese local
|
||||
- **THEN** la reseña previa se actualiza (puntuacion y comentario) y se registra la fecha de edición, sin crear duplicados
|
||||
|
||||
#### Scenario: Borrado de la propia reseña
|
||||
- **WHEN** un dispositivo solicita borrar su reseña de un local
|
||||
- **THEN** la reseña desaparece de la lista y la puntuación del local se recalcula
|
||||
|
||||
### Requirement: Valoración obligatoria 1–5 y comentario opcional
|
||||
La reseña SHALL contener una valoración de 1 a 5 estrellas obligatoria y un comentario opcional de como máximo 500 caracteres; las escrituras fuera de ese contrato SHALL rechazarse con error 400.
|
||||
|
||||
#### Scenario: Reseña sin puntuacion
|
||||
- **WHEN** se envía una reseña sin puntuacion o fuera del rango 1–5
|
||||
- **THEN** el servidor responde 400 y no se crea ni modifica ninguna reseña
|
||||
|
||||
#### Scenario: Comentario demasiado largo
|
||||
- **WHEN** se envía un comentario de más de 500 caracteres
|
||||
- **THEN** el servidor responde 400
|
||||
|
||||
### Requirement: Media agregada en la puntuación del local
|
||||
El sistema SHALL mantener `locales.puntuacion` como la media (entero redondeado) de las reseñas vigentes del local, recalculada al crear, editar o borrar una reseña; sin reseñas SHALL valer 0. Los consumidores existentes (estrellas de la tarjeta, popup del mapa, orden "★ Mejor" y media global) SHALL funcionar sin cambios.
|
||||
|
||||
#### Scenario: Recálculo al crear
|
||||
- **WHEN** un local sin reseñas recibe una reseña de 5 estrellas y luego otra de 4
|
||||
- **THEN** tras la primera la puntuación del local es 5, y tras la segunda es 5 (media 4.5 redondeada al entero más próximo, ROUND de SQLite)
|
||||
|
||||
#### Scenario: Recálculo al borrar
|
||||
- **WHEN** se borra la única reseña de un local
|
||||
- **THEN** la puntuación del local vuelve a 0
|
||||
|
||||
### Requirement: Identidad anónima con huella corta
|
||||
El sistema SHALL identificar a quien reseña mediante un identificador de dispositivo aleatorio (sin datos personales) y SHALL mostrar cada reseña como "Anónimo" seguida de una huella corta estable por local (derivada del identificador de dispositivo y del local, no reversible y no rastreable entre locales) junto a su fecha.
|
||||
|
||||
#### Scenario: Visualización anónima
|
||||
- **WHEN** se lista las reseñas de un local
|
||||
- **THEN** cada reseña se muestra como anónima con su huella corta y su fecha, sin exponer el identificador completo del dispositivo
|
||||
|
||||
#### Scenario: Huella estable dentro de un local
|
||||
- **WHEN** el mismo dispositivo reseña (o edita su reseña en) un local
|
||||
- **THEN** la huella mostrada es la misma en todas las reseñas de ese local para ese dispositivo
|
||||
|
||||
### Requirement: Publicación directa con filtro de palabras
|
||||
Las reseñas SHALL publicarse inmediatamente al enviarse, aplicando el filtro de palabras prohibidas al comentario; un comentario con palabras no permitidas SHALL rechazarse con el aviso correspondiente.
|
||||
|
||||
#### Scenario: Palabra prohibida en el comentario
|
||||
- **WHEN** se envía una reseña cuyo comentario contiene una palabra no permitida
|
||||
- **THEN** el servidor responde con error y la reseña no se publica
|
||||
|
||||
#### Scenario: Publicación inmediata
|
||||
- **WHEN** una reseña válida se envía
|
||||
- **THEN** queda visible en la lista del local sin intervención del administrador
|
||||
|
||||
### Requirement: Rate limiting de escrituras
|
||||
El sistema SHALL limitar la frecuencia de escrituras de reseñas (crear/editar/borrar) por dirección IP, rechazando con error 429 los excesos, como defensa base contra el boicot automatizado.
|
||||
|
||||
#### Scenario: Límite excedido
|
||||
- **WHEN** una misma IP supera el límite de escrituras de reseñas en la ventana configurada
|
||||
- **THEN** las peticiones adicionales reciben 429 y no modifican datos
|
||||
|
||||
### Requirement: Reporte y moderación de reseñas
|
||||
El sistema SHALL permitir reportar una reseña concreta (reusando el flujo de reportes) y SHALL ofrecer al administrador, bajo el prefijo admin, el listado de reseñas y el borrado de cualquiera de ellas, recalculando la media al borrar.
|
||||
|
||||
#### Scenario: Reportar una reseña
|
||||
- **WHEN** un usuario reporta una reseña de un local
|
||||
- **THEN** el reporte aparece en la lista de reportes del admin identificado como reporte de esa reseña
|
||||
|
||||
#### Scenario: Borrado admin
|
||||
- **WHEN** el administrador borra una reseña desde el panel
|
||||
- **THEN** la reseña desaparece y la puntuación del local se recalcula
|
||||
|
||||
### Requirement: Sección de reseñas desplegable en la tarjeta del local
|
||||
La tarjeta de cada local SHALL incluir una sección "Reseñas (N) · ★ media" que al expandirla muestra perezosamente la lista de reseñas y el formulario inline (estrellas interactivas 1–5 y comentario opcional de 500 caracteres), con las acciones de publicar/actualizar y borrar para la reseña del propio dispositivo.
|
||||
|
||||
#### Scenario: Tarjeta sin expandir
|
||||
- **WHEN** se muestra la tarjeta de un local
|
||||
- **THEN** la sección de reseñas aparece plegada con el número de reseñas y la media
|
||||
|
||||
#### Scenario: Expandir y reseñar
|
||||
- **WHEN** el usuario expande la sección de reseñas y envía estrellas (y opcionalmente comentario)
|
||||
- **THEN** su reseña aparece en la lista y la cabecera actualiza número y media
|
||||
|
||||
#### Scenario: La propia reseña es editable
|
||||
- **WHEN** el dispositivo ya tiene reseña en ese local y expande la sección
|
||||
- **THEN** el formulario aparece precargado con su reseña y ofrece actualizar o borrar
|
||||
@@ -0,0 +1,52 @@
|
||||
# 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.
|
||||
|
||||
> **Estado:** implementado y verificado. `./node_modules/.bin/vitest run` →
|
||||
> **132/132 en verde** (19 ficheros), con 18 tests nuevos: 9 de rutas en
|
||||
> `test-resenas.spec.js` (upsert, contrato 400/404, filtro, media, reportes
|
||||
> y moderación admin), 1 de rate-limit 429 en `test-resenas-ratelimit.spec.js`
|
||||
> y 6 de componente en `ResenasLocal.spec.jsx` (mockeando api.js). Extra no
|
||||
> previsto en las tareas y añadido para cubrir el escenario del spec
|
||||
> «borrado admin desde el panel»: botón «🗑 Borrar reseña» en la pestaña
|
||||
> Reportes del AdminPanel (borra la reseña y descarta el aviso).
|
||||
|
||||
## 1. BD (server/db.js)
|
||||
|
||||
- [x] 1.1 Crear tabla `resenas` (id, localId, deviceId, puntuacion 1–5 CHECK, comentario, fecha, fechaEdicion, UNIQUE(localId, deviceId))
|
||||
- [x] 1.2 `ensureColumn("reportes", "resenaId", "TEXT")` para reportar reseñas concretas
|
||||
|
||||
## 2. Servidor (server/index.js)
|
||||
|
||||
- [x] 2.1 Helper `recalcularMedia(localId)`: `UPDATE locales SET puntuacion = ROUND(AVG(resenas.puntuacion))` (0 si vacío)
|
||||
- [x] 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)); `?deviceId=` marca `esPropia`
|
||||
- [x] 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
|
||||
- [x] 2.4 `DELETE /api/locales/:id/resenas` con deviceId → borra la propia (200) y recalcula; 404 si no tiene reseña
|
||||
- [x] 2.5 Rate-limit por IP en POST/DELETE de reseñas (mapa en memoria, ventana 1h, `LOCALESP_RESENAS_RATELIMIT_MAX` configurable, 429 + Retry-After)
|
||||
- [x] 2.6 Extender `POST /api/locales/:id/reportar` para aceptar `resenaId` opcional (404 si la reseña no existe en ese local)
|
||||
- [x] 2.7 Admin bajo prefijo: `GET $PREFIX/resenas` (lista con localNombre) y `DELETE $PREFIX/resenas/:id` (borrado de moderación + recálculo)
|
||||
- [x] (extra) `GET /api/locales` incluye `totalResenas` por local (para plegar "Reseñas (N)" sin expandir)
|
||||
|
||||
## 3. Frontend
|
||||
|
||||
- [x] 3.1 Util `deviceId` persistente en localStorage (`src/utils/dispositivo.js`; UUID v4 con fallback, tolerante a almacenamiento no disponible)
|
||||
- [x] 3.2 Cliente API de reseñas en `src/api.js` (listar con deviceId, enviar upsert, borrar propia, `obtenerResenas`/`borrarResenaAdmin` de moderación) + re-exports en `firebase.js`; `reportarLocal` acepta `resenaId`
|
||||
- [x] 3.3 `StarRating` interactivo: ya existía (`onChange` con role="radio"); usado tal cual en el formulario
|
||||
- [x] 3.4 Componente `ResenasLocal` desplegable: cabecera "★media · Reseñas (N)", carga perezosa al expandir, lista (huella, estrellas, comentario, fecha, marca "editada", ⚑ reportar ajenas) y formulario inline (estrellas + textarea 500 + Publicar/Actualizar + Borrar mi reseña); errores (filtro/429) como alerta
|
||||
- [x] 3.5 Integrar en `LocalCard.jsx` (sustituye la fila de estrellas read-only; la media y el total se actualizan en local tras escribir) + botón «🗑 Borrar reseña» en el AdminPanel (pestaña Reportes, para reportes con resenaId)
|
||||
- [x] 3.6 Popup del mapa, orden "★ Mejor" y media global consumen `local.puntuacion` (ahora media agregada): sin cambios, verificado por revisión de código (los tres leen el mismo campo)
|
||||
|
||||
## 4. Tests
|
||||
|
||||
- [x] 4.1 `tests/unit/test-resenas.spec.js`: upsert (una por dispositivo), 400 sin puntuacion/fuera de rango/comentario >500/deviceId inválido, 404 local inexistente, filtro de palabras server-side, recálculo de media al crear/editar/borrar (ROUND: 4.5→5, 2.5→3), reporte con resenaId, listado/borrado admin con recálculo, `totalResenas` en `/api/locales`
|
||||
- [x] 4.2 `tests/component/ResenasLocal.spec.jsx`: plegado sin cargar, expansión con carga perezosa (huella, estrellas, deviceId en localStorage), envío con estrellas+comentario, precarga de la propia (Actualizar/Borrar), reporte de ajena con resenaId, aviso de error del servidor
|
||||
- [x] 4.3 Suite completa en verde: `./node_modules/.bin/vitest run` → **132/132** (+`tests/unit/test-resenas-ratelimit.spec.js`: 429 con Retry-After, DELETE limitado, lectura disponible)
|
||||
|
||||
## 5. Cierre
|
||||
|
||||
- [x] 5.1 README: sección «Reseñas por local (issue #6)» (contrato público, moderación, anonimato y huella, rate-limit) + rutas admin nuevas en la tabla + `.env.example` con `LOCALESP_RESENAS_RATELIMIT_MAX`
|
||||
- [x] 5.2 Referenciar la issue #6 en el commit de cierre y verificar despliegue en prototipo-yb01.localesp.es — commit `38ea283` (ref. issue #6 en el título); verificado en producción: bundle nuevo con la sección de reseñas, `totalResenas` en los 3 locales, `GET …/resenas` 200 (vacío), 404s correctos y `$PREFIX/resenas` 200
|
||||
Reference in New Issue
Block a user