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,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 `<ResenasLocal>`: 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.
|
||||
@@ -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).
|
||||
@@ -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
|
||||
@@ -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
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user