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.
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
-
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). -
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).
-
Límite
maxLength=200caracteres en el textarea. La columna BD esTEXTsin 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). -
Vacío → ausente, no cadena vacía. Se hace
trim()y si queda""el payload envíaundefined(JSON lo omite): la BD guarda NULL y todas las vistas (descripcion && …) siguen funcionando sin cambios. Si hay texto, se envía recortado. -
Filtro de palabras prohibidas cubre la descripción. En
enviarLocal,textoCompletopasa a incluirform.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. -
puedeContinuar: () => truecomo enPasoSubcategoria: 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=200y 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.jsxyPasosFormulario.spec.jsxen 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).