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
+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);