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,22 @@
# Delta: resenas-por-local (UI de la sección de reseñas)
## MODIFIED Requirements
### Requirement: Sección de reseñas desplegable en la tarjeta del local
La tarjeta de cada local SHALL incluir una sección "★ media · Reseñas (N)" que carga sus reseñas al montar la tarjeta y muestra las 2 más recientes visibles en la primera vista; al expandirla, una animación amplía la tarjeta revelando todas las reseñas y el formulario inline (estrellas interactivas 1–5 y comentario opcional de 500 caracteres), con las acciones de publicar/actualizar y borrar para la reseña del propio dispositivo. La expansión también puede dispararse desde el botón "Comentar" de la barra inferior.
#### Scenario: Vista previa sin expandir
- **WHEN** se muestra la tarjeta de un local con reseñas
- **THEN** la sección de reseñas presenta la media, el total y las 2 reseñas más recientes visibles sin interacción
#### Scenario: Expansión animada
- **WHEN** el usuario expande la sección de reseñas
- **THEN** la tarjeta se amplía con una animación de transición que revela todas las reseñas y el formulario
#### Scenario: Expandir y reseñar
- **WHEN** el usuario expande la sección de reseñas y envía estrellas (y opcionalmente comentario)
- **THEN** su reseña aparece en la lista y la cabecera actualiza número y media
#### Scenario: La propia reseña es editable
- **WHEN** el dispositivo ya tiene reseña en ese local y expande la sección
- **THEN** el formulario aparece precargado con su reseña y ofrece actualizar o borrar
@@ -0,0 +1,33 @@
# Delta Spec: tarjeta-local (nueva capacidad)
## ADDED Requirements
### Requirement: Estructura de la tarjeta de local
La tarjeta de cada local SHALL presentar sus bloques en este orden: nombre y provincia en la cabecera, categoría, dirección, enlaces de navegación, descripción del local (si existe), sección de reseñas, aviso de confirmación (cuando corresponda), fecha de publicación y, como pie, la barra inferior de acciones.
#### Scenario: La descripción va encima de las reseñas
- **WHEN** un local tiene descripción y reseñas
- **THEN** la descripción se muestra como bloque propio, inmediatamente encima de la sección de reseñas y sin mezclarse con ella
#### Scenario: Local sin descripción
- **WHEN** un local no tiene descripción
- **THEN** la tarjeta pasa de los enlaces de navegación directamente a la sección de reseñas
### Requirement: Barra inferior de acciones
El pie de la tarjeta SHALL estar ocupado por una barra de botones a ancho completo con, de momento, cuatro acciones: Comentar, Reportar, Marcar y Compartir. La fecha de publicación SHALL quedar como texto secundario justo encima de la barra, y el aviso de confirmación ("Sigue aquí") SHALL mostrarse como banner encima de la barra cuando corresponda.
#### Scenario: Comentar
- **WHEN** el usuario pulsa "Comentar"
- **THEN** la sección de reseñas se expande si estaba plegada, la tarjeta se desplaza suavemente hasta el formulario y el foco pasa a la valoración por estrellas
#### Scenario: Reportar
- **WHEN** el usuario pulsa "Reportar"
- **THEN** se abre el formulario de reporte del local encima de la barra, sin salir de la tarjeta
#### Scenario: Marcar
- **WHEN** el usuario pulsa "Marcar" en un local no marcado
- **THEN** el local pasa a ser favorito y el botón refleja el estado activo (y viceversa al pulsar de nuevo)
#### Scenario: Compartir
- **WHEN** el usuario pulsa "Compartir"
- **THEN** se abre el flujo de compartir del local (nativo del dispositivo o WhatsApp con enlace copiado)