Compare commits
7
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ac566a9655 | ||
|
|
2fa95840a7 | ||
|
|
c381a4747f | ||
|
|
9b24953a5e | ||
|
|
c4a60c099c | ||
|
|
ebbd7b696e | ||
|
|
478943c58a |
+1
-1
@@ -49,4 +49,4 @@
|
||||
## 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`
|
||||
- [ ] 5.2 Referenciar la issue #6 en el commit de cierre y verificar despliegue en prototipo-yb01.localesp.es
|
||||
- [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
|
||||
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-10-11
|
||||
@@ -0,0 +1,106 @@
|
||||
# Design: Rediseño de la tarjeta de local
|
||||
|
||||
## Context
|
||||
|
||||
Decisiones de entrevista (2026-10-11): Marcar = favorito **solo** en la barra
|
||||
(el corazón sale de la cabecera); **2 reseñas** visibles en primera vista;
|
||||
"Comentar" **expande y enfoca** el formulario inline (no modal); barra de
|
||||
**4 botones** (Comentar · Reportar · Marcar · Compartir) con la fecha en
|
||||
pequeñito encima y el banner "Sigue aquí" cuando toque. Sin cambios de
|
||||
backend: es un redisefo de `LocalCard` + `ResenasLocal` + `ReportarLocal`.
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:**
|
||||
- Jerarquía clara: descripción (datos del local) encima; reseñas (contenido
|
||||
vivo) debajo, con 2 visibles sin interacción.
|
||||
- Expansión animada que amplíe la tarjeta revelando todo + formulario.
|
||||
- Acciones primarias siempre visibles en una barra inferior a ancho completo.
|
||||
|
||||
**Non-Goals:**
|
||||
- Cambios de API/BD (la carga es la misma de `GET …/resenas`, solo cambia
|
||||
cuándo se dispara).
|
||||
- Paginación/límite de reseñas por local (futuro si hay locales muy reseñados).
|
||||
- Virtualización del listado de tarjetas (cada tarjeta hace 1 fetch de
|
||||
reseñas al montar; con pocos locales es irrelevante).
|
||||
|
||||
## Decisions
|
||||
|
||||
1. **Carga de reseñas al montar** (`useEffect` en `ResenasLocal`) en vez de
|
||||
al expandir: la vista previa debe existir sin interacción. Se refresca al
|
||||
expandir y tras cada escritura. El polling general de locales (5 s) no
|
||||
refresca reseñas (no hace falta).
|
||||
|
||||
2. **Vista previa = 2 reseñas más recientes** (`slice(0, 2)`), la lista
|
||||
completa vive dentro de la zona animada. Cabecera: `★ media · Reseñas (N)`
|
||||
+ chevron con `aria-expanded`. Si hay más de 2, una pista "Ver las N
|
||||
reseñas ▾" bajo la vista previa también expande (área de toque generosa).
|
||||
|
||||
3. **Animación con `grid-template-rows: 0fr → 1fr`** (contenedor
|
||||
`display: grid`, hijo `overflow: hidden`, `transition` 350 ms). Mejor que
|
||||
`max-height` fijado a ojo (no hay que estimar altura ni recortar contenido
|
||||
largo) y soportada por todos los navegadores actuales. Con estilos inline,
|
||||
sin tocar CSS global.
|
||||
|
||||
4. **`comentar()` imperativo vía `forwardRef` + `useImperativeHandle`** en
|
||||
`ResenasLocal`: la barra de `LocalCard` llama al ref → `setAbierto(true)`
|
||||
→ tras ~360 ms (fin de la transición) `scrollIntoView({ behavior:
|
||||
"smooth", block: "nearest" })` del formulario y foco en la primera
|
||||
estrella. `scrollIntoView` se llama con encadenamiento opcional (jsdom no
|
||||
lo implementa y los tests no deben romperse).
|
||||
|
||||
5. **`ReportarLocal` controlado:** props `{ localId, onCerrar,
|
||||
inicialAbierto }`; la barra lo monta con `inicialAbierto` y `onCerrar` lo
|
||||
desmonta. Se mantiene autónomo en su lógica de envío (motivo, comentario,
|
||||
estado enviado). Se renderiza justo encima de la barra, donde vivía el
|
||||
enlace "Reportar".
|
||||
|
||||
6. **Barra inferior = 4 botones iguales** (`flex: 1`, icono Tabler encima y
|
||||
etiqueta debajo, ~11 px), separada por borde superior; "Marcar" usa
|
||||
`aria-pressed` + corazón relleno rojizo cuando es favorito. En móvil los 4
|
||||
caben en un tercio de ancho cada uno sin wrap; si algún día crece, se
|
||||
permite `flexWrap`.
|
||||
|
||||
7. **Cabecera limpia:** salen el corazón y compartir; queda nombre +
|
||||
provincia. `CategoriaBadge`, dirección y enlaces Maps/Waze no cambian.
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- [Un fetch de reseñas por tarjeta al montar] → aceptable con pocos locales
|
||||
(prod tiene 3); si crece, batch endpoint (`?ids=`) como endurecimiento.
|
||||
- [Animación `grid-template-rows` en navegadores viejos] → degrada a salto
|
||||
seco sin romper nada (la propiedad anima o ignora).
|
||||
- [Vista previa + zona animada duplican render de tarjetas de reseña] → las
|
||||
2 primeras se renderizan una vez (fuera de la zona animada); dentro solo
|
||||
van de la 3ª en adelante. Sin duplicación real.
|
||||
|
||||
## Migration Plan
|
||||
|
||||
Puro frontend, desplegar y ya. Rollback = revert.
|
||||
|
||||
## Open Questions
|
||||
|
||||
(nada bloqueante; el número mágico 2 de la vista previa y los 350 ms de la
|
||||
transición son fácilmente ajustables)
|
||||
|
||||
## Iteración 2 (feedback de usuario, 2026-10-11)
|
||||
|
||||
Problemas reportados: (a) no había forma evidente de cerrar la sección de
|
||||
reseñas (el único cierre era el chevron diminuto y "Comentar" solo
|
||||
expandía); (b) demasiadas cajas anidadas (caja del formulario dentro de la
|
||||
zona expandida dentro de la tarjeta). Decisiones:
|
||||
|
||||
1. **Cierre por tres vías:** el chevron de la cabecera alterna (ya lo hacía;
|
||||
se comprueba con test), "Comentar" pasa a ser **toggle** (abre con foco /
|
||||
cierra), y el formulario plano gana un botón **"Cerrar"**.
|
||||
2. **Grid de reseñas:** vista previa de **3** reseñas en fila
|
||||
(`repeat(auto-fit, minmax(120px, 1fr))`: ocupan toda la anchura sean 1,
|
||||
2 o 3); al expandir, el resto aparece en el mismo grid. Comentarios con
|
||||
`line-clamp: 3` y fecha corta con `text-overflow` para que quepan
|
||||
"estrechadas".
|
||||
3. **Menos anidamiento:** el formulario deja de ser una caja (sin fondo ni
|
||||
borde propio): solo un `border-top` que lo separa del grid. Las tarjetas
|
||||
de reseña (fondo suave) son el único nivel de caja interior.
|
||||
4. **Acciones por tarjeta de reseña:** "Borrar" solo en las propias
|
||||
(`esPropia`), "Reportar" solo en las ajenas (con estado "✅ reportada").
|
||||
El botón "Borrar mi reseña" del formulario desaparece (redundante).
|
||||
@@ -0,0 +1,59 @@
|
||||
# Proposal: Rediseño de la tarjeta de local (usabilidad)
|
||||
|
||||
## Why
|
||||
|
||||
La sección de reseñas actual (fila plegable donde antes estaban las estrellas)
|
||||
esconde todo el contenido tras un clic y mezcla jerarquías: la descripción del
|
||||
local queda debajo de las reseñas y las acciones están dispersas (corazón y
|
||||
compartir en la cabecera, reportar abajo en pequeñito). La tarjeta necesita
|
||||
una jerarquía clara: la descripción del local es del local; las reseñas son
|
||||
contenido vivo que debe verse sin fricción; y las acciones primarias merecen
|
||||
una barra propia y visible.
|
||||
|
||||
## What Changes
|
||||
|
||||
- **Descripción separada y encima:** `local.descripcion` deja de convivir con
|
||||
las reseñas y se muestra en su propio bloque, encima de la sección de
|
||||
reseñas.
|
||||
- **Reseñas con vista previa:** la sección de reseñas carga al montar la
|
||||
tarjeta y muestra **2 reseñas visibles en la primera vista** (las más
|
||||
recientes) con la cabecera "★ media · Reseñas (N)".
|
||||
- **Expansión animada:** al expandir, una animación (transición CSS) amplía la
|
||||
tarjeta revelando **todas** las reseñas y el formulario inline.
|
||||
- **Barra inferior de acciones a ancho completo:** el pie de la tarjeta queda
|
||||
cubierto por cuatro botones — **Comentar · Reportar · Marcar · Compartir**:
|
||||
- *Comentar*: expande la sección de reseñas (si estaba plegada), hace
|
||||
scroll suave hasta el formulario y enfoca las estrellas.
|
||||
- *Reportar*: abre el formulario de reporte del local (antes era un
|
||||
textuelo "Reportar").
|
||||
- *Marcar*: favorito (el corazón desaparece de la cabecera; estado activo
|
||||
visible en la barra).
|
||||
- *Compartir*: el share se muda de la cabecera a la barra.
|
||||
- La fecha ("Publicado …") queda en pequeñito justo encima de la barra; el
|
||||
aviso "Sigue aquí ✅" se mantiene como banner cuando corresponde, encima de
|
||||
la barra.
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
|
||||
- `tarjeta-local`: estructura y acciones de la tarjeta de local — orden de
|
||||
bloques (descripción sobre reseñas), barra inferior de acciones y sus
|
||||
comportamientos.
|
||||
|
||||
### Modified Capabilities
|
||||
|
||||
- `resenas-por-local`: el requisito "Sección de reseñas desplegable en la
|
||||
tarjeta del local" cambia de carga perezosa tras clic a **carga en la
|
||||
primera vista con 2 reseñas visibles** y expansión **animada** que revela
|
||||
todas + formulario, abrible también desde "Comentar".
|
||||
|
||||
## Impact
|
||||
|
||||
- **Frontend:** `LocalCard.jsx` (reestructura + barra), `ResenasLocal.jsx`
|
||||
(carga al montar, vista previa de 2, animación, `comentar()` imperativo),
|
||||
`ReportarLocal.jsx` (controlado: se abre desde la barra).
|
||||
- **Tests:** rework de `ResenasLocal.spec.jsx` (carga temprana, 2 visibles,
|
||||
expansión, comentar) y nuevo `LocalCard.spec.jsx` (barra de 4, descripción
|
||||
encima, Marcar activo).
|
||||
- **Sin cambios** de backend, BD ni API.
|
||||
+30
@@ -0,0 +1,30 @@
|
||||
# Delta: resenas-por-local (UI de la sección de reseñas)
|
||||
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Sección de reseñas desplegable en la tarjeta del local
|
||||
La tarjeta de cada local SHALL incluir una sección "★ media · Reseñas (N)" que carga sus reseñas al montar la tarjeta y muestra las 3 primeras en una fila de tarjetas que ocupa toda la anchura de la tarjeta; al expandirla, una animación amplía la tarjeta revelando el resto de reseñas en el mismo grid y el formulario inline plano (estrellas interactivas 1–5 y comentario opcional de 500 caracteres). Cada tarjeta de reseña SHALL incluir un botón "Borrar" cuando sea propia del dispositivo y un botón "Reportar" cuando sea ajena. La sección SHALL poder cerrarse desde la cabecera, desde el botón "Comentar" de la barra inferior (que alterna) y desde un botón "Cerrar" del formulario.
|
||||
|
||||
#### Scenario: Vista previa sin expandir
|
||||
- **WHEN** se muestra la tarjeta de un local con reseñas
|
||||
- **THEN** la sección presenta la media, el total y las 3 reseñas más recientes en fila ocupando toda la anchura, sin interacción
|
||||
|
||||
#### Scenario: Expansión animada
|
||||
- **WHEN** el usuario expande la sección de reseñas
|
||||
- **THEN** la tarjeta se amplía con una animación que revela el resto de reseñas en el mismo grid y el formulario
|
||||
|
||||
#### Scenario: Cierre accesible
|
||||
- **WHEN** la sección está expandida
|
||||
- **THEN** puede cerrarse desde la cabecera, pulsando de nuevo "Comentar" o con el botón "Cerrar" del formulario
|
||||
|
||||
#### 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 y borrable desde su tarjeta
|
||||
- **WHEN** el dispositivo ya tiene reseña en ese local
|
||||
- **THEN** el formulario aparece precargado al expandir (Actualizar) y su tarjeta de reseña incluye un botón "Borrar"
|
||||
|
||||
#### Scenario: Reportar una reseña ajena
|
||||
- **WHEN** el usuario pulsa "Reportar" en una tarjeta de reseña ajena
|
||||
- **THEN** se envía el reporte de esa reseña y la tarjeta lo refleja
|
||||
+33
@@ -0,0 +1,33 @@
|
||||
# Delta Spec: tarjeta-local (nueva capacidad)
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Estructura de la tarjeta de local
|
||||
La tarjeta de cada local SHALL presentar sus bloques en este orden: nombre y provincia en la cabecera, categoría, dirección, enlaces de navegación, descripción del local (si existe), sección de reseñas, aviso de confirmación (cuando corresponda), fecha de publicación y, como pie, la barra inferior de acciones.
|
||||
|
||||
#### Scenario: La descripción va encima de las reseñas
|
||||
- **WHEN** un local tiene descripción y reseñas
|
||||
- **THEN** la descripción se muestra como bloque propio, inmediatamente encima de la sección de reseñas y sin mezclarse con ella
|
||||
|
||||
#### Scenario: Local sin descripción
|
||||
- **WHEN** un local no tiene descripción
|
||||
- **THEN** la tarjeta pasa de los enlaces de navegación directamente a la sección de reseñas
|
||||
|
||||
### Requirement: Barra inferior de acciones
|
||||
El pie de la tarjeta SHALL estar ocupado por una barra de botones a ancho completo con, de momento, cuatro acciones: Comentar, Reportar, Marcar y Compartir. La fecha de publicación SHALL quedar como texto secundario justo encima de la barra, y el aviso de confirmación ("Sigue aquí") SHALL mostrarse como banner encima de la barra cuando corresponda.
|
||||
|
||||
#### Scenario: Comentar
|
||||
- **WHEN** el usuario pulsa "Comentar"
|
||||
- **THEN** la sección de reseñas se expande si estaba plegada (con desplazamiento suave hasta el formulario y foco en la valoración) y se cierra si estaba expandida
|
||||
|
||||
#### Scenario: Reportar
|
||||
- **WHEN** el usuario pulsa "Reportar"
|
||||
- **THEN** se abre el formulario de reporte del local encima de la barra, sin salir de la tarjeta
|
||||
|
||||
#### Scenario: Marcar
|
||||
- **WHEN** el usuario pulsa "Marcar" en un local no marcado
|
||||
- **THEN** el local pasa a ser favorito y el botón refleja el estado activo (y viceversa al pulsar de nuevo)
|
||||
|
||||
#### Scenario: Compartir
|
||||
- **WHEN** el usuario pulsa "Compartir"
|
||||
- **THEN** se abre el flujo de compartir del local (nativo del dispositivo o WhatsApp con enlace copiado)
|
||||
@@ -0,0 +1,52 @@
|
||||
# Tasks: Rediseño de la tarjeta de local (usabilidad)
|
||||
|
||||
> **Estado:** implementado y verificado. `./node_modules/.bin/vitest run` →
|
||||
> **138/138 en verde** (20 ficheros): rework de `ResenasLocal.spec.jsx`
|
||||
> (7 tests: carga al montar, vista previa de 2 con la tercera oculta por
|
||||
> aria-hidden, expansión, comentar() con foco, envío, propia precargada,
|
||||
> reporte y error) y nuevo `LocalCard.spec.jsx` (5 tests: descripción encima
|
||||
> por orden DOM, barra de 4, Marcar aria-pressed + persistencia, reporte
|
||||
> controlado, Comentar expande y enfoca).
|
||||
|
||||
> Decisiones de entrevista (2026-10-11): Marcar = favorito solo en la barra,
|
||||
> 2 reseñas visibles plegada, "Comentar" expande + enfoca el formulario, barra
|
||||
> de 4 (Comentar · Reportar · Marcar · Compartir), fecha pequeñita encima y
|
||||
> banner "Sigue aquí" cuando toque. Sin cambios de backend.
|
||||
|
||||
## 1. ResenasLocal (vista previa + animación + comentar)
|
||||
|
||||
- [x] 1.1 Cargar las reseñas al montar (`useEffect`) en vez de al expandir; refrescar al expandir y tras cada escritura
|
||||
- [x] 1.2 Vista previa: mostrar las 2 reseñas más recientes sin expandir; cabecera "★ media · Reseñas (N)" + chevron `aria-expanded`; pista "Ver las N reseñas ▾" cuando haya más de 2
|
||||
- [x] 1.3 Zona animada `grid-template-rows: 0fr → 1fr` (350 ms, hijo `overflow: hidden`) que contiene el resto de reseñas y el formulario
|
||||
- [x] 1.4 `comentar()` imperativo (`forwardRef` + `useImperativeHandle`): expande, scroll suave hasta el formulario (`scrollIntoView` opcional-safe) y foco en la primera estrella tras la transición
|
||||
|
||||
## 2. ReportarLocal controlado
|
||||
|
||||
- [x] 2.1 Props `{ localId, onCerrar, inicialAbierto }`: montar ya abierto desde la barra; "Cancelar" desmonta vía `onCerrar` (mantener el flujo motivo/comentario/enviado intacto)
|
||||
|
||||
## 3. LocalCard (reestructura + barra de acciones)
|
||||
|
||||
- [x] 3.1 Cabecera limpia: fuera corazón y compartir; queda nombre + provincia (CategoriaBadge, dirección y enlaces sin cambios)
|
||||
- [x] 3.2 Descripción del local en bloque propio ENCIMA de la sección de reseñas
|
||||
- [x] 3.3 Barra inferior a ancho completo con 4 botones (icono + etiqueta): Comentar (→ `resenasRef.comentar()`), Reportar (monta el formulario encima de la barra), Marcar (`aria-pressed`, corazón relleno en activo) y Compartir (flujo existente)
|
||||
- [x] 3.4 Fecha "Publicado …" en pequeñito justo encima de la barra; banner "Sigue aquí" y mensaje de confirmado encima de la barra cuando corresponda
|
||||
|
||||
## 4. Tests
|
||||
|
||||
- [x] 4.1 Rework de `tests/component/ResenasLocal.spec.jsx`: carga al montar sin expandir, vista previa de 2 (y pista "Ver las N"), expansión muestra todas + formulario, `comentar()` via ref expande y enfoca, propia precargada (Actualizar/Borrar), reporte de ajena, error de servidor
|
||||
- [x] 4.2 Nuevo `tests/component/LocalCard.spec.jsx`: descripción encima de la sección de reseñas, barra con los 4 botones, "Marcar" alterna `aria-pressed`, "Reportar" abre el formulario controlado
|
||||
- [x] 4.3 Suite completa en verde: `./node_modules/.bin/vitest run`
|
||||
|
||||
## 5. Cierre
|
||||
|
||||
- [x] 5.1 Commit + push y verificación del despliegue en prototipo-yb01.localesp.es
|
||||
|
||||
## 6. Iteración 2 (feedback de usuario: cierre + grid)
|
||||
|
||||
- [x] 6.1 Cierre por tres vías: "Comentar" pasa a alternar (toggle), botón "Cerrar" en el formulario, chevron de la cabecera (diagnóstico: la lógica ya alternaba; era un problema de afordancia)
|
||||
- [x] 6.2 Vista previa de 3 reseñas en grid que ocupa toda la anchura (`repeat(auto-fit, minmax(120px, 1fr))`), con comentario acotado a 3 líneas y fecha corta
|
||||
- [x] 6.3 Al expandir, el resto de reseñas aparece en el mismo grid
|
||||
- [x] 6.4 Formulario plano (sin caja: solo `border-top`) para eliminar las cajas anidadas
|
||||
- [x] 6.5 Acciones por tarjeta de reseña: "Borrar" en las propias y "Reportar" en las ajenas; fuera el "Borrar mi reseña" del formulario
|
||||
- [x] 6.6 Tests actualizados (toggle de cierre por cabecera/Comentar/Cerrar, grid de 3, borrar/reportar por tarjeta) y suite en verde
|
||||
- [x] 6.7 Ajuste fino a petición del usuario: un poco más de padding en las tarjetas de reseña (8px/8px/6px → 10px/10px/8px), desplegado y verificado (bundle index-CeuX36oZ.js)
|
||||
@@ -0,0 +1,111 @@
|
||||
# Reseñas por local
|
||||
|
||||
## Purpose
|
||||
|
||||
Reseñas anónimas múltiples por local (issue #6): una por dispositivo, editables y borrables por su autor; la puntuación del local pasa a ser la media de sus reseñas. Publicación directa con filtro de palabras, reportes y moderación admin; identidad anónima con huella corta por local (estilo 4chan, sin datos personales) y rate-limit por IP como defensa anti-boicot base.
|
||||
|
||||
## 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 "★ media · Reseñas (N)" que carga sus reseñas al montar la tarjeta y muestra las 3 primeras en una fila de tarjetas que ocupa toda la anchura de la tarjeta; al expandirla, una animación amplía la tarjeta revelando el resto de reseñas en el mismo grid y el formulario inline plano (estrellas interactivas 1–5 y comentario opcional de 500 caracteres). Cada tarjeta de reseña SHALL incluir un botón "Borrar" cuando sea propia del dispositivo y un botón "Reportar" cuando sea ajena. La sección SHALL poder cerrarse desde la cabecera, desde el botón "Comentar" de la barra inferior (que alterna) y desde un botón "Cerrar" del formulario.
|
||||
|
||||
#### Scenario: Vista previa sin expandir
|
||||
- **WHEN** se muestra la tarjeta de un local con reseñas
|
||||
- **THEN** la sección presenta la media, el total y las 3 reseñas más recientes en fila ocupando toda la anchura, sin interacción
|
||||
|
||||
#### Scenario: Expansión animada
|
||||
- **WHEN** el usuario expande la sección de reseñas
|
||||
- **THEN** la tarjeta se amplía con una animación que revela el resto de reseñas en el mismo grid y el formulario
|
||||
|
||||
#### Scenario: Cierre accesible
|
||||
- **WHEN** la sección está expandida
|
||||
- **THEN** puede cerrarse desde la cabecera, pulsando de nuevo "Comentar" o con el botón "Cerrar" del formulario
|
||||
|
||||
#### 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 y borrable desde su tarjeta
|
||||
- **WHEN** el dispositivo ya tiene reseña en ese local
|
||||
- **THEN** el formulario aparece precargado al expandir (Actualizar) y su tarjeta de reseña incluye un botón "Borrar"
|
||||
|
||||
#### Scenario: Reportar una reseña ajena
|
||||
- **WHEN** el usuario pulsa "Reportar" en una tarjeta de reseña ajena
|
||||
- **THEN** se envía el reporte de esa reseña y la tarjeta lo refleja
|
||||
@@ -0,0 +1,37 @@
|
||||
# Tarjeta de local
|
||||
|
||||
## Purpose
|
||||
|
||||
Estructura y acciones de la tarjeta de local en la web pública: orden de bloques (cabecera, categoría, dirección, enlaces, descripción ENCIMA de las reseñas, fecha y barra de acciones) y la barra inferior de acciones (Comentar · Reportar · Marcar · Compartir).
|
||||
|
||||
## Requirements
|
||||
|
||||
### Requirement: Estructura de la tarjeta de local
|
||||
La tarjeta de cada local SHALL presentar sus bloques en este orden: nombre y provincia en la cabecera, categoría, dirección, enlaces de navegación, descripción del local (si existe), sección de reseñas, aviso de confirmación (cuando corresponda), fecha de publicación y, como pie, la barra inferior de acciones.
|
||||
|
||||
#### Scenario: La descripción va encima de las reseñas
|
||||
- **WHEN** un local tiene descripción y reseñas
|
||||
- **THEN** la descripción se muestra como bloque propio, inmediatamente encima de la sección de reseñas y sin mezclarse con ella
|
||||
|
||||
#### Scenario: Local sin descripción
|
||||
- **WHEN** un local no tiene descripción
|
||||
- **THEN** la tarjeta pasa de los enlaces de navegación directamente a la sección de reseñas
|
||||
|
||||
### Requirement: Barra inferior de acciones
|
||||
El pie de la tarjeta SHALL estar ocupado por una barra de botones a ancho completo con, de momento, cuatro acciones: Comentar, Reportar, Marcar y Compartir. La fecha de publicación SHALL quedar como texto secundario justo encima de la barra, y el aviso de confirmación ("Sigue aquí") SHALL mostrarse como banner encima de la barra cuando corresponda.
|
||||
|
||||
#### Scenario: Comentar
|
||||
- **WHEN** el usuario pulsa "Comentar"
|
||||
- **THEN** la sección de reseñas se expande si estaba plegada (con desplazamiento suave hasta el formulario y foco en la valoración) y se cierra si estaba expandida
|
||||
|
||||
#### Scenario: Reportar
|
||||
- **WHEN** el usuario pulsa "Reportar"
|
||||
- **THEN** se abre el formulario de reporte del local encima de la barra, sin salir de la tarjeta
|
||||
|
||||
#### Scenario: Marcar
|
||||
- **WHEN** el usuario pulsa "Marcar" en un local no marcado
|
||||
- **THEN** el local pasa a ser favorito y el botón refleja el estado activo (y viceversa al pulsar de nuevo)
|
||||
|
||||
#### Scenario: Compartir
|
||||
- **WHEN** el usuario pulsa "Compartir"
|
||||
- **THEN** se abre el flujo de compartir del local (nativo del dispositivo o WhatsApp con enlace copiado)
|
||||
@@ -1,4 +1,4 @@
|
||||
import { useState } from "react";
|
||||
import { useRef, useState } from "react";
|
||||
import CategoriaBadge from "./CategoriaBadge.jsx";
|
||||
import ResenasLocal from "./ResenasLocal.jsx";
|
||||
import ReportarLocal from "./ReportarLocal.jsx";
|
||||
@@ -24,12 +24,26 @@ function mesesDesde(fecha) {
|
||||
return (Date.now() - date.getTime()) / (1000 * 60 * 60 * 24 * 30);
|
||||
}
|
||||
|
||||
const botonBarra = (activo) => ({
|
||||
flex: 1, display: "flex", flexDirection: "column", alignItems: "center", gap: 2,
|
||||
background: "none", border: "none", padding: "6px 2px 2px", cursor: "pointer",
|
||||
fontSize: 11, fontWeight: 500, lineHeight: 1.2,
|
||||
color: activo ? "#8B0000" : "var(--color-text-secondary)",
|
||||
});
|
||||
|
||||
// Tarjeta de local (rediseño de usabilidad): cabecera limpia (nombre y
|
||||
// provincia), categoría, dirección y enlaces; la DESCRIPCIÓN del local en
|
||||
// bloque propio ENCIMA de la sección de reseñas (vista previa de 2 + detalle
|
||||
// en `ResenasLocal`); fecha en pequeñito y, como pie, la barra inferior de
|
||||
// acciones a ancho completo: Comentar · Reportar · Marcar · Compartir.
|
||||
export default function LocalCard({ local, distanciaKm }) {
|
||||
const { esFavorito, alternarFavorito } = useFavoritos();
|
||||
const { toast, mostrarToast } = useToast();
|
||||
const [confirmando, setConfirmando] = useState(false);
|
||||
const [confirmado, setConfirmado] = useState(false);
|
||||
const [fechaConfirmacion, setFechaConfirmacion] = useState(local.fechaConfirmacion || local.fecha);
|
||||
const [reportando, setReportando] = useState(false);
|
||||
const resenasRef = useRef(null);
|
||||
|
||||
const gmUrl = local.enlaceGoogleMaps || enlaceGoogleMapsDesdeLocal(local);
|
||||
const wazeUrl = enlaceWazeDesdeLocal(local);
|
||||
@@ -78,25 +92,13 @@ export default function LocalCard({ local, distanciaKm }) {
|
||||
onMouseEnter={(e) => { e.currentTarget.style.borderColor = "var(--color-border-secondary)"; }}
|
||||
onMouseLeave={(e) => { e.currentTarget.style.borderColor = "var(--color-border-tertiary)"; }}
|
||||
>
|
||||
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "flex-start", gap: 8 }}>
|
||||
<div style={{ flex: 1, minWidth: 0 }}>
|
||||
<p style={{ fontWeight: 500, fontSize: 16, margin: 0 }}>{local.nombre}</p>
|
||||
<p style={{ fontSize: 13, color: "var(--color-text-secondary)", margin: "2px 0 0" }}>
|
||||
{local.provincia}
|
||||
{distanciaKm != null && <span style={{ color: "var(--color-text-tertiary)" }}> · {formatearDistancia(distanciaKm)}</span>}
|
||||
</p>
|
||||
</div>
|
||||
<div style={{ display: "flex", gap: 4, flexShrink: 0 }}>
|
||||
<button type="button" onClick={compartir} title="Compartir"
|
||||
style={{ background: "none", border: "none", cursor: "pointer", fontSize: 16, color: "var(--color-text-tertiary)", padding: 4 }}>
|
||||
<i className="ti ti-share-2" aria-hidden="true"></i>
|
||||
</button>
|
||||
<button type="button" onClick={handleAlternarFavorito} title={favorito ? "Quitar de favoritos" : "Guardar en favoritos"}
|
||||
aria-pressed={favorito}
|
||||
style={{ background: "none", border: "none", cursor: "pointer", fontSize: 16, color: favorito ? "#8B0000" : "var(--color-text-tertiary)", padding: 4 }}>
|
||||
<i className={favorito ? "ti ti-heart-filled" : "ti ti-heart"} aria-hidden="true"></i>
|
||||
</button>
|
||||
</div>
|
||||
{/* Cabecera: solo nombre y provincia (las acciones viven en la barra inferior) */}
|
||||
<div>
|
||||
<p style={{ fontWeight: 500, fontSize: 16, margin: 0 }}>{local.nombre}</p>
|
||||
<p style={{ fontSize: 13, color: "var(--color-text-secondary)", margin: "2px 0 0" }}>
|
||||
{local.provincia}
|
||||
{distanciaKm != null && <span style={{ color: "var(--color-text-tertiary)" }}> · {formatearDistancia(distanciaKm)}</span>}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<CategoriaBadge categoria={local.categoria} subcategoria={local.subcategoria} />
|
||||
@@ -134,19 +136,19 @@ export default function LocalCard({ local, distanciaKm }) {
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Media de reseñas + sección desplegable "Reseñas (N)" (issue #6).
|
||||
totalResenas lo aporta GET /api/locales; tras escribir, la cabecera
|
||||
se actualiza en local y el listado general llega por el polling. */}
|
||||
{/* Descripción del local: bloque propio, ENCIMA de las reseñas */}
|
||||
{local.descripcion && (
|
||||
<p style={{ fontSize: 13, color: "var(--color-text-secondary)", margin: 0, fontStyle: "italic" }}>"{local.descripcion}"</p>
|
||||
)}
|
||||
|
||||
{/* Reseñas: vista previa de 2 + expansión animada (media y total aquí) */}
|
||||
<ResenasLocal
|
||||
ref={resenasRef}
|
||||
localId={local.id}
|
||||
totalInicial={local.totalResenas || 0}
|
||||
mediaInicial={local.puntuacion || 0}
|
||||
/>
|
||||
|
||||
{local.descripcion && (
|
||||
<p style={{ fontSize: 13, color: "var(--color-text-secondary)", margin: 0, fontStyle: "italic" }}>"{local.descripcion}"</p>
|
||||
)}
|
||||
|
||||
{sinConfirmarReciente && !confirmado && (
|
||||
<div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 8, flexWrap: "wrap", background: "#FDF2E9", border: "1px solid #F5CBA7", borderRadius: "var(--border-radius-md)", padding: "6px 10px" }}>
|
||||
<span style={{ fontSize: 12, color: "#784212", display: "flex", alignItems: "center", gap: 5 }}>
|
||||
@@ -162,11 +164,30 @@ export default function LocalCard({ local, distanciaKm }) {
|
||||
<p style={{ fontSize: 12, color: "#1E8449", margin: 0 }}>✅ Gracias por confirmar que sigue activo.</p>
|
||||
)}
|
||||
|
||||
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", gap: 8, flexWrap: "wrap" }}>
|
||||
{fechaFormateada && (
|
||||
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: 0 }}>Publicado {fechaFormateada}</p>
|
||||
)}
|
||||
<ReportarLocal localId={local.id} />
|
||||
{/* Formulario de reporte (se abre desde la barra inferior) */}
|
||||
{reportando && (
|
||||
<ReportarLocal localId={local.id} inicialAbierto onCerrar={() => setReportando(false)} />
|
||||
)}
|
||||
|
||||
{/* Fecha, en pequeñito, justo encima de la barra */}
|
||||
{fechaFormateada && (
|
||||
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: 0 }}>Publicado {fechaFormateada}</p>
|
||||
)}
|
||||
|
||||
{/* Barra inferior de acciones: cubre todo el pie de la tarjeta */}
|
||||
<div style={{ display: "flex", gap: 2, marginTop: 2, paddingTop: 6, borderTop: "0.5px solid var(--color-border-tertiary)", flexWrap: "wrap" }}>
|
||||
<button type="button" onClick={() => resenasRef.current?.comentar()} style={botonBarra(false)}>
|
||||
<i className="ti ti-message-dots" aria-hidden="true" style={{ fontSize: 18 }}></i> Comentar
|
||||
</button>
|
||||
<button type="button" onClick={() => setReportando(true)} style={botonBarra(false)}>
|
||||
<i className="ti ti-flag" aria-hidden="true" style={{ fontSize: 18 }}></i> Reportar
|
||||
</button>
|
||||
<button type="button" onClick={handleAlternarFavorito} aria-pressed={favorito} style={botonBarra(favorito)}>
|
||||
<i className={`ti ${favorito ? "ti-heart-filled" : "ti-heart"}`} aria-hidden="true" style={{ fontSize: 18 }}></i> {favorito ? "Marcado" : "Marcar"}
|
||||
</button>
|
||||
<button type="button" onClick={compartir} style={botonBarra(false)}>
|
||||
<i className="ti ti-share-2" aria-hidden="true" style={{ fontSize: 18 }}></i> Compartir
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<Toast toast={toast} />
|
||||
|
||||
@@ -8,8 +8,12 @@ const MOTIVOS = [
|
||||
{ id: "otro", label: "Otro motivo" },
|
||||
];
|
||||
|
||||
export default function ReportarLocal({ localId }) {
|
||||
const [abierto, setAbierto] = useState(false);
|
||||
// Formulario de reporte de un local (cerrado / datos incorrectos /
|
||||
// inapropiado / otro). Controlado desde fuera: la barra de acciones de la
|
||||
// tarjeta lo monta con `inicialAbierto` (al pulsar "Reportar") y lo cierra
|
||||
// vía `onCerrar`. Si se monta sin `inicialAbierto`, se comporta como antes.
|
||||
export default function ReportarLocal({ localId, onCerrar, inicialAbierto = false }) {
|
||||
const [abierto, setAbierto] = useState(inicialAbierto);
|
||||
const [motivo, setMotivo] = useState("cerrado");
|
||||
const [comentario, setComentario] = useState("");
|
||||
const [enviando, setEnviando] = useState(false);
|
||||
@@ -20,12 +24,7 @@ export default function ReportarLocal({ localId }) {
|
||||
}
|
||||
|
||||
if (!abierto) {
|
||||
return (
|
||||
<button type="button" onClick={() => setAbierto(true)}
|
||||
style={{ display: "inline-flex", alignItems: "center", gap: 4, background: "none", border: "none", padding: 0, fontSize: 12, color: "var(--color-text-tertiary)", cursor: "pointer", width: "fit-content" }}>
|
||||
<i className="ti ti-flag" aria-hidden="true"></i> Reportar
|
||||
</button>
|
||||
);
|
||||
return null;
|
||||
}
|
||||
|
||||
const enviar = async () => {
|
||||
@@ -53,7 +52,7 @@ export default function ReportarLocal({ localId }) {
|
||||
style={{ fontSize: 12, background: "#8B0000", color: "white", border: "none", borderRadius: "var(--border-radius-md)", padding: "5px 12px", cursor: "pointer" }}>
|
||||
{enviando ? "Enviando..." : "Enviar aviso"}
|
||||
</button>
|
||||
<button type="button" onClick={() => setAbierto(false)}
|
||||
<button type="button" onClick={() => (onCerrar ? onCerrar() : setAbierto(false))}
|
||||
style={{ fontSize: 12, background: "none", border: "none", color: "var(--color-text-tertiary)", cursor: "pointer" }}>
|
||||
Cancelar
|
||||
</button>
|
||||
|
||||
+203
-108
@@ -1,22 +1,86 @@
|
||||
import { useState } from "react";
|
||||
import { forwardRef, useEffect, useImperativeHandle, useRef, useState } from "react";
|
||||
import StarRating from "./StarRating.jsx";
|
||||
import { borrarResena, enviarResena, listarResenas, reportarLocal } from "../firebase.js";
|
||||
import { obtenerDeviceId } from "../utils/dispositivo.js";
|
||||
|
||||
const MAX_COMENTARIO = 500;
|
||||
// Reseñas visibles sin expandir (en fila, ocupando el ancho) y duración de
|
||||
// la animación de revelado (ms), sincronizada con la transición CSS.
|
||||
const VISTA_PREVIA = 3;
|
||||
const DURACION_TRANSICION = 350;
|
||||
|
||||
function formatearFecha(fecha) {
|
||||
const gridResenas = {
|
||||
display: "grid",
|
||||
gridTemplateColumns: "repeat(auto-fit, minmax(120px, 1fr))",
|
||||
gap: 6,
|
||||
};
|
||||
|
||||
function formatearFechaCorta(fecha) {
|
||||
const d = new Date(fecha);
|
||||
return Number.isNaN(d.getTime()) ? "" : d.toLocaleDateString("es-ES", { day: "numeric", month: "short", year: "numeric" });
|
||||
return Number.isNaN(d.getTime()) ? "" : d.toLocaleDateString("es-ES", { day: "numeric", month: "short" });
|
||||
}
|
||||
|
||||
// Sección desplegable de reseñas anónimas (issue #6): cabecera plegable
|
||||
// "Reseñas (N) · ★media" sobre la propia tarjeta, con carga perezosa de la
|
||||
// lista al expandir y formulario inline. Una reseña por dispositivo (el
|
||||
// servidor hace upsert): la propia se precarga y permite actualizar o
|
||||
// borrar; las ajenas se pueden reportar. Identidad anónima con huella corta
|
||||
// por local ("Anónimo #a3f"), sin datos personales.
|
||||
export default function ResenasLocal({ localId, totalInicial = 0, mediaInicial = 0 }) {
|
||||
const accionTarjeta = {
|
||||
background: "none",
|
||||
border: "0.5px solid var(--color-border-secondary)",
|
||||
borderRadius: "var(--border-radius-md)",
|
||||
padding: "2px 6px",
|
||||
fontSize: 10,
|
||||
cursor: "pointer",
|
||||
color: "var(--color-text-secondary)",
|
||||
};
|
||||
|
||||
// Tarjeta de reseña (celda del grid): estrellas, comentario acotado a 3
|
||||
// líneas, autor anónimo con huella + fecha corta y acciones por tarjeta —
|
||||
// "Borrar" solo en las propias, "Reportar" solo en las ajenas.
|
||||
function Reseña({ r, reportada, onReportar, onBorrar }) {
|
||||
const autor = `Anónimo ${r.huella} · ${formatearFechaCorta(r.fecha)}${r.fechaEdicion ? " · ed." : ""}`;
|
||||
return (
|
||||
<div style={{
|
||||
background: "var(--color-background-secondary)",
|
||||
borderRadius: "var(--border-radius-md)",
|
||||
padding: "12px 12px 8px",
|
||||
display: "flex", flexDirection: "column", gap: 10, minWidth: 0,
|
||||
border: r.esPropia ? "0.5px solid var(--color-border-secondary)" : "none",
|
||||
}}>
|
||||
<StarRating value={r.puntuacion} readOnly size={12} />
|
||||
{r.comentario && (
|
||||
<p
|
||||
title={r.comentario}
|
||||
style={{
|
||||
margin: 10, fontSize: 12, color: "var(--color-text-secondary)",
|
||||
display: "-webkit-box", WebkitLineClamp: 3, WebkitBoxOrient: "vertical", overflow: "hidden",
|
||||
}}
|
||||
>
|
||||
{r.comentario}
|
||||
</p>
|
||||
)}
|
||||
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", gap: 4, marginTop: "auto", flexWrap: "wrap" }}>
|
||||
<span title={autor} style={{ fontSize: 10, color: "var(--color-text-tertiary)", whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis", minWidth: 0 }}>
|
||||
{r.esPropia ? "Tú" : `Anónimo ${r.huella}`}
|
||||
</span>
|
||||
<span style={{ display: "flex", gap: 4, flexShrink: 0 }}>
|
||||
{r.esPropia ? (
|
||||
<button type="button" onClick={() => onBorrar(r)} style={{ ...accionTarjeta, color: "#922B21" }}>Borrar</button>
|
||||
) : reportada === r.id ? (
|
||||
<span style={{ fontSize: 10, color: "#1E8449" }}>✅</span>
|
||||
) : (
|
||||
<button type="button" onClick={() => onReportar(r)} style={accionTarjeta}>Reportar</button>
|
||||
)}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
// Sección de reseñas de la tarjeta del local (issue #6 + rediseño de
|
||||
// usabilidad, iteración 2): carga al montar y muestra VISTA_PREVIA reseñas
|
||||
// en fila ocupando el ancho; la cabecera "★ media · Reseñas (N)" alterna con
|
||||
// una animación (grid-template-rows 0fr→1fr) que revela el resto en el mismo
|
||||
// grid y el formulario inline PLANO (sin caja propia). Cierre por tres vías:
|
||||
// cabecera, "Comentar" (toggle, desde la barra de la tarjeta) y "Cerrar" en
|
||||
// el formulario. Identidad anónima con huella corta por local.
|
||||
const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial = 0, mediaInicial = 0 }, ref) {
|
||||
const [abierto, setAbierto] = useState(false);
|
||||
const [resenas, setResenas] = useState(null); // null = aún sin cargar
|
||||
const [cargando, setCargando] = useState(false);
|
||||
@@ -28,6 +92,7 @@ export default function ResenasLocal({ localId, totalInicial = 0, mediaInicial =
|
||||
const [enviando, setEnviando] = useState(false);
|
||||
const [error, setError] = useState("");
|
||||
const [reportada, setReportada] = useState(null);
|
||||
const formRef = useRef(null);
|
||||
|
||||
const cargar = async () => {
|
||||
setCargando(true);
|
||||
@@ -47,10 +112,34 @@ export default function ResenasLocal({ localId, totalInicial = 0, mediaInicial =
|
||||
setCargando(false);
|
||||
};
|
||||
|
||||
// La vista previa debe existir sin interacción: carga al montar la tarjeta.
|
||||
// Se refresca al expandir y tras cada escritura.
|
||||
useEffect(() => { cargar(); /* eslint-disable-line react-hooks/exhaustive-deps */ }, []);
|
||||
|
||||
const expandir = (conFoco = false) => {
|
||||
setAbierto(true);
|
||||
if (conFoco) {
|
||||
// Espera al fin de la transición para no pelearse con la animación.
|
||||
setTimeout(() => {
|
||||
formRef.current?.scrollIntoView?.({ behavior: "smooth", block: "nearest" });
|
||||
formRef.current?.querySelector("button")?.focus();
|
||||
}, DURACION_TRANSICION + 30);
|
||||
}
|
||||
};
|
||||
|
||||
// API imperativa para la barra de acciones de la tarjeta: ALTERNA (abre con
|
||||
// foco / cierra). El cierre también está en la cabecera y en "Cerrar".
|
||||
useImperativeHandle(ref, () => ({
|
||||
comentar: () => (abierto ? setAbierto(false) : expandir(true)),
|
||||
}));
|
||||
|
||||
const alternar = () => {
|
||||
const nuevo = !abierto;
|
||||
setAbierto(nuevo);
|
||||
if (nuevo && resenas === null && !cargando) cargar();
|
||||
if (abierto) {
|
||||
setAbierto(false);
|
||||
} else {
|
||||
expandir(false);
|
||||
if (resenas === null && !cargando) cargar();
|
||||
}
|
||||
};
|
||||
|
||||
const enviar = async () => {
|
||||
@@ -72,7 +161,8 @@ export default function ResenasLocal({ localId, totalInicial = 0, mediaInicial =
|
||||
setEnviando(false);
|
||||
};
|
||||
|
||||
const borrar = async () => {
|
||||
// Borrado desde la propia tarjeta de reseña (solo propias).
|
||||
const borrarPropia = async () => {
|
||||
setEnviando(true);
|
||||
setError("");
|
||||
try {
|
||||
@@ -97,6 +187,12 @@ export default function ResenasLocal({ localId, totalInicial = 0, mediaInicial =
|
||||
}
|
||||
};
|
||||
|
||||
const lista = resenas || [];
|
||||
// La vista previa son siempre las primeras VISTA_PREVIA; el resto vive
|
||||
// dentro de la zona animada (se revela al expandir, sin duplicar render).
|
||||
const visibles = lista.slice(0, VISTA_PREVIA);
|
||||
const resto = lista.slice(VISTA_PREVIA);
|
||||
|
||||
return (
|
||||
<div style={{ display: "flex", flexDirection: "column", gap: 8 }}>
|
||||
{/* Cabecera plegable: media + número de reseñas */}
|
||||
@@ -116,120 +212,119 @@ export default function ResenasLocal({ localId, totalInicial = 0, mediaInicial =
|
||||
<i
|
||||
className={`ti ${abierto ? "ti-chevron-up" : "ti-chevron-down"}`}
|
||||
aria-hidden="true"
|
||||
style={{ fontSize: 13, marginLeft: 4, color: "var(--color-text-tertiary)" }}
|
||||
style={{ fontSize: 14, marginLeft: 4, color: "var(--color-text-tertiary)" }}
|
||||
/>
|
||||
</span>
|
||||
</button>
|
||||
|
||||
{abierto && (
|
||||
<div style={{ display: "flex", flexDirection: "column", gap: 10 }}>
|
||||
{cargando && resenas === null && (
|
||||
<p style={{ fontSize: 12, color: "var(--color-text-tertiary)", margin: 0 }}>Cargando reseñas…</p>
|
||||
)}
|
||||
{/* Vista previa: siempre a la vista, en fila ocupando el ancho */}
|
||||
{cargando && resenas === null && (
|
||||
<p style={{ fontSize: 12, color: "var(--color-text-tertiary)", margin: 0 }}>Cargando reseñas…</p>
|
||||
)}
|
||||
{resenas !== null && lista.length === 0 && (
|
||||
<p style={{ fontSize: 12, color: "var(--color-text-tertiary)", margin: 0 }}>
|
||||
Aún no hay reseñas. ¡Sé el primero!
|
||||
</p>
|
||||
)}
|
||||
<div style={gridResenas} aria-label="Vista previa de reseñas">
|
||||
{visibles.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} onBorrar={borrarPropia} />)}
|
||||
</div>
|
||||
|
||||
{/* Lista de reseñas */}
|
||||
{resenas !== null && resenas.length === 0 && (
|
||||
<p style={{ fontSize: 12, color: "var(--color-text-tertiary)", margin: 0 }}>
|
||||
Aún no hay reseñas. ¡Sé el primero!
|
||||
</p>
|
||||
)}
|
||||
{resenas !== null && resenas.map((r) => (
|
||||
<div key={r.id} style={{
|
||||
background: "var(--color-background-secondary)",
|
||||
borderRadius: "var(--border-radius-md)",
|
||||
padding: "8px 10px",
|
||||
border: r.esPropia ? "0.5px solid var(--color-border-secondary)" : "none",
|
||||
}}>
|
||||
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", gap: 6 }}>
|
||||
<span style={{ fontSize: 12, color: "var(--color-text-secondary)" }}>
|
||||
Anónimo {r.huella} · {formatearFecha(r.fecha)}
|
||||
{r.fechaEdicion && <span style={{ color: "var(--color-text-tertiary)" }}> · editada</span>}
|
||||
</span>
|
||||
<span style={{ display: "flex", alignItems: "center", gap: 6 }}>
|
||||
{r.esPropia
|
||||
? <span style={{ fontSize: 11, color: "#8B0000", fontWeight: 500 }}>tu reseña</span>
|
||||
: reportada === r.id
|
||||
? <span style={{ fontSize: 11, color: "#1E8449" }}>✅ reportada</span>
|
||||
: (
|
||||
<button type="button" onClick={() => reportar(r)} title="Reportar esta reseña"
|
||||
style={{ background: "none", border: "none", padding: 0, cursor: "pointer", fontSize: 12, color: "var(--color-text-tertiary)" }}>
|
||||
<i className="ti ti-flag" aria-hidden="true"></i>
|
||||
</button>
|
||||
)}
|
||||
</span>
|
||||
</div>
|
||||
<div style={{ marginTop: 2 }}>
|
||||
<StarRating value={r.puntuacion} readOnly size={13} />
|
||||
</div>
|
||||
{r.comentario && (
|
||||
<p style={{ margin: "4px 0 0", fontSize: 13, color: "var(--color-text-secondary)" }}>{r.comentario}</p>
|
||||
)}
|
||||
</div>
|
||||
))}
|
||||
{/* Pista de expansión cuando hay más reseñas que la vista previa */}
|
||||
{!abierto && total > VISTA_PREVIA && (
|
||||
<button
|
||||
type="button"
|
||||
onClick={() => expandir(false)}
|
||||
style={{
|
||||
background: "none", border: "none", padding: 0, width: "fit-content",
|
||||
fontSize: 12, color: "#8B0000", cursor: "pointer", fontWeight: 500,
|
||||
}}
|
||||
>
|
||||
Ver las {total} reseñas <i className="ti ti-chevron-down" aria-hidden="true"></i>
|
||||
</button>
|
||||
)}
|
||||
|
||||
{/* Formulario inline: crear o actualizar la reseña propia */}
|
||||
<div style={{
|
||||
background: "var(--color-background-primary)",
|
||||
border: "0.5px solid var(--color-border-tertiary)",
|
||||
borderRadius: "var(--border-radius-md)",
|
||||
padding: "8px 10px",
|
||||
display: "flex", flexDirection: "column", gap: 6,
|
||||
}}>
|
||||
<p style={{ margin: 0, fontSize: 12, fontWeight: 500 }}>
|
||||
{tienePropia ? "Tu reseña (anónima)" : "Deja tu reseña (anónima)"}
|
||||
</p>
|
||||
<StarRating value={puntuacion} onChange={setPuntuacion} size={20} />
|
||||
<textarea
|
||||
value={comentario}
|
||||
onChange={(e) => setComentario(e.target.value)}
|
||||
maxLength={MAX_COMENTARIO}
|
||||
rows={2}
|
||||
placeholder="Comentario opcional (máx. 500 caracteres)…"
|
||||
aria-label="Comentario de la reseña"
|
||||
style={{
|
||||
fontSize: 12, padding: "5px 8px", borderRadius: "var(--border-radius-md)",
|
||||
border: "0.5px solid var(--color-border-secondary)",
|
||||
background: "var(--color-background-primary)", color: "var(--color-text-primary)",
|
||||
resize: "vertical", fontFamily: "inherit",
|
||||
}}
|
||||
/>
|
||||
{error && (
|
||||
<p role="alert" style={{ margin: 0, fontSize: 12, color: "#922B21" }}>
|
||||
<i className="ti ti-alert-triangle" aria-hidden="true"></i> {error}
|
||||
</p>
|
||||
{/* Zona animada: resto de reseñas (mismo grid) + formulario plano. La
|
||||
altura anima de 0fr a 1fr; el contenido permanece montado para que
|
||||
la transición sea fluida y se oculta del árbol accesible plegado. */}
|
||||
<div
|
||||
aria-hidden={!abierto}
|
||||
style={{
|
||||
display: "grid",
|
||||
gridTemplateRows: abierto ? "1fr" : "0fr",
|
||||
transition: `grid-template-rows ${DURACION_TRANSICION}ms ease`,
|
||||
}}
|
||||
>
|
||||
<div style={{ overflow: "hidden" }}>
|
||||
<div style={{ display: "flex", flexDirection: "column", gap: 8, paddingTop: abierto ? 8 : 0 }}>
|
||||
{resto.length > 0 && (
|
||||
<div style={gridResenas}>
|
||||
{resto.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} onBorrar={borrarPropia} />)}
|
||||
</div>
|
||||
)}
|
||||
<div style={{ display: "flex", gap: 6, alignItems: "center" }}>
|
||||
<button
|
||||
type="button"
|
||||
onClick={enviar}
|
||||
disabled={puntuacion < 1 || enviando}
|
||||
|
||||
{/* Formulario inline PLANO (sin caja): solo un borde que lo separa */}
|
||||
<div ref={formRef} style={{ paddingTop: 8, borderTop: "0.5px solid var(--color-border-tertiary)", display: "flex", flexDirection: "column", gap: 8 }}>
|
||||
<p style={{ margin: 0, fontSize: 12, fontWeight: 500 }}>
|
||||
{tienePropia ? "Tu reseña (anónima) — edítala o bórrala desde su tarjeta" : "Deja tu reseña (anónima)"}
|
||||
</p>
|
||||
{/* Las estrellas usan lineHeight 0 (caja de línea de altura 0:
|
||||
el glifo desborda y se solapa con el título). El wrapper con
|
||||
lineHeight normal aporta el soporte de línea que falta. */}
|
||||
<div style={{ lineHeight: "26px" }}>
|
||||
<StarRating value={puntuacion} onChange={setPuntuacion} size={20} />
|
||||
</div>
|
||||
<textarea
|
||||
value={comentario}
|
||||
onChange={(e) => setComentario(e.target.value)}
|
||||
maxLength={MAX_COMENTARIO}
|
||||
rows={2}
|
||||
placeholder="Comentario opcional (máx. 500 caracteres)…"
|
||||
aria-label="Comentario de la reseña"
|
||||
style={{
|
||||
fontSize: 12, background: puntuacion >= 1 ? "#8B0000" : "var(--color-background-secondary)",
|
||||
color: puntuacion >= 1 ? "white" : "var(--color-text-tertiary)",
|
||||
border: "none", borderRadius: "var(--border-radius-md)", padding: "5px 12px",
|
||||
cursor: puntuacion >= 1 && !enviando ? "pointer" : "not-allowed", fontWeight: 500,
|
||||
fontSize: 12, padding: "5px 8px", borderRadius: "var(--border-radius-md)",
|
||||
border: "0.5px solid var(--color-border-secondary)",
|
||||
background: "var(--color-background-primary)", color: "var(--color-text-primary)",
|
||||
resize: "vertical", fontFamily: "inherit",
|
||||
}}
|
||||
>
|
||||
{enviando ? "Guardando…" : tienePropia ? "Actualizar" : "Publicar"}
|
||||
</button>
|
||||
{tienePropia && (
|
||||
/>
|
||||
{error && (
|
||||
<p role="alert" style={{ margin: 0, fontSize: 12, color: "#922B21" }}>
|
||||
<i className="ti ti-alert-triangle" aria-hidden="true"></i> {error}
|
||||
</p>
|
||||
)}
|
||||
<div style={{ display: "flex", gap: 6, alignItems: "center" }}>
|
||||
<button
|
||||
type="button"
|
||||
onClick={borrar}
|
||||
disabled={enviando}
|
||||
onClick={enviar}
|
||||
disabled={puntuacion < 1 || enviando}
|
||||
style={{
|
||||
fontSize: 12, background: puntuacion >= 1 ? "#8B0000" : "var(--color-background-secondary)",
|
||||
color: puntuacion >= 1 ? "white" : "var(--color-text-tertiary)",
|
||||
border: "none", borderRadius: "var(--border-radius-md)", padding: "5px 12px",
|
||||
cursor: puntuacion >= 1 && !enviando ? "pointer" : "not-allowed", fontWeight: 500,
|
||||
}}
|
||||
>
|
||||
{enviando ? "Guardando…" : tienePropia ? "Actualizar" : "Publicar"}
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
onClick={() => setAbierto(false)}
|
||||
style={{
|
||||
fontSize: 12, background: "none", border: "0.5px solid var(--color-border-secondary)",
|
||||
borderRadius: "var(--border-radius-md)", padding: "5px 12px", cursor: "pointer",
|
||||
color: "var(--color-text-secondary)",
|
||||
}}
|
||||
>
|
||||
Borrar mi reseña
|
||||
Cerrar
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
});
|
||||
|
||||
export default ResenasLocal;
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
// @vitest-environment jsdom
|
||||
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
|
||||
import { cleanup, fireEvent, render, screen, waitFor } from "@testing-library/react";
|
||||
|
||||
// Mock del cliente API: LocalCard importa confirmarLocal vía firebase.js y
|
||||
// ResenasLocal importa las funciones de reseñas por la misma vía.
|
||||
vi.mock("../../src/api.js", () => ({
|
||||
confirmarLocal: vi.fn(),
|
||||
listarResenas: vi.fn(async () => ({ resenas: [], total: 0 })),
|
||||
enviarResena: vi.fn(),
|
||||
borrarResena: vi.fn(),
|
||||
reportarLocal: vi.fn(),
|
||||
}));
|
||||
|
||||
import LocalCard from "../../src/components/LocalCard.jsx";
|
||||
|
||||
beforeEach(() => { vi.clearAllMocks(); localStorage.clear(); });
|
||||
afterEach(cleanup);
|
||||
|
||||
const LOCAL = {
|
||||
id: "loc-1", nombre: "Bar Prueba", provincia: "Madrid", categoria: "Restauración",
|
||||
subcategoria: "", direccion: "Calle Mayor 5", enlaceGoogleMaps: "",
|
||||
descripcion: "Panadería artesana de barrio", puntuacion: 4, totalResenas: 2,
|
||||
fecha: "2026-10-01T10:00:00.000Z",
|
||||
};
|
||||
|
||||
describe("LocalCard (rediseño de usabilidad)", () => {
|
||||
it("la descripción va en bloque propio ENCIMA de la sección de reseñas", () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
const descripcion = screen.getByText(/Panadería artesana/i);
|
||||
const cabeceraResenas = screen.getByRole("button", { name: /reseñas \(2\)/i });
|
||||
expect(
|
||||
descripcion.compareDocumentPosition(cabeceraResenas) & Node.DOCUMENT_POSITION_FOLLOWING,
|
||||
).toBeTruthy();
|
||||
});
|
||||
|
||||
it("la barra inferior cubre el pie con Comentar · Reportar · Marcar · Compartir", () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
for (const nombre of [/^comentar$/i, /^reportar$/i, /^marcar$/i, /^compartir$/i]) {
|
||||
expect(screen.getByRole("button", { name: nombre })).toBeTruthy();
|
||||
}
|
||||
// la fecha queda en pequeñito encima de la barra
|
||||
expect(screen.getByText(/^publicado /i)).toBeTruthy();
|
||||
});
|
||||
|
||||
it("Marcar alterna el favorito (aria-pressed + persistencia)", () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
const marcar = screen.getByRole("button", { name: /^marcar$/i });
|
||||
expect(marcar.getAttribute("aria-pressed")).toBe("false");
|
||||
|
||||
fireEvent.click(marcar);
|
||||
const marcado = screen.getByRole("button", { name: /marcado/i });
|
||||
expect(marcado.getAttribute("aria-pressed")).toBe("true");
|
||||
expect(JSON.parse(localStorage.getItem("localesp_favoritos"))).toContain("loc-1");
|
||||
|
||||
fireEvent.click(marcado);
|
||||
expect(screen.getByRole("button", { name: /^marcar$/i }).getAttribute("aria-pressed")).toBe("false");
|
||||
});
|
||||
|
||||
it("Reportar abre el formulario controlado encima de la barra; Cancelar lo cierra", () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
fireEvent.click(screen.getByRole("button", { name: /^reportar$/i }));
|
||||
expect(screen.getByText(/¿Qué está mal con este local\?/i)).toBeTruthy();
|
||||
|
||||
fireEvent.click(screen.getByRole("button", { name: /cancelar/i }));
|
||||
expect(screen.queryByText(/¿Qué está mal/i)).toBeNull();
|
||||
});
|
||||
|
||||
it("Comentar expande la sección de reseñas y enfoca el formulario", async () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
fireEvent.click(screen.getByRole("button", { name: /^comentar$/i }));
|
||||
|
||||
await waitFor(() => expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy(), { timeout: 3000 });
|
||||
await waitFor(
|
||||
() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/),
|
||||
{ timeout: 3000 },
|
||||
);
|
||||
|
||||
// Comentar ALTERNA: la segunda pulsación cierra la sección
|
||||
fireEvent.click(screen.getByRole("button", { name: /^comentar$/i }));
|
||||
await waitFor(() => expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull());
|
||||
});
|
||||
});
|
||||
@@ -1,6 +1,6 @@
|
||||
// @vitest-environment jsdom
|
||||
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
|
||||
import { cleanup, fireEvent, render, screen, waitFor } from "@testing-library/react";
|
||||
import { act, cleanup, fireEvent, render, screen, waitFor, within } from "@testing-library/react";
|
||||
|
||||
// Mock del cliente API (firebase.js re-exporta api.js: el mock intercepta la
|
||||
// resolución del módulo y cubre ambas vías).
|
||||
@@ -11,6 +11,7 @@ vi.mock("../../src/api.js", () => ({
|
||||
reportarLocal: vi.fn(),
|
||||
}));
|
||||
|
||||
import { createRef } from "react";
|
||||
import ResenasLocal from "../../src/components/ResenasLocal.jsx";
|
||||
import { borrarResena, enviarResena, listarResenas, reportarLocal } from "../../src/api.js";
|
||||
|
||||
@@ -20,45 +21,92 @@ beforeEach(() => {
|
||||
});
|
||||
afterEach(cleanup);
|
||||
|
||||
const RESENA_AJENA = {
|
||||
id: "res-1111", huella: "#a1b2c3", puntuacion: 4, comentario: "Genial",
|
||||
fecha: "2026-10-11T10:00:00.000Z", fechaEdicion: null, esPropia: false,
|
||||
};
|
||||
const RESENA_PROPIA = {
|
||||
id: "res-2222", huella: "#d4e5f6", puntuacion: 5, comentario: "Mi favorito",
|
||||
fecha: "2026-10-10T10:00:00.000Z", fechaEdicion: null, esPropia: true,
|
||||
};
|
||||
const ISO = "2026-10-11T10:00:00.000Z";
|
||||
const reseña = (id, huella, puntuacion, comentario, extra = {}) => ({
|
||||
id, huella, puntuacion, comentario, fecha: ISO, fechaEdicion: null, esPropia: false, ...extra,
|
||||
});
|
||||
const CUATRO = [
|
||||
reseña("r1", "#111111", 5, "Uno"),
|
||||
reseña("r2", "#222222", 4, "Dos"),
|
||||
reseña("r3", "#333333", 3, "Tres"),
|
||||
reseña("r4", "#444444", 2, "Cuatro"),
|
||||
];
|
||||
const PROPIA = reseña("r9", "#999999", 5, "Mi favorito", { esPropia: true });
|
||||
|
||||
const abrir = () => fireEvent.click(screen.getByRole("button", { name: /reseñas/i }));
|
||||
const cabecera = () => screen.getByRole("button", { name: /reseñas \(\d+\)/i });
|
||||
|
||||
describe("ResenasLocal (sección desplegable en la tarjeta)", () => {
|
||||
it("plegado muestra media y número, sin cargar nada; aria-expanded refleja el estado", () => {
|
||||
render(<ResenasLocal localId="loc-1" totalInicial={3} mediaInicial={4} />);
|
||||
const cabecera = screen.getByRole("button", { name: /reseñas \(3\)/i });
|
||||
expect(cabecera.getAttribute("aria-expanded")).toBe("false");
|
||||
expect(listarResenas).not.toHaveBeenCalled();
|
||||
});
|
||||
describe("ResenasLocal (grid + cierre por tres vías)", () => {
|
||||
it("carga al montar y muestra 3 en fila; la 4ª y el formulario quedan plegados", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
|
||||
render(<ResenasLocal localId="loc-1" totalInicial={4} mediaInicial={4} />);
|
||||
|
||||
it("al expandir carga perezosamente la lista (huella anónima, estrellas, comentario)", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [RESENA_AJENA], total: 1 });
|
||||
render(<ResenasLocal localId="loc-1" totalInicial={1} mediaInicial={4} />);
|
||||
|
||||
abrir();
|
||||
await waitFor(() => expect(listarResenas).toHaveBeenCalledWith("loc-1", expect.any(String)));
|
||||
expect(await screen.findByText(/anónimo #a1b2c3/i)).toBeTruthy();
|
||||
expect(screen.getByText("Genial")).toBeTruthy();
|
||||
// estrellas de la reseña (la cabecera también es role=img con la media)
|
||||
expect(screen.getAllByRole("img", { name: /valoración: 4 de 5/i }).length).toBeGreaterThan(0);
|
||||
// el deviceId se genera y persiste en localStorage
|
||||
expect(localStorage.getItem("localesp_device_id")).toMatch(/./);
|
||||
expect(await screen.findByText("Uno")).toBeTruthy();
|
||||
expect(screen.getByText("Dos")).toBeTruthy();
|
||||
expect(screen.getByText("Tres")).toBeTruthy();
|
||||
|
||||
// la vista previa contiene solo las 3 primeras
|
||||
const previa = screen.getByLabelText(/vista previa de reseñas/i);
|
||||
expect(within(previa).queryByText("Cuatro")).toBeNull();
|
||||
// pista y formulario plegado (aria-hidden excluye los roles)
|
||||
expect(screen.getByRole("button", { name: /ver las 4 reseñas/i })).toBeTruthy();
|
||||
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
|
||||
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
|
||||
});
|
||||
|
||||
it("formulario: elegir estrellas y publicar llama a enviarResena con el deviceId", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
|
||||
enviarResena.mockResolvedValue({ ok: true, media: 5, total: 1 });
|
||||
it("expandir revela el resto en el mismo grid y el formulario; la cabecera vuelve a cerrar", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText("Uno");
|
||||
|
||||
abrir();
|
||||
fireEvent.click(cabecera());
|
||||
expect(await screen.findByText("Cuatro")).toBeTruthy();
|
||||
expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy();
|
||||
expect(screen.getByRole("button", { name: /cerrar/i })).toBeTruthy();
|
||||
expect(screen.queryByRole("button", { name: /ver las 4 reseñas/i })).toBeNull();
|
||||
expect(cabecera().getAttribute("aria-expanded")).toBe("true");
|
||||
|
||||
// cierre vía cabecera
|
||||
fireEvent.click(cabecera());
|
||||
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
|
||||
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
|
||||
});
|
||||
|
||||
it("el botón Cerrar del formulario pliega la sección", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText("Uno");
|
||||
|
||||
fireEvent.click(cabecera());
|
||||
fireEvent.click(await screen.findByRole("button", { name: /cerrar/i }));
|
||||
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
|
||||
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
|
||||
});
|
||||
|
||||
it("comentar() (barra de acciones) alterna: abre con foco y vuelve a cerrar", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
|
||||
const ref = createRef();
|
||||
render(<ResenasLocal ref={ref} localId="loc-1" />);
|
||||
await waitFor(() => expect(listarResenas).toHaveBeenCalled());
|
||||
|
||||
act(() => ref.current.comentar());
|
||||
await waitFor(() => expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy(), { timeout: 3000 });
|
||||
await waitFor(
|
||||
() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/),
|
||||
{ timeout: 3000 },
|
||||
);
|
||||
|
||||
act(() => ref.current.comentar());
|
||||
await waitFor(() => expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull());
|
||||
});
|
||||
|
||||
it("elegir estrellas y publicar llama a enviarResena con el deviceId", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
|
||||
enviarResena.mockResolvedValue({ ok: true, media: 4, total: 1 });
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText(/aún no hay reseñas/i);
|
||||
|
||||
fireEvent.click(cabecera());
|
||||
fireEvent.click(await screen.findByRole("radio", { name: "4 estrellas" }));
|
||||
fireEvent.change(screen.getByLabelText(/comentario de la reseña/i), { target: { value: "Muy bien" } });
|
||||
fireEvent.click(screen.getByRole("button", { name: /publicar/i }));
|
||||
@@ -68,39 +116,47 @@ describe("ResenasLocal (sección desplegable en la tarjeta)", () => {
|
||||
puntuacion: 4,
|
||||
comentario: "Muy bien",
|
||||
}));
|
||||
expect(localStorage.getItem("localesp_device_id")).toMatch(/./);
|
||||
});
|
||||
|
||||
it("la reseña propia se precarga: botón Actualizar y Borrar mi reseña", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [RESENA_PROPIA], total: 1 });
|
||||
it("la propia aparece como «Tú» con botón Borrar en su tarjeta; el formulario se precarga (Actualizar)", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [PROPIA], total: 1 });
|
||||
borrarResena.mockResolvedValue({ ok: true, media: 0, total: 0 });
|
||||
render(<ResenasLocal localId="loc-1" totalInicial={1} mediaInicial={5} />);
|
||||
const previa = screen.getByLabelText(/vista previa de reseñas/i);
|
||||
await waitFor(() => expect(within(previa).getByText("Mi favorito")).toBeTruthy());
|
||||
|
||||
abrir();
|
||||
expect(await screen.findByText(/tu reseña/i)).toBeTruthy();
|
||||
expect(screen.getByRole("button", { name: /actualizar/i })).toBeTruthy();
|
||||
expect(screen.getByLabelText(/comentario de la reseña/i).value).toBe("Mi favorito");
|
||||
|
||||
fireEvent.click(screen.getByRole("button", { name: /borrar mi reseña/i }));
|
||||
// tarjeta propia en la vista previa: etiqueta «Tú» + Borrar (sin Reportar)
|
||||
const tarjeta = within(previa).getByText("Mi favorito").closest("div");
|
||||
expect(within(tarjeta).getByText(/^tú$/i)).toBeTruthy();
|
||||
fireEvent.click(within(tarjeta).getByRole("button", { name: /borrar/i }));
|
||||
await waitFor(() => expect(borrarResena).toHaveBeenCalledWith("loc-1", expect.any(String)));
|
||||
|
||||
// el formulario expandido sigue precargando la propia (Actualizar)
|
||||
fireEvent.click(cabecera());
|
||||
expect(await screen.findByRole("button", { name: /actualizar/i })).toBeTruthy();
|
||||
expect(screen.getByLabelText(/comentario de la reseña/i).value).toBe("Mi favorito");
|
||||
});
|
||||
|
||||
it("las reseñas ajenas se pueden reportar (reportarLocal con resenaId)", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [RESENA_AJENA], total: 1 });
|
||||
it("las reseñas ajenas tienen botón Reportar por tarjeta y queda marcada", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [CUATRO[0]], total: 1 });
|
||||
reportarLocal.mockResolvedValue({ ok: true });
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText("Uno");
|
||||
|
||||
abrir();
|
||||
fireEvent.click(await screen.findByTitle(/reportar esta reseña/i));
|
||||
await waitFor(() => expect(reportarLocal).toHaveBeenCalledWith("loc-1", "inapropiado", "", "res-1111"));
|
||||
expect(await screen.findByText(/✅ reportada/i)).toBeTruthy();
|
||||
const tarjeta = screen.getByText("Uno").closest("div");
|
||||
fireEvent.click(within(tarjeta).getByRole("button", { name: /reportar/i }));
|
||||
await waitFor(() => expect(reportarLocal).toHaveBeenCalledWith("loc-1", "inapropiado", "", "r1"));
|
||||
await waitFor(() => expect(within(tarjeta).getByText("✅")).toBeTruthy());
|
||||
});
|
||||
|
||||
it("errores del servidor (palabras no permitidas, 429) se muestran como aviso", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
|
||||
enviarResena.mockRejectedValue(new Error("El comentario contiene palabras no permitidas"));
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText(/aún no hay reseñas/i);
|
||||
|
||||
abrir();
|
||||
fireEvent.click(cabecera());
|
||||
fireEvent.click(await screen.findByRole("radio", { name: "3 estrellas" }));
|
||||
fireEvent.click(screen.getByRole("button", { name: /publicar/i }));
|
||||
expect((await screen.findByRole("alert")).textContent).toMatch(/no permitidas/i);
|
||||
|
||||
Reference in New Issue
Block a user