feat(pasarela): campo opcional de descripción en la pasarela de proponer local
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.
This commit is contained in:
2026-10-11 15:04:37 +02:00
parent 695d59d31e
commit d34ebf7ca0
18 changed files with 350 additions and 10 deletions
@@ -0,0 +1,38 @@
# Tasks: Campo opcional de descripción en la pasarela
> Cambio frontend-only: backend, BD y visualización ya soportan
> `descripcion` de punta a punta (ver propuesta y design).
> **Estado:** implementado y verificado. `./node_modules/.bin/vitest run` →
> **114/114 en verde** (16 ficheros), con 5 tests nuevos: 2 de
> `PasoDescripcion`, 1 de navegación/conservación en `ModalPasarela`, 1 de la
> fila de resumen en `PasoResumen` y 1 e2e de rutas (propuesta con
> descripción → pendientes → aprobar → local publicado). El README no
> documenta las pantallas de la pasarela (5.2 N/A).
## 1. Estado del formulario y envío (src/App.jsx)
- [x] 1.1 Añadir `descripcion: ""` a `FORM_VACIO`
- [x] 1.2 En `guardarPropuesta`, incluir `descripcion` en el payload de `enviarPropuesta`: `trim()` y si queda vacía enviar `undefined` (ausente, no cadena vacía)
- [x] 1.3 En `enviarLocal`, incluir `form.descripcion` en `textoCompleto` del chequeo de palabras prohibidas y actualizar el mensaje del aviso para que mencione también la descripción
## 2. Nueva pantalla Descripción (paso opcional)
- [x] 2.1 Crear `src/components/PasoDescripcion.jsx` siguiendo el patrón de `PasoSubcategoria.jsx`: `label` + `textarea` con `maxLength=200`, `inputStyle` de `styles/shared.js`, nota "Paso opcional: puedes continuar sin escribir descripción"
- [x] 2.2 Registrar el paso en `PASOS` (`ModalPasarela.jsx`) entre `subcategoria` y `resumen`, con `puedeContinuar: () => true`
## 3. Resumen previo al envío (PasoResumen.jsx)
- [x] 3.1 Añadir la fila "💬 Descripción" al resumen, entre Tipo específico y el cierre de la tarjeta: texto recortado si existe, "—" en gris terciario si está vacía (mismo patrón que Tipo específico); la fila de Tipo específico deja de ser la última sin borde
## 4. Tests
- [x] 4.1 `tests/component/PasosFormulario.spec.jsx`: tests del nuevo `PasoDescripcion` (render, escritura en `form.descripcion`, límite 200, nota de opcional)
- [x] 4.2 `tests/component/ModalPasarela.spec.jsx`: actualizar orden/número de pasos (6 pasos, "Paso 5 de 6" en Descripción, avance sin bloqueo con campo vacío)
- [x] 4.3 `tests/component/PasoResumen.spec.jsx`: fila de descripción con texto y con "—" cuando está vacía
- [x] 4.4 Suite completa en verde: `./node_modules/.bin/vitest run` (114/114)
## 5. Cierre
- [x] 5.1 Verificar que el flujo end-to-end queda cubierto sin cambios de servidor: propuesta con descripción → pendiente con descripción (visible en AdminPanel) → aprobar → local publicado con descripción (LocalCard y popup ya la renderizan) — cubierto por el test e2e en `tests/unit/test-routes.spec.js`
- [x] 5.2 Actualizar README si documenta las pantallas de la pasarela — N/A: el README no documenta las pantallas de la pasarela