deploy-branch / deploy (push) Failing after 2s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m17s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m7s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
- ResenasLocal: desaparece la cabecera «Reseñas (N)» que iba encima de las tarjetas; el único control de expansión es el botón de ancho completo bajo las reseñas («Ver las N reseñas» / «Ver menos»). - Tarjetas de reseña (y de reseña propia): las estrellas llevan soporte de línea y padding superior para que el hueco de arriba iguale al del resto del contenido. - App: se eliminan los tres contadores del principio de la página (Locales · Provincias · Media ★) y las variables que solo los alimentaban (issue #4). 164/164 tests y build en verde.
57 lines
6.1 KiB
Markdown
57 lines
6.1 KiB
Markdown
# Design: rediseno-resenas-tarjeta
|
|
|
|
## Context
|
|
|
|
`LocalCard.jsx` monta la tarjeta del local: cabecera (nombre/provincia), categoría, dirección, enlaces, descripción, `ResenasLocal` (sección de reseñas) y pie con la barra de acciones (Comentar · Reportar · Marcar · Compartir). `ResenasLocal.jsx` es hoy el dueño de todo el estado de reseñas (lista, media, total, formulario, envío, borrado, reporte) y expone `comentar()` por ref para que la barra abra/cierre la sección; su cajón animado contiene el resto de reseñas **y** el formulario. `StarRating.jsx` se usa con tamaños 12 (tarjetas de reseña), 14 (media) y 20 (input). Los estilos son inline; el único CSS global vive en `<style>` de `index.html`.
|
|
|
|
Consecuencia de la estructura actual: no es posible colocar el formulario debajo de la barra (el formulario vive en el subárbol de `ResenasLocal`) ni mostrar la media en la cabecera (la media vive en `ResenasLocal`) sin reorganizar la propiedad del estado.
|
|
|
|
## Goals / Non-Goals
|
|
|
|
**Goals:**
|
|
- Media en la cabecera de la tarjeta, arriba a la derecha, a la altura del título.
|
|
- Formulario bajo la barra de acciones, visible solo con «Comentar», con ese botón en estado activo mientras está abierto.
|
|
- Expandir reseñas amplía solo reseñas, con control de ancho completo debajo de ellas.
|
|
- Paddings uniformes en las tarjetas de comentario, tamaño único de estrellas y hover/activo de botones a superficie completa.
|
|
- Mantener intacto el contrato con la API (`listarResenas`, `enviarResena`, `borrarResena`, `reportarLocal`) y la identidad anónima.
|
|
|
|
**Non-Goals:**
|
|
- No cambiar el contrato de la API ni el cálculo de la media (servidor).
|
|
- No tocar la barra de filtros (cambio `unificar-filtros-iu`) ni la pasarela de propuesta.
|
|
- No reordenar el resto de bloques de la tarjeta (descripción, aviso de confirmación, fecha).
|
|
|
|
## Decisions
|
|
|
|
### D1 — Un dueño único del estado de reseñas: hook `useResenas(localId, { totalInicial, mediaInicial })`
|
|
El estado y las acciones de reseñas (lista, cargando, total, media, reseña propia y valores del formulario, enviando, error, reportada) pasan a un hook. `LocalCard` lo consume y reparte datos a dos componentes presentacionales: `ResenasLocal` (lista + expansión) y `FormularioResena` (formulario). *Alternativas descartadas*: (a) portal del formulario al pie de la tarjeta — mantendría el estado en `ResenasLocal` a costa de un patrón poco habitual en el repo; (b) elevar el estado directamente a `LocalCard` — funciona, pero engorda el contenedor y el hook es la convención ya usada (`useFavoritos`, `useUbicacion`, `useToast`). El hook elimina la necesidad del `ref` imperativo `comentar()`, que desaparece.
|
|
|
|
### D2 — El formulario se controla desde el hook y se monta bajo la barra
|
|
`FormularioResena` es presentacional y controlado (`puntuacion`, `comentario`, `tienePropia`, `enviando`, `error` + callbacks). `LocalCard` guarda `comentando` (solo UI) y lo monta como último hijo de la tarjeta, debajo de la barra. Tras enviar, el hook refresca la lista y actualiza media/total, así que el formulario queda en modo «Actualizar» sin lógica extra.
|
|
|
|
### D3 — Cajón: solo el resto de reseñas y control de ancho completo
|
|
`ResenasLocal` conserva su estado local `abierto` y la animación `grid-template-rows 0fr→1fr`. El contenido del cajón es únicamente el resto de reseñas; **se elimina la cabecera «Reseñas (N)»** que vivía encima de las tarjetas (el recuento solo aparece en la etiqueta del botón «Ver las N reseñas» cuando hay más que la vista previa). El único control de ampliar/plegar es ese botón, de ancho completo y situado **después** del cajón, con `aria-expanded`.
|
|
|
|
### D4 — Un único tamaño de estrellas
|
|
`StarRating.jsx` exporta `TAMANO_ESTRELLAS` (14) y ese valor lo usan la media de la cabecera, las tarjetas de reseña y el input de valoración. *Alternativa descartada*: dejar el input a 20 — es lo que hoy provoca la inconsistencia señalada; 14 mantiene el input usable (los botones de estrella conservan su padding).
|
|
|
|
### D5 — Hover y estado activo por clase CSS (no inline)
|
|
Con estilos inline no se pueden expresar `:hover`/`:active`, y un `background` inline anularía la regla de hover. Se añaden clases en el `<style>` de `index.html` (`.btn-hover`, `.btn-hover.activo`) que pintan **el fondo completo del botón** (no solo el icono) en hover, pulsado y estado activo. Las acciones de la barra dejan de fijar `background` inline fuera del estado activo.
|
|
|
|
### D6 — Padding uniforme en las tarjetas de comentario
|
|
La tarjeta de reseña queda con `padding: 12` y el párrafo del comentario con `margin: 0` (hoy tiene `margin: 10`, que desplaza el texto respecto a las estrellas y al pie de la tarjeta). Las estrellas, que usan `lineHeight: 0`, se envuelven en un contenedor con soporte de línea y `paddingTop: 2` para que el hueco superior iguale al del resto del contenido (mismo tratamiento que en el formulario).
|
|
|
|
## Risks / Trade-offs
|
|
|
|
- [Mover estado y formulario rompe las pruebas existentes de `ResenasLocal`] → la prueba pasa a ser de presentación y la lógica (envío, borrado, reporte, errores) se cubre en `useResenas.spec.js` y `LocalCard.spec.jsx`.
|
|
- [Reasignar el tamaño de estrellas cambia el aspecto de las tarjetas de reseña (12→14)] → es el objetivo de «igualar tamaños»; si se prefiere otro valor, se cambia en una constante.
|
|
- [El hover por CSS depende de que no quede `background` inline] → se retiran explícitamente de los botones afectados y se comprueba en el navegador.
|
|
- [Con el formulario abierto y el cajón plegado, el usuario podría no ver la lista completa] → el formulario es independiente del cajón por diseño (petición explícita).
|
|
|
|
## Migration Plan
|
|
|
|
1. Hook `useResenas` + `StarRating.TAMANO_ESTRELLAS` + clases CSS de botones.
|
|
2. `ResenasLocal` presentacional (cajón solo con reseñas, control ancho completo, paddings y estrellas).
|
|
3. `FormularioResena` y montaje en `LocalCard` bajo la barra, con media en la cabecera y estado activo de «Comentar».
|
|
4. Pruebas y verificación en el navegador (servidor local en marcha con datos de ejemplo).
|
|
Rollback: revertir los commits del cambio; sin migración de datos.
|