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
@@ -0,0 +1,84 @@
# 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)