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

- 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:
2026-10-11 23:21:22 +02:00
parent 478943c58a
commit ebbd7b696e
17 changed files with 724 additions and 188 deletions
@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-10-11
@@ -0,0 +1,84 @@
# 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)
@@ -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.
@@ -0,0 +1,22 @@
# 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 2 más recientes visibles en la primera vista; al expandirla, una animación amplía la tarjeta revelando todas las 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. La expansión también puede dispararse desde el botón "Comentar" de la barra inferior.
#### Scenario: Vista previa sin expandir
- **WHEN** se muestra la tarjeta de un local con reseñas
- **THEN** la sección de reseñas presenta la media, el total y las 2 reseñas más recientes visibles 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 de transición que revela todas las reseñas y el 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
- **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,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, la tarjeta se desplaza suavemente hasta el formulario y el foco pasa a la valoración por estrellas
#### 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,42 @@
# 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
+99
View File
@@ -0,0 +1,99 @@
# 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 "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
+53 -32
View File
@@ -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 -9
View File
@@ -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>
+176 -105
View File
@@ -1,22 +1,62 @@
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 (las más recientes) y duración de la
// animación de revelado (ms), sincronizada con la transición CSS.
const VISTA_PREVIA = 2;
const DURACION_TRANSICION = 350;
function formatearFecha(fecha) {
const d = new Date(fecha);
return Number.isNaN(d.getTime()) ? "" : d.toLocaleDateString("es-ES", { day: "numeric", month: "short", year: "numeric" });
}
// 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 }) {
function Reseña({ r, reportada, onReportar }) {
return (
<div 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={() => onReportar(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>
);
}
// Sección de reseñas de la tarjeta del local (issue #6 + rediseño de
// usabilidad): carga al montar y muestra VISTA_PREVIA reseñas sin expandir;
// la cabecera "★ media · Reseñas (N)" pliega/despliega con una animación
// (grid-template-rows 0fr→1fr) que revela el resto y el formulario inline.
// `comentar()` (llamado desde la barra inferior de la tarjeta) expande y
// enfoca 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 +68,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 +88,31 @@ 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.
useImperativeHandle(ref, () => ({ comentar: () => 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 () => {
@@ -97,6 +159,12 @@ export default function ResenasLocal({ localId, totalInicial = 0, mediaInicial =
}
};
const lista = resenas || [];
// La vista previa son siempre las 2 primeras; 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 */}
@@ -121,115 +189,118 @@ export default function ResenasLocal({ localId, totalInicial = 0, mediaInicial =
</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, sin interacción */}
{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={{ display: "flex", flexDirection: "column", gap: 6 }} aria-label="Vista previa de reseñas">
{visibles.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} />)}
</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)",
{/* 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>
)}
{/* Zona animada: el resto de reseñas + el formulario. La altura anima de
0fr a 1fr; el contenido permanece montado para que la transición sea
fluida y se oculta del árbol de accesibilidad cuando está plegada. */}
<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: 6, paddingTop: abierto ? 6 : 0 }}>
{resto.length > 0 && (
<div style={{ display: "flex", flexDirection: "column", gap: 6 }}>
{resto.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} />)}
</div>
)}
{/* Formulario inline: crear o actualizar la reseña propia */}
<div ref={formRef} style={{
background: "var(--color-background-primary)",
border: "0.5px solid var(--color-border-tertiary)",
borderRadius: "var(--border-radius-md)",
padding: "8px 10px",
border: r.esPropia ? "0.5px solid var(--color-border-secondary)" : "none",
display: "flex", flexDirection: "column", gap: 6,
}}>
<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>
))}
{/* 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 style={{ margin: 0, fontSize: 12, fontWeight: 500 }}>
{tienePropia ? "Tu reseña (anónima)" : "Deja tu reseña (anónima)"}
</p>
)}
<div style={{ display: "flex", gap: 6, alignItems: "center" }}>
<button
type="button"
onClick={enviar}
disabled={puntuacion < 1 || enviando}
<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, 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: "none", border: "0.5px solid var(--color-border-secondary)",
borderRadius: "var(--border-radius-md)", padding: "5px 12px", cursor: "pointer",
color: "var(--color-text-secondary)",
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,
}}
>
Borrar mi reseña
{enviando ? "Guardando…" : tienePropia ? "Actualizar" : "Publicar"}
</button>
)}
{tienePropia && (
<button
type="button"
onClick={borrar}
disabled={enviando}
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
</button>
)}
</div>
</div>
</div>
</div>
)}
</div>
</div>
);
}
});
export default ResenasLocal;
+79
View File
@@ -0,0 +1,79 @@
// @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 },
);
});
});
+67 -42
View File
@@ -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,67 @@ 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 TRES = [
{ id: "r1", huella: "#111111", puntuacion: 5, comentario: "Uno", fecha: ISO, fechaEdicion: null, esPropia: false },
{ id: "r2", huella: "#222222", puntuacion: 4, comentario: "Dos", fecha: ISO, fechaEdicion: null, esPropia: false },
{ id: "r3", huella: "#333333", puntuacion: 3, comentario: "Tres", fecha: ISO, fechaEdicion: null, esPropia: false },
];
const PROPIA = { id: "r9", huella: "#999999", puntuacion: 5, comentario: "Mi favorito", fecha: ISO, fechaEdicion: null, 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", () => {
describe("ResenasLocal (vista previa + expansión animada)", () => {
it("carga al montar y muestra la vista previa de 2; la tercera y el formulario quedan plegados", async () => {
listarResenas.mockResolvedValue({ resenas: TRES, total: 3 });
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();
});
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();
// carga sin interacción (para la vista previa)
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();
// el formulario y la pista están fuera del árbol visible (aria-hidden)
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
expect(screen.getByRole("button", { name: /ver las 3 reseñas/i })).toBeTruthy();
// la vista previa contiene solo las 2 primeras
const previa = screen.getByLabelText(/vista previa de reseñas/i);
expect(within(previa).queryByText("Tres")).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 todas las reseñas y el formulario (aria-expanded)", async () => {
listarResenas.mockResolvedValue({ resenas: TRES, total: 3 });
render(<ResenasLocal localId="loc-1" />);
await screen.findByText("Uno");
abrir();
fireEvent.click(cabecera());
expect(await screen.findByText("Tres")).toBeTruthy();
expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy();
expect(screen.queryByRole("button", { name: /ver las 3 reseñas/i })).toBeNull();
expect(cabecera().getAttribute("aria-expanded")).toBe("true");
});
it("comentar() (barra de acciones) expande y enfoca el formulario", 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 });
// tras la transición, el foco cae en la primera estrella del formulario
await waitFor(() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/), { timeout: 3000 });
});
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,30 +91,31 @@ 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 reseña propia se precarga al expandir: Actualizar y Borrar mi reseña", async () => {
listarResenas.mockResolvedValue({ resenas: [PROPIA], total: 1 });
borrarResena.mockResolvedValue({ ok: true, media: 0, total: 0 });
render(<ResenasLocal localId="loc-1" totalInicial={1} mediaInicial={5} />);
await screen.findByText(/tu reseña/i); // visible en la vista previa
abrir();
expect(await screen.findByText(/tu reseña/i)).toBeTruthy();
expect(screen.getByRole("button", { name: /actualizar/i })).toBeTruthy();
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");
fireEvent.click(screen.getByRole("button", { name: /borrar mi reseña/i }));
await waitFor(() => expect(borrarResena).toHaveBeenCalledWith("loc-1", expect.any(String)));
});
it("las reseñas ajenas se pueden reportar (reportarLocal con resenaId)", async () => {
listarResenas.mockResolvedValue({ resenas: [RESENA_AJENA], total: 1 });
it("las reseñas ajenas (visibles en la vista previa) se pueden reportar", async () => {
listarResenas.mockResolvedValue({ resenas: [TRES[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"));
fireEvent.click(screen.getByTitle(/reportar esta reseña/i));
await waitFor(() => expect(reportarLocal).toHaveBeenCalledWith("loc-1", "inapropiado", "", "r1"));
expect(await screen.findByText(/✅ reportada/i)).toBeTruthy();
});
@@ -99,8 +123,9 @@ describe("ResenasLocal (sección desplegable en la tarjeta)", () => {
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);