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