openspec: archiva tarjeta-local-rediseno (sync aplicado)
deploy-branch / deploy (push) Successful in 2m40s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 2m57s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m8s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
deploy-branch / deploy (push) Successful in 2m40s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 2m57s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m8s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
- 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
This commit is contained in:
@@ -0,0 +1,106 @@
|
||||
# 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)
|
||||
|
||||
## 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:
|
||||
|
||||
1. **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"**.
|
||||
2. **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 con
|
||||
`line-clamp: 3` y fecha corta con `text-overflow` para que quepan
|
||||
"estrechadas".
|
||||
3. **Menos anidamiento:** el formulario deja de ser una caja (sin fondo ni
|
||||
borde propio): solo un `border-top` que lo separa del grid. Las tarjetas
|
||||
de reseña (fondo suave) son el único nivel de caja interior.
|
||||
4. **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).
|
||||
Reference in New Issue
Block a user