Files
localesp/openspec/changes/tarjeta-local-rediseno/proposal.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

60 lines
2.7 KiB
Markdown

# Proposal: Rediseño de la tarjeta de local (usabilidad)
## Why
La sección de reseñas actual (fila plegable donde antes estaban las estrellas)
esconde todo el contenido tras un clic y mezcla jerarquías: la descripción del
local queda debajo de las reseñas y las acciones están dispersas (corazón y
compartir en la cabecera, reportar abajo en pequeñito). La tarjeta necesita
una jerarquía clara: la descripción del local es del local; las reseñas son
contenido vivo que debe verse sin fricción; y las acciones primarias merecen
una barra propia y visible.
## What Changes
- **Descripción separada y encima:** `local.descripcion` deja de convivir con
las reseñas y se muestra en su propio bloque, encima de la sección de
reseñas.
- **Reseñas con vista previa:** la sección de reseñas carga al montar la
tarjeta y muestra **2 reseñas visibles en la primera vista** (las más
recientes) con la cabecera "★ media · Reseñas (N)".
- **Expansión animada:** al expandir, una animación (transición CSS) amplía la
tarjeta revelando **todas** las reseñas y el formulario inline.
- **Barra inferior de acciones a ancho completo:** el pie de la tarjeta queda
cubierto por cuatro botones — **Comentar · Reportar · Marcar · Compartir**:
- *Comentar*: expande la sección de reseñas (si estaba plegada), hace
scroll suave hasta el formulario y enfoca las estrellas.
- *Reportar*: abre el formulario de reporte del local (antes era un
textuelo "Reportar").
- *Marcar*: favorito (el corazón desaparece de la cabecera; estado activo
visible en la barra).
- *Compartir*: el share se muda de la cabecera a la barra.
- La fecha ("Publicado …") queda en pequeñito justo encima de la barra; el
aviso "Sigue aquí ✅" se mantiene como banner cuando corresponde, encima de
la barra.
## Capabilities
### New Capabilities
- `tarjeta-local`: estructura y acciones de la tarjeta de local — orden de
bloques (descripción sobre reseñas), barra inferior de acciones y sus
comportamientos.
### Modified Capabilities
- `resenas-por-local`: el requisito "Sección de reseñas desplegable en la
tarjeta del local" cambia de carga perezosa tras clic a **carga en la
primera vista con 2 reseñas visibles** y expansión **animada** que revela
todas + formulario, abrible también desde "Comentar".
## Impact
- **Frontend:** `LocalCard.jsx` (reestructura + barra), `ResenasLocal.jsx`
(carga al montar, vista previa de 2, animación, `comentar()` imperativo),
`ReportarLocal.jsx` (controlado: se abre desde la barra).
- **Tests:** rework de `ResenasLocal.spec.jsx` (carga temprana, 2 visibles,
expansión, comentar) y nuevo `LocalCard.spec.jsx` (barra de 4, descripción
encima, Marcar activo).
- **Sin cambios** de backend, BD ni API.