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
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.
80 lines
3.8 KiB
Markdown
80 lines
3.8 KiB
Markdown
# 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).
|