Files
localesp/openspec/changes/pasarela-descripcion-opcional/proposal.md
T
edgar.friendly d34ebf7ca0
deploy-branch / deploy (push) Successful in 3m11s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m27s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m0s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
feat(pasarela): campo opcional de descripción en la pasarela de proponer local
Nueva pantalla "Descripción" (paso 5 de 6, opcional, máx. 200 caracteres)
entre Tipo específico y Revisión. La descripción viaja en la propuesta
(trim; vacía → ausente/NULL), el filtro de palabras prohibidas la cubre y
el resumen la muestra. Backend/BD ya la soportaban: cambio frontend-only.

Incluye el archivo del cambio hide-admin-route y la propuesta
openspec del nuevo cambio. Suite: 114/114.
2026-10-11 15:04:37 +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.