diff --git a/openspec/changes/hide-admin-route/.openspec.yaml b/openspec/changes/archive/2026-01-11-hide-admin-route/.openspec.yaml similarity index 100% rename from openspec/changes/hide-admin-route/.openspec.yaml rename to openspec/changes/archive/2026-01-11-hide-admin-route/.openspec.yaml diff --git a/openspec/changes/hide-admin-route/design.md b/openspec/changes/archive/2026-01-11-hide-admin-route/design.md similarity index 100% rename from openspec/changes/hide-admin-route/design.md rename to openspec/changes/archive/2026-01-11-hide-admin-route/design.md diff --git a/openspec/changes/hide-admin-route/proposal.md b/openspec/changes/archive/2026-01-11-hide-admin-route/proposal.md similarity index 100% rename from openspec/changes/hide-admin-route/proposal.md rename to openspec/changes/archive/2026-01-11-hide-admin-route/proposal.md diff --git a/openspec/changes/hide-admin-route/specs/route-obfuscation/spec.md b/openspec/changes/archive/2026-01-11-hide-admin-route/specs/route-obfuscation/spec.md similarity index 100% rename from openspec/changes/hide-admin-route/specs/route-obfuscation/spec.md rename to openspec/changes/archive/2026-01-11-hide-admin-route/specs/route-obfuscation/spec.md diff --git a/openspec/changes/hide-admin-route/tasks.md b/openspec/changes/archive/2026-01-11-hide-admin-route/tasks.md similarity index 100% rename from openspec/changes/hide-admin-route/tasks.md rename to openspec/changes/archive/2026-01-11-hide-admin-route/tasks.md diff --git a/openspec/changes/pasarela-descripcion-opcional/.openspec.yaml b/openspec/changes/pasarela-descripcion-opcional/.openspec.yaml new file mode 100644 index 0000000..a369219 --- /dev/null +++ b/openspec/changes/pasarela-descripcion-opcional/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-10-11 diff --git a/openspec/changes/pasarela-descripcion-opcional/design.md b/openspec/changes/pasarela-descripcion-opcional/design.md new file mode 100644 index 0000000..c17f89d --- /dev/null +++ b/openspec/changes/pasarela-descripcion-opcional/design.md @@ -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). diff --git a/openspec/changes/pasarela-descripcion-opcional/proposal.md b/openspec/changes/pasarela-descripcion-opcional/proposal.md new file mode 100644 index 0000000..9905688 --- /dev/null +++ b/openspec/changes/pasarela-descripcion-opcional/proposal.md @@ -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. diff --git a/openspec/changes/pasarela-descripcion-opcional/specs/pasarela-proponer-local/spec.md b/openspec/changes/pasarela-descripcion-opcional/specs/pasarela-proponer-local/spec.md new file mode 100644 index 0000000..12026f7 --- /dev/null +++ b/openspec/changes/pasarela-descripcion-opcional/specs/pasarela-proponer-local/spec.md @@ -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 diff --git a/openspec/changes/pasarela-descripcion-opcional/tasks.md b/openspec/changes/pasarela-descripcion-opcional/tasks.md new file mode 100644 index 0000000..3c5aeb1 --- /dev/null +++ b/openspec/changes/pasarela-descripcion-opcional/tasks.md @@ -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 diff --git a/src/App.jsx b/src/App.jsx index 96caf4d..0802c0e 100644 --- a/src/App.jsx +++ b/src/App.jsx @@ -14,7 +14,7 @@ import useFavoritos from "./hooks/useFavoritos.js"; import useUbicacion from "./hooks/useUbicacion.js"; const FORM_VACIO = { - nombre: "", provincia: "", categoria: "", subcategoria: "", + nombre: "", provincia: "", categoria: "", subcategoria: "", descripcion: "", direccion: "", enlaceGoogleMaps: "", lat: null, lng: null, entradaUbicacion: "", proveedorUbicacion: "", // estado interno del paso de ubicación, no se envía }; @@ -104,6 +104,8 @@ export default function App() { await enviarPropuesta({ nombre: form.nombre, provincia: form.provincia, 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, lat, lng, }); @@ -123,9 +125,9 @@ export default function App() { setErrorFiltro(""); setPosibleDuplicado(null); // Comprobar filtro de palabras - const textoCompleto = [form.nombre, form.direccion].join(" "); + const textoCompleto = [form.nombre, form.direccion, form.descripcion].join(" "); 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; } diff --git a/src/components/ModalPasarela.jsx b/src/components/ModalPasarela.jsx index 0fc2bcc..35a5c54 100644 --- a/src/components/ModalPasarela.jsx +++ b/src/components/ModalPasarela.jsx @@ -4,6 +4,7 @@ import PasoUbicacion from "./PasoUbicacion.jsx"; import PasoDatosLocal from "./PasoDatosLocal.jsx"; import PasoCategoria from "./PasoCategoria.jsx"; import PasoSubcategoria from "./PasoSubcategoria.jsx"; +import PasoDescripcion from "./PasoDescripcion.jsx"; import PasoResumen from "./PasoResumen.jsx"; // 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: "categoria", titulo: "Categoría", Componente: PasoCategoria, puedeContinuar: (f) => !!f.categoria }, { 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 }, ]; diff --git a/src/components/PasoDescripcion.jsx b/src/components/PasoDescripcion.jsx new file mode 100644 index 0000000..9879608 --- /dev/null +++ b/src/components/PasoDescripcion.jsx @@ -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 ( +
+ +