Files
localesp/openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/design.md
T
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

3.8 KiB

Design: Campo opcional de descripción en la pasarela

Context

La pasarela (ModalPasarela) es un wizard declarativo: PASOS define orden, título, componente y puedeContinuar. Los pasos opcionales ya tienen patrón (PasoSubcategoria). El backend y la BD soportan descripcion de punta a punta (columna en pendientes/locales, se persiste en POST /api/propuestas, se copia al aprobar, y AdminPanel/LocalCard/popup la muestran si existe). El spec vigente prohíbe el campo; este cambio lo convierte en opcional. AppMovil.jsx es legacy (no lo monta main.jsx) y tiene su propio formulario; no se toca.

Goals / Non-Goals

Goals:

  • Recoger una descripción corta opcional en la pasarela y enviarla al backend.
  • Mantener la filosofía "un campo por pantalla" y el patrón de paso opcional.
  • Cubrir la descripción con el filtro de palabras prohibidas existente.
  • Mostrar la descripción en el resumen previo al envío.

Non-Goals:

  • No tocar backend, BD ni endpoints (ya soportan descripcion).
  • No añadir puntuación/valoración (sigue excluida).
  • No editar descripciones desde el panel admin.
  • No tocar AppMovil.jsx (legacy).

Decisions

  1. Pantalla propia en lugar de añadir el textarea a "Datos del local". La pasarela es "un campo por pantalla"; la pantalla de Datos ya agrupa nombre+provincia+dirección por inferencia de ubicación, y mezclar allí una descripción larga rompería su propósito (corregir inferencias). Una pantalla propia, saltable, es coherente con PasoSubcategoria. Alternativa descartada: campo en "Datos del local" (más rápido pero contradice el diseño del wizard y ensucia la inferencia).

  2. Posición: entre "Tipo específico" y "Revisión y envío". Los dos pasos opcionales quedan consecutivos justo antes de revisar; el orden obligatorio (ubicación → datos → categoría) no cambia y el resumen sigue siendo el destino final. Alternativa descartada: tras "Datos del local" (separaría los opcionales y añadiría fricción antes de elegir categoría).

  3. Límite maxLength=200 caracteres en el textarea. La columna BD es TEXT sin límite; un tope en UI es defensa razonable contra texto-abuso sin tocar el servidor, coherente con una "descripción corta". Sin contador visible (el límite lo impone el propio control). Alternativa descartada: sin límite (deja la puerta abierta a textos enormes con ninguna utilidad en una ficha).

  4. Vacío → ausente, no cadena vacía. Se hace trim() y si queda "" el payload envía undefined (JSON lo omite): la BD guarda NULL y todas las vistas (descripcion && …) siguen funcionando sin cambios. Si hay texto, se envía recortado.

  5. Filtro de palabras prohibidas cubre la descripción. En enviarLocal, textoCompleto pasa a incluir form.descripcion, y el mensaje de aviso menciona también la descripción. Es texto libre publicado (tras revisión), mismo tratamiento que nombre y dirección.

  6. puedeContinuar: () => true como en PasoSubcategoria: el paso nunca bloquea el avance.

Risks / Trade-offs

  • [Más superficie de texto libre → SPAM/contenido inapropiado] → Mitigado por el filtro de palabras prohibidas, maxLength=200 y la revisión humana del admin antes de publicar (la descripción de un local publicado solo llega vía aprobación).
  • [Tests de componentes asumen 5 pasos y orden fijo] → Actualizar ModalPasarela.spec.jsx, PasoResumen.spec.jsx y PasosFormulario.spec.jsx en el mismo cambio; suite debe quedar en verde.
  • [Mensaje de filtro desactualizado si solo se amplía el chequeo] → El texto del aviso se actualiza para nombrar la descripción.

Migration Plan

Cambio puramente frontend y aditivo: desplegar y ya. Rollback = revert del commit; las propuestas existentes sin descripción siguen válidas (NULL).