fix(tarjeta): cierre accesible de reseñas + grid de tarjetas con acciones
deploy-branch / deploy (push) Successful in 3m26s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m50s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m48s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped

Feedback de usuario tras el rediseño:

- Cierre por tres vías (antes solo un chevron poco visible): "Comentar"
  ahora ALTERNA (abre con foco / cierra), botón "Cerrar" en el formulario
  y chevron de la cabecera (chevron agrandado)
- Reseñas en GRID: 3 primeras en fila ocupando el ancho de la tarjeta
  (auto-fit minmax(120px,1fr)); al expandir, el resto en el mismo grid;
  comentario con line-clamp 3 y fecha corta para cabir "estrechadas"
- Menos cajas anidadas: el formulario es plano (solo border-top), sin
  caja propia dentro de la zona expandida
- Acciones por tarjeta de reseña: "Borrar" en las propias (etiqueta
  «Tú»), "Reportar" en las ajenas con estado ✅; fuera el botón
  "Borrar mi reseña" del formulario (redundante)

Suite: 139/139 (toggle de cierre por las tres vías, grid de 3 con la
4ª oculta, borrar/reportar por tarjeta, comentar() alterna).
This commit is contained in:
2026-10-12 10:10:44 +02:00
parent ebbd7b696e
commit c4a60c099c
7 changed files with 204 additions and 111 deletions
@@ -82,3 +82,25 @@ Puro frontend, desplegar y ya. Rollback = revert.
(nada bloqueante; el número mágico 2 de la vista previa y los 350 ms de la (nada bloqueante; el número mágico 2 de la vista previa y los 350 ms de la
transición son fácilmente ajustables) 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).
@@ -3,20 +3,28 @@
## MODIFIED Requirements ## MODIFIED Requirements
### Requirement: Sección de reseñas desplegable en la tarjeta del local ### 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. 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 #### Scenario: Vista previa sin expandir
- **WHEN** se muestra la tarjeta de un local con reseñas - **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 - **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 #### Scenario: Expansión animada
- **WHEN** el usuario expande la sección de reseñas - **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 - **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 #### Scenario: Expandir y reseñar
- **WHEN** el usuario expande la sección de reseñas y envía estrellas (y opcionalmente comentario) - **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 - **THEN** su reseña aparece en la lista y la cabecera actualiza número y media
#### Scenario: La propia reseña es editable #### Scenario: La propia reseña es editable y borrable desde su tarjeta
- **WHEN** el dispositivo ya tiene reseña en ese local y expande la sección - **WHEN** el dispositivo ya tiene reseña en ese local
- **THEN** el formulario aparece precargado con su reseña y ofrece actualizar o borrar - **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
@@ -18,7 +18,7 @@ El pie de la tarjeta SHALL estar ocupado por una barra de botones a ancho comple
#### Scenario: Comentar #### Scenario: Comentar
- **WHEN** el usuario pulsa "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 - **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 #### Scenario: Reportar
- **WHEN** el usuario pulsa "Reportar" - **WHEN** el usuario pulsa "Reportar"
@@ -40,3 +40,12 @@
## 5. Cierre ## 5. Cierre
- [x] 5.1 Commit + push y verificación del despliegue en prototipo-yb01.localesp.es - [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
+91 -72
View File
@@ -4,58 +4,82 @@ import { borrarResena, enviarResena, listarResenas, reportarLocal } from "../fir
import { obtenerDeviceId } from "../utils/dispositivo.js"; import { obtenerDeviceId } from "../utils/dispositivo.js";
const MAX_COMENTARIO = 500; const MAX_COMENTARIO = 500;
// Reseñas visibles sin expandir (las más recientes) y duración de la // Reseñas visibles sin expandir (en fila, ocupando el ancho) y duración de
// animación de revelado (ms), sincronizada con la transición CSS. // la animación de revelado (ms), sincronizada con la transición CSS.
const VISTA_PREVIA = 2; const VISTA_PREVIA = 3;
const DURACION_TRANSICION = 350; 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); 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" });
} }
function Reseña({ r, reportada, onReportar }) { 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 ( return (
<div style={{ <div style={{
background: "var(--color-background-secondary)", background: "var(--color-background-secondary)",
borderRadius: "var(--border-radius-md)", borderRadius: "var(--border-radius-md)",
padding: "8px 10px", padding: "8px 8px 6px",
display: "flex", flexDirection: "column", gap: 4, minWidth: 0,
border: r.esPropia ? "0.5px solid var(--color-border-secondary)" : "none", border: r.esPropia ? "0.5px solid var(--color-border-secondary)" : "none",
}}> }}>
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", gap: 6 }}> <StarRating value={r.puntuacion} readOnly size={12} />
<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 && ( {r.comentario && (
<p style={{ margin: "4px 0 0", fontSize: 13, color: "var(--color-text-secondary)" }}>{r.comentario}</p> <p
title={r.comentario}
style={{
margin: 0, 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> </div>
); );
} }
// Sección de reseñas de la tarjeta del local (issue #6 + rediseño de // 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; // usabilidad, iteración 2): carga al montar y muestra VISTA_PREVIA reseñas
// la cabecera "★ media · Reseñas (N)" pliega/despliega con una animación // en fila ocupando el ancho; la cabecera "★ media · Reseñas (N)" alterna con
// (grid-template-rows 0fr→1fr) que revela el resto y el formulario inline. // una animación (grid-template-rows 0fr→1fr) que revela el resto en el mismo
// `comentar()` (llamado desde la barra inferior de la tarjeta) expande y // grid y el formulario inline PLANO (sin caja propia). Cierre por tres vías:
// enfoca el formulario. Identidad anónima con huella corta por local. // 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 ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial = 0, mediaInicial = 0 }, ref) {
const [abierto, setAbierto] = useState(false); const [abierto, setAbierto] = useState(false);
const [resenas, setResenas] = useState(null); // null = aún sin cargar const [resenas, setResenas] = useState(null); // null = aún sin cargar
@@ -103,8 +127,11 @@ const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial =
} }
}; };
// API imperativa para la barra de acciones de la tarjeta. // API imperativa para la barra de acciones de la tarjeta: ALTERNA (abre con
useImperativeHandle(ref, () => ({ comentar: () => expandir(true) })); // foco / cierra). El cierre también está en la cabecera y en "Cerrar".
useImperativeHandle(ref, () => ({
comentar: () => (abierto ? setAbierto(false) : expandir(true)),
}));
const alternar = () => { const alternar = () => {
if (abierto) { if (abierto) {
@@ -134,7 +161,8 @@ const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial =
setEnviando(false); setEnviando(false);
}; };
const borrar = async () => { // Borrado desde la propia tarjeta de reseña (solo propias).
const borrarPropia = async () => {
setEnviando(true); setEnviando(true);
setError(""); setError("");
try { try {
@@ -160,8 +188,8 @@ const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial =
}; };
const lista = resenas || []; const lista = resenas || [];
// La vista previa son siempre las 2 primeras; el resto vive dentro de la // La vista previa son siempre las primeras VISTA_PREVIA; el resto vive
// zona animada (se revela al expandir, sin duplicar render). // dentro de la zona animada (se revela al expandir, sin duplicar render).
const visibles = lista.slice(0, VISTA_PREVIA); const visibles = lista.slice(0, VISTA_PREVIA);
const resto = lista.slice(VISTA_PREVIA); const resto = lista.slice(VISTA_PREVIA);
@@ -184,12 +212,12 @@ const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial =
<i <i
className={`ti ${abierto ? "ti-chevron-up" : "ti-chevron-down"}`} className={`ti ${abierto ? "ti-chevron-up" : "ti-chevron-down"}`}
aria-hidden="true" aria-hidden="true"
style={{ fontSize: 13, marginLeft: 4, color: "var(--color-text-tertiary)" }} style={{ fontSize: 14, marginLeft: 4, color: "var(--color-text-tertiary)" }}
/> />
</span> </span>
</button> </button>
{/* Vista previa: siempre a la vista, sin interacción */} {/* Vista previa: siempre a la vista, en fila ocupando el ancho */}
{cargando && resenas === null && ( {cargando && resenas === null && (
<p style={{ fontSize: 12, color: "var(--color-text-tertiary)", margin: 0 }}>Cargando reseñas…</p> <p style={{ fontSize: 12, color: "var(--color-text-tertiary)", margin: 0 }}>Cargando reseñas…</p>
)} )}
@@ -198,8 +226,8 @@ const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial =
Aún no hay reseñas. ¡Sé el primero! Aún no hay reseñas. ¡Sé el primero!
</p> </p>
)} )}
<div style={{ display: "flex", flexDirection: "column", gap: 6 }} aria-label="Vista previa de reseñas"> <div style={gridResenas} aria-label="Vista previa de reseñas">
{visibles.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} />)} {visibles.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} onBorrar={borrarPropia} />)}
</div> </div>
{/* Pista de expansión cuando hay más reseñas que la vista previa */} {/* Pista de expansión cuando hay más reseñas que la vista previa */}
@@ -216,9 +244,9 @@ const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial =
</button> </button>
)} )}
{/* Zona animada: el resto de reseñas + el formulario. La altura anima de {/* Zona animada: resto de reseñas (mismo grid) + formulario plano. La
0fr a 1fr; el contenido permanece montado para que la transición sea altura anima de 0fr a 1fr; el contenido permanece montado para que
fluida y se oculta del árbol de accesibilidad cuando está plegada. */} la transición sea fluida y se oculta del árbol accesible plegado. */}
<div <div
aria-hidden={!abierto} aria-hidden={!abierto}
style={{ style={{
@@ -228,23 +256,17 @@ const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial =
}} }}
> >
<div style={{ overflow: "hidden" }}> <div style={{ overflow: "hidden" }}>
<div style={{ display: "flex", flexDirection: "column", gap: 6, paddingTop: abierto ? 6 : 0 }}> <div style={{ display: "flex", flexDirection: "column", gap: 8, paddingTop: abierto ? 8 : 0 }}>
{resto.length > 0 && ( {resto.length > 0 && (
<div style={{ display: "flex", flexDirection: "column", gap: 6 }}> <div style={gridResenas}>
{resto.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} />)} {resto.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} onBorrar={borrarPropia} />)}
</div> </div>
)} )}
{/* Formulario inline: crear o actualizar la reseña propia */} {/* Formulario inline PLANO (sin caja): solo un borde que lo separa */}
<div ref={formRef} style={{ <div ref={formRef} style={{ paddingTop: 8, borderTop: "0.5px solid var(--color-border-tertiary)", display: "flex", flexDirection: "column", gap: 6 }}>
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 }}> <p style={{ margin: 0, fontSize: 12, fontWeight: 500 }}>
{tienePropia ? "Tu reseña (anónima)" : "Deja tu reseña (anónima)"} {tienePropia ? "Tu reseña (anónima) — edítala o bórrala desde su tarjeta" : "Deja tu reseña (anónima)"}
</p> </p>
<StarRating value={puntuacion} onChange={setPuntuacion} size={20} /> <StarRating value={puntuacion} onChange={setPuntuacion} size={20} />
<textarea <textarea
@@ -280,20 +302,17 @@ const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial =
> >
{enviando ? "Guardando…" : tienePropia ? "Actualizar" : "Publicar"} {enviando ? "Guardando…" : tienePropia ? "Actualizar" : "Publicar"}
</button> </button>
{tienePropia && ( <button
<button type="button"
type="button" onClick={() => setAbierto(false)}
onClick={borrar} style={{
disabled={enviando} fontSize: 12, background: "none", border: "0.5px solid var(--color-border-secondary)",
style={{ borderRadius: "var(--border-radius-md)", padding: "5px 12px", cursor: "pointer",
fontSize: 12, background: "none", border: "0.5px solid var(--color-border-secondary)", color: "var(--color-text-secondary)",
borderRadius: "var(--border-radius-md)", padding: "5px 12px", cursor: "pointer", }}
color: "var(--color-text-secondary)", >
}} Cerrar
> </button>
Borrar mi reseña
</button>
)}
</div> </div>
</div> </div>
</div> </div>
+4
View File
@@ -75,5 +75,9 @@ describe("LocalCard (rediseño de usabilidad)", () => {
() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/), () => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/),
{ timeout: 3000 }, { 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());
}); });
}); });
+63 -32
View File
@@ -22,48 +22,68 @@ beforeEach(() => {
afterEach(cleanup); afterEach(cleanup);
const ISO = "2026-10-11T10:00:00.000Z"; const ISO = "2026-10-11T10:00:00.000Z";
const TRES = [ const reseña = (id, huella, puntuacion, comentario, extra = {}) => ({
{ id: "r1", huella: "#111111", puntuacion: 5, comentario: "Uno", fecha: ISO, fechaEdicion: null, esPropia: false }, id, huella, puntuacion, comentario, fecha: ISO, fechaEdicion: null, esPropia: false, ...extra,
{ 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 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 = { id: "r9", huella: "#999999", puntuacion: 5, comentario: "Mi favorito", fecha: ISO, fechaEdicion: null, esPropia: true }; const PROPIA = reseña("r9", "#999999", 5, "Mi favorito", { esPropia: true });
const cabecera = () => screen.getByRole("button", { name: /reseñas \(\d+\)/i }); const cabecera = () => screen.getByRole("button", { name: /reseñas \(\d+\)/i });
describe("ResenasLocal (vista previa + expansión animada)", () => { describe("ResenasLocal (grid + cierre por tres vías)", () => {
it("carga al montar y muestra la vista previa de 2; la tercera y el formulario quedan plegados", async () => { it("carga al montar y muestra 3 en fila; la 4ª y el formulario quedan plegados", async () => {
listarResenas.mockResolvedValue({ resenas: TRES, total: 3 }); listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
render(<ResenasLocal localId="loc-1" totalInicial={3} mediaInicial={4} />); render(<ResenasLocal localId="loc-1" totalInicial={4} mediaInicial={4} />);
// carga sin interacción (para la vista previa)
await waitFor(() => expect(listarResenas).toHaveBeenCalledWith("loc-1", expect.any(String))); await waitFor(() => expect(listarResenas).toHaveBeenCalledWith("loc-1", expect.any(String)));
expect(await screen.findByText("Uno")).toBeTruthy(); expect(await screen.findByText("Uno")).toBeTruthy();
expect(screen.getByText("Dos")).toBeTruthy(); expect(screen.getByText("Dos")).toBeTruthy();
expect(screen.getByText("Tres")).toBeTruthy();
// el formulario y la pista están fuera del árbol visible (aria-hidden) // la vista previa contiene solo las 3 primeras
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); const previa = screen.getByLabelText(/vista previa de reseñas/i);
expect(within(previa).queryByText("Tres")).toBeNull(); 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"); expect(cabecera().getAttribute("aria-expanded")).toBe("false");
}); });
it("expandir revela todas las reseñas y el formulario (aria-expanded)", async () => { it("expandir revela el resto en el mismo grid y el formulario; la cabecera vuelve a cerrar", async () => {
listarResenas.mockResolvedValue({ resenas: TRES, total: 3 }); listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
render(<ResenasLocal localId="loc-1" />); render(<ResenasLocal localId="loc-1" />);
await screen.findByText("Uno"); await screen.findByText("Uno");
fireEvent.click(cabecera()); fireEvent.click(cabecera());
expect(await screen.findByText("Tres")).toBeTruthy(); expect(await screen.findByText("Cuatro")).toBeTruthy();
expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy(); expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy();
expect(screen.queryByRole("button", { name: /ver las 3 reseñas/i })).toBeNull(); 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"); 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("comentar() (barra de acciones) expande y enfoca el formulario", async () => { 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 }); listarResenas.mockResolvedValue({ resenas: [], total: 0 });
const ref = createRef(); const ref = createRef();
render(<ResenasLocal ref={ref} localId="loc-1" />); render(<ResenasLocal ref={ref} localId="loc-1" />);
@@ -71,8 +91,13 @@ describe("ResenasLocal (vista previa + expansión animada)", () => {
act(() => ref.current.comentar()); act(() => ref.current.comentar());
await waitFor(() => expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy(), { timeout: 3000 }); 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(
await waitFor(() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/), { timeout: 3000 }); () => 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 () => { it("elegir estrellas y publicar llama a enviarResena con el deviceId", async () => {
@@ -94,29 +119,35 @@ describe("ResenasLocal (vista previa + expansión animada)", () => {
expect(localStorage.getItem("localesp_device_id")).toMatch(/./); expect(localStorage.getItem("localesp_device_id")).toMatch(/./);
}); });
it("la reseña propia se precarga al expandir: Actualizar y Borrar mi reseña", async () => { 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 }); listarResenas.mockResolvedValue({ resenas: [PROPIA], total: 1 });
borrarResena.mockResolvedValue({ ok: true, media: 0, total: 0 }); borrarResena.mockResolvedValue({ ok: true, media: 0, total: 0 });
render(<ResenasLocal localId="loc-1" totalInicial={1} mediaInicial={5} />); render(<ResenasLocal localId="loc-1" totalInicial={1} mediaInicial={5} />);
await screen.findByText(/tu reseña/i); // visible en la vista previa const previa = screen.getByLabelText(/vista previa de reseñas/i);
await waitFor(() => expect(within(previa).getByText("Mi favorito")).toBeTruthy());
// 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()); fireEvent.click(cabecera());
expect(await screen.findByRole("button", { name: /actualizar/i })).toBeTruthy(); expect(await screen.findByRole("button", { name: /actualizar/i })).toBeTruthy();
expect(screen.getByLabelText(/comentario de la reseña/i).value).toBe("Mi favorito"); 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 (visibles en la vista previa) se pueden reportar", async () => { it("las reseñas ajenas tienen botón Reportar por tarjeta y queda marcada", async () => {
listarResenas.mockResolvedValue({ resenas: [TRES[0]], total: 1 }); listarResenas.mockResolvedValue({ resenas: [CUATRO[0]], total: 1 });
reportarLocal.mockResolvedValue({ ok: true }); reportarLocal.mockResolvedValue({ ok: true });
render(<ResenasLocal localId="loc-1" />); render(<ResenasLocal localId="loc-1" />);
await screen.findByText("Uno"); await screen.findByText("Uno");
fireEvent.click(screen.getByTitle(/reportar esta reseña/i)); 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(reportarLocal).toHaveBeenCalledWith("loc-1", "inapropiado", "", "r1"));
expect(await screen.findByText(/✅ reportada/i)).toBeTruthy(); await waitFor(() => expect(within(tarjeta).getByText("✅")).toBeTruthy());
}); });
it("errores del servidor (palabras no permitidas, 429) se muestran como aviso", async () => { it("errores del servidor (palabras no permitidas, 429) se muestran como aviso", async () => {