Files
localesp/openspec/changes/rediseno-resenas-tarjeta/proposal.md
T
edgar.friendly 24cce5dbb9
deploy-branch / deploy (push) Failing after 2s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 3m12s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
tests / Unitarias + componente + build (push) Successful in 3m9s
tests / Integración (Nominatim real, opt-in) (push) Skipped
fix(resenas,portada): quita el recuento de reseñas y los tres contadores
- 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: 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).

CI: en .gitea/workflows/tests.yml el build de producción pasa a correr
ANTES de las pruebas. La suite incluye un smoke de la SPA servida
(GET / → dist/index.html) y `dist/` está gitignored, así que sin build
previo esa prueba recibía 404 en el runner (hasta ahora el artefacto lo
generaba el job de deploy, que en esta rama falla por no tener entrada
en scripts/entornos.env).

164/164 tests y build en verde.
2026-10-14 00:37:18 +02:00

27 lines
2.7 KiB
Markdown

# Proposal: rediseno-resenas-tarjeta
## Why
Al usar el prototipo aparecen inconsistencias de usabilidad en la tarjeta del local y su sección de reseñas: la media vive dentro de la sección de reseñas (escondida), el formulario de reseña está dentro del cajón desplegable (así que «ver más reseñas» abre también el formulario), el control de expansión es un enlace pequeño a la izquierda, las tarjetas de comentario tienen el texto con un margen interno asimétrico, hay tres tamaños de estrellas distintos y los botones no responden al pasar el ratón (el sombreado de los estados activos solo tiñe el icono, no la superficie del botón).
## What Changes
- **Cabecera de la tarjeta**: las estrellas de la media pasan a la esquina superior derecha, a la altura del título.
- **Formulario de reseña**: sale del cajón de reseñas y aparece **debajo de la barra de acciones**, solo al pulsar «Comentar»; mientras está abierto, el botón «Comentar» queda en estado activo.
- **Cajón de reseñas**: expandir amplía **solo las reseñas** (el formulario ya no está dentro); el botón de ampliar/plegar pasa a **ancho completo** y se coloca **debajo de las reseñas**, y desaparece el recuento «Reseñas (N)» que estaba encima de las tarjetas.
- **Tarjetas de comentario**: padding uniforme (se elimina el margen interno asimétrico del texto) y padding superior en las estrellas para igualar el espaciado con el resto del contenido.
- **Estrellas**: un solo tamaño para media, tarjetas de reseña e input de valoración.
- **Botones**: efecto *hover* y estados activos con fondo que cubre **toda la superficie** del botón, no solo el icono.
## Capabilities
### Modified Capabilities
- `tarjeta-local`: la cabecera incorpora la media; la tarjeta aloja el formulario de reseña bajo la barra de acciones; se añade la respuesta visual de los botones (hover y estado activo).
- `resenas-por-local`: la sección desplegable pierde la media y el formulario (se mueven a la tarjeta), expande solo las reseñas y su control de expansión pasa a ancho completo bajo las reseñas.
## Impact
- **Código**: `src/components/LocalCard.jsx`, `src/components/ResenasLocal.jsx`, nuevo `src/components/FormularioResena.jsx`, nuevo `src/hooks/useResenas.js` (dueño único del estado de reseñas), `src/components/StarRating.jsx` (exporta el tamaño único), `index.html` (reglas de hover en los botones).
- **Tests**: `ResenasLocal.spec.jsx` pasa a prueba de presentación; nuevos `FormularioResena.spec.jsx` y `useResenas.spec.js`; `LocalCard.spec.jsx` cubre la cabecera con media, el formulario bajo la barra y la expansión de solo reseñas.
- **Sin cambios** de API, contrato de datos ni moderación.