- spec principal nuevo tarjeta-local (estructura + barra de acciones) - resenas-por-local actualizado: vista previa de 3 en grid, cierre por tres vías, acciones por tarjeta (Borrar propias / Reportar ajenas) - cambio archivado en archive/2026-10-11-tarjeta-local-rediseno
5.2 KiB
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
-
Carga de reseñas al montar (
useEffectenResenasLocal) 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). -
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).
- chevron con
-
Animación con
grid-template-rows: 0fr → 1fr(contenedordisplay: grid, hijooverflow: hidden,transition350 ms). Mejor quemax-heightfijado 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. -
comentar()imperativo víaforwardRef+useImperativeHandleenResenasLocal: la barra deLocalCardllama 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.scrollIntoViewse llama con encadenamiento opcional (jsdom no lo implementa y los tests no deben romperse). -
ReportarLocalcontrolado: props{ localId, onCerrar, inicialAbierto }; la barra lo monta coninicialAbiertoyonCerrarlo 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". -
Barra inferior = 4 botones iguales (
flex: 1, icono Tabler encima y etiqueta debajo, ~11 px), separada por borde superior; "Marcar" usaaria-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 permiteflexWrap. -
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-rowsen navegadores viejos] → degrada a salto seco sin romper nada (la propiedad anima o ignora). - [Vista previa + zona animada duplican render de tarjetas de reseña] → las 2 primeras se renderizan una vez (fuera de la zona animada); dentro solo van de la 3ª en adelante. Sin duplicación real.
Migration Plan
Puro frontend, desplegar y ya. Rollback = revert.
Open Questions
(nada bloqueante; el número mágico 2 de la vista previa y los 350 ms de la transición son fácilmente ajustables)
Iteración 2 (feedback de usuario, 2026-10-11)
Problemas reportados: (a) no había forma evidente de cerrar la sección de reseñas (el único cierre era el chevron diminuto y "Comentar" solo expandía); (b) demasiadas cajas anidadas (caja del formulario dentro de la zona expandida dentro de la tarjeta). Decisiones:
- 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".
- 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 conline-clamp: 3y fecha corta context-overflowpara que quepan "estrechadas". - Menos anidamiento: el formulario deja de ser una caja (sin fondo ni
borde propio): solo un
border-topque lo separa del grid. Las tarjetas de reseña (fondo suave) son el único nivel de caja interior. - 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).