openspec: archiva pasarela-descripcion-opcional (sync aplicado) y abre resenas-por-local (issue #6)
- spec principal pasarela-proponer-local sincronizado con el delta (descripción opcional, orden de 6 pantallas, filtro sobre descripción) - cambio archivado en archive/2026-10-11-pasarela-descripcion-opcional - nuevo cambio resenas-por-local: reseñas anónimas estilo 4chan, media agregada, publicación directa + reportes, rate-limit (artefactos 4/4)
This commit is contained in:
@@ -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.
|
||||
+53
@@ -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
|
||||
Reference in New Issue
Block a user