From dd6febf8b05955b8518c671bfaee2f50a3609dfa Mon Sep 17 00:00:00 2001 From: Edgar Friendly Date: Sun, 11 Oct 2026 15:45:57 +0200 Subject: [PATCH] openspec: archiva pasarela-descripcion-opcional (sync aplicado) y abre resenas-por-local (issue #6) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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) --- .../.openspec.yaml | 0 .../design.md | 0 .../proposal.md | 0 .../specs/pasarela-proponer-local/spec.md | 0 .../tasks.md | 0 .../changes/resenas-por-local/.openspec.yaml | 2 + openspec/changes/resenas-por-local/design.md | 141 ++++++++++++++++++ .../changes/resenas-por-local/proposal.md | 69 +++++++++ .../specs/resenas-por-local/spec.md | 95 ++++++++++++ openspec/changes/resenas-por-local/tasks.md | 42 ++++++ .../specs/pasarela-proponer-local/spec.md | 30 ++-- 11 files changed, 370 insertions(+), 9 deletions(-) rename openspec/changes/{pasarela-descripcion-opcional => archive/2026-10-11-pasarela-descripcion-opcional}/.openspec.yaml (100%) rename openspec/changes/{pasarela-descripcion-opcional => archive/2026-10-11-pasarela-descripcion-opcional}/design.md (100%) rename openspec/changes/{pasarela-descripcion-opcional => archive/2026-10-11-pasarela-descripcion-opcional}/proposal.md (100%) rename openspec/changes/{pasarela-descripcion-opcional => archive/2026-10-11-pasarela-descripcion-opcional}/specs/pasarela-proponer-local/spec.md (100%) rename openspec/changes/{pasarela-descripcion-opcional => archive/2026-10-11-pasarela-descripcion-opcional}/tasks.md (100%) create mode 100644 openspec/changes/resenas-por-local/.openspec.yaml create mode 100644 openspec/changes/resenas-por-local/design.md create mode 100644 openspec/changes/resenas-por-local/proposal.md create mode 100644 openspec/changes/resenas-por-local/specs/resenas-por-local/spec.md create mode 100644 openspec/changes/resenas-por-local/tasks.md diff --git a/openspec/changes/pasarela-descripcion-opcional/.openspec.yaml b/openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/.openspec.yaml similarity index 100% rename from openspec/changes/pasarela-descripcion-opcional/.openspec.yaml rename to openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/.openspec.yaml diff --git a/openspec/changes/pasarela-descripcion-opcional/design.md b/openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/design.md similarity index 100% rename from openspec/changes/pasarela-descripcion-opcional/design.md rename to openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/design.md diff --git a/openspec/changes/pasarela-descripcion-opcional/proposal.md b/openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/proposal.md similarity index 100% rename from openspec/changes/pasarela-descripcion-opcional/proposal.md rename to openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/proposal.md diff --git a/openspec/changes/pasarela-descripcion-opcional/specs/pasarela-proponer-local/spec.md b/openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/specs/pasarela-proponer-local/spec.md similarity index 100% rename from openspec/changes/pasarela-descripcion-opcional/specs/pasarela-proponer-local/spec.md rename to openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/specs/pasarela-proponer-local/spec.md diff --git a/openspec/changes/pasarela-descripcion-opcional/tasks.md b/openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/tasks.md similarity index 100% rename from openspec/changes/pasarela-descripcion-opcional/tasks.md rename to openspec/changes/archive/2026-10-11-pasarela-descripcion-opcional/tasks.md diff --git a/openspec/changes/resenas-por-local/.openspec.yaml b/openspec/changes/resenas-por-local/.openspec.yaml new file mode 100644 index 0000000..a369219 --- /dev/null +++ b/openspec/changes/resenas-por-local/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-10-11 diff --git a/openspec/changes/resenas-por-local/design.md b/openspec/changes/resenas-por-local/design.md new file mode 100644 index 0000000..1484484 --- /dev/null +++ b/openspec/changes/resenas-por-local/design.md @@ -0,0 +1,141 @@ +# Design: Reseñas múltiples por local (issue #6) + +## Context + +La issue #6 pide comentarios y valoraciones múltiples por local (una reseña +por usuario, editable). Entrevista con el usuario (2026-10-11): + +- **Identidad v1: anónima estilo 4chan** — huella de dispositivo, sin + cuentas; "ya añadiremos cuentas". Preocupación explícita: boicots y DDoS. +- **UI: sección desplegable en la propia tarjeta** del local. +- **Display del reseñador: "Anónimo" con inicial/huella** + fecha. +- **Modelo de datos: tabla `resenas` + media agregada en `locales.puntuacion`** + (elegido en la primera ronda de entrevista). +- **Moderación: publicación directa + reportes** (como el flujo actual de + reportes de locales). + +Estado actual: sin autenticación alguna (tabla `users` vacía de código); +`locales.puntuacion` es un entero único casi siempre 0 (estrellas read-only +en `LocalCard`, media global y orden "★ Mejor" en `App.jsx`); `reportes` +tiene flujo admin completo (listar/descartar); filtro de palabras +centralizado en `config.filtro_palabras`. + +## Goals / Non-Goals + +**Goals:** +- Una reseña por dispositivo y local, editable y borrable por su autor. +- Media de reseñas visible donde ya hay estrellas, sin tocar consumidores. +- Resistencia base al boicot de contenido (rate-limit, unicidad, filtro, + moderación) manteniendo cero fricción (sin registro). +- Anonimato sin datos personales, con huella corta legible por local. + +**Non-Goals:** +- Cuentas de usuario / login (futuro; diseño prepara la migración). +- Reseñas anónimas firmadas criptográficamente o prueba-de-trabajo (se + valoran como endurecimiento posterior si hay abuso real). +- Moderación previa (cola de aprobación) — se publican directamente. +- Mitigación de DDoS volumétrico (borde/infra: proxy con rate-limit, + fail2ban o CDN delante; fuera de este cambio). +- Editar la `descripcion` del local ni tocar la pasarela. + +## Decisions + +1. **`deviceId` aleatorio en `localStorage` como identidad v1** (UUID v4). + Anónimo, cero fricción, sin PII. Se envía en el POST/DELETE (el servidor + no puede fiarse de él para autenticar, pero sí para la unicidad y la + propiedad lógica de la reseña). *Alternativa descartada:* huella + derivada del request (IP+UA): frágil (IP dinámica) y colisiona en redes + compartidas (CGNAT móviles muy comunes en España). + +2. **Esquema: tabla `resenas` con `UNIQUE(localId, deviceId)`.** + ```sql + CREATE TABLE IF NOT EXISTS resenas ( + id TEXT PRIMARY KEY, + localId TEXT NOT NULL, + deviceId TEXT NOT NULL, + puntuacion INTEGER NOT NULL CHECK (puntuacion BETWEEN 1 AND 5), + comentario TEXT, + fecha TEXT DEFAULT CURRENT_TIMESTAMP, + fechaEdicion TEXT, + UNIQUE (localId, deviceId) + ); + ``` + Editar = `UPDATE` de la misma fila (+`fechaEdicion`). "Una por usuario" + se garantiza por constraint, no por código. `reportes` gana + `resenaId TEXT` nullable (`ensureColumn`, sin migración destructiva). + *Futuro cuentas:* columna `userId` nullable + migración + deviceId→userId; el UNIQUE se mueve a (localId, userId) cuando exista. + +3. **Media agregada en `locales.puntuacion`.** Tras cada + crear/editar/borrar: `UPDATE locales SET puntuacion = ROUND(AVG(...))` + (0 si no quedan reseñas). Así `LocalCard`, el popup del mapa, el orden + "★ Mejor" y la media global consumen el campo tal cual, sin cambios. + *Alternativa descartada:* media calculada en cada lectura (obliga a + tocar todos los consumidores y las queries de listado). + +4. **API REST siguiente la convención del repo:** + - `GET /api/locales/:id/resenas` → 200 lista pública (sin deviceId + completo: solo huella corta por reseña). + - `POST /api/locales/:id/resenas` `{ deviceId, puntuacion, comentario }` + → **upsert** (201 crea; 200 actualiza la propia). Simplifica el + cliente: un solo botón "Publicar/Actualizar". + - `DELETE /api/locales/:id/resenas?deviceId=...` → 200 borra la propia. + - `$PREFIX/resenas` → 200 lista admin; `DELETE $PREFIX/resenas/:id` → + 200 borra (moderación), recalcula media. + - Reporte de reseña: reusa `POST /api/locales/:id/reportar` con + `{ motivo, comentario, resenaId }`. + +5. **Hucha corta estilo 4chan por local:** `#` + 3 primeros hex del + sha256(deviceId + localId). Estable por local (permite seguir el hilo de + un "anónimo" dentro del mismo local), no reversible al deviceId y no + rastreable entre locales. *Alternativa descartada:* huella global — + permitiría perfilar a un anónimo entre todos los locales. + +6. **Anti-boicot por capas (todo server-side, en memoria):** + - `express-rate-limit` (o tabla simple en memoria si se prefiere cero + dependencias) sobre POST/DELETE de reseñas: p. ej. 10/hora por IP. + - Unicidad (localId, deviceId) — un dispositivo no inflaba la media. + - Filtro de palabras en el comentario + `maxLength` 500. + - Moderación reactiva: reportes visibles en el panel → borrado admin. + *Registro de la razón por la que NO PoW/HMAC-token en v1:* complejidad + de implementación y UX; con rate-limit + unicidad + moderación el + coste de un boicot coordinado ya no es trivial. Endurecemos si pasa. + +7. **UI: desplegable en `LocalCard`.** Cabecera "Reseñas (N) · ★media" + clicable que expande ``: lista (huella, estrellas, + comentario, fecha, "editada") + formulario inline (StarRating + interactivo + textarea 500 + Publicar/Actualizar/Borrar). Carga perezosa + (solo al expandir). *Alternativa descartada:* modal de detalle — más + navegación para el caso de uso dominante (leer reseñas al comparar). + +## Risks / Trade-offs + +- [deviceId en localStorage es falsificable → boicot con N dispositivos + artificiales] → rate-limit por IP + unicidad + reportes + borrado admin; + endurecimiento posterior (PoW/cuentas) si se materializa. +- [Media secuestrable por primeros votantes] → es la naturaleza de una + media; con volumen se corrige sola y la moderación cubre abuso evidente. +- [localStorage compartido/borrado → el usuario pierde su reseña] → + aceptable en v1 anónima (sin identidad portátil); las cuentas lo + resolverán. +- [Escribir en `locales` desde el endpoint de reseñas acopla tablas] → + recálculo centralizado en un helper `recalcularMedia(localId)` usado por + todas las vías (crear/editar/borrar/admin). +- [Comentario publicado sin revisión previa] → elegido por el usuario; + mitigado por filtro de palabras, reportes y borrado admin inmediato. + +## Migration Plan + +Solo aditivo (CREATE TABLE + ensureColumn): desplegar y ya. Las +`puntuacion` históricas (mayormente 0) pasan a significar "sin reseñas"; +si algún local tuviera puntuación manual heredada, se mantiene hasta la +primera reseña (decisión documentada; no hay camino de datos conocido con +puntuaciones manuales). Rollback = revert; la tabla queda huérfana sin +efecto. + +## Open Questions + +- ¿Rate-limit exacto (10/hora/IP es un punto de partida razonable)? Se + ajusta tras ver tráfico real. +- ¿Tope de longitud del comentario 500? Alineado con la filosofía "corto" + de la descripción de la pasarela (200) pero algo más holgado. diff --git a/openspec/changes/resenas-por-local/proposal.md b/openspec/changes/resenas-por-local/proposal.md new file mode 100644 index 0000000..e3e1ea0 --- /dev/null +++ b/openspec/changes/resenas-por-local/proposal.md @@ -0,0 +1,69 @@ +# Proposal: Reseñas múltiples por local (issue #6) + +## Why + +La issue #6 pide que los comentarios y las valoraciones sean múltiples por +local: una reseña por usuario, editable. Hoy un local tiene una única +`puntuacion` (entero histórico, casi siempre 0) mostrada como estrellas +read-only, sin reseñas. Una pestaña de reseñas por local da voz a quien usa +la web y convierte la puntuación en una media real. Decidido en entrevista: +**v1 anónima estilo 4chan** (huella de dispositivo, sin cuentas, cuentas en +un futuro), **publicación directa con filtro y reportes**, y la media se +agrega en `locales.puntuacion`. + +## What Changes + +- Nueva tabla `resenas`: una por (local, dispositivo) — restricción UNIQUE; + `puntuacion` 1–5 obligatoria y `comentario` opcional (≤500 caracteres); + editable (misma fila, `fechaEdicion`) y borrable por su autor. +- `locales.puntuacion` pasa a ser la **media** de las reseñas (entero + redondeado), recalculada al crear/editar/borrar una reseña; sin reseñas + sigue en 0. +- Identidad **anónima por dispositivo**: `deviceId` aleatorio en + `localStorage` (sin datos personales). Cada reseña se muestra como + "Anónimo #xxx" con huella corta derivada del deviceId (estilo 4chan), + nunca el deviceId completo. +- Endpoints públicos: `GET /api/locales/:id/resenas`, + `POST /api/locales/:id/resenas` (crear o editar la propia: upsert), + `DELETE /api/locales/:id/resenas` (borrar la propia, identificándose con + el deviceId). Admin bajo prefijo: listar y borrar reseñas abusivas + (`$PREFIX/resenas`). +- **Rate-limiting por IP** en las escrituras de reseñas (defensa base + anti-boicot; el DDoS volumétrico se mitiga en el borde, fuera de alcance). +- Filtro de palabras prohibidas aplicado al comentario; flujo de reportes + extendido para poder reportar una reseña concreta (columna `resenaId` + nullable en `reportes`) y que el admin la borre. +- UI: **sección desplegable en la propia tarjeta** del local — + "Reseñas (N) · ★ media" que expande la lista y el formulario inline + (estrellas interactivas + comentario). La propia reseña del dispositivo + aparece como editable/borrable. + +## Capabilities + +### New Capabilities + +- `resenas-por-local`: reseñas anónimas múltiples por local — una por + dispositivo, editables; media agregada en la puntuación del local; + publicación directa con filtro, reportes y rate-limit; UI desplegable en + la tarjeta. + +### Modified Capabilities + +(vacío — la pasarela no cambia: la puntuación sigue sin formar parte de la +propuesta de local; las reseñas viven sobre locales publicados) + +## Impact + +- **BD (`server/db.js`):** tabla `resenas` + `ensureColumn("reportes", + "resenaId", ...)`. Sin migración destructiva. +- **Servidor (`server/index.js`):** endpoints públicos y admin de reseñas, + recálculo de media, rate-limit en memoria por IP, filtro de palabras en + comentarios, reporte de reseñas. +- **Frontend:** `deviceId` en localStorage (util nuevo), componente + desplegable de reseñas integrado en `LocalCard.jsx` (y `StarRating` + interactivo en el formulario). El popup del mapa y el orden "★ Mejor" + consumen `puntuacion` ya agregada: sin cambios. +- **Tests:** rutas (upsert, unicidad, media, rate-limit, filtro, admin) y + componentes (desplegable, formulario, editar/borrar propia). +- **Futuro (no en este cambio):** migración deviceId→userId cuando lleguen + las cuentas (el diseño lo deja preparado). diff --git a/openspec/changes/resenas-por-local/specs/resenas-por-local/spec.md b/openspec/changes/resenas-por-local/specs/resenas-por-local/spec.md new file mode 100644 index 0000000..305e29f --- /dev/null +++ b/openspec/changes/resenas-por-local/specs/resenas-por-local/spec.md @@ -0,0 +1,95 @@ +# Delta Spec: resenas-por-local (nueva capacidad) + +## ADDED Requirements + +### Requirement: Una reseña por dispositivo y local +El sistema SHALL permitir como máximo una reseña por dispositivo y local; enviar una reseña cuando ya existe una del mismo dispositivo SHALL actualizar (editar) la existente en lugar de crear una duplicada. + +#### Scenario: Primera reseña +- **WHEN** un dispositivo envía `puntuacion` (1–5) y un comentario opcional a un local sin reseña previa suya +- **THEN** la reseña se crea con fecha y queda visible en la lista del local + +#### Scenario: Reenvío edita la existente +- **WHEN** un dispositivo que ya reseñó un local envía de nuevo una reseña para ese local +- **THEN** la reseña previa se actualiza (puntuacion y comentario) y se registra la fecha de edición, sin crear duplicados + +#### Scenario: Borrado de la propia reseña +- **WHEN** un dispositivo solicita borrar su reseña de un local +- **THEN** la reseña desaparece de la lista y la puntuación del local se recalcula + +### Requirement: Valoración obligatoria 1–5 y comentario opcional +La reseña SHALL contener una valoración de 1 a 5 estrellas obligatoria y un comentario opcional de como máximo 500 caracteres; las escrituras fuera de ese contrato SHALL rechazarse con error 400. + +#### Scenario: Reseña sin puntuacion +- **WHEN** se envía una reseña sin puntuacion o fuera del rango 1–5 +- **THEN** el servidor responde 400 y no se crea ni modifica ninguna reseña + +#### Scenario: Comentario demasiado largo +- **WHEN** se envía un comentario de más de 500 caracteres +- **THEN** el servidor responde 400 + +### Requirement: Media agregada en la puntuación del local +El sistema SHALL mantener `locales.puntuacion` como la media (entero redondeado) de las reseñas vigentes del local, recalculada al crear, editar o borrar una reseña; sin reseñas SHALL valer 0. Los consumidores existentes (estrellas de la tarjeta, popup del mapa, orden "★ Mejor" y media global) SHALL funcionar sin cambios. + +#### Scenario: Recálculo al crear +- **WHEN** un local sin reseñas recibe una reseña de 5 estrellas y luego otra de 4 +- **THEN** tras la primera la puntuación del local es 5, y tras la segunda es 5 (media 4.5 redondeada al entero más próximo, ROUND de SQLite) + +#### Scenario: Recálculo al borrar +- **WHEN** se borra la única reseña de un local +- **THEN** la puntuación del local vuelve a 0 + +### Requirement: Identidad anónima con huella corta +El sistema SHALL identificar a quien reseña mediante un identificador de dispositivo aleatorio (sin datos personales) y SHALL mostrar cada reseña como "Anónimo" seguida de una huella corta estable por local (derivada del identificador de dispositivo y del local, no reversible y no rastreable entre locales) junto a su fecha. + +#### Scenario: Visualización anónima +- **WHEN** se lista las reseñas de un local +- **THEN** cada reseña se muestra como anónima con su huella corta y su fecha, sin exponer el identificador completo del dispositivo + +#### Scenario: Huella estable dentro de un local +- **WHEN** el mismo dispositivo reseña (o edita su reseña en) un local +- **THEN** la huella mostrada es la misma en todas las reseñas de ese local para ese dispositivo + +### Requirement: Publicación directa con filtro de palabras +Las reseñas SHALL publicarse inmediatamente al enviarse, aplicando el filtro de palabras prohibidas al comentario; un comentario con palabras no permitidas SHALL rechazarse con el aviso correspondiente. + +#### Scenario: Palabra prohibida en el comentario +- **WHEN** se envía una reseña cuyo comentario contiene una palabra no permitida +- **THEN** el servidor responde con error y la reseña no se publica + +#### Scenario: Publicación inmediata +- **WHEN** una reseña válida se envía +- **THEN** queda visible en la lista del local sin intervención del administrador + +### Requirement: Rate limiting de escrituras +El sistema SHALL limitar la frecuencia de escrituras de reseñas (crear/editar/borrar) por dirección IP, rechazando con error 429 los excesos, como defensa base contra el boicot automatizado. + +#### Scenario: Límite excedido +- **WHEN** una misma IP supera el límite de escrituras de reseñas en la ventana configurada +- **THEN** las peticiones adicionales reciben 429 y no modifican datos + +### Requirement: Reporte y moderación de reseñas +El sistema SHALL permitir reportar una reseña concreta (reusando el flujo de reportes) y SHALL ofrecer al administrador, bajo el prefijo admin, el listado de reseñas y el borrado de cualquiera de ellas, recalculando la media al borrar. + +#### Scenario: Reportar una reseña +- **WHEN** un usuario reporta una reseña de un local +- **THEN** el reporte aparece en la lista de reportes del admin identificado como reporte de esa reseña + +#### Scenario: Borrado admin +- **WHEN** el administrador borra una reseña desde el panel +- **THEN** la reseña desaparece y la puntuación del local se recalcula + +### Requirement: Sección de reseñas desplegable en la tarjeta del local +La tarjeta de cada local SHALL incluir una sección "Reseñas (N) · ★ media" que al expandirla muestra perezosamente la lista de reseñas y el formulario inline (estrellas interactivas 1–5 y comentario opcional de 500 caracteres), con las acciones de publicar/actualizar y borrar para la reseña del propio dispositivo. + +#### Scenario: Tarjeta sin expandir +- **WHEN** se muestra la tarjeta de un local +- **THEN** la sección de reseñas aparece plegada con el número de reseñas y la media + +#### Scenario: Expandir y reseñar +- **WHEN** el usuario expande la sección de reseñas y envía estrellas (y opcionalmente comentario) +- **THEN** su reseña aparece en la lista y la cabecera actualiza número y media + +#### Scenario: La propia reseña es editable +- **WHEN** el dispositivo ya tiene reseña en ese local y expande la sección +- **THEN** el formulario aparece precargado con su reseña y ofrece actualizar o borrar diff --git a/openspec/changes/resenas-por-local/tasks.md b/openspec/changes/resenas-por-local/tasks.md new file mode 100644 index 0000000..8cfa21f --- /dev/null +++ b/openspec/changes/resenas-por-local/tasks.md @@ -0,0 +1,42 @@ +# Tasks: Reseñas múltiples por local (issue #6) + +> Decisiones de entrevista (2026-10-11): v1 anónima estilo 4chan (deviceId +> en localStorage, huella corta por local), sección desplegable en la +> tarjeta, "Anónimo #xxx" + fecha, tabla `resenas` + media agregada en +> `locales.puntuacion`, publicación directa + reportes, rate-limit por IP. +> Detalles de esquema y endpoints: design.md. + +## 1. BD (server/db.js) + +- [ ] 1.1 Crear tabla `resenas` (id, localId, deviceId, puntuacion 1–5 CHECK, comentario, fecha, fechaEdicion, UNIQUE(localId, deviceId)) +- [ ] 1.2 `ensureColumn("reportes", "resenaId", "TEXT")` para reportar reseñas concretas + +## 2. Servidor (server/index.js) + +- [ ] 2.1 Helper `recalcularMedia(localId)`: `UPDATE locales SET puntuacion = ROUND(AVG(resenas.puntuacion))` (0 si vacío) +- [ ] 2.2 `GET /api/locales/:id/resenas` → 200 lista pública sin deviceId completo (huella corta por reseña: 3 hex de sha256(deviceId+localId)) +- [ ] 2.3 `POST /api/locales/:id/resenas` upsert: valida puntuacion 1–5 y comentario ≤500; 404 si el local no existe; filtro de palabras en el comentario; crea (201) o edita la propia (200, fechaEdicion); recalcula media +- [ ] 2.4 `DELETE /api/locales/:id/resenas` con deviceId → borra la propia (200) y recalcula; 404 si no tiene reseña +- [ ] 2.5 Rate-limit por IP en POST/DELETE de reseñas (en memoria o express-rate-limit; 429 al exceder) +- [ ] 2.6 Extender `POST /api/locales/:id/reportar` para aceptar `resenaId` opcional (reporte de reseña) +- [ ] 2.7 Admin bajo prefijo: `GET $PREFIX/resenas` (lista con datos completos) y `DELETE $PREFIX/resenas/:id` (borrado de moderación + recálculo) + +## 3. Frontend + +- [ ] 3.1 Util `deviceId` persistente en localStorage (UUID v4, creación perezosa) en `src/utils/` +- [ ] 3.2 Cliente API de reseñas en `src/api.js` (listar, enviar upsert, borrar propia) con el deviceId +- [ ] 3.3 `StarRating` interactivo (modo edición: click 1–5) manteniendo el readOnly actual +- [ ] 3.4 Componente `ResenasLocal` desplegable: cabecera "Reseñas (N) · ★media", carga perezosa al expandir, lista (huella, estrellas, comentario, fecha, marca "editada") y formulario inline (estrellas + textarea 500) +- [ ] 3.5 Integrar en `LocalCard.jsx`: precargar el formulario con la reseña propia y ofrecer Actualizar/Borrar; reportar reseña ajena desde la lista +- [ ] 3.6 Verificar que popup del mapa, orden "★ Mejor" y media global siguen correctos con la puntuación agregada (sin cambios de código previstos) + +## 4. Tests + +- [ ] 4.1 `tests/unit/test-routes.spec.js` (o fichero nuevo `test-resenas.spec.js`): upsert (una por dispositivo), 400 sin puntuacion/fuera de rango/comentario >500, 404 local inexistente, filtro de palabras, recálculo de media al crear/editar/borrar (incl. borrado admin), reporte con resenaId, rate-limit 429 +- [ ] 4.2 Tests de componente: `ResenasLocal` plegado/expandido, formulario con estrellas, precarga de la propia, envío y borrado +- [ ] 4.3 Suite completa en verde: `./node_modules/.bin/vitest run` + +## 5. Cierre + +- [ ] 5.1 README: documentar reseñas (contrato de la API pública, moderación, anonimato y su huella, rate-limit) +- [ ] 5.2 Referenciar la issue #6 en el commit de cierre y verificar despliegue en prototipo-yb01.localesp.es diff --git a/openspec/specs/pasarela-proponer-local/spec.md b/openspec/specs/pasarela-proponer-local/spec.md index b15a5cb..c8e75a2 100644 --- a/openspec/specs/pasarela-proponer-local/spec.md +++ b/openspec/specs/pasarela-proponer-local/spec.md @@ -2,7 +2,7 @@ ## Purpose -Experiencia guiada (wizard) en un modal para proponer un local con un solo campo por pantalla —empezando por la ubicación con autodetección del proveedor e inferencia de nombre/provincia—, sin campos de comentario ni puntuación, conservando las validaciones existentes (palabras prohibidas, duplicados, privacidad obligatoria). +Experiencia guiada (wizard) en un modal para proponer un local con un solo campo por pantalla —empezando por la ubicación con autodetección del proveedor e inferencia de nombre/provincia—, con una descripción corta opcional y sin campo de puntuación, conservando las validaciones existentes (palabras prohibidas sobre nombre, dirección y descripción, duplicados, privacidad obligatoria). ## Requirements @@ -26,7 +26,7 @@ El sistema SHALL presentar la propuesta de un local como una pasarela (wizard) d - **THEN** la pasarela se cierra y se descarta el borrador en curso ### 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) Revisión y envío. +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 @@ -36,6 +36,10 @@ La pasarela SHALL presentar las pantallas en este orden: 1) Ubicación, 2) Datos - **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: Inferencia de Nombre, Provincia y Dirección desde la Ubicación El sistema SHALL pre-rellenar los campos Nombre, Provincia y Dirección a partir de la ubicación introducida en la primera pantalla (geocodificación inversa), mostrándolos juntos en la pantalla de Datos del local y permitiendo al usuario corregirlos (incluida la dirección). @@ -51,12 +55,20 @@ El sistema SHALL pre-rellenar los campos Nombre, Provincia y Dirección a partir - **WHEN** la inferencia falla o devuelve campos vacíos - **THEN** la pantalla de Datos del local aparece vacía y el usuario la rellena manualmente, sin bloquear la pasarela -### Requirement: Sin campo de comentario ni puntuación -La pasarela SHALL NOT incluir el campo de comentario/descripción ni el campo de puntuación; la propuesta se envía sin esos datos. +### 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 sin comentario ni puntuación -- **WHEN** el usuario completa la pasarela y envía -- **THEN** la propuesta se registra con nombre, provincia, categoría, subcategoría, dirección/enlace y coordenadas, sin descripción y sin puntuación +#### 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: Revisión y aceptación de privacidad antes de enviar La última pantalla de la pasarela SHALL mostrar un resumen de los datos introducidos y el checkbox de aceptación de la política de privacidad, siendo este último obligatorio para enviar. @@ -70,10 +82,10 @@ La última pantalla de la pasarela SHALL mostrar un resumen de los datos introdu - **THEN** ve un resumen legible de todos los datos introducidos con posibilidad de volver atrás a corregirlos ### Requirement: Validaciones existentes integradas en la pasarela -La pasarela SHALL conservar las validaciones actuales del formulario: filtro de palabras prohibidas y comprobación de duplicados, mostrando los avisos dentro del modal. +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 contiene una palabra no permitida +- **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