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

58 lines
2.7 KiB
Markdown

# 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.