Files
localesp/openspec/changes/tarjeta-local-rediseno/design.md
T
edgar.friendly ebbd7b696e
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
feat(tarjeta): rediseño de usabilidad — descripción arriba, vista previa de reseñas y barra de acciones
- 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).
2026-10-11 23:21:22 +02:00

3.9 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

  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)