Files
localesp/openspec/specs/resenas-por-local/spec.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

100 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Reseñas por local
## Purpose
Reseñas anónimas múltiples por local (issue #6): una por dispositivo, editables y borrables por su autor; la puntuación del local pasa a ser la media de sus reseñas. Publicación directa con filtro de palabras, reportes y moderación admin; identidad anónima con huella corta por local (estilo 4chan, sin datos personales) y rate-limit por IP como defensa anti-boicot base.
## Requirements
### Requirement: Una reseña por dispositivo y local
El sistema SHALL permitir como máximo una reseña por dispositivo y local; enviar una reseña cuando ya existe una del mismo dispositivo SHALL actualizar (editar) la existente en lugar de crear una duplicada.
#### Scenario: Primera reseña
- **WHEN** un dispositivo envía `puntuacion` (1–5) y un comentario opcional a un local sin reseña previa suya
- **THEN** la reseña se crea con fecha y queda visible en la lista del local
#### Scenario: Reenvío edita la existente
- **WHEN** un dispositivo que ya reseñó un local envía de nuevo una reseña para ese local
- **THEN** la reseña previa se actualiza (puntuacion y comentario) y se registra la fecha de edición, sin crear duplicados
#### Scenario: Borrado de la propia reseña
- **WHEN** un dispositivo solicita borrar su reseña de un local
- **THEN** la reseña desaparece de la lista y la puntuación del local se recalcula
### Requirement: Valoración obligatoria 1–5 y comentario opcional
La reseña SHALL contener una valoración de 1 a 5 estrellas obligatoria y un comentario opcional de como máximo 500 caracteres; las escrituras fuera de ese contrato SHALL rechazarse con error 400.
#### Scenario: Reseña sin puntuacion
- **WHEN** se envía una reseña sin puntuacion o fuera del rango 1–5
- **THEN** el servidor responde 400 y no se crea ni modifica ninguna reseña
#### Scenario: Comentario demasiado largo
- **WHEN** se envía un comentario de más de 500 caracteres
- **THEN** el servidor responde 400
### Requirement: Media agregada en la puntuación del local
El sistema SHALL mantener `locales.puntuacion` como la media (entero redondeado) de las reseñas vigentes del local, recalculada al crear, editar o borrar una reseña; sin reseñas SHALL valer 0. Los consumidores existentes (estrellas de la tarjeta, popup del mapa, orden "★ Mejor" y media global) SHALL funcionar sin cambios.
#### Scenario: Recálculo al crear
- **WHEN** un local sin reseñas recibe una reseña de 5 estrellas y luego otra de 4
- **THEN** tras la primera la puntuación del local es 5, y tras la segunda es 5 (media 4.5 redondeada al entero más próximo, ROUND de SQLite)
#### Scenario: Recálculo al borrar
- **WHEN** se borra la única reseña de un local
- **THEN** la puntuación del local vuelve a 0
### Requirement: Identidad anónima con huella corta
El sistema SHALL identificar a quien reseña mediante un identificador de dispositivo aleatorio (sin datos personales) y SHALL mostrar cada reseña como "Anónimo" seguida de una huella corta estable por local (derivada del identificador de dispositivo y del local, no reversible y no rastreable entre locales) junto a su fecha.
#### Scenario: Visualización anónima
- **WHEN** se lista las reseñas de un local
- **THEN** cada reseña se muestra como anónima con su huella corta y su fecha, sin exponer el identificador completo del dispositivo
#### Scenario: Huella estable dentro de un local
- **WHEN** el mismo dispositivo reseña (o edita su reseña en) un local
- **THEN** la huella mostrada es la misma en todas las reseñas de ese local para ese dispositivo
### Requirement: Publicación directa con filtro de palabras
Las reseñas SHALL publicarse inmediatamente al enviarse, aplicando el filtro de palabras prohibidas al comentario; un comentario con palabras no permitidas SHALL rechazarse con el aviso correspondiente.
#### Scenario: Palabra prohibida en el comentario
- **WHEN** se envía una reseña cuyo comentario contiene una palabra no permitida
- **THEN** el servidor responde con error y la reseña no se publica
#### Scenario: Publicación inmediata
- **WHEN** una reseña válida se envía
- **THEN** queda visible en la lista del local sin intervención del administrador
### Requirement: Rate limiting de escrituras
El sistema SHALL limitar la frecuencia de escrituras de reseñas (crear/editar/borrar) por dirección IP, rechazando con error 429 los excesos, como defensa base contra el boicot automatizado.
#### Scenario: Límite excedido
- **WHEN** una misma IP supera el límite de escrituras de reseñas en la ventana configurada
- **THEN** las peticiones adicionales reciben 429 y no modifican datos
### Requirement: Reporte y moderación de reseñas
El sistema SHALL permitir reportar una reseña concreta (reusando el flujo de reportes) y SHALL ofrecer al administrador, bajo el prefijo admin, el listado de reseñas y el borrado de cualquiera de ellas, recalculando la media al borrar.
#### Scenario: Reportar una reseña
- **WHEN** un usuario reporta una reseña de un local
- **THEN** el reporte aparece en la lista de reportes del admin identificado como reporte de esa reseña
#### Scenario: Borrado admin
- **WHEN** el administrador borra una reseña desde el panel
- **THEN** la reseña desaparece y la puntuación del local se recalcula
### Requirement: Sección de reseñas desplegable en la tarjeta del local
La tarjeta de cada local SHALL incluir una sección "Reseñas (N) · ★ media" que al expandirla muestra perezosamente la lista de 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.
#### Scenario: Tarjeta sin expandir
- **WHEN** se muestra la tarjeta de un local
- **THEN** la sección de reseñas aparece plegada con el número de reseñas y la media
#### 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