Files
edgar.friendly dd6febf8b0 openspec: archiva pasarela-descripcion-opcional (sync aplicado) y abre resenas-por-local (issue #6)
- spec principal pasarela-proponer-local sincronizado con el delta
  (descripción opcional, orden de 6 pantallas, filtro sobre descripción)
- cambio archivado en archive/2026-10-11-pasarela-descripcion-opcional
- nuevo cambio resenas-por-local: reseñas anónimas estilo 4chan, media
  agregada, publicación directa + reportes, rate-limit (artefactos 4/4)
2026-10-11 15:45:57 +02:00

6.3 KiB

Pasarela de propuesta de local

Purpose

Experiencia guiada (wizard) en un modal para proponer un local con un solo campo por pantalla —empezando por la ubicación con autodetección del proveedor e inferencia de nombre/provincia—, con una descripción corta opcional y sin campo de puntuación, conservando las validaciones existentes (palabras prohibidas sobre nombre, dirección y descripción, duplicados, privacidad obligatoria).

Requirements

Requirement: Pasarela paso a paso en un modal

El sistema SHALL presentar la propuesta de un local como una pasarela (wizard) dentro de un modal, con un solo campo por pantalla, navegación atrás/siguiente e indicador de progreso.

Scenario: Una pantalla por campo

  • WHEN la pasarela está abierta
  • THEN cada pantalla muestra únicamente el campo correspondiente al paso actual, con botones para avanzar y retroceder

Scenario: Navegación hacia atrás

  • WHEN el usuario pulsa "Atrás" en una pantalla intermedia
  • THEN vuelve a la pantalla anterior conservando los datos ya introducidos

Scenario: Avance bloqueado sin dato válido

  • WHEN el campo de la pantalla actual está vacío o es inválido
  • THEN el botón "Siguiente" está deshabilitado y la pantalla no avanza

Scenario: Cierre del modal

  • WHEN el usuario cierra el modal (botón ✕, botón Cancelar o tecla Escape)
  • THEN la pasarela se cierra y se descarta el borrador en curso

Requirement: Orden de las pantallas empezando por Ubicación

La pasarela SHALL presentar las pantallas en este orden: 1) Ubicación, 2) Datos del local (nombre, provincia y dirección inferidos, juntos en una misma pantalla), 3) Categoría, 4) Tipo específico (opcional), 5) Descripción (opcional), 6) Revisión y envío.

Scenario: Primera pantalla

  • WHEN se abre la pasarela
  • THEN la primera pantalla que se muestra es la de Ubicación

Scenario: Tipo específico omitible

  • WHEN el usuario está en la pantalla de Tipo específico
  • THEN puede continuar sin seleccionar ninguna subcategoría

Scenario: Descripción omitible

  • WHEN el usuario está en la pantalla de Descripción
  • THEN puede continuar sin escribir ninguna descripción

Requirement: Inferencia de Nombre, Provincia y Dirección desde la Ubicación

El sistema SHALL pre-rellenar los campos Nombre, Provincia y Dirección a partir de la ubicación introducida en la primera pantalla (geocodificación inversa), mostrándolos juntos en la pantalla de Datos del local y permitiendo al usuario corregirlos (incluida la dirección).

Scenario: Datos pre-rellenados en su pantalla conjunta

  • WHEN el usuario introduce una ubicación válida en la primera pantalla y esta se resuelve con éxito
  • THEN al llegar a la pantalla de Datos del local los campos nombre, provincia y dirección aparecen pre-rellenados con los valores inferidos

Scenario: Valores corregibles

  • WHEN los valores inferidos no son correctos
  • THEN el usuario puede editarlos libremente antes de enviar

Scenario: Degradación sin inferencia

  • WHEN la inferencia falla o devuelve campos vacíos
  • THEN la pantalla de Datos del local aparece vacía y el usuario la rellena manualmente, sin bloquear la pasarela

Requirement: Descripción opcional, sin puntuación

La pasarela SHALL incluir un campo opcional de descripción corta (texto multilínea con límite de 200 caracteres) en su propia pantalla; la puntuación SHALL NOT formar parte de la pasarela y la propuesta se envía sin ella.

Scenario: Envío con descripción

  • WHEN el usuario escribe una descripción en la pantalla de Descripción y envía la propuesta
  • THEN la propuesta se registra con nombre, provincia, categoría, subcategoría, dirección/enlace, coordenadas y descripción, sin puntuación

Scenario: Envío sin descripción

  • WHEN el usuario deja la descripción vacía (solo espacios o nada) y envía la propuesta
  • THEN la propuesta se registra sin descripción (ausente/NULL), sin puntuación

Scenario: Límite de longitud

  • WHEN el usuario intenta escribir más de 200 caracteres en la descripción
  • THEN el campo no admite más texto

Requirement: Revisión y aceptación de privacidad antes de enviar

La última pantalla de la pasarela SHALL mostrar un resumen de los datos introducidos y el checkbox de aceptación de la política de privacidad, siendo este último obligatorio para enviar.

Scenario: Envío bloqueado sin aceptar privacidad

  • WHEN el usuario llega a la pantalla final sin marcar la casilla de privacidad
  • THEN el botón de envío está deshabilitado hasta que la marque

Scenario: Resumen antes de enviar

  • WHEN el usuario llega a la pantalla final
  • THEN ve un resumen legible de todos los datos introducidos con posibilidad de volver atrás a corregirlos

Requirement: Validaciones existentes integradas en la pasarela

La pasarela SHALL conservar las validaciones actuales del formulario: filtro de palabras prohibidas (aplicado al nombre, la dirección y la descripción) y comprobación de duplicados, mostrando los avisos dentro del modal.

Scenario: Palabra prohibida detectada

  • WHEN el texto introducido en nombre, dirección o descripción contiene una palabra no permitida
  • THEN se muestra un aviso dentro del modal y la propuesta no se envía

Scenario: Posible duplicado detectado

  • WHEN al enviar se detecta un local igual o muy cercano
  • THEN se muestra el aviso de duplicado dentro del modal con las coincidencias y las opciones de enviar de todos modos o revisar los datos

Scenario: Envío correcto

  • WHEN la propuesta se envía con éxito
  • THEN el modal se cierra y aparece la confirmación de propuesta enviada en la página principal

Requirement: Modal responsive accesible

El modal de la pasarela SHALL ser usable en PC (diálogo centrado) y móvil (ocupando prácticamente toda la pantalla), con foco contenido y cierre mediante Escape.

Scenario: Uso en móvil

  • WHEN la pasarela se abre en una pantalla estrecha
  • THEN el modal ocupa el ancho completo y es operativo con teclado y scroll táctil

Scenario: Foco contenido en el modal

  • WHEN el modal está abierto
  • THEN el foco de teclado permanece dentro del modal y la tecla Escape lo cierra