# 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)