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