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

2.7 KiB

Proposal: Campo opcional de descripción en la pasarela

Why

La pasarela de proponer local no permite añadir ningún contexto sobre el local (requisito vigente que lo prohíbe expresamente). Una descripción corta y opcional enriquece la propuesta: quien propone puede explicar qué se vende, el ambiente o algún detalle, el administrador la ve al revisar la propuesta y la ficha pública la muestra. Todo el circuito de datos ya existe y funciona — columna descripcion en pendientes y locales, POST /api/propuestas la persiste, al aprobar se copia, y AdminPanel, LocalCard y el popup del mapa la renderizan si está presente—; solo falta recogerla en la pasarela y enviarla.

What Changes

  • Nueva pantalla opcional Descripción en la pasarela, entre "Tipo específico" y "Revisión y envío": un textarea saltable (se puede continuar sin escribir nada), igual que el paso de tipo específico.
  • El payload de POST /api/propuestas pasa a incluir descripcion (recortada de espacios; vacía se envía como ausente). Sin cambios de servidor ni de BD: ya la aceptan, persisten y propagan.
  • El filtro de palabras prohibidas se aplica también al texto de la descripción (es texto libre, como nombre y dirección).
  • El paso de "Revisión y envío" (PasoResumen) muestra la descripción en el resumen (con "—" si se dejó vacía).
  • El indicador de progreso pasa de 5 a 6 puntos (deriva de PASOS.length, sin código extra).

Capabilities

New Capabilities

(ninguna)

Modified Capabilities

  • pasarela-proponer-local: el requisito "Sin campo de comentario ni puntuación" se relaja: ahora la pasarela incluye una descripción corta opcional y sigue sin incluir puntuación. El orden de pantallas añade el paso opcional de descripción, la validación de palabras prohibidas cubre la descripción y el resumen la muestra.

Impact

  • Frontend (única zona tocada):
    • src/components/ModalPasarela.jsx: nuevo paso en PASOS.
    • Nuevo src/components/PasoDescripcion.jsx (patrón de PasoSubcategoria).
    • src/components/PasoResumen.jsx: fila de descripción en el resumen.
    • src/App.jsx: FORM_VACIO añade descripcion: "", guardarPropuesta la incluye en el payload, enviarLocal la incluye en el chequeo del filtro de palabras.
  • Tests: tests/component/ModalPasarela.spec.jsx, tests/component/PasoResumen.spec.jsx, tests/component/PasosFormulario.spec.jsx (nuevo paso y fila de resumen).
  • Backend / BD: sin cambios (soporte completo ya existente).
  • Fuera de alcance: src/AppMovil.jsx es legacy (no lo monta main.jsx) y conserva su propio formulario con descripción; no se toca.