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,2 @@
schema: spec-driven
created: 2026-10-11
@@ -0,0 +1,79 @@
# 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).
@@ -0,0 +1,57 @@
# 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.
@@ -0,0 +1,53 @@
# Delta Spec: pasarela-proponer-local
## RENAMED Requirements
- FROM: `### Requirement: Sin campo de comentario ni puntuación`
- TO: `### Requirement: Descripción opcional, sin puntuación`
## MODIFIED Requirements
### Requirement: Orden de las pantallas empezando por Ubicación
La pasarela SHALL presentar las pantallas en este orden: 1) Ubicación, 2) Datos del local (nombre, provincia y dirección inferidos, juntos en una misma pantalla), 3) Categoría, 4) Tipo específico (opcional), 5) Descripción (opcional), 6) Revisión y envío.
#### Scenario: Primera pantalla
- **WHEN** se abre la pasarela
- **THEN** la primera pantalla que se muestra es la de Ubicación
#### Scenario: Tipo específico omitible
- **WHEN** el usuario está en la pantalla de Tipo específico
- **THEN** puede continuar sin seleccionar ninguna subcategoría
#### Scenario: Descripción omitible
- **WHEN** el usuario está en la pantalla de Descripción
- **THEN** puede continuar sin escribir ninguna descripción
### Requirement: Descripción opcional, sin puntuación
La pasarela SHALL incluir un campo opcional de descripción corta (texto multilínea con límite de 200 caracteres) en su propia pantalla; la puntuación SHALL NOT formar parte de la pasarela y la propuesta se envía sin ella.
#### Scenario: Envío con descripción
- **WHEN** el usuario escribe una descripción en la pantalla de Descripción y envía la propuesta
- **THEN** la propuesta se registra con nombre, provincia, categoría, subcategoría, dirección/enlace, coordenadas y descripción, sin puntuación
#### Scenario: Envío sin descripción
- **WHEN** el usuario deja la descripción vacía (solo espacios o nada) y envía la propuesta
- **THEN** la propuesta se registra sin descripción (ausente/NULL), sin puntuación
#### Scenario: Límite de longitud
- **WHEN** el usuario intenta escribir más de 200 caracteres en la descripción
- **THEN** el campo no admite más texto
### Requirement: Validaciones existentes integradas en la pasarela
La pasarela SHALL conservar las validaciones actuales del formulario: filtro de palabras prohibidas (aplicado al nombre, la dirección y la descripción) y comprobación de duplicados, mostrando los avisos dentro del modal.
#### Scenario: Palabra prohibida detectada
- **WHEN** el texto introducido en nombre, dirección o descripción contiene una palabra no permitida
- **THEN** se muestra un aviso dentro del modal y la propuesta no se envía
#### Scenario: Posible duplicado detectado
- **WHEN** al enviar se detecta un local igual o muy cercano
- **THEN** se muestra el aviso de duplicado dentro del modal con las coincidencias y las opciones de enviar de todos modos o revisar los datos
#### Scenario: Envío correcto
- **WHEN** la propuesta se envía con éxito
- **THEN** el modal se cierra y aparece la confirmación de propuesta enviada en la página principal
@@ -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
+5 -3
View File
@@ -14,7 +14,7 @@ import useFavoritos from "./hooks/useFavoritos.js";
import useUbicacion from "./hooks/useUbicacion.js"; import useUbicacion from "./hooks/useUbicacion.js";
const FORM_VACIO = { const FORM_VACIO = {
nombre: "", provincia: "", categoria: "", subcategoria: "", nombre: "", provincia: "", categoria: "", subcategoria: "", descripcion: "",
direccion: "", enlaceGoogleMaps: "", lat: null, lng: null, direccion: "", enlaceGoogleMaps: "", lat: null, lng: null,
entradaUbicacion: "", proveedorUbicacion: "", // estado interno del paso de ubicación, no se envía entradaUbicacion: "", proveedorUbicacion: "", // estado interno del paso de ubicación, no se envía
}; };
@@ -104,6 +104,8 @@ export default function App() {
await enviarPropuesta({ await enviarPropuesta({
nombre: form.nombre, provincia: form.provincia, nombre: form.nombre, provincia: form.provincia,
categoria: form.categoria, subcategoria: form.subcategoria, categoria: form.categoria, subcategoria: form.subcategoria,
// Opcional: vacía (o solo espacios) viaja como ausente → NULL en BD
descripcion: form.descripcion.trim() || undefined,
direccion: form.direccion, enlaceGoogleMaps: form.enlaceGoogleMaps, direccion: form.direccion, enlaceGoogleMaps: form.enlaceGoogleMaps,
lat, lng, lat, lng,
}); });
@@ -123,9 +125,9 @@ export default function App() {
setErrorFiltro(""); setErrorFiltro("");
setPosibleDuplicado(null); setPosibleDuplicado(null);
// Comprobar filtro de palabras // Comprobar filtro de palabras
const textoCompleto = [form.nombre, form.direccion].join(" "); const textoCompleto = [form.nombre, form.direccion, form.descripcion].join(" ");
if (contienepalabrasProhibidas(textoCompleto, palabrasProhibidas)) { if (contienepalabrasProhibidas(textoCompleto, palabrasProhibidas)) {
setErrorFiltro("Tu propuesta contiene palabras no permitidas. Por favor, revisa el nombre o la dirección."); setErrorFiltro("Tu propuesta contiene palabras no permitidas. Por favor, revisa el nombre, la dirección o la descripción.");
return; return;
} }
+2
View File
@@ -4,6 +4,7 @@ import PasoUbicacion from "./PasoUbicacion.jsx";
import PasoDatosLocal from "./PasoDatosLocal.jsx"; import PasoDatosLocal from "./PasoDatosLocal.jsx";
import PasoCategoria from "./PasoCategoria.jsx"; import PasoCategoria from "./PasoCategoria.jsx";
import PasoSubcategoria from "./PasoSubcategoria.jsx"; import PasoSubcategoria from "./PasoSubcategoria.jsx";
import PasoDescripcion from "./PasoDescripcion.jsx";
import PasoResumen from "./PasoResumen.jsx"; import PasoResumen from "./PasoResumen.jsx";
// Definición declarativa de las pantallas de la pasarela: orden, título y // Definición declarativa de las pantallas de la pasarela: orden, título y
@@ -14,6 +15,7 @@ const PASOS = [
{ id: "datos", titulo: "Datos del local", Componente: PasoDatosLocal, puedeContinuar: (f) => (f.nombre || "").trim().length >= 2 && !!f.provincia }, { id: "datos", titulo: "Datos del local", Componente: PasoDatosLocal, puedeContinuar: (f) => (f.nombre || "").trim().length >= 2 && !!f.provincia },
{ id: "categoria", titulo: "Categoría", Componente: PasoCategoria, puedeContinuar: (f) => !!f.categoria }, { id: "categoria", titulo: "Categoría", Componente: PasoCategoria, puedeContinuar: (f) => !!f.categoria },
{ id: "subcategoria", titulo: "Tipo específico", Componente: PasoSubcategoria, puedeContinuar: () => true }, { id: "subcategoria", titulo: "Tipo específico", Componente: PasoSubcategoria, puedeContinuar: () => true },
{ id: "descripcion", titulo: "Descripción", Componente: PasoDescripcion, puedeContinuar: () => true },
{ id: "resumen", titulo: "Revisión y envío", Componente: PasoResumen, puedeContinuar: () => true }, { id: "resumen", titulo: "Revisión y envío", Componente: PasoResumen, puedeContinuar: () => true },
]; ];
+26
View File
@@ -0,0 +1,26 @@
import { inputStyle } from "../styles/shared.js";
// Paso 5 de la pasarela: descripción corta del local, opcional. Se puede
// continuar sin escribir nada. El texto (recortado de espacios) viaja en la
// propuesta: el admin lo ve al revisarla y la ficha pública al aprobarse.
export default function PasoDescripcion({ form, setForm }) {
return (
<div>
<label htmlFor="paso-descripcion" style={{ fontSize: 12, color: "var(--color-text-secondary)", display: "block", marginBottom: 4 }}>
Descripción
</label>
<textarea
id="paso-descripcion"
style={{ ...inputStyle, resize: "vertical", minHeight: 72, fontFamily: "inherit", lineHeight: 1.5 }}
maxLength={200}
rows={3}
value={form.descripcion}
onChange={(e) => setForm((f) => ({ ...f, descripcion: e.target.value }))}
placeholder="Qué se vende, el ambiente, algún detalle que te gustaría contar…"
/>
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: "6px 0 0" }}>
Paso opcional: puedes continuar sin escribir descripción. Máximo 200 caracteres.
</p>
</div>
);
}
+7 -1
View File
@@ -45,12 +45,18 @@ export default function PasoResumen({
<span style={clave}>📂 Categoría</span> <span style={clave}>📂 Categoría</span>
<span style={valor}>{categoria ? `${categoria.emoji} ${form.categoria}` : ""}</span> <span style={valor}>{categoria ? `${categoria.emoji} ${form.categoria}` : ""}</span>
</div> </div>
<div style={{ ...fila, borderBottom: "none" }}> <div style={fila}>
<span style={clave}>🔖 Tipo específico</span> <span style={clave}>🔖 Tipo específico</span>
<span style={{ ...valor, fontWeight: form.subcategoria ? 500 : 400, color: form.subcategoria ? "inherit" : "var(--color-text-tertiary)" }}> <span style={{ ...valor, fontWeight: form.subcategoria ? 500 : 400, color: form.subcategoria ? "inherit" : "var(--color-text-tertiary)" }}>
{form.subcategoria || "—"} {form.subcategoria || "—"}
</span> </span>
</div> </div>
<div style={{ ...fila, borderBottom: "none" }}>
<span style={clave}>💬 Descripción</span>
<span style={{ ...valor, fontWeight: form.descripcion ? 500 : 400, color: form.descripcion ? "inherit" : "var(--color-text-tertiary)", whiteSpace: "pre-line" }}>
{form.descripcion || "—"}
</span>
</div>
</div> </div>
<label style={{ display: "flex", alignItems: "flex-start", gap: 8, marginBottom: 12, fontSize: 12, color: "var(--color-text-secondary)", cursor: "pointer" }}> <label style={{ display: "flex", alignItems: "flex-start", gap: 8, marginBottom: 12, fontSize: 12, color: "var(--color-text-secondary)", cursor: "pointer" }}>
+32 -6
View File
@@ -1,5 +1,6 @@
// @vitest-environment jsdom // @vitest-environment jsdom
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { useState } from "react";
import { cleanup, fireEvent, render, screen } from "@testing-library/react"; import { cleanup, fireEvent, render, screen } from "@testing-library/react";
import ModalPasarela from "../../src/components/ModalPasarela.jsx"; import ModalPasarela from "../../src/components/ModalPasarela.jsx";
@@ -9,7 +10,7 @@ beforeEach(() => {
afterEach(cleanup); afterEach(cleanup);
const FORM_VACIO = { const FORM_VACIO = {
nombre: "", provincia: "", categoria: "", subcategoria: "", nombre: "", provincia: "", categoria: "", subcategoria: "", descripcion: "",
direccion: "", enlaceGoogleMaps: "", lat: null, lng: null, direccion: "", enlaceGoogleMaps: "", lat: null, lng: null,
entradaUbicacion: "", proveedorUbicacion: "", entradaUbicacion: "", proveedorUbicacion: "",
}; };
@@ -42,13 +43,13 @@ const propsBase = {
const siguiente = () => screen.getByRole("button", { name: "Siguiente" }); const siguiente = () => screen.getByRole("button", { name: "Siguiente" });
describe("ModalPasarela", () => { describe("ModalPasarela", () => {
it("arranca en la pantalla de Ubicación con las 5 pantallas declaradas", () => { it("arranca en la pantalla de Ubicación con las 6 pantallas declaradas", () => {
render(<ModalPasarela {...propsBase} form={FORM_VACIO} />); render(<ModalPasarela {...propsBase} form={FORM_VACIO} />);
expect(screen.getByLabelText(/ubicación del local/i)).toBeTruthy(); expect(screen.getByLabelText(/ubicación del local/i)).toBeTruthy();
expect(screen.getByText(/paso 1 de 5/i)).toBeTruthy(); expect(screen.getByText(/paso 1 de 6/i)).toBeTruthy();
// indicador de progreso: 5 barras // indicador de progreso: 6 barras
const barras = document.querySelectorAll('[aria-hidden="true"] span[style*="width: 16px"]'); const barras = document.querySelectorAll('[aria-hidden="true"] span[style*="width: 16px"]');
expect(barras.length).toBe(5); expect(barras.length).toBe(6);
}); });
it("Siguiente deshabilitado sin resolución de ubicación válida", () => { it("Siguiente deshabilitado sin resolución de ubicación válida", () => {
@@ -107,8 +108,33 @@ describe("ModalPasarela", () => {
it("en el paso final muestra el resumen con su propio botón de envío", () => { it("en el paso final muestra el resumen con su propio botón de envío", () => {
render(<ModalPasarela {...propsBase} form={FORM_RESUELTO} />); render(<ModalPasarela {...propsBase} form={FORM_RESUELTO} />);
for (let i = 0; i < 4; i++) fireEvent.click(siguiente()); for (let i = 0; i < 5; i++) fireEvent.click(siguiente());
expect(screen.getByRole("button", { name: /enviar propuesta/i })).toBeTruthy(); expect(screen.getByRole("button", { name: /enviar propuesta/i })).toBeTruthy();
expect(screen.queryByRole("button", { name: "Siguiente" })).toBeNull(); expect(screen.queryByRole("button", { name: "Siguiente" })).toBeNull();
}); });
it("Descripción es el paso 5 de 6: opcional (no bloquea) y conserva el texto al volver", () => {
// El form lo controla el padre (App.jsx): harness con useState real para
// comprobar que lo escrito sobrevive a la navegación atrás/siguiente.
const estado = { form: FORM_RESUELTO };
function Wrapper() {
const [form, setForm] = useState(FORM_RESUELTO);
estado.form = form;
return <ModalPasarela {...propsBase} form={form} setForm={setForm} />;
}
render(<Wrapper />);
for (let i = 0; i < 4; i++) fireEvent.click(siguiente());
expect(screen.getByText(/paso 5 de 6/i)).toBeTruthy();
// vacía no bloquea el avance
expect(siguiente().disabled).toBe(false);
// escribir y volver atrás conserva el texto
fireEvent.change(screen.getByLabelText(/^descripción$/i), { target: { value: "Cafetería clásica de barrio" } });
expect(estado.form.descripcion).toBe("Cafetería clásica de barrio");
fireEvent.click(screen.getByRole("button", { name: /atrás/i }));
expect(screen.getByLabelText(/^tipo específico$/i)).toBeTruthy();
fireEvent.click(siguiente());
expect(screen.getByLabelText(/^descripción$/i).value).toBe("Cafetería clásica de barrio");
});
}); });
+8
View File
@@ -10,6 +10,7 @@ afterEach(cleanup);
const FORM_BASE = { const FORM_BASE = {
nombre: "Bar El Olivo", provincia: "Madrid", categoria: "Restauración", subcategoria: "Tapas y raciones", nombre: "Bar El Olivo", provincia: "Madrid", categoria: "Restauración", subcategoria: "Tapas y raciones",
descripcion: "Cafetería clásica de barrio",
direccion: "Calle Mayor 5, Madrid", enlaceGoogleMaps: "", lat: 40.4168, lng: -3.7038, direccion: "Calle Mayor 5, Madrid", enlaceGoogleMaps: "", lat: 40.4168, lng: -3.7038,
entradaUbicacion: "40.4168, -3.7038", proveedorUbicacion: "coordenadas", entradaUbicacion: "40.4168, -3.7038", proveedorUbicacion: "coordenadas",
}; };
@@ -35,10 +36,17 @@ describe("PasoResumen", () => {
expect(screen.getByText("Madrid")).toBeTruthy(); expect(screen.getByText("Madrid")).toBeTruthy();
expect(screen.getByText(/🍽️ Restauración/)).toBeTruthy(); expect(screen.getByText(/🍽️ Restauración/)).toBeTruthy();
expect(screen.getByText("Tapas y raciones")).toBeTruthy(); expect(screen.getByText("Tapas y raciones")).toBeTruthy();
expect(screen.getByText("Cafetería clásica de barrio")).toBeTruthy();
expect(screen.getByText("Calle Mayor 5, Madrid")).toBeTruthy(); expect(screen.getByText("Calle Mayor 5, Madrid")).toBeTruthy();
expect(screen.getByText(/Coordenadas/)).toBeTruthy(); expect(screen.getByText(/Coordenadas/)).toBeTruthy();
}); });
it("sin descripción muestra «—» en gris en su fila (opcional)", () => {
render(<PasoResumen {...propsBase} form={{ ...FORM_BASE, descripcion: "" }} />);
const filaDescripcion = screen.getByText(/descripción/i).closest("div");
expect(filaDescripcion.textContent).toContain("—");
});
it("botón de envío deshabilitado sin aceptar la privacidad", () => { it("botón de envío deshabilitado sin aceptar la privacidad", () => {
render(<PasoResumen {...propsBase} />); render(<PasoResumen {...propsBase} />);
const boton = screen.getByRole("button", { name: /enviar propuesta/i }); const boton = screen.getByRole("button", { name: /enviar propuesta/i });
+19
View File
@@ -5,6 +5,7 @@ import { cleanup, fireEvent, render, screen } from "@testing-library/react";
import PasoDatosLocal from "../../src/components/PasoDatosLocal.jsx"; import PasoDatosLocal from "../../src/components/PasoDatosLocal.jsx";
import PasoCategoria from "../../src/components/PasoCategoria.jsx"; import PasoCategoria from "../../src/components/PasoCategoria.jsx";
import PasoSubcategoria from "../../src/components/PasoSubcategoria.jsx"; import PasoSubcategoria from "../../src/components/PasoSubcategoria.jsx";
import PasoDescripcion from "../../src/components/PasoDescripcion.jsx";
import { PROVINCIAS } from "../../src/constants/provincias.js"; import { PROVINCIAS } from "../../src/constants/provincias.js";
import { CATEGORIAS, NOMBRES_CATEGORIAS } from "../../src/constants/categorias.js"; import { CATEGORIAS, NOMBRES_CATEGORIAS } from "../../src/constants/categorias.js";
@@ -84,3 +85,21 @@ describe("PasoSubcategoria", () => {
expect(opciones).toEqual(["", ...CATEGORIAS["Restauración"].subcategorias]); expect(opciones).toEqual(["", ...CATEGORIAS["Restauración"].subcategorias]);
}); });
}); });
describe("PasoDescripcion", () => {
it("escribe en form.descripcion con límite de 200 caracteres y avisa de que es opcional", () => {
const estado = renderPaso(PasoDescripcion, { descripcion: "" });
const area = screen.getByLabelText(/^descripción$/i);
expect(area.maxLength).toBe(200);
expect(screen.getByText(/paso opcional: puedes continuar sin escribir descripción/i)).toBeTruthy();
fireEvent.change(area, { target: { value: "Cafetería clásica de barrio" } });
expect(estado.form.descripcion).toBe("Cafetería clásica de barrio");
});
it("arranca vacío y con placeholder sugerente", () => {
renderPaso(PasoDescripcion, { descripcion: "" });
expect(screen.getByLabelText(/^descripción$/i).value).toBe("");
expect(screen.getByPlaceholderText(/qué se vende/i)).toBeTruthy();
});
});
+22
View File
@@ -89,6 +89,28 @@ describe("Rutas admin bajo el prefijo configurable — funcionan", () => {
expect(despues.some((p) => p.id === propuesta.id)).toBe(false); expect(despues.some((p) => p.id === propuesta.id)).toBe(false);
}); });
it("descripcion opcional: propuesta con descripcion → pendientes → local publicado", async () => {
const creada = await request(server)
.post("/api/propuestas")
.send({
nombre: "Bar Con Descripcion", provincia: "Valencia",
categoria: "Restauración", descripcion: "Cafetería clásica de barrio",
})
.expect(201);
expect(creada.body.descripcion).toBe("Cafetería clásica de barrio");
// el admin la ve al revisar la propuesta pendiente
const pendientes = (await request(server).get(`${PREFIX}/pendientes`)).body;
const pendiente = pendientes.find((p) => p.id === creada.body.id);
expect(pendiente.descripcion).toBe("Cafetería clásica de barrio");
// al aprobar, la descripcion viaja al local publicado (nuevo uuid)
await request(server).post(`${PREFIX}/aprobar/${creada.body.id}`).expect(200);
const locales = (await request(server).get("/api/locales")).body;
const local = locales.find((l) => l.nombre === "Bar Con Descripcion");
expect(local.descripcion).toBe("Cafetería clásica de barrio");
});
it("POST $PREFIX/rechazar/:id → elimina la propuesta pendiente", async () => { it("POST $PREFIX/rechazar/:id → elimina la propuesta pendiente", async () => {
const creada = await request(server) const creada = await request(server)
.post("/api/propuestas") .post("/api/propuestas")