Compare commits
25
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
df4e01a1a5 | ||
|
|
8106f0b40c | ||
|
|
ab79239541 | ||
|
|
ac566a9655 | ||
|
|
2fa95840a7 | ||
|
|
c381a4747f | ||
|
|
9b24953a5e | ||
|
|
c4a60c099c | ||
|
|
ebbd7b696e | ||
|
|
478943c58a | ||
|
|
38ea2830fb | ||
|
|
dd6febf8b0 | ||
|
|
d34ebf7ca0 | ||
|
|
695d59d31e | ||
|
|
4d7d9e19dc | ||
|
|
34bd421853 | ||
|
|
85a054d886 | ||
|
|
49e965b248 | ||
|
|
6cc326e8ac | ||
|
|
6323fe8f0e | ||
|
|
adb2b4dfe4 | ||
|
|
98b19aa3a2 | ||
|
|
27166eb3f4 | ||
|
|
e08d959cf9 | ||
|
|
c06300833b |
@@ -0,0 +1,24 @@
|
||||
# Configuración de LocalESP — copia este fichero a `.env` y rellena los valores.
|
||||
# cp .env.example .env
|
||||
#
|
||||
# El servidor carga `.env` automáticamente al arrancar (no sobrescribe
|
||||
# variables ya presentes en el entorno) y Vite lo lee en dev y build.
|
||||
|
||||
# Prefijo bajo el que se sirven las rutas de administración (OBLIGATORIO,
|
||||
# sin valor por defecto: servidor y build fallan si no está configurada).
|
||||
#
|
||||
# - Es la ÚNICA variable: servidor (`node server/index.js`), proxy de
|
||||
# desarrollo (`npm run dev`) y frontend (`npm run build`) leen esta misma.
|
||||
# - Empieza por "/" y no lo publiques: es lo que oculta /admin de la
|
||||
# enumeración de rutas. Usa algo difícil de adivinar, p. ej. /gestion-x7k2
|
||||
# - Las rutas históricas (/api/pendientes, /api/reportes, ...) dejan de
|
||||
# existir; el panel /admin llama a `$LOCALESP_ADMIN_PREFIX/...`
|
||||
LOCALESP_ADMIN_PREFIX=
|
||||
|
||||
# Opcional: ruta de la base de datos SQLite (por defecto localesp.db del
|
||||
# repo; en pruebas se usa ":memory:").
|
||||
# LOCALESP_DB=
|
||||
|
||||
# Opcional: máximo de escrituras de reseñas (crear/editar/borrar) por IP y
|
||||
# hora, como defensa base anti-boicot (por defecto 10; 429 al exceder).
|
||||
# LOCALESP_RESENAS_RATELIMIT_MAX=10
|
||||
@@ -27,10 +27,23 @@ jobs:
|
||||
|
||||
- name: Build (npm ci + vite build)
|
||||
shell: bash
|
||||
env:
|
||||
BRANCH: ${{ github.event.inputs.branch || github.ref_name }}
|
||||
run: |
|
||||
# better-sqlite3 (v12) requiere C++20; el GCC 8 del sistema (AlmaLinux 8) no lo soporta.
|
||||
# gcc-toolset-12 (GCC 12) ya está instalado en /opt/rh.
|
||||
source /opt/rh/gcc-toolset-12/enable 2>/dev/null || echo "WARN: gcc-toolset-12 no encontrado"
|
||||
# Config por entorno EN EL REPO (la misma que usará deploy.sh):
|
||||
# scripts/entornos.env mapea <slug>=<prefijo admin>, que el build
|
||||
# incrusta en el bundle. Sin entrada para la rama, falla (sin default).
|
||||
. scripts/lib/env.sh
|
||||
# El alias rama->entorno manda también aquí (entornos.alias.env).
|
||||
slug="$(EnvSlug::environment "$(Slug::from "$BRANCH")" .)"
|
||||
prefix="$(Config::admin_prefix "$slug" scripts/entornos.env)" || {
|
||||
echo "::error::Falta entrada '$slug=' en scripts/entornos.env — añádela y relanza" >&2
|
||||
exit 1
|
||||
}
|
||||
export LOCALESP_ADMIN_PREFIX="$prefix"
|
||||
npm ci
|
||||
npm run build
|
||||
|
||||
|
||||
@@ -25,12 +25,20 @@ jobs:
|
||||
source /opt/rh/gcc-toolset-12/enable 2>/dev/null || echo "WARN: gcc-toolset-12 no encontrado"
|
||||
npm ci
|
||||
|
||||
- name: Build de producción
|
||||
# Va ANTES de las pruebas: la suite incluye un smoke de la SPA servida
|
||||
# (GET / -> dist/index.html) y `dist/` está gitignored, así que el
|
||||
# artefacto tiene que existir cuando corre `npm test`.
|
||||
# El prefijo real lo resuelve deploy.yml desde scripts/entornos.env
|
||||
# (con alias en scripts/entornos.alias.env); aquí basta un valor
|
||||
# cualquiera: se comprueba que el build funciona, no la configuración.
|
||||
env:
|
||||
LOCALESP_ADMIN_PREFIX: /admin-ci
|
||||
run: npm run build
|
||||
|
||||
- name: Pruebas unitarias y de componente (offline)
|
||||
run: npm test
|
||||
|
||||
- name: Build de producción
|
||||
run: npm run build
|
||||
|
||||
integracion:
|
||||
name: Integración (Nominatim real, opt-in)
|
||||
runs-on: self-hosted
|
||||
|
||||
@@ -1,2 +1,86 @@
|
||||
# LocalESP
|
||||
Registro colaborativo de negocios españoles
|
||||
|
||||
Registro colaborativo de negocios españoles.
|
||||
|
||||
## Rutas de administración (prefijo configurable)
|
||||
|
||||
Las rutas de administración **solo se sirven bajo un prefijo configurable**;
|
||||
las rutas históricas (`/api/pendientes`, `/api/reportes`, `/api/aprobar/:id`,
|
||||
`/api/rechazar/:id`, `DELETE /api/locales/:id`, `/api/reportes/:id/descartar`)
|
||||
dejan de existir y devuelven 404. Además, **el propio panel admin vive en la
|
||||
raíz del prefijo** (p. ej. `$ADMIN_PREFIX` → `https://…/administrador`):
|
||||
la antigua `/admin` muestra la web pública. Todo ello oculta la superficie
|
||||
admin de la enumeración de rutas sin añadir autenticación (ocultación, no
|
||||
seguridad real).
|
||||
|
||||
| Ruta admin | Método |
|
||||
|---|---|
|
||||
| `$ADMIN_PREFIX/pendientes` | GET |
|
||||
| `$ADMIN_PREFIX/aprobar/:id` | POST |
|
||||
| `$ADMIN_PREFIX/rechazar/:id` | POST |
|
||||
| `$ADMIN_PREFIX/locales/:id` | DELETE |
|
||||
| `$ADMIN_PREFIX/reportes` | GET |
|
||||
| `$ADMIN_PREFIX/reportes/:id/descartar` | POST |
|
||||
| `$ADMIN_PREFIX/resenas` | GET |
|
||||
| `$ADMIN_PREFIX/resenas/:id` | DELETE |
|
||||
|
||||
Siguen siendo públicas (las usa la web): `GET /api/locales`,
|
||||
`POST /api/propuestas`, `POST /api/check-duplicado`,
|
||||
`POST /api/locales/:id/confirmar`, `POST /api/locales/:id/reportar`,
|
||||
`GET/POST /api/locales/:id/resenas`, `DELETE /api/locales/:id/resenas` y
|
||||
`GET/POST /api/config/filtro_palabras`.
|
||||
|
||||
## Reseñas por local (issue #6)
|
||||
|
||||
Cada local publicado tiene **reseñas anónimas múltiples**: una por
|
||||
dispositivo, editable y borrable por su autor; `locales.puntuacion` es la
|
||||
**media** (redondeo de SQLite) de las reseñas vigentes y se recalcula al
|
||||
crear/editar/borrar.
|
||||
|
||||
- **Identidad anónima:** `deviceId` aleatorio persistido en `localStorage`
|
||||
(sin cuentas ni datos personales, "estilo 4chan"). Cada reseña se muestra
|
||||
como `Anónimo #xxx` con una huella corta derivada de
|
||||
`sha256(deviceId:localId)`: estable dentro del local, no reversible y no
|
||||
rastreable entre locales. El deviceId completo nunca sale del servidor.
|
||||
- **Contrato público:** `GET /api/locales/:id/resenas` (admite `?deviceId=`
|
||||
para marcar la propia), `POST /api/locales/:id/resenas`
|
||||
(`{ deviceId, puntuacion 1–5, comentario ≤500 }`, upsert: crea 201 o edita
|
||||
200) y `DELETE /api/locales/:id/resenas?deviceId=…` (borra la propia).
|
||||
`GET /api/locales` incluye `totalResenas` por local.
|
||||
- **Moderación:** publicación directa; el filtro de palabras se aplica al
|
||||
comentario server-side. Una reseña concreta se reporta con
|
||||
`POST /api/locales/:id/reportar` añadiendo `resenaId`; el admin la borra
|
||||
desde el panel (pestaña Reportes → «Borrar reseña», también vía
|
||||
`DELETE $ADMIN_PREFIX/resenas/:id`).
|
||||
- **Anti-abuso:** rate-limit por IP en las escrituras de reseñas (por defecto
|
||||
10/hora, configurable con `LOCALESP_RESENAS_RATELIMIT_MAX`; responde 429
|
||||
con `Retry-After`) más la unicidad por dispositivo. El DDoS volumétrico se
|
||||
mitiga en el borde (proxy/CDN), no en la app. Las cuentas de usuario
|
||||
quedarán como trabajo futuro (migración deviceId→userId prevista).
|
||||
|
||||
### Configuración
|
||||
|
||||
`LOCALESP_ADMIN_PREFIX` es **obligatoria, sin valor por defecto y la única
|
||||
variable necesaria**: servidor, proxy de desarrollo y build del frontend
|
||||
leen la misma. Sin ella, `node server/index.js` y `npm run build` fallan con
|
||||
un error claro. La forma más cómoda de configurarla es copiar el template:
|
||||
|
||||
```bash
|
||||
cp .env.example .env # y rellena LOCALESP_ADMIN_PREFIX
|
||||
```
|
||||
|
||||
- **Servidor:** lee `LOCALESP_ADMIN_PREFIX` del entorno y de `.env` (el
|
||||
fichero no sobrescribe variables ya presentes).
|
||||
- **Frontend:** Vite expone `LOCALESP_ADMIN_PREFIX` al código cliente vía
|
||||
`envPrefix` (`.env` o entorno en dev/build); `npm run build` falla si falta.
|
||||
- **Desarrollo:** `npm run dev` proxya `/api` y el prefijo admin al backend
|
||||
en `localhost:3000`, leyendo ambos del entorno o de `.env`.
|
||||
- **Despliegue CI (entorno por rama):** el prefijo de cada entorno se declara
|
||||
en `scripts/entornos.env` (mapping `slug=prefijo`, en el repo): el workflow
|
||||
de deploy lo incrusta en el build y `deploy.sh` lo materializa como
|
||||
`<dest>/.env`. Sin entrada para la rama, el deploy falla con mensaje claro.
|
||||
|
||||
> Nota: sin prefijo configurado el servidor no arranca (no existe modo sin
|
||||
> ocultación). El prefijo viaja en el bundle del frontend, así que esto es
|
||||
> ocultación básica frente a enumeración, no un mecanismo de seguridad; la
|
||||
> autenticación real queda como trabajo futuro.
|
||||
|
||||
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-09-30
|
||||
@@ -0,0 +1,150 @@
|
||||
# Design: Hide Admin Route
|
||||
|
||||
> **Actualización 1 (2026-10-02) — decisión del usuario:** se descarta el
|
||||
> middleware de enmascaramiento con 404. Enfoque adoptado: **prefijo de
|
||||
> administración configurable** (`LOCALESP_ADMIN_PREFIX` en el servidor,
|
||||
> `VITE_ADMIN_PREFIX` al compilar el frontend). Las rutas
|
||||
> admin solo se registran bajo ese prefijo; las rutas históricas `/api/...`
|
||||
> dejan de existir (404 natural, sin handler). `reportar`/`confirmar` siguen
|
||||
> públicas (las usa la web) y `DELETE /api/locales/:id` pasa al prefijo.
|
||||
> No hay middleware: cualquier método, query o variante de las rutas antiguas
|
||||
> recibe el mismo 404 por construcción.
|
||||
>
|
||||
> **Actualización 2 (2026-10-02, petición del usuario):** `LOCALESP_ADMIN_PREFIX`
|
||||
> pasa a ser **obligatoria y sin valor por defecto**: sin ella el servidor hace
|
||||
> fail-fast al arrancar. Se añade `.env.example` como template y el servidor
|
||||
> carga `.env` automáticamente (sin sobrescribir variables del entorno). Se
|
||||
> elimina el escenario de compatibilidad con prefijo `/api` por defecto.
|
||||
>
|
||||
> **Actualización 3 (2026-10-02, petición del usuario):** se elimina la
|
||||
> redundancia `VITE_ADMIN_PREFIX`: **una sola variable** (`LOCALESP_ADMIN_PREFIX`)
|
||||
> para servidor, proxy de desarrollo y frontend. Vite la expone al código
|
||||
> cliente mediante `envPrefix: ["VITE_", "LOCALESP_"]` y `npm run build`
|
||||
> también falla si falta.
|
||||
>
|
||||
> **Actualización 4 (2026-10-02, petición del usuario):** el panel de
|
||||
> administración también se oculta: vive en la **raíz del prefijo**
|
||||
> (`$LOCALESP_ADMIN_PREFIX`, p. ej. `/administrador`) y la ruta fija `/admin`
|
||||
> pasa a mostrar la web pública. Una sola variable define URL del panel y API.
|
||||
>
|
||||
> **Actualización 5 (2026-10-03, petición del usuario):** la config por entorno
|
||||
> pasa del host (`/etc/localesp/<slug>.env`) **al repo**: `scripts/entornos.env`
|
||||
> mapea `slug=prefijo`. El workflow de deploy la aplica al build y `deploy.sh`
|
||||
> la materializa como `<dest>/.env`. Sin entrada para la rama: fail-fast.
|
||||
|
||||
## Context
|
||||
|
||||
The current application serves a list of user-submitted proposals (`/api/pendientes`)
|
||||
that are meant only for administrators to approve or reject. It also serves a list
|
||||
of reports (`/api/reportes`) to an admin panel at `/admin`. These routes are publicly
|
||||
accessible without authentication, making them discoverable via:
|
||||
|
||||
- Direct URL access: `GET http://example.com/api/pendientes`
|
||||
- Route enumeration: `/admin`, `/api/pendientes`, `/api/reportes`
|
||||
|
||||
This is a common attack surface for automated scanning and brute-force attempts.
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:**
|
||||
- Obscure admin-only routes from public discovery
|
||||
- Prevent accidental or malicious unauthorized access to admin endpoints
|
||||
- Maintain the same functionality for authenticated admin users
|
||||
- Do not change the API contract for authenticated users
|
||||
|
||||
**Non-Goals:**
|
||||
- Implementing actual authentication (outside the scope of this change)
|
||||
- Modifying existing database or frontend changes
|
||||
- Changing user-visible URLs for authenticated admins
|
||||
|
||||
## Decisions
|
||||
|
||||
### Approach: 404 Masking Middleware
|
||||
|
||||
We will add middleware that intercepts all requests matching admin route patterns
|
||||
and returns a 404 response, without exposing the pattern in any way.
|
||||
|
||||
**Why this approach?**
|
||||
1. **Minimal friction** — existing admin users who know the URL still get the data
|
||||
2. **No auth required** — avoids adding another layer of complexity
|
||||
3. **No breaking changes** — authenticated users are unaffected
|
||||
4. **Low risk** — does not interfere with other routes
|
||||
|
||||
**Alternatives considered:**
|
||||
|
||||
| Approach | Pros | Cons | Decision |
|
||||
|----------|------|------|----------|
|
||||
| 404 masking | Low friction, no auth needed | Admins must know the URL | ✅ Selected |
|
||||
| Auth middleware | Full protection | High friction, adds complexity | ❌ Out of scope |
|
||||
| Rename routes | Hides routes from `app._routes` | Doesn't help against direct access | ❌ Incomplete |
|
||||
| IP whitelist | Strong protection | High friction, hard to configure | ❌ Out of scope |
|
||||
|
||||
### Technical Design
|
||||
|
||||
Implement the middleware as a route that matches admin endpoints **before** the SPA fallback (which responds with `index.html` to anything starting with `/` that doesn't start with `/api/`).
|
||||
|
||||
The middleware will:
|
||||
1. Check the request path against the admin route list
|
||||
2. If matched: return `404` with a generic message
|
||||
3. If not matched: fall through to existing handlers
|
||||
|
||||
**Route patterns to protect:**
|
||||
- `/api/pendientes`
|
||||
- `/api/reportes`
|
||||
- `/api/locales/:id/reportar`
|
||||
- `/api/locales/:id/confirmar`
|
||||
- `/api/locales/:id/` (GET — deletes, but GET could also expose)
|
||||
|
||||
**Implementation strategy:**
|
||||
```
|
||||
Middleware Position: Before the SPA fallback, after public API routes are established:
|
||||
|
||||
1. /api/locales (public)
|
||||
2. /api/pendientes (→ protected → 404)
|
||||
3. /api/check-duplicado (public)
|
||||
4. /api/propuestas (public)
|
||||
5. /api/aprobar (→ protected → 404)
|
||||
6. /api/rechazar (→ protected → 404)
|
||||
7. /api/reportes (→ protected → 404)
|
||||
8. /api/locales/:id/reportar (→ protected → 404)
|
||||
9. ...
|
||||
10. SPA fallback → 404 / index.html for unmatched paths
|
||||
```
|
||||
|
||||
The middleware essentially "protects" these routes *after* they're defined but *by returning 404* on all unmatched patterns. Wait — this is backwards. We want to protect **admin-only** routes from **public** access.
|
||||
|
||||
**Correct approach:** Add a middleware that:
|
||||
- Checks if the route is in the `ADMIN_ROUTES` list
|
||||
- Returns `404` for unmatched paths against the list (masking) — NO, that's not right either
|
||||
|
||||
Let me reconsider. The SPA fallback already 404s on unknown routes at the HTTP level. The issue is:
|
||||
- Route enumeration tools can discover that `/api/pendientes` returns JSON
|
||||
- Authenticated users see the routes in some admin dashboard (likely on the frontend)
|
||||
|
||||
**Revised approach:**
|
||||
1. Add a middleware that logs and alerts when `/api/pendientes` or `/api/reportes` is accessed
|
||||
2. Return 404 with a message for unauthenticated requests that triggers the middleware
|
||||
3. For authenticated requests (user-agent with token etc.), pass through normally
|
||||
|
||||
Actually, let me keep it simple: just return 404 for these specific routes. This is a "secret API" pattern — the route exists but is effectively a hole because it returns a 404 by default.
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
| Risk | Impact | Mitigation |
|
||||
|------|--------|------------|
|
||||
| Legitimate admin users can't access /api/pendientes | Medium | Admins must use the known panel path; update documentation |
|
||||
| Routes still visible in some tools (e.g. curl, browser dev tools) | Low | This is a mitigation, not complete protection |
|
||||
| SPA fallback might still leak URLs | Low | SPA sends `index.html` for unmatched paths, effectively hiding them |
|
||||
| New routes added without re-applying protection | Medium | Add routes to `ADMIN_ROUTES` list in middleware |
|
||||
|
||||
## Migration Plan
|
||||
|
||||
1. Add the middleware to `server/index.js`
|
||||
2. Add `ADMIN_ROUTES` constant with patterns to protect
|
||||
3. Deploy to production
|
||||
4. Share the new route patterns (or keep them secret — the point is obscurity)
|
||||
|
||||
## Open Questions
|
||||
|
||||
- Should we also protect `/api/aprobar` and `/api/rechazar` even for authenticated users (force them through the UI)? This would require auth middleware. → **Out of scope for now.**
|
||||
- Should we add actual authentication in a follow-up? → **Yes, recommended but separate.**
|
||||
@@ -0,0 +1,25 @@
|
||||
# Hide Admin Route
|
||||
|
||||
## Why
|
||||
|
||||
The `/api/pendientes` endpoint (admin-only) and `/api/reportes` endpoint are currently exposed at obvious routes, making them easy targets for attackers. By default, the admin panel URL is well-known or discoverable via route enumeration (`/admin`, `/admin/api/pendientes`, `/api/pendientes`). This increases the attack surface of the application.
|
||||
|
||||
By obscuring or moving the admin route, we increase the effort required for attackers to find the admin panel, reducing the likelihood of unwanted access.
|
||||
|
||||
## What Changes
|
||||
|
||||
- **New capability**: `route-obfuscation` — middleware-based approach to hide the admin API routes by redirecting access attempts and serving a 404 or custom page.
|
||||
- Modify server configuration to intercept requests to known admin API routes and return a 404 or redirect to a custom page.
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
|
||||
- **route-obfuscation**: Protects admin routes (`/api/pendientes`, `/api/reportes`, `/api/locales/:id/*`) by returning a 404 response when accessed without authentication, without exposing the route listing in response to global route enumeration.
|
||||
|
||||
## Impact
|
||||
|
||||
- Affects the server configuration in `server/index.js`.
|
||||
- Adds middleware to filter/admin route protection.
|
||||
- Does not change the API contract for authenticated users.
|
||||
- No database changes required.
|
||||
@@ -0,0 +1,90 @@
|
||||
# Route Obfuscation Spec
|
||||
|
||||
## Description
|
||||
|
||||
The route obfuscation capability mounts all admin-only API routes under a
|
||||
configurable prefix (`LOCALESP_ADMIN_PREFIX`). The well-known `/api/...` admin
|
||||
paths no longer have handlers and return 404, hiding the admin surface from
|
||||
route enumeration without adding authentication.
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Admin routes are served only under a configurable prefix
|
||||
|
||||
The system SHALL serve admin-only endpoints exclusively under the value of
|
||||
`LOCALESP_ADMIN_PREFIX` (**required, no default**: the server fails fast with
|
||||
a clear error when it is unset; documented in `.env.example`, which the
|
||||
server auto-loads without overriding real environment variables), and SHALL
|
||||
NOT register handlers for those endpoints under the legacy `/api` paths.
|
||||
|
||||
Admin endpoints under the prefix:
|
||||
|
||||
| Endpoint | Method |
|
||||
|---|---|
|
||||
| `$ADMIN_PREFIX/pendientes` | GET |
|
||||
| `$ADMIN_PREFIX/aprobar/:id` | POST |
|
||||
| `$ADMIN_PREFIX/rechazar/:id` | POST |
|
||||
| `$ADMIN_PREFIX/locales/:id` | DELETE |
|
||||
| `$ADMIN_PREFIX/reportes` | GET |
|
||||
| `$ADMIN_PREFIX/reportes/:id/descartar` | POST |
|
||||
|
||||
#### Scenario: Legacy admin path returns 404 when a prefix is configured
|
||||
- **WHEN** `LOCALESP_ADMIN_PREFIX` is set to a value other than `/api`
|
||||
- **AND** a client makes a request to `/api/pendientes`, `/api/reportes`,
|
||||
`/api/aprobar/:id`, `/api/rechazar/:id`, `DELETE /api/locales/:id` or
|
||||
`/api/reportes/:id/descartar`
|
||||
- **THEN** the server responds with HTTP 404
|
||||
- **AND** no data is returned and no action is executed
|
||||
|
||||
#### Scenario: Prefixed admin path serves data to clients that know it
|
||||
- **WHEN** `LOCALESP_ADMIN_PREFIX` is set to a value other than `/api`
|
||||
- **AND** a client requests `$ADMIN_PREFIX/pendientes`
|
||||
- **THEN** the server responds with the pending proposals as before
|
||||
- **AND** the admin panel works unchanged because the frontend is compiled
|
||||
with the same single `LOCALESP_ADMIN_PREFIX` variable
|
||||
(exposed to the client via Vite `envPrefix`)
|
||||
|
||||
#### Scenario: Missing configuration fails fast
|
||||
- **WHEN** `LOCALESP_ADMIN_PREFIX` is not set (or empty)
|
||||
- **THEN** the server refuses to start with a clear configuration error
|
||||
- **AND** there is no default value: every deployment must choose its prefix
|
||||
(documented in `.env.example`)
|
||||
|
||||
#### Scenario: Public routes are unaffected
|
||||
- **WHEN** a client makes a GET request to `/api/locales`
|
||||
- **THEN** the server responds with HTTP 200 and the list of locales
|
||||
|
||||
#### Scenario: User-facing report and confirm actions remain public
|
||||
- **WHEN** a client makes a POST request to `/api/locales/:id/reportar` or
|
||||
`/api/locales/:id/confirmar`
|
||||
- **THEN** the endpoints behave as before, because the public website uses
|
||||
them (they are user features, not admin surface)
|
||||
|
||||
## REMOVED Requirements
|
||||
|
||||
### Requirement: Admin panel routes are fully discoverable
|
||||
**Reason**: Security concern — admin routes should be harder to discover
|
||||
**Migration**: Admin users access the panel at the prefix root
|
||||
(`$ADMIN_PREFIX`, compiled with the same `LOCALESP_ADMIN_PREFIX`); its API
|
||||
calls go to the configured prefix
|
||||
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Admin panel serves pending proposals
|
||||
|
||||
The requirement SHALL:
|
||||
1. Allow unauthenticated clients to submit proposals via `/api/propuestas` (unchanged)
|
||||
2. Serve the pending-proposals list from `$ADMIN_PREFIX/pendientes` (legacy
|
||||
`/api/pendientes` returns 404 when a prefix is configured)
|
||||
|
||||
#### Scenario: Admin views pending proposals through the panel
|
||||
- **WHEN** an admin opens the panel at the prefix root (`$ADMIN_PREFIX`,
|
||||
e.g. `/administrador`)
|
||||
- **THEN** the panel fetches `$ADMIN_PREFIX/pendientes` (compiled with
|
||||
`LOCALESP_ADMIN_PREFIX`) and renders the list exactly as before
|
||||
- **AND** the legacy `/admin` URL renders the public site (the panel route
|
||||
no longer exists)
|
||||
|
||||
**Design note**: This is obscurity, not security: the prefix ships in the
|
||||
frontend bundle. It raises the cost of blind route enumeration only. Real
|
||||
authentication is explicitly deferred to a future change.
|
||||
@@ -0,0 +1,136 @@
|
||||
# Tasks: Hide Admin Route
|
||||
|
||||
> **Pivote decidido por el usuario (2026-10-02):** "solo quiero que se pueda
|
||||
> configurar el prefijo de admin, nada más". El enfoque de middleware de
|
||||
> enmascaramiento con 404 se **descarta**; las rutas admin se montan bajo un
|
||||
> **prefijo configurable** (`LOCALESP_ADMIN_PREFIX`, única variable para
|
||||
> servidor y frontend) y las rutas históricas bajo
|
||||
> `/api` dejan de existir (404 natural, sin handler). `reportar`/`confirmar`
|
||||
> siguen públicas (las usa la web); `DELETE /api/locales/:id` pasa al prefijo.
|
||||
>
|
||||
> **Estado (2026-10-02, tras el pivote + obligatoriedad):** implementado y
|
||||
> verificado. `./node_modules/.bin/vitest run` → **109/109 en verde** (16
|
||||
> ficheros), incluyendo `tests/unit/test-routes.spec.js` (18 tests, prefijo
|
||||
> configurado) y `tests/unit/test-admin-prefix-required.spec.js` (fail-fast
|
||||
> sin configurar).
|
||||
|
||||
> **Actualización 2 (2026-10-02):** a petición del usuario, `LOCALESP_ADMIN_PREFIX`
|
||||
> pasa a ser obligatoria (sin default `/api`): sin ella el servidor lanza error
|
||||
> claro y no arranca. Añadidos `.env.example`, cargador de `.env` en el servidor
|
||||
> (no sobrescribe el entorno) y lectura del prefijo en `vite.config.js` vía
|
||||
> `loadEnv`. Test de compatibilidad con `/api` sustituido por
|
||||
> `test-admin-prefix-required.spec.js` (fail-fast verificado). Suite: 109/109.
|
||||
>
|
||||
> **Actualización 3 (2026-10-02):** eliminada la redundancia `VITE_ADMIN_PREFIX`:
|
||||
> **una sola variable** (`LOCALESP_ADMIN_PREFIX`) para servidor, proxy de dev
|
||||
> y frontend (Vite la expone vía `envPrefix`; `npm run build` falla si falta).
|
||||
>
|
||||
> **Actualización 4 (2026-10-03):** el panel admin vive en la raíz del prefijo
|
||||
> (`/administrador` en prototipo-yb01) y `/admin` muestra la web pública.
|
||||
>
|
||||
> **Actualización 5 (2026-10-03):** config por entorno movida del host al repo
|
||||
> (`scripts/entornos.env`, mapping `slug=prefijo`): el workflow la aplica al
|
||||
> build y `deploy.sh` genera `<dest>/.env` desde ella. Fail-fast sin entrada.
|
||||
|
||||
## 1. Revisión de rutas existentes
|
||||
|
||||
- [x] 1.1 Leer y entender la estructura de rutas de `server/index.js`
|
||||
- [x] 1.2 Identificar las rutas solo-admin (`/api/pendientes`, `/api/reportes`, `/api/locales/:id/reportar`, `/api/locales/:id/confirmar`, `/api/locales/:id`, `/api/aprobar/:id`, `/api/rechazar/:id`, `/api/reportes/:id/descartar`)
|
||||
- [x] 1.3 Documentar el orden de rutas y la posición del fallback SPA
|
||||
|
||||
## 2. Prefijo de administración configurable (re-encaminado)
|
||||
|
||||
> Originalmente "middleware de ofuscación"; sustituido por el pivote al
|
||||
> prefijo configurable. El middleware roto y `ADMIN_ROUTES`/`ROUTE_REGEXPS`
|
||||
> se eliminaron del servidor.
|
||||
|
||||
- [x] 2.1 Montar las rutas admin bajo `ADMIN_PREFIX` (`LOCALESP_ADMIN_PREFIX`, **obligatoria y sin valor por defecto**: fail-fast al arrancar si falta; template en `.env.example`, que el servidor autocarga sin pisar el entorno)
|
||||
- [x] 2.2 Rutas bajo prefijo: `pendientes`, `aprobar/:id`, `rechazar/:id`, `locales/:id` (DELETE), `reportes`, `reportes/:id/descartar` — sin middleware ni matching por patrón
|
||||
- [x] 2.3 Posición: mismas posiciones que las rutas originales; el fallback SPA sigue excluyendo `api/`
|
||||
- [x] 2.4 Verificado por tests: las rutas históricas bajo `/api` devuelven 404 cuando el prefijo está configurado
|
||||
|
||||
## 3. Verificar que las rutas no-admin siguen funcionando
|
||||
|
||||
- [x] 3.1 `GET /api/locales` → 200 con lista de locales (test)
|
||||
- [x] 3.2 `POST /api/propuestas` → 201 con la propuesta creada (test)
|
||||
- [x] 3.3 Fallback SPA `GET /` sirve `index.html` (test, aserción case-insensitive)
|
||||
|
||||
## 4. Documentación
|
||||
|
||||
- [x] 4.1 Documentar las reglas de protección y las rutas afectadas en el spec (`specs/route-obfuscation/spec.md`, actualizado al enfoque de prefijo)
|
||||
- [x] 4.2 README actualizado: tabla de rutas admin bajo prefijo, variable única `LOCALESP_ADMIN_PREFIX` (servidor + proxy dev + build), proxy de dev y advertencia de que es ocultación, no autenticación
|
||||
- [x] 4.3 `DELETE /api/locales/:id` — decidido por el usuario: pasa al prefijo configurable (test cubre borrado bajo prefijo y 404 en la ruta antigua)
|
||||
|
||||
## 5. Pruebas
|
||||
|
||||
> Con el enfoque de prefijo, "protegida" = la ruta histórica bajo `/api` ya no
|
||||
> tiene handler (404 idéntico para cualquier método, query, extensión o
|
||||
> variante de cadena) y la funcionalidad vive bajo `$ADMIN_PREFIX`.
|
||||
> Cubierto por `tests/unit/test-routes.spec.js` (prefijo `/prefijo-admin-test`)
|
||||
> y `tests/unit/test-admin-prefix-default.spec.js` (prefijo por defecto).
|
||||
|
||||
### 5.1 Rutas públicas (deben funcionar sin cambios)
|
||||
- [x] 5.1 `GET /api/locales` → 200 (test)
|
||||
- [x] 5.2 `POST /api/propuestas` → 201 con cuerpo (test)
|
||||
- [x] 5.3 `POST /api/check-duplicado` → 200 con contrato `coincidencias` intacto (test)
|
||||
- [x] 5.4 N/A: no existe ruta `/health` ni middleware que la intercepte
|
||||
- [x] 5.5 `GET /` → 200 sirve `dist/index.html` (test, doctype case-insensitive)
|
||||
- [x] 5.6 N/A: assets estáticos los sirve `express.static` sin intervención
|
||||
- [x] 5.7 N/A: ídem
|
||||
- [x] 5.8 Corregido el enunciado: `GET /api/locales/123` → 404 (el fallback SPA siempre excluyó `api/`); sin fuga
|
||||
- [x] 5.9 `GET /api/config/filtro_palabras` → 200 (test)
|
||||
|
||||
### 5.2 Rutas protegidas (la ruta histórica devuelve 404; la función vive bajo prefijo)
|
||||
- [x] 5.10 `GET /api/pendientes` → 404 y `$P/pendientes` → 200 con datos (test)
|
||||
- [x] 5.11 `GET /api/reportes` → 404 y `$P/reportes` → 200 con datos (test)
|
||||
- [x] 5.12 `POST /api/locales/:id/reportar` → **pública** (la usa la web); su flujo admin (listar/descartar reportes) bajo prefijo (test)
|
||||
- [x] 5.13 `POST /api/locales/:id/confirmar` → **pública** (la usa la web); 200 renueva fecha (test)
|
||||
- [x] 5.14 `POST /api/aprobar/:id` → 404 en `/api`; bajo prefijo mueve a locales y saca de pendientes (test)
|
||||
- [x] 5.15 `POST /api/rechazar/:id` → 404 en `/api`; bajo prefido elimina pendiente (test)
|
||||
- [x] 5.16 `POST /api/reportes/:id/descartar` → 404 en `/api`; bajo prefijo descarta (test)
|
||||
|
||||
### 5.3 Comportamiento (evitar falsos positivos)
|
||||
- [x] 5.17 `GET /api/locales` → 200 (test)
|
||||
- [x] 5.18/5.19/5.20 Corregido el enunciado: cualquier GET bajo `api/` sin handler → 404 (el fallback SPA siempre excluyó `api/`); sin middleware que bloquee de más
|
||||
- [x] 5.21 `GET /API/PENDIENTES` → sin handler API; cae al fallback SPA sin datos (test)
|
||||
- [x] 5.22 `GET /api/pendientes/extra` → 404 (test)
|
||||
- [x] 5.23 `POST /api/locales/:id/reponer` → 404 (sin handler)
|
||||
|
||||
### 5.4 Pruebas de seguridad (enumeración y rutas maliciosas)
|
||||
- [x] 5.24 `GET /api/pendientes.json` → 404 (test)
|
||||
- [x] 5.25 `GET /api/pending` / `/api/xpendientes` → 404 (test)
|
||||
- [x] 5.26–5.34 Sin handler bajo `/api`, cualquier método/query/extensión/cadena recibe el mismo 404 (por construcción); las variantes que no empiezan por `api/` reciben el HTML genérico del fallback SPA, sin datos
|
||||
- [x] 5.35 `GET /api/xpendientes` → 404 (test)
|
||||
|
||||
### 5.5 Pruebas de regresión y no-regresión
|
||||
- [x] 5.36 `POST /api/propuestas` → 201 con campos correctos (test); payload malformado gestionado por la BD/validación existente (sin cambios en este cambio)
|
||||
- [x] 5.38 `DELETE` bajo prefijo → 200 y borra local + reportes (test); ruta antigua → 404
|
||||
- [x] 5.39–5.44 N/A o por construcción: no hay middleware, no hay cabeceras especiales ni logs nuevos
|
||||
- [x] Suite completa previa (componentes incluidos) en verde: 110/110
|
||||
|
||||
### 5.6 Validación contra el esquema de base de datos
|
||||
- [x] 5.45 `GET /api/locales` sin cambios de columnas (no se tocó la query)
|
||||
- [x] 5.46 `POST /api/propuestas` sin cambios (ídem)
|
||||
- [x] 5.47 `$P/reportes` devuelve exactamente lo que devolvía `/api/reportes` (misma query)
|
||||
|
||||
## 6. Limpieza
|
||||
|
||||
- [x] 6.1 N/A tras el pivote: no hay lista `ADMIN_ROUTES`
|
||||
- [x] 6.2 `DELETE /api/locales/:id` resuelto: vive bajo el prefijo (4.3)
|
||||
- [x] 6.3 N/A tras el pivote: `reportes/:id/descartar` montado bajo prefijo y verificado por test
|
||||
- [x] 6.4 Ficheros de prueba duplicados/muertos eliminados: `tests/integration/test-hide-admin-route.js` (nunca recogido por ningún include y con sintaxis rota) y `vitest.config.js` redundante (pisaba `vitest.config.mjs`, que es la config vigente); se conserva un único `tests/unit/test-routes.spec.js` (+ el de prefijo obligatorio)
|
||||
|
||||
## 7. Seguimiento: protección fina por método
|
||||
|
||||
> Obsoleto tras el pivote: el prefijo configurable ya separa superficie
|
||||
> pública y admin sin matching por método. Si en el futuro se añade
|
||||
> autenticación real, este apartado queda como referencia.
|
||||
|
||||
## 8. Bloqueadores para cerrar el cambio
|
||||
|
||||
- [x] 8.1 Obsoleto: el middleware se eliminó (pivote al prefijo)
|
||||
- [x] 8.2 El handler de `GET pendientes` existe de nuevo, montado bajo el prefijo: quien conoce la URL prefijada obtiene los datos; la ruta `/api/pendientes` histórica devuelve 404
|
||||
- [x] 8.3 Suite en verde: 109/109 tests (19 de rutas/prefijo en 2 ficheros: configurado + obligatorio)
|
||||
- [x] 8.4 Aserción del SPA corregida (comparación case-insensitive de `<!doctype html>`)
|
||||
- [x] 8.5 Revertidos los cambios fuera de alcance: `distanciaMetros` (haversine) restaurada, `db`→`Db` deshecho, comentarios originales restaurados, contrato `coincidencias` intacto, `src/App.jsx` (resaltado `?local=ID` + bloque de estadísticas) restaurado vía `git checkout`, `vite.config.js` limpio (solo proxy + prefijo de dev), `package-lock.json` revertido
|
||||
- [x] 8.6 README actualizado (4.2) y `DELETE /api/locales/:id` decidido (4.3)
|
||||
@@ -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
|
||||
@@ -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,52 @@
|
||||
# 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.
|
||||
|
||||
> **Estado:** implementado y verificado. `./node_modules/.bin/vitest run` →
|
||||
> **132/132 en verde** (19 ficheros), con 18 tests nuevos: 9 de rutas en
|
||||
> `test-resenas.spec.js` (upsert, contrato 400/404, filtro, media, reportes
|
||||
> y moderación admin), 1 de rate-limit 429 en `test-resenas-ratelimit.spec.js`
|
||||
> y 6 de componente en `ResenasLocal.spec.jsx` (mockeando api.js). Extra no
|
||||
> previsto en las tareas y añadido para cubrir el escenario del spec
|
||||
> «borrado admin desde el panel»: botón «🗑 Borrar reseña» en la pestaña
|
||||
> Reportes del AdminPanel (borra la reseña y descarta el aviso).
|
||||
|
||||
## 1. BD (server/db.js)
|
||||
|
||||
- [x] 1.1 Crear tabla `resenas` (id, localId, deviceId, puntuacion 1–5 CHECK, comentario, fecha, fechaEdicion, UNIQUE(localId, deviceId))
|
||||
- [x] 1.2 `ensureColumn("reportes", "resenaId", "TEXT")` para reportar reseñas concretas
|
||||
|
||||
## 2. Servidor (server/index.js)
|
||||
|
||||
- [x] 2.1 Helper `recalcularMedia(localId)`: `UPDATE locales SET puntuacion = ROUND(AVG(resenas.puntuacion))` (0 si vacío)
|
||||
- [x] 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)); `?deviceId=` marca `esPropia`
|
||||
- [x] 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
|
||||
- [x] 2.4 `DELETE /api/locales/:id/resenas` con deviceId → borra la propia (200) y recalcula; 404 si no tiene reseña
|
||||
- [x] 2.5 Rate-limit por IP en POST/DELETE de reseñas (mapa en memoria, ventana 1h, `LOCALESP_RESENAS_RATELIMIT_MAX` configurable, 429 + Retry-After)
|
||||
- [x] 2.6 Extender `POST /api/locales/:id/reportar` para aceptar `resenaId` opcional (404 si la reseña no existe en ese local)
|
||||
- [x] 2.7 Admin bajo prefijo: `GET $PREFIX/resenas` (lista con localNombre) y `DELETE $PREFIX/resenas/:id` (borrado de moderación + recálculo)
|
||||
- [x] (extra) `GET /api/locales` incluye `totalResenas` por local (para plegar "Reseñas (N)" sin expandir)
|
||||
|
||||
## 3. Frontend
|
||||
|
||||
- [x] 3.1 Util `deviceId` persistente en localStorage (`src/utils/dispositivo.js`; UUID v4 con fallback, tolerante a almacenamiento no disponible)
|
||||
- [x] 3.2 Cliente API de reseñas en `src/api.js` (listar con deviceId, enviar upsert, borrar propia, `obtenerResenas`/`borrarResenaAdmin` de moderación) + re-exports en `firebase.js`; `reportarLocal` acepta `resenaId`
|
||||
- [x] 3.3 `StarRating` interactivo: ya existía (`onChange` con role="radio"); usado tal cual en el formulario
|
||||
- [x] 3.4 Componente `ResenasLocal` desplegable: cabecera "★media · Reseñas (N)", carga perezosa al expandir, lista (huella, estrellas, comentario, fecha, marca "editada", ⚑ reportar ajenas) y formulario inline (estrellas + textarea 500 + Publicar/Actualizar + Borrar mi reseña); errores (filtro/429) como alerta
|
||||
- [x] 3.5 Integrar en `LocalCard.jsx` (sustituye la fila de estrellas read-only; la media y el total se actualizan en local tras escribir) + botón «🗑 Borrar reseña» en el AdminPanel (pestaña Reportes, para reportes con resenaId)
|
||||
- [x] 3.6 Popup del mapa, orden "★ Mejor" y media global consumen `local.puntuacion` (ahora media agregada): sin cambios, verificado por revisión de código (los tres leen el mismo campo)
|
||||
|
||||
## 4. Tests
|
||||
|
||||
- [x] 4.1 `tests/unit/test-resenas.spec.js`: upsert (una por dispositivo), 400 sin puntuacion/fuera de rango/comentario >500/deviceId inválido, 404 local inexistente, filtro de palabras server-side, recálculo de media al crear/editar/borrar (ROUND: 4.5→5, 2.5→3), reporte con resenaId, listado/borrado admin con recálculo, `totalResenas` en `/api/locales`
|
||||
- [x] 4.2 `tests/component/ResenasLocal.spec.jsx`: plegado sin cargar, expansión con carga perezosa (huella, estrellas, deviceId en localStorage), envío con estrellas+comentario, precarga de la propia (Actualizar/Borrar), reporte de ajena con resenaId, aviso de error del servidor
|
||||
- [x] 4.3 Suite completa en verde: `./node_modules/.bin/vitest run` → **132/132** (+`tests/unit/test-resenas-ratelimit.spec.js`: 429 con Retry-After, DELETE limitado, lectura disponible)
|
||||
|
||||
## 5. Cierre
|
||||
|
||||
- [x] 5.1 README: sección «Reseñas por local (issue #6)» (contrato público, moderación, anonimato y huella, rate-limit) + rutas admin nuevas en la tabla + `.env.example` con `LOCALESP_RESENAS_RATELIMIT_MAX`
|
||||
- [x] 5.2 Referenciar la issue #6 en el commit de cierre y verificar despliegue en prototipo-yb01.localesp.es — commit `38ea283` (ref. issue #6 en el título); verificado en producción: bundle nuevo con la sección de reseñas, `totalResenas` en los 3 locales, `GET …/resenas` 200 (vacío), 404s correctos y `$PREFIX/resenas` 200
|
||||
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-10-11
|
||||
@@ -0,0 +1,106 @@
|
||||
# Design: Rediseño de la tarjeta de local
|
||||
|
||||
## Context
|
||||
|
||||
Decisiones de entrevista (2026-10-11): Marcar = favorito **solo** en la barra
|
||||
(el corazón sale de la cabecera); **2 reseñas** visibles en primera vista;
|
||||
"Comentar" **expande y enfoca** el formulario inline (no modal); barra de
|
||||
**4 botones** (Comentar · Reportar · Marcar · Compartir) con la fecha en
|
||||
pequeñito encima y el banner "Sigue aquí" cuando toque. Sin cambios de
|
||||
backend: es un redisefo de `LocalCard` + `ResenasLocal` + `ReportarLocal`.
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:**
|
||||
- Jerarquía clara: descripción (datos del local) encima; reseñas (contenido
|
||||
vivo) debajo, con 2 visibles sin interacción.
|
||||
- Expansión animada que amplíe la tarjeta revelando todo + formulario.
|
||||
- Acciones primarias siempre visibles en una barra inferior a ancho completo.
|
||||
|
||||
**Non-Goals:**
|
||||
- Cambios de API/BD (la carga es la misma de `GET …/resenas`, solo cambia
|
||||
cuándo se dispara).
|
||||
- Paginación/límite de reseñas por local (futuro si hay locales muy reseñados).
|
||||
- Virtualización del listado de tarjetas (cada tarjeta hace 1 fetch de
|
||||
reseñas al montar; con pocos locales es irrelevante).
|
||||
|
||||
## Decisions
|
||||
|
||||
1. **Carga de reseñas al montar** (`useEffect` en `ResenasLocal`) en vez de
|
||||
al expandir: la vista previa debe existir sin interacción. Se refresca al
|
||||
expandir y tras cada escritura. El polling general de locales (5 s) no
|
||||
refresca reseñas (no hace falta).
|
||||
|
||||
2. **Vista previa = 2 reseñas más recientes** (`slice(0, 2)`), la lista
|
||||
completa vive dentro de la zona animada. Cabecera: `★ media · Reseñas (N)`
|
||||
+ chevron con `aria-expanded`. Si hay más de 2, una pista "Ver las N
|
||||
reseñas ▾" bajo la vista previa también expande (área de toque generosa).
|
||||
|
||||
3. **Animación con `grid-template-rows: 0fr → 1fr`** (contenedor
|
||||
`display: grid`, hijo `overflow: hidden`, `transition` 350 ms). Mejor que
|
||||
`max-height` fijado a ojo (no hay que estimar altura ni recortar contenido
|
||||
largo) y soportada por todos los navegadores actuales. Con estilos inline,
|
||||
sin tocar CSS global.
|
||||
|
||||
4. **`comentar()` imperativo vía `forwardRef` + `useImperativeHandle`** en
|
||||
`ResenasLocal`: la barra de `LocalCard` llama al ref → `setAbierto(true)`
|
||||
→ tras ~360 ms (fin de la transición) `scrollIntoView({ behavior:
|
||||
"smooth", block: "nearest" })` del formulario y foco en la primera
|
||||
estrella. `scrollIntoView` se llama con encadenamiento opcional (jsdom no
|
||||
lo implementa y los tests no deben romperse).
|
||||
|
||||
5. **`ReportarLocal` controlado:** props `{ localId, onCerrar,
|
||||
inicialAbierto }`; la barra lo monta con `inicialAbierto` y `onCerrar` lo
|
||||
desmonta. Se mantiene autónomo en su lógica de envío (motivo, comentario,
|
||||
estado enviado). Se renderiza justo encima de la barra, donde vivía el
|
||||
enlace "Reportar".
|
||||
|
||||
6. **Barra inferior = 4 botones iguales** (`flex: 1`, icono Tabler encima y
|
||||
etiqueta debajo, ~11 px), separada por borde superior; "Marcar" usa
|
||||
`aria-pressed` + corazón relleno rojizo cuando es favorito. En móvil los 4
|
||||
caben en un tercio de ancho cada uno sin wrap; si algún día crece, se
|
||||
permite `flexWrap`.
|
||||
|
||||
7. **Cabecera limpia:** salen el corazón y compartir; queda nombre +
|
||||
provincia. `CategoriaBadge`, dirección y enlaces Maps/Waze no cambian.
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- [Un fetch de reseñas por tarjeta al montar] → aceptable con pocos locales
|
||||
(prod tiene 3); si crece, batch endpoint (`?ids=`) como endurecimiento.
|
||||
- [Animación `grid-template-rows` en navegadores viejos] → degrada a salto
|
||||
seco sin romper nada (la propiedad anima o ignora).
|
||||
- [Vista previa + zona animada duplican render de tarjetas de reseña] → las
|
||||
2 primeras se renderizan una vez (fuera de la zona animada); dentro solo
|
||||
van de la 3ª en adelante. Sin duplicación real.
|
||||
|
||||
## Migration Plan
|
||||
|
||||
Puro frontend, desplegar y ya. Rollback = revert.
|
||||
|
||||
## Open Questions
|
||||
|
||||
(nada bloqueante; el número mágico 2 de la vista previa y los 350 ms de la
|
||||
transición son fácilmente ajustables)
|
||||
|
||||
## Iteración 2 (feedback de usuario, 2026-10-11)
|
||||
|
||||
Problemas reportados: (a) no había forma evidente de cerrar la sección de
|
||||
reseñas (el único cierre era el chevron diminuto y "Comentar" solo
|
||||
expandía); (b) demasiadas cajas anidadas (caja del formulario dentro de la
|
||||
zona expandida dentro de la tarjeta). Decisiones:
|
||||
|
||||
1. **Cierre por tres vías:** el chevron de la cabecera alterna (ya lo hacía;
|
||||
se comprueba con test), "Comentar" pasa a ser **toggle** (abre con foco /
|
||||
cierra), y el formulario plano gana un botón **"Cerrar"**.
|
||||
2. **Grid de reseñas:** vista previa de **3** reseñas en fila
|
||||
(`repeat(auto-fit, minmax(120px, 1fr))`: ocupan toda la anchura sean 1,
|
||||
2 o 3); al expandir, el resto aparece en el mismo grid. Comentarios con
|
||||
`line-clamp: 3` y fecha corta con `text-overflow` para que quepan
|
||||
"estrechadas".
|
||||
3. **Menos anidamiento:** el formulario deja de ser una caja (sin fondo ni
|
||||
borde propio): solo un `border-top` que lo separa del grid. Las tarjetas
|
||||
de reseña (fondo suave) son el único nivel de caja interior.
|
||||
4. **Acciones por tarjeta de reseña:** "Borrar" solo en las propias
|
||||
(`esPropia`), "Reportar" solo en las ajenas (con estado "✅ reportada").
|
||||
El botón "Borrar mi reseña" del formulario desaparece (redundante).
|
||||
@@ -0,0 +1,59 @@
|
||||
# Proposal: Rediseño de la tarjeta de local (usabilidad)
|
||||
|
||||
## Why
|
||||
|
||||
La sección de reseñas actual (fila plegable donde antes estaban las estrellas)
|
||||
esconde todo el contenido tras un clic y mezcla jerarquías: la descripción del
|
||||
local queda debajo de las reseñas y las acciones están dispersas (corazón y
|
||||
compartir en la cabecera, reportar abajo en pequeñito). La tarjeta necesita
|
||||
una jerarquía clara: la descripción del local es del local; las reseñas son
|
||||
contenido vivo que debe verse sin fricción; y las acciones primarias merecen
|
||||
una barra propia y visible.
|
||||
|
||||
## What Changes
|
||||
|
||||
- **Descripción separada y encima:** `local.descripcion` deja de convivir con
|
||||
las reseñas y se muestra en su propio bloque, encima de la sección de
|
||||
reseñas.
|
||||
- **Reseñas con vista previa:** la sección de reseñas carga al montar la
|
||||
tarjeta y muestra **2 reseñas visibles en la primera vista** (las más
|
||||
recientes) con la cabecera "★ media · Reseñas (N)".
|
||||
- **Expansión animada:** al expandir, una animación (transición CSS) amplía la
|
||||
tarjeta revelando **todas** las reseñas y el formulario inline.
|
||||
- **Barra inferior de acciones a ancho completo:** el pie de la tarjeta queda
|
||||
cubierto por cuatro botones — **Comentar · Reportar · Marcar · Compartir**:
|
||||
- *Comentar*: expande la sección de reseñas (si estaba plegada), hace
|
||||
scroll suave hasta el formulario y enfoca las estrellas.
|
||||
- *Reportar*: abre el formulario de reporte del local (antes era un
|
||||
textuelo "Reportar").
|
||||
- *Marcar*: favorito (el corazón desaparece de la cabecera; estado activo
|
||||
visible en la barra).
|
||||
- *Compartir*: el share se muda de la cabecera a la barra.
|
||||
- La fecha ("Publicado …") queda en pequeñito justo encima de la barra; el
|
||||
aviso "Sigue aquí ✅" se mantiene como banner cuando corresponde, encima de
|
||||
la barra.
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
|
||||
- `tarjeta-local`: estructura y acciones de la tarjeta de local — orden de
|
||||
bloques (descripción sobre reseñas), barra inferior de acciones y sus
|
||||
comportamientos.
|
||||
|
||||
### Modified Capabilities
|
||||
|
||||
- `resenas-por-local`: el requisito "Sección de reseñas desplegable en la
|
||||
tarjeta del local" cambia de carga perezosa tras clic a **carga en la
|
||||
primera vista con 2 reseñas visibles** y expansión **animada** que revela
|
||||
todas + formulario, abrible también desde "Comentar".
|
||||
|
||||
## Impact
|
||||
|
||||
- **Frontend:** `LocalCard.jsx` (reestructura + barra), `ResenasLocal.jsx`
|
||||
(carga al montar, vista previa de 2, animación, `comentar()` imperativo),
|
||||
`ReportarLocal.jsx` (controlado: se abre desde la barra).
|
||||
- **Tests:** rework de `ResenasLocal.spec.jsx` (carga temprana, 2 visibles,
|
||||
expansión, comentar) y nuevo `LocalCard.spec.jsx` (barra de 4, descripción
|
||||
encima, Marcar activo).
|
||||
- **Sin cambios** de backend, BD ni API.
|
||||
+30
@@ -0,0 +1,30 @@
|
||||
# Delta: resenas-por-local (UI de la sección de reseñas)
|
||||
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Sección de reseñas desplegable en la tarjeta del local
|
||||
La tarjeta de cada local SHALL incluir una sección "★ media · Reseñas (N)" que carga sus reseñas al montar la tarjeta y muestra las 3 primeras en una fila de tarjetas que ocupa toda la anchura de la tarjeta; al expandirla, una animación amplía la tarjeta revelando el resto de reseñas en el mismo grid y el formulario inline plano (estrellas interactivas 1–5 y comentario opcional de 500 caracteres). Cada tarjeta de reseña SHALL incluir un botón "Borrar" cuando sea propia del dispositivo y un botón "Reportar" cuando sea ajena. La sección SHALL poder cerrarse desde la cabecera, desde el botón "Comentar" de la barra inferior (que alterna) y desde un botón "Cerrar" del formulario.
|
||||
|
||||
#### Scenario: Vista previa sin expandir
|
||||
- **WHEN** se muestra la tarjeta de un local con reseñas
|
||||
- **THEN** la sección presenta la media, el total y las 3 reseñas más recientes en fila ocupando toda la anchura, sin interacción
|
||||
|
||||
#### Scenario: Expansión animada
|
||||
- **WHEN** el usuario expande la sección de reseñas
|
||||
- **THEN** la tarjeta se amplía con una animación que revela el resto de reseñas en el mismo grid y el formulario
|
||||
|
||||
#### Scenario: Cierre accesible
|
||||
- **WHEN** la sección está expandida
|
||||
- **THEN** puede cerrarse desde la cabecera, pulsando de nuevo "Comentar" o con el botón "Cerrar" del formulario
|
||||
|
||||
#### 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 y borrable desde su tarjeta
|
||||
- **WHEN** el dispositivo ya tiene reseña en ese local
|
||||
- **THEN** el formulario aparece precargado al expandir (Actualizar) y su tarjeta de reseña incluye un botón "Borrar"
|
||||
|
||||
#### Scenario: Reportar una reseña ajena
|
||||
- **WHEN** el usuario pulsa "Reportar" en una tarjeta de reseña ajena
|
||||
- **THEN** se envía el reporte de esa reseña y la tarjeta lo refleja
|
||||
+33
@@ -0,0 +1,33 @@
|
||||
# Delta Spec: tarjeta-local (nueva capacidad)
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Estructura de la tarjeta de local
|
||||
La tarjeta de cada local SHALL presentar sus bloques en este orden: nombre y provincia en la cabecera, categoría, dirección, enlaces de navegación, descripción del local (si existe), sección de reseñas, aviso de confirmación (cuando corresponda), fecha de publicación y, como pie, la barra inferior de acciones.
|
||||
|
||||
#### Scenario: La descripción va encima de las reseñas
|
||||
- **WHEN** un local tiene descripción y reseñas
|
||||
- **THEN** la descripción se muestra como bloque propio, inmediatamente encima de la sección de reseñas y sin mezclarse con ella
|
||||
|
||||
#### Scenario: Local sin descripción
|
||||
- **WHEN** un local no tiene descripción
|
||||
- **THEN** la tarjeta pasa de los enlaces de navegación directamente a la sección de reseñas
|
||||
|
||||
### Requirement: Barra inferior de acciones
|
||||
El pie de la tarjeta SHALL estar ocupado por una barra de botones a ancho completo con, de momento, cuatro acciones: Comentar, Reportar, Marcar y Compartir. La fecha de publicación SHALL quedar como texto secundario justo encima de la barra, y el aviso de confirmación ("Sigue aquí") SHALL mostrarse como banner encima de la barra cuando corresponda.
|
||||
|
||||
#### Scenario: Comentar
|
||||
- **WHEN** el usuario pulsa "Comentar"
|
||||
- **THEN** la sección de reseñas se expande si estaba plegada (con desplazamiento suave hasta el formulario y foco en la valoración) y se cierra si estaba expandida
|
||||
|
||||
#### Scenario: Reportar
|
||||
- **WHEN** el usuario pulsa "Reportar"
|
||||
- **THEN** se abre el formulario de reporte del local encima de la barra, sin salir de la tarjeta
|
||||
|
||||
#### Scenario: Marcar
|
||||
- **WHEN** el usuario pulsa "Marcar" en un local no marcado
|
||||
- **THEN** el local pasa a ser favorito y el botón refleja el estado activo (y viceversa al pulsar de nuevo)
|
||||
|
||||
#### Scenario: Compartir
|
||||
- **WHEN** el usuario pulsa "Compartir"
|
||||
- **THEN** se abre el flujo de compartir del local (nativo del dispositivo o WhatsApp con enlace copiado)
|
||||
@@ -0,0 +1,52 @@
|
||||
# Tasks: Rediseño de la tarjeta de local (usabilidad)
|
||||
|
||||
> **Estado:** implementado y verificado. `./node_modules/.bin/vitest run` →
|
||||
> **138/138 en verde** (20 ficheros): rework de `ResenasLocal.spec.jsx`
|
||||
> (7 tests: carga al montar, vista previa de 2 con la tercera oculta por
|
||||
> aria-hidden, expansión, comentar() con foco, envío, propia precargada,
|
||||
> reporte y error) y nuevo `LocalCard.spec.jsx` (5 tests: descripción encima
|
||||
> por orden DOM, barra de 4, Marcar aria-pressed + persistencia, reporte
|
||||
> controlado, Comentar expande y enfoca).
|
||||
|
||||
> Decisiones de entrevista (2026-10-11): Marcar = favorito solo en la barra,
|
||||
> 2 reseñas visibles plegada, "Comentar" expande + enfoca el formulario, barra
|
||||
> de 4 (Comentar · Reportar · Marcar · Compartir), fecha pequeñita encima y
|
||||
> banner "Sigue aquí" cuando toque. Sin cambios de backend.
|
||||
|
||||
## 1. ResenasLocal (vista previa + animación + comentar)
|
||||
|
||||
- [x] 1.1 Cargar las reseñas al montar (`useEffect`) en vez de al expandir; refrescar al expandir y tras cada escritura
|
||||
- [x] 1.2 Vista previa: mostrar las 2 reseñas más recientes sin expandir; cabecera "★ media · Reseñas (N)" + chevron `aria-expanded`; pista "Ver las N reseñas ▾" cuando haya más de 2
|
||||
- [x] 1.3 Zona animada `grid-template-rows: 0fr → 1fr` (350 ms, hijo `overflow: hidden`) que contiene el resto de reseñas y el formulario
|
||||
- [x] 1.4 `comentar()` imperativo (`forwardRef` + `useImperativeHandle`): expande, scroll suave hasta el formulario (`scrollIntoView` opcional-safe) y foco en la primera estrella tras la transición
|
||||
|
||||
## 2. ReportarLocal controlado
|
||||
|
||||
- [x] 2.1 Props `{ localId, onCerrar, inicialAbierto }`: montar ya abierto desde la barra; "Cancelar" desmonta vía `onCerrar` (mantener el flujo motivo/comentario/enviado intacto)
|
||||
|
||||
## 3. LocalCard (reestructura + barra de acciones)
|
||||
|
||||
- [x] 3.1 Cabecera limpia: fuera corazón y compartir; queda nombre + provincia (CategoriaBadge, dirección y enlaces sin cambios)
|
||||
- [x] 3.2 Descripción del local en bloque propio ENCIMA de la sección de reseñas
|
||||
- [x] 3.3 Barra inferior a ancho completo con 4 botones (icono + etiqueta): Comentar (→ `resenasRef.comentar()`), Reportar (monta el formulario encima de la barra), Marcar (`aria-pressed`, corazón relleno en activo) y Compartir (flujo existente)
|
||||
- [x] 3.4 Fecha "Publicado …" en pequeñito justo encima de la barra; banner "Sigue aquí" y mensaje de confirmado encima de la barra cuando corresponda
|
||||
|
||||
## 4. Tests
|
||||
|
||||
- [x] 4.1 Rework de `tests/component/ResenasLocal.spec.jsx`: carga al montar sin expandir, vista previa de 2 (y pista "Ver las N"), expansión muestra todas + formulario, `comentar()` via ref expande y enfoca, propia precargada (Actualizar/Borrar), reporte de ajena, error de servidor
|
||||
- [x] 4.2 Nuevo `tests/component/LocalCard.spec.jsx`: descripción encima de la sección de reseñas, barra con los 4 botones, "Marcar" alterna `aria-pressed`, "Reportar" abre el formulario controlado
|
||||
- [x] 4.3 Suite completa en verde: `./node_modules/.bin/vitest run`
|
||||
|
||||
## 5. Cierre
|
||||
|
||||
- [x] 5.1 Commit + push y verificación del despliegue en prototipo-yb01.localesp.es
|
||||
|
||||
## 6. Iteración 2 (feedback de usuario: cierre + grid)
|
||||
|
||||
- [x] 6.1 Cierre por tres vías: "Comentar" pasa a alternar (toggle), botón "Cerrar" en el formulario, chevron de la cabecera (diagnóstico: la lógica ya alternaba; era un problema de afordancia)
|
||||
- [x] 6.2 Vista previa de 3 reseñas en grid que ocupa toda la anchura (`repeat(auto-fit, minmax(120px, 1fr))`), con comentario acotado a 3 líneas y fecha corta
|
||||
- [x] 6.3 Al expandir, el resto de reseñas aparece en el mismo grid
|
||||
- [x] 6.4 Formulario plano (sin caja: solo `border-top`) para eliminar las cajas anidadas
|
||||
- [x] 6.5 Acciones por tarjeta de reseña: "Borrar" en las propias y "Reportar" en las ajenas; fuera el "Borrar mi reseña" del formulario
|
||||
- [x] 6.6 Tests actualizados (toggle de cierre por cabecera/Comentar/Cerrar, grid de 3, borrar/reportar por tarjeta) y suite en verde
|
||||
- [x] 6.7 Ajuste fino a petición del usuario: un poco más de padding en las tarjetas de reseña (8px/8px/6px → 10px/10px/8px), desplegado y verificado (bundle index-CeuX36oZ.js)
|
||||
@@ -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) Nombre, 3) Provincia, 4) Categoría, 5) Tipo específico (opcional), 6) 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,12 +36,16 @@ La pasarela SHALL presentar las pantallas en este orden: 1) Ubicación, 2) Nombr
|
||||
- **WHEN** el usuario está en la pantalla de Tipo específico
|
||||
- **THEN** puede continuar sin seleccionar ninguna subcategoría
|
||||
|
||||
### Requirement: Inferencia de Nombre y Provincia desde la Ubicación
|
||||
El sistema SHALL pre-rellenar los campos Nombre y Provincia a partir de la ubicación introducida en la primera pantalla (geocodificación inversa), permitiendo al usuario corregirlos.
|
||||
#### Scenario: Descripción omitible
|
||||
- **WHEN** el usuario está en la pantalla de Descripción
|
||||
- **THEN** puede continuar sin escribir ninguna descripción
|
||||
|
||||
#### Scenario: Nombre y provincia pre-rellenados
|
||||
### 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).
|
||||
|
||||
#### Scenario: Datos pre-rellenados en su pantalla conjunta
|
||||
- **WHEN** el usuario introduce una ubicación válida en la primera pantalla y esta se resuelve con éxito
|
||||
- **THEN** al llegar a las pantallas de Nombre y Provincia ambos campos aparecen pre-rellenados con los valores inferidos
|
||||
- **THEN** al llegar a la pantalla de Datos del local los campos nombre, provincia y dirección aparecen pre-rellenados con los valores inferidos
|
||||
|
||||
#### Scenario: Valores corregibles
|
||||
- **WHEN** los valores inferidos no son correctos
|
||||
@@ -49,14 +53,22 @@ El sistema SHALL pre-rellenar los campos Nombre y Provincia a partir de la ubica
|
||||
|
||||
#### Scenario: Degradación sin inferencia
|
||||
- **WHEN** la inferencia falla o devuelve campos vacíos
|
||||
- **THEN** las pantallas de Nombre y Provincia aparecen vacías y el usuario los rellena manualmente, sin bloquear la pasarela
|
||||
- **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
|
||||
|
||||
@@ -0,0 +1,111 @@
|
||||
# Reseñas por local
|
||||
|
||||
## Purpose
|
||||
|
||||
Reseñas anónimas múltiples por local (issue #6): una por dispositivo, editables y borrables por su autor; la puntuación del local pasa a ser la media de sus reseñas. Publicación directa con filtro de palabras, reportes y moderación admin; identidad anónima con huella corta por local (estilo 4chan, sin datos personales) y rate-limit por IP como defensa anti-boicot base.
|
||||
|
||||
## 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 "★ media · Reseñas (N)" que carga sus reseñas al montar la tarjeta y muestra las 3 primeras en una fila de tarjetas que ocupa toda la anchura de la tarjeta; al expandirla, una animación amplía la tarjeta revelando el resto de reseñas en el mismo grid y el formulario inline plano (estrellas interactivas 1–5 y comentario opcional de 500 caracteres). Cada tarjeta de reseña SHALL incluir un botón "Borrar" cuando sea propia del dispositivo y un botón "Reportar" cuando sea ajena. La sección SHALL poder cerrarse desde la cabecera, desde el botón "Comentar" de la barra inferior (que alterna) y desde un botón "Cerrar" del formulario.
|
||||
|
||||
#### Scenario: Vista previa sin expandir
|
||||
- **WHEN** se muestra la tarjeta de un local con reseñas
|
||||
- **THEN** la sección presenta la media, el total y las 3 reseñas más recientes en fila ocupando toda la anchura, sin interacción
|
||||
|
||||
#### Scenario: Expansión animada
|
||||
- **WHEN** el usuario expande la sección de reseñas
|
||||
- **THEN** la tarjeta se amplía con una animación que revela el resto de reseñas en el mismo grid y el formulario
|
||||
|
||||
#### Scenario: Cierre accesible
|
||||
- **WHEN** la sección está expandida
|
||||
- **THEN** puede cerrarse desde la cabecera, pulsando de nuevo "Comentar" o con el botón "Cerrar" del formulario
|
||||
|
||||
#### 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 y borrable desde su tarjeta
|
||||
- **WHEN** el dispositivo ya tiene reseña en ese local
|
||||
- **THEN** el formulario aparece precargado al expandir (Actualizar) y su tarjeta de reseña incluye un botón "Borrar"
|
||||
|
||||
#### Scenario: Reportar una reseña ajena
|
||||
- **WHEN** el usuario pulsa "Reportar" en una tarjeta de reseña ajena
|
||||
- **THEN** se envía el reporte de esa reseña y la tarjeta lo refleja
|
||||
@@ -0,0 +1,37 @@
|
||||
# Tarjeta de local
|
||||
|
||||
## Purpose
|
||||
|
||||
Estructura y acciones de la tarjeta de local en la web pública: orden de bloques (cabecera, categoría, dirección, enlaces, descripción ENCIMA de las reseñas, fecha y barra de acciones) y la barra inferior de acciones (Comentar · Reportar · Marcar · Compartir).
|
||||
|
||||
## Requirements
|
||||
|
||||
### Requirement: Estructura de la tarjeta de local
|
||||
La tarjeta de cada local SHALL presentar sus bloques en este orden: nombre y provincia en la cabecera, categoría, dirección, enlaces de navegación, descripción del local (si existe), sección de reseñas, aviso de confirmación (cuando corresponda), fecha de publicación y, como pie, la barra inferior de acciones.
|
||||
|
||||
#### Scenario: La descripción va encima de las reseñas
|
||||
- **WHEN** un local tiene descripción y reseñas
|
||||
- **THEN** la descripción se muestra como bloque propio, inmediatamente encima de la sección de reseñas y sin mezclarse con ella
|
||||
|
||||
#### Scenario: Local sin descripción
|
||||
- **WHEN** un local no tiene descripción
|
||||
- **THEN** la tarjeta pasa de los enlaces de navegación directamente a la sección de reseñas
|
||||
|
||||
### Requirement: Barra inferior de acciones
|
||||
El pie de la tarjeta SHALL estar ocupado por una barra de botones a ancho completo con, de momento, cuatro acciones: Comentar, Reportar, Marcar y Compartir. La fecha de publicación SHALL quedar como texto secundario justo encima de la barra, y el aviso de confirmación ("Sigue aquí") SHALL mostrarse como banner encima de la barra cuando corresponda.
|
||||
|
||||
#### Scenario: Comentar
|
||||
- **WHEN** el usuario pulsa "Comentar"
|
||||
- **THEN** la sección de reseñas se expande si estaba plegada (con desplazamiento suave hasta el formulario y foco en la valoración) y se cierra si estaba expandida
|
||||
|
||||
#### Scenario: Reportar
|
||||
- **WHEN** el usuario pulsa "Reportar"
|
||||
- **THEN** se abre el formulario de reporte del local encima de la barra, sin salir de la tarjeta
|
||||
|
||||
#### Scenario: Marcar
|
||||
- **WHEN** el usuario pulsa "Marcar" en un local no marcado
|
||||
- **THEN** el local pasa a ser favorito y el botón refleja el estado activo (y viceversa al pulsar de nuevo)
|
||||
|
||||
#### Scenario: Compartir
|
||||
- **WHEN** el usuario pulsa "Compartir"
|
||||
- **THEN** se abre el flujo de compartir del local (nativo del dispositivo o WhatsApp con enlace copiado)
|
||||
@@ -0,0 +1,9 @@
|
||||
# entornos.alias.env — alias rama -> entorno (una línea: <slug-rama>=<slug-entorno>)
|
||||
#
|
||||
# Por defecto cada rama publica en <slug-rama>.localesp.es. Con un alias, la
|
||||
# rama comparte HOST, unit systemd, puerto y vhost con otro entorno, que es lo
|
||||
# que hace falta cuando el DNS sólo tiene configurado un subdominio.
|
||||
#
|
||||
# prototipo-ef -> se publica en prototipo-yb01.localesp.es (único subdominio
|
||||
# disponible), ocupando el entorno prototipo-yb01.
|
||||
prototipo-ef=prototipo-yb01
|
||||
@@ -0,0 +1,11 @@
|
||||
# entornos.env — prefijo admin por entorno de rama (una línea: <slug>=<prefijo>)
|
||||
#
|
||||
# El slug es el nombre de rama normalizado (minúsculas, [a-z0-9-]), igual que
|
||||
# Slug::from en scripts/lib/env.sh. LOCALESP_ADMIN_PREFIX es obligatoria: sin
|
||||
# entrada para el slug, build y deploy fallan (sin valor por defecto).
|
||||
# El prefijo NO es secreto: viaja igualmente en el bundle del frontend.
|
||||
#
|
||||
# Nuevos entornos: añade una línea con el slug de tu rama.
|
||||
prototipo-yb01=/administrador
|
||||
master=/administrador
|
||||
# prototipo-yb01-ef=/administrador
|
||||
+66
-1
@@ -24,6 +24,8 @@
|
||||
|
||||
DOMAIN="localesp.es"
|
||||
PORT_BASE=8082 # 8080/8081 son entornos legacy
|
||||
ENV_CONFIG_FILE="scripts/entornos.env" # mapping slug=prefijo admin (fichero del repo)
|
||||
ENV_ALIAS_FILE="scripts/entornos.alias.env" # mapping slug-rama=slug-entorno (fichero del repo)
|
||||
LOGGER_TAG="env"
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
@@ -49,6 +51,25 @@ Slug::from() {
|
||||
printf '%s' "$branch" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//'
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# EnvSlug — servicio estático: alias rama -> entorno.
|
||||
# ---------------------------------------------------------------------------
|
||||
# scripts/entornos.alias.env mapea <slug-rama>=<slug-entorno>. Con alias, la
|
||||
# rama reutiliza host, unit, puerto, destino y vhost del entorno indicado; sin
|
||||
# alias, el entorno es la propia rama (comportamiento histórico).
|
||||
EnvSlug::environment() {
|
||||
local slug="$1"
|
||||
local root="${2:-.}"
|
||||
local alias
|
||||
|
||||
alias="$(grep -E "^[[:space:]]*${slug}[[:space:]]*=" "$root/$ENV_ALIAS_FILE" 2>/dev/null | tail -1 | cut -d= -f2- | tr -d '[:space:]')"
|
||||
if [ -n "$alias" ]; then
|
||||
printf '%s' "$alias"
|
||||
else
|
||||
printf '%s' "$slug"
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Host — servicio estático: IP pública y resolución DNS.
|
||||
# ---------------------------------------------------------------------------
|
||||
@@ -61,6 +82,25 @@ Host::resolved_ip() {
|
||||
getent hosts "$host" | awk '{print $1}' | head -1 || true
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Config — servicio estático: config por entorno desde el REPO.
|
||||
# ---------------------------------------------------------------------------
|
||||
# scripts/entornos.env mapea <slug>=<LOCALESP_ADMIN_PREFIX> (una línea por
|
||||
# entorno de rama; comentarios con #). Al vivir en el repo, la config viaja
|
||||
# con el código que despliega y se revisa en PR. El prefijo no es secreto
|
||||
# (el bundle del frontend lo contiene igualmente).
|
||||
Config::admin_prefix() {
|
||||
local slug="$1"
|
||||
local file="${2:-$ENV_CONFIG_FILE}"
|
||||
local value
|
||||
|
||||
value="$(grep -E "^[[:space:]]*${slug}[[:space:]]*=" "$file" 2>/dev/null | tail -1 | cut -d= -f2- | tr -d '[:space:]')"
|
||||
if [ -z "$value" ]; then
|
||||
return 1
|
||||
fi
|
||||
printf '%s' "$value"
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Port — servicio estático: asigna/reutiliza puerto para una unit+dest.
|
||||
# ---------------------------------------------------------------------------
|
||||
@@ -374,7 +414,7 @@ Env::new() {
|
||||
|
||||
s[branch]="$branch"
|
||||
s[root]="$root"
|
||||
s[slug]="$(Slug::from "$branch")"
|
||||
s[slug]="$(EnvSlug::environment "$(Slug::from "$branch")" "$root")"
|
||||
if [ -z "${s[slug]}" ]; then
|
||||
Logger::error "slug vacío para la rama '$branch'"
|
||||
exit 2
|
||||
@@ -390,14 +430,39 @@ Env::new() {
|
||||
TlsCert::new "${self}__cert" "${s[host]}"
|
||||
}
|
||||
|
||||
# Config por entorno: scripts/entornos.env (en el repo) debe definir el
|
||||
# prefijo admin del slug. LOCALESP_ADMIN_PREFIX es obligatoria para servidor
|
||||
# y build; no hay valor por defecto.
|
||||
Env::require_config() {
|
||||
local self="$1"
|
||||
local -n s="$self"
|
||||
local config="${s[root]}/$ENV_CONFIG_FILE"
|
||||
|
||||
if ! prefix="$(Config::admin_prefix "${s[slug]}" "$config")"; then
|
||||
Logger::error "falta entrada '${s[slug]}=' en $ENV_CONFIG_FILE (repo)"
|
||||
Logger::error "añade una línea: ${s[slug]}=/administrador"
|
||||
exit 1
|
||||
fi
|
||||
Logger::info "prefijo admin de ${s[slug]}: $prefix"
|
||||
}
|
||||
|
||||
Env::deploy() {
|
||||
local self="$1"
|
||||
local -n s="$self"
|
||||
local prefix
|
||||
local config="${s[root]}/$ENV_CONFIG_FILE"
|
||||
|
||||
Artifacts::require_built "${s[root]}"
|
||||
Env::require_config "$self"
|
||||
Logger::info "sincronizando artefactos -> ${s[dest]}"
|
||||
Artifacts::sync "${s[root]}" "${s[dest]}"
|
||||
|
||||
# El servidor autocarga <dest>/.env (no pisa variables del entorno);
|
||||
# rsync --delete sólo afecta a dist/ y server/, así que sobrevive, pero
|
||||
# se regenera en cada despliegue desde la config del repo.
|
||||
prefix="$(Config::admin_prefix "${s[slug]}" "$config")"
|
||||
printf 'LOCALESP_ADMIN_PREFIX=%s\n' "$prefix" > "${s[dest]}/.env"
|
||||
|
||||
Logger::info "instalando dependencias (prod)"
|
||||
Deps::install "${s[root]}" "${s[dest]}"
|
||||
|
||||
|
||||
@@ -48,6 +48,7 @@ db.exec(`
|
||||
CREATE TABLE IF NOT EXISTS reportes (
|
||||
id TEXT PRIMARY KEY,
|
||||
localId TEXT NOT NULL,
|
||||
resenaId TEXT,
|
||||
motivo TEXT,
|
||||
comentario TEXT,
|
||||
fecha TEXT DEFAULT CURRENT_TIMESTAMP,
|
||||
@@ -60,6 +61,17 @@ db.exec(`
|
||||
password TEXT NOT NULL,
|
||||
created TEXT DEFAULT CURRENT_TIMESTAMP
|
||||
);
|
||||
|
||||
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)
|
||||
);
|
||||
`);
|
||||
|
||||
// Migración suave: si la base de datos ya existía con el esquema antiguo
|
||||
@@ -86,4 +98,8 @@ for (const table of ["locales", "pendientes"]) {
|
||||
ensureColumn("locales", "fechaConfirmacion", "TEXT");
|
||||
db.prepare("UPDATE locales SET fechaConfirmacion = fecha WHERE fechaConfirmacion IS NULL").run();
|
||||
|
||||
// Reseñas (issue #6): reportes puede señalar una reseña concreta (nullable;
|
||||
// null = reporte del local en sí, como hasta ahora).
|
||||
ensureColumn("reportes", "resenaId", "TEXT");
|
||||
|
||||
export default db;
|
||||
|
||||
+218
-30
@@ -1,27 +1,68 @@
|
||||
import express from "express";
|
||||
import { fileURLToPath, pathToFileURL } from "url";
|
||||
import { dirname, join } from "path";
|
||||
import { readFileSync } from "fs";
|
||||
import db from "./db.js";
|
||||
import { randomUUID } from "crypto";
|
||||
import { randomUUID, createHash } from "crypto";
|
||||
|
||||
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||||
const app = express();
|
||||
|
||||
// Carga mínima de `.env` (repo raíz): KEY=valor, ignora comentarios y líneas
|
||||
// vacías, admite comillas y `export`, y NO sobrescribe variables ya presentes
|
||||
// en el entorno (las de pruebas/despliegue mandan sobre el fichero).
|
||||
function cargarDotEnv(ruta) {
|
||||
let contenido;
|
||||
try {
|
||||
contenido = readFileSync(ruta, "utf8");
|
||||
} catch {
|
||||
return; // sin .env: se usan solo las variables del entorno
|
||||
}
|
||||
for (const linea of contenido.split("\n")) {
|
||||
const m = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)\s*$/.exec(linea);
|
||||
if (!m) continue;
|
||||
let valor = m[2].trim();
|
||||
if ((valor.startsWith('"') && valor.endsWith('"')) || (valor.startsWith("'") && valor.endsWith("'"))) {
|
||||
valor = valor.slice(1, -1);
|
||||
}
|
||||
if (!(m[1] in process.env)) process.env[m[1]] = valor;
|
||||
}
|
||||
}
|
||||
cargarDotEnv(join(__dirname, "../.env"));
|
||||
|
||||
// Prefijo de las rutas de administración (ocultación por ruta no obvia): las
|
||||
// rutas admin solo se sirven bajo este prefijo y las históricas /api/... dejan
|
||||
// de existir (404). OBLIGATORIO y SIN valor por defecto: es la única variable
|
||||
// y también la usa el frontend (Vite la expone vía envPrefix; el build falla si
|
||||
// falta). Ver .env.example.
|
||||
function normalizarPrefijo(valor) {
|
||||
const limpio = (valor || "").trim().replace(/\/+$/, "");
|
||||
if (!limpio || limpio === "") return null;
|
||||
return limpio.startsWith("/") ? limpio : `/${limpio}`;
|
||||
}
|
||||
const ADMIN_PREFIX = normalizarPrefijo(process.env.LOCALESP_ADMIN_PREFIX);
|
||||
if (!ADMIN_PREFIX || ADMIN_PREFIX === "/") {
|
||||
console.error(
|
||||
"[config] Falta LOCALESP_ADMIN_PREFIX (obligatorio, sin valor por defecto)." +
|
||||
" Copia .env.example a .env y asigna el prefijo de administración," +
|
||||
" p. ej. LOCALESP_ADMIN_PREFIX=/gestion-x7k2",
|
||||
);
|
||||
throw new Error("LOCALESP_ADMIN_PREFIX no configurado");
|
||||
}
|
||||
|
||||
app.use(express.json());
|
||||
app.use(express.static(join(__dirname, "../dist")));
|
||||
|
||||
// Locales (público, solo lectura)
|
||||
// Locales (público, solo lectura). Incluye el número de reseñas de cada
|
||||
// local para que la tarjeta pueda plegar "Reseñas (N)" sin expandir.
|
||||
app.get("/api/locales", (_req, res) => {
|
||||
const locales = db.prepare("SELECT * FROM locales ORDER BY fecha DESC").all();
|
||||
const locales = db.prepare(`
|
||||
SELECT l.*, (SELECT COUNT(*) FROM resenas WHERE localId = l.id) AS totalResenas
|
||||
FROM locales l ORDER BY fecha DESC
|
||||
`).all();
|
||||
res.json(locales);
|
||||
});
|
||||
|
||||
// Pendientes (admin)
|
||||
app.get("/api/pendientes", (_req, res) => {
|
||||
const pendientes = db.prepare("SELECT * FROM pendientes ORDER BY fechaPropuesta DESC").all();
|
||||
res.json(pendientes);
|
||||
});
|
||||
|
||||
// Utilidades para detectar duplicados
|
||||
function normaliza(s) {
|
||||
return (s || "").toString().toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").trim();
|
||||
@@ -71,8 +112,14 @@ app.post("/api/propuestas", (req, res) => {
|
||||
res.status(201).json({ id, nombre, descripcion, provincia, subcategoria, direccion, enlaceGoogleMaps, puntuacion: puntuacion ?? 0, categoria, estado: "pendiente", fechaPropuesta, lat, lng });
|
||||
});
|
||||
|
||||
// Pendientes (admin, bajo prefijo configurable)
|
||||
app.get(`${ADMIN_PREFIX}/pendientes`, (_req, res) => {
|
||||
const pendientes = db.prepare("SELECT * FROM pendientes ORDER BY fechaPropuesta DESC").all();
|
||||
res.json(pendientes);
|
||||
});
|
||||
|
||||
// Aprobar propuesta
|
||||
app.post("/api/aprobar/:id", (req, res) => {
|
||||
app.post(`${ADMIN_PREFIX}/aprobar/:id`, (req, res) => {
|
||||
const { id } = req.params;
|
||||
const propuesta = db.prepare("SELECT * FROM pendientes WHERE id = ?").get(id);
|
||||
|
||||
@@ -92,20 +139,58 @@ app.post("/api/aprobar/:id", (req, res) => {
|
||||
});
|
||||
|
||||
// Rechazar propuesta
|
||||
app.post("/api/rechazar/:id", (req, res) => {
|
||||
app.post(`${ADMIN_PREFIX}/rechazar/:id`, (req, res) => {
|
||||
const { id } = req.params;
|
||||
db.prepare("DELETE FROM pendientes WHERE id = ?").run(id);
|
||||
res.json({ ok: true });
|
||||
});
|
||||
|
||||
// Eliminar local
|
||||
app.delete("/api/locales/:id", (req, res) => {
|
||||
app.delete(`${ADMIN_PREFIX}/locales/:id`, (req, res) => {
|
||||
const { id } = req.params;
|
||||
db.prepare("DELETE FROM locales WHERE id = ?").run(id);
|
||||
db.prepare("DELETE FROM reportes WHERE localId = ?").run(id);
|
||||
res.json({ ok: true });
|
||||
});
|
||||
|
||||
// Reportes (admin, bajo prefijo configurable)
|
||||
app.get(`${ADMIN_PREFIX}/reportes`, (_req, res) => {
|
||||
const reportes = db.prepare(`
|
||||
SELECT r.*, l.nombre AS localNombre, l.provincia AS localProvincia, l.direccion AS localDireccion
|
||||
FROM reportes r LEFT JOIN locales l ON l.id = r.localId
|
||||
WHERE r.estado = 'pendiente'
|
||||
ORDER BY r.fecha DESC
|
||||
`).all();
|
||||
res.json(reportes);
|
||||
});
|
||||
|
||||
// Descartar un reporte (el admin revisó y no hace falta actuar)
|
||||
app.post(`${ADMIN_PREFIX}/reportes/:id/descartar`, (req, res) => {
|
||||
const { id } = req.params;
|
||||
db.prepare("UPDATE reportes SET estado = 'descartado' WHERE id = ?").run(id);
|
||||
res.json({ ok: true });
|
||||
});
|
||||
|
||||
// Reseñas (admin, bajo prefijo configurable): listado completo y borrado de
|
||||
// moderación. La media del local se recalcula al borrar.
|
||||
app.get(`${ADMIN_PREFIX}/resenas`, (_req, res) => {
|
||||
const resenas = db.prepare(`
|
||||
SELECT r.*, l.nombre AS localNombre, l.provincia AS localProvincia
|
||||
FROM resenas r LEFT JOIN locales l ON l.id = r.localId
|
||||
ORDER BY r.fecha DESC
|
||||
`).all();
|
||||
res.json(resenas);
|
||||
});
|
||||
|
||||
app.delete(`${ADMIN_PREFIX}/resenas/:id`, (req, res) => {
|
||||
const { id } = req.params;
|
||||
const resena = db.prepare("SELECT * FROM resenas WHERE id = ?").get(id);
|
||||
if (!resena) return res.status(404).json({ error: "Reseña no encontrada" });
|
||||
db.prepare("DELETE FROM resenas WHERE id = ?").run(id);
|
||||
recalcularMedia(resena.localId);
|
||||
res.json({ ok: true });
|
||||
});
|
||||
|
||||
// Confirmar que un local sigue activo (renueva fechaConfirmacion)
|
||||
app.post("/api/locales/:id/confirmar", (req, res) => {
|
||||
const { id } = req.params;
|
||||
@@ -116,36 +201,139 @@ app.post("/api/locales/:id/confirmar", (req, res) => {
|
||||
res.json({ ok: true, fechaConfirmacion: ahora });
|
||||
});
|
||||
|
||||
// Reportar un local (cerrado / datos incorrectos / inapropiado / otro)
|
||||
// Reportar un local (cerrado / datos incorrectos / inapropiado / otro) o,
|
||||
// con resenaId, una reseña concreta de ese local.
|
||||
app.post("/api/locales/:id/reportar", (req, res) => {
|
||||
const { id } = req.params;
|
||||
const { motivo, comentario } = req.body;
|
||||
const { motivo, comentario, resenaId } = req.body;
|
||||
const local = db.prepare("SELECT id FROM locales WHERE id = ?").get(id);
|
||||
if (!local) return res.status(404).json({ error: "Local no encontrado" });
|
||||
if (resenaId) {
|
||||
const resena = db.prepare("SELECT id FROM resenas WHERE id = ? AND localId = ?").get(resenaId, id);
|
||||
if (!resena) return res.status(404).json({ error: "Reseña no encontrada" });
|
||||
}
|
||||
const reporteId = randomUUID();
|
||||
db.prepare(`
|
||||
INSERT INTO reportes (id, localId, motivo, comentario, fecha, estado)
|
||||
VALUES (?, ?, ?, ?, ?, 'pendiente')
|
||||
`).run(reporteId, id, motivo || "otro", comentario || "", new Date().toISOString());
|
||||
INSERT INTO reportes (id, localId, resenaId, motivo, comentario, fecha, estado)
|
||||
VALUES (?, ?, ?, ?, ?, ?, 'pendiente')
|
||||
`).run(reporteId, id, resenaId || null, motivo || "otro", comentario || "", new Date().toISOString());
|
||||
res.status(201).json({ ok: true, id: reporteId });
|
||||
});
|
||||
|
||||
// Reportes (admin)
|
||||
app.get("/api/reportes", (_req, res) => {
|
||||
const reportes = db.prepare(`
|
||||
SELECT r.*, l.nombre AS localNombre, l.provincia AS localProvincia, l.direccion AS localDireccion
|
||||
FROM reportes r LEFT JOIN locales l ON l.id = r.localId
|
||||
WHERE r.estado = 'pendiente'
|
||||
ORDER BY r.fecha DESC
|
||||
`).all();
|
||||
res.json(reportes);
|
||||
// --- Reseñas anónimas por local (issue #6) ---
|
||||
// Identidad v1: deviceId aleatorio del navegador (sin cuentas, estilo 4chan).
|
||||
// Una reseña por (local, dispositivo) garantizada por UNIQUE; enviar de nuevo
|
||||
// edita la propia. Publicación directa con filtro de palabras y rate-limit
|
||||
// por IP como defensa anti-boicot; los reportes y el borrado admin cubren la
|
||||
// moderación reactiva.
|
||||
|
||||
// Rate limit en memoria por IP (ventana 1h). Máximo configurable para pruebas
|
||||
// (LOCALESP_RESENAS_RATELIMIT_MAX). El DDoS volumétrico se mitiga en el borde,
|
||||
// no aquí.
|
||||
const RESENAS_RATELIMIT_MAX = Number(process.env.LOCALESP_RESENAS_RATELIMIT_MAX) || 10;
|
||||
const RESENAS_RATELIMIT_VENTANA_MS = 60 * 60 * 1000;
|
||||
const resenasPorIP = new Map();
|
||||
function limitarEscriturasResenas(req, res, siguiente) {
|
||||
const ip = req.ip || req.socket?.remoteAddress || "desconocida";
|
||||
const ahora = Date.now();
|
||||
const entrada = resenasPorIP.get(ip);
|
||||
if (entrada && ahora - entrada.inicio < RESENAS_RATELIMIT_VENTANA_MS) {
|
||||
if (entrada.contador >= RESENAS_RATELIMIT_MAX) {
|
||||
res.setHeader("Retry-After", Math.ceil((entrada.inicio + RESENAS_RATELIMIT_VENTANA_MS - ahora) / 1000));
|
||||
return res.status(429).json({ error: "Demasiadas escrituras de reseñas desde esta conexión. Inténtalo de nuevo más tarde." });
|
||||
}
|
||||
entrada.contador += 1;
|
||||
} else {
|
||||
resenasPorIP.set(ip, { inicio: ahora, contador: 1 });
|
||||
}
|
||||
siguiente();
|
||||
}
|
||||
|
||||
// Huella corta por local (estilo 4chan): 3 hex del sha256(deviceId:localId).
|
||||
// Estable dentro del local, no reversible y no rastreable entre locales.
|
||||
function huellaCorta(deviceId, localId) {
|
||||
return "#" + createHash("sha256").update(`${deviceId}:${localId}`).digest("hex").slice(0, 3);
|
||||
}
|
||||
|
||||
// Mantener locales.puntuacion como la media (ROUND) de las reseñas vigentes.
|
||||
function recalcularMedia(localId) {
|
||||
const fila = db.prepare("SELECT ROUND(AVG(puntuacion)) AS media FROM resenas WHERE localId = ?").get(localId);
|
||||
const media = Number(fila?.media) || 0;
|
||||
db.prepare("UPDATE locales SET puntuacion = ? WHERE id = ?").run(media, localId);
|
||||
return media;
|
||||
}
|
||||
|
||||
function contienePalabraProhibida(texto) {
|
||||
const config = db.prepare("SELECT datos FROM config WHERE id = ?").get("filtro_palabras");
|
||||
if (!config) return false;
|
||||
const norm = (s) => (s || "").toString().toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "");
|
||||
const t = norm(texto);
|
||||
return JSON.parse(config.datos).some((p) => t.includes(norm(p)));
|
||||
}
|
||||
|
||||
// Listar reseñas de un local (público). Con ?deviceId= se marca esPropia.
|
||||
// Nunca se expone el deviceId completo: solo la huella corta.
|
||||
app.get("/api/locales/:id/resenas", (req, res) => {
|
||||
const { id } = req.params;
|
||||
const local = db.prepare("SELECT id FROM locales WHERE id = ?").get(id);
|
||||
if (!local) return res.status(404).json({ error: "Local no encontrado" });
|
||||
const { deviceId } = req.query;
|
||||
const resenas = db.prepare("SELECT * FROM resenas WHERE localId = ? ORDER BY fecha DESC").all(id)
|
||||
.map(({ deviceId: d, ...resto }) => ({
|
||||
...resto,
|
||||
huella: huellaCorta(d, id),
|
||||
esPropia: deviceId ? d === deviceId : false,
|
||||
}));
|
||||
res.json({ resenas, total: resenas.length });
|
||||
});
|
||||
|
||||
// Descartar un reporte (el admin revisó y no hace falta actuar)
|
||||
app.post("/api/reportes/:id/descartar", (req, res) => {
|
||||
// Crear (201) o editar (200) la reseña del dispositivo en el local (upsert).
|
||||
app.post("/api/locales/:id/resenas", limitarEscriturasResenas, (req, res) => {
|
||||
const { id } = req.params;
|
||||
db.prepare("UPDATE reportes SET estado = 'descartado' WHERE id = ?").run(id);
|
||||
res.json({ ok: true });
|
||||
const local = db.prepare("SELECT id FROM locales WHERE id = ?").get(id);
|
||||
if (!local) return res.status(404).json({ error: "Local no encontrado" });
|
||||
|
||||
const { deviceId, puntuacion, comentario } = req.body || {};
|
||||
if (typeof deviceId !== "string" || deviceId.length < 8 || deviceId.length > 64) {
|
||||
return res.status(400).json({ error: "Falta o es inválido el identificador de dispositivo" });
|
||||
}
|
||||
const puntos = Number(puntuacion);
|
||||
if (!Number.isInteger(puntos) || puntos < 1 || puntos > 5) {
|
||||
return res.status(400).json({ error: "La puntuación debe ser un entero entre 1 y 5" });
|
||||
}
|
||||
const comentarioStr = (comentario ?? "").toString().trim();
|
||||
if (comentarioStr.length > 500) {
|
||||
return res.status(400).json({ error: "El comentario no puede superar los 500 caracteres" });
|
||||
}
|
||||
if (comentarioStr && contienePalabraProhibida(comentarioStr)) {
|
||||
return res.status(400).json({ error: "El comentario contiene palabras no permitidas" });
|
||||
}
|
||||
|
||||
const existente = db.prepare("SELECT id FROM resenas WHERE localId = ? AND deviceId = ?").get(id, deviceId);
|
||||
const ahora = new Date().toISOString();
|
||||
if (existente) {
|
||||
db.prepare("UPDATE resenas SET puntuacion = ?, comentario = ?, fechaEdicion = ? WHERE id = ?")
|
||||
.run(puntos, comentarioStr || null, ahora, existente.id);
|
||||
} else {
|
||||
db.prepare("INSERT INTO resenas (id, localId, deviceId, puntuacion, comentario, fecha) VALUES (?, ?, ?, ?, ?, ?)")
|
||||
.run(randomUUID(), id, deviceId, puntos, comentarioStr || null, ahora);
|
||||
}
|
||||
const media = recalcularMedia(id);
|
||||
res.status(existente ? 200 : 201).json({ ok: true, creada: !existente, media, total: db.prepare("SELECT COUNT(*) AS n FROM resenas WHERE localId = ?").get(id).n });
|
||||
});
|
||||
|
||||
// Borrar la reseña propia del dispositivo en el local.
|
||||
app.delete("/api/locales/:id/resenas", limitarEscriturasResenas, (req, res) => {
|
||||
const { id } = req.params;
|
||||
const { deviceId } = req.query;
|
||||
if (typeof deviceId !== "string" || !deviceId) {
|
||||
return res.status(400).json({ error: "Falta el identificador de dispositivo" });
|
||||
}
|
||||
const existente = db.prepare("SELECT id FROM resenas WHERE localId = ? AND deviceId = ?").get(id, deviceId);
|
||||
if (!existente) return res.status(404).json({ error: "No hay reseña de este dispositivo en el local" });
|
||||
db.prepare("DELETE FROM resenas WHERE id = ?").run(existente.id);
|
||||
const media = recalcularMedia(id);
|
||||
res.json({ ok: true, media, total: db.prepare("SELECT COUNT(*) AS n FROM resenas WHERE localId = ?").get(id).n });
|
||||
});
|
||||
|
||||
// Config (palabras filtradas)
|
||||
|
||||
+16
-4
@@ -1,11 +1,11 @@
|
||||
// AdminPanel.jsx — /admin
|
||||
// No aparece en ningún menú público. Acceso solo por URL directa.
|
||||
// AdminPanel.jsx — raíz del prefijo admin configurado (LOCALESP_ADMIN_PREFIX)
|
||||
// No aparece en ningún menú público. Acceso solo por URL directa prefijada.
|
||||
import { useState, useEffect } from "react";
|
||||
import {
|
||||
escucharAuth, loginAdmin, registrarAdmin, cerrarSesion,
|
||||
suscribirPendientes, aprobarPropuesta, rechazarPropuesta,
|
||||
suscribirLocales, deleteLocal,
|
||||
obtenerReportes, descartarReporte,
|
||||
obtenerReportes, descartarReporte, borrarResenaAdmin,
|
||||
obtenerPalabrasFiltradas, guardarPalabrasFiltradas,
|
||||
} from "./firebase.js";
|
||||
import { obtenerCategoria } from "./constants/categorias.js";
|
||||
@@ -165,6 +165,16 @@ function PanelAdmin({ email }) {
|
||||
const rechazar = async (id) => { if (!confirm("¿Rechazar y eliminar esta propuesta?")) return; try { await rechazarPropuesta(id); mostrarToast("Propuesta rechazada", "info"); } catch(e) { mostrarToast("Error: "+e.message, "error"); } };
|
||||
const eliminar = async (id) => { if (!confirm("¿Eliminar este local publicado?")) return; try { await deleteLocal(id); cargarReportes(); mostrarToast("Local eliminado", "info"); } catch(e) { mostrarToast("Error: "+e.message, "error"); } };
|
||||
const descartar = async (id) => { try { await descartarReporte(id); setReportes(r => r.filter(x => x.id !== id)); mostrarToast("Aviso descartado", "info"); } catch(e) { mostrarToast("Error: "+e.message, "error"); } };
|
||||
// Moderación de reseñas (issue #6): al borrar la reseña reportada se
|
||||
// descarta también el aviso (queda resuelto).
|
||||
const borrarResenaReportada = async (resenaId, reporteId) => {
|
||||
try {
|
||||
await borrarResenaAdmin(resenaId);
|
||||
await descartarReporte(reporteId);
|
||||
setReportes(r => r.filter(x => x.id !== reporteId));
|
||||
mostrarToast("Reseña eliminada", "exito");
|
||||
} catch(e) { mostrarToast("Error: "+e.message, "error"); }
|
||||
};
|
||||
|
||||
const addPalabra = () => {
|
||||
const p = nuevaP.trim().toLowerCase();
|
||||
@@ -279,13 +289,15 @@ function PanelAdmin({ email }) {
|
||||
<div style={{ display:"flex", alignItems:"center", gap:8, flexWrap:"wrap", marginBottom:6 }}>
|
||||
<span style={{ fontWeight:700, fontSize:16 }}>{r.localNombre || "(local ya eliminado)"}</span>
|
||||
<span style={S.badge("#C0392B", "#FDEDEC")}>{{ cerrado:"Ha cerrado", datos_incorrectos:"Datos incorrectos", inapropiado:"Contenido inapropiado", otro:"Otro motivo" }[r.motivo] || r.motivo}</span>
|
||||
{r.resenaId && <span style={S.badge("#8B4513", "#FDF2E9")}>Reseña</span>}
|
||||
</div>
|
||||
<p style={{ margin:0, fontSize:13, color:"#666" }}>📍 {r.localProvincia} {r.localDireccion ? `· ${r.localDireccion}` : ""}</p>
|
||||
{r.comentario && <p style={{ margin:"8px 0 0", fontSize:13, color:"#666", fontStyle:"italic", background:"#FAFAFA", padding:"8px 12px", borderRadius:8 }}>"{r.comentario}"</p>}
|
||||
<p style={{ margin:"6px 0 0", fontSize:11, color:"#AAA" }}>Reportado: {new Date(r.fecha).toLocaleDateString("es-ES", { day:"numeric", month:"short", hour:"2-digit", minute:"2-digit" })}</p>
|
||||
</div>
|
||||
<div style={{ display:"flex", gap:8, flexShrink:0 }}>
|
||||
{r.localId && <button onClick={() => eliminar(r.localId)} style={{ ...S.btn("#C0392B"), padding:"8px 16px", fontSize:13 }}>🗑 Eliminar local</button>}
|
||||
{r.resenaId && <button onClick={() => borrarResenaReportada(r.resenaId, r.id)} style={{ ...S.btn("#C0392B"), padding:"8px 16px", fontSize:13 }}>🗑 Borrar reseña</button>}
|
||||
{r.localId && !r.resenaId && <button onClick={() => eliminar(r.localId)} style={{ ...S.btn("#C0392B"), padding:"8px 16px", fontSize:13 }}>🗑 Eliminar local</button>}
|
||||
<button onClick={() => descartar(r.id)} style={{ ...S.btn("#EEE","#666"), padding:"8px 16px", fontSize:13 }}>Descartar aviso</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
+5
-3
@@ -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;
|
||||
}
|
||||
|
||||
|
||||
+58
-9
@@ -1,6 +1,12 @@
|
||||
// Local SQLite API instead of Firebase
|
||||
|
||||
const API_URL = "/api";
|
||||
// Prefijo de las rutas de administración: la MISMA variable que usa el
|
||||
// servidor (LOCALESP_ADMIN_PREFIX), expuesta al frontend por Vite mediante
|
||||
// `envPrefix` (dev/build la recogen de .env o del entorno; el build falla si
|
||||
// falta). El fallback "/api" solo aplica fuera de un build real (p. ej. tests).
|
||||
const rawAdmin = String(import.meta.env.LOCALESP_ADMIN_PREFIX || "").trim().replace(/\/+$/, "");
|
||||
const ADMIN_URL = rawAdmin ? (rawAdmin.startsWith("/") ? rawAdmin : `/${rawAdmin}`) : "/api";
|
||||
|
||||
export async function suscribirLocales(onData, onError) {
|
||||
try {
|
||||
@@ -25,13 +31,13 @@ export async function suscribirLocales(onData, onError) {
|
||||
|
||||
export async function suscribirPendientes(onData, onError) {
|
||||
try {
|
||||
const response = await fetch(`${API_URL}/pendientes`);
|
||||
const response = await fetch(`${ADMIN_URL}/pendientes`);
|
||||
const data = await response.json();
|
||||
onData(data);
|
||||
// Simulate real-time by polling every 5 seconds
|
||||
const interval = setInterval(async () => {
|
||||
try {
|
||||
const res = await fetch(`${API_URL}/pendientes`);
|
||||
const res = await fetch(`${ADMIN_URL}/pendientes`);
|
||||
const newData = await res.json();
|
||||
onData(newData);
|
||||
} catch (err) {
|
||||
@@ -64,7 +70,7 @@ export async function comprobarDuplicado({ nombre, provincia, lat, lng }) {
|
||||
}
|
||||
|
||||
export async function aprobarPropuesta(p) {
|
||||
const response = await fetch(`${API_URL}/aprobar/${p.id}`, {
|
||||
const response = await fetch(`${ADMIN_URL}/aprobar/${p.id}`, {
|
||||
method: "POST",
|
||||
headers: { "Content-Type": "application/json" },
|
||||
});
|
||||
@@ -72,7 +78,7 @@ export async function aprobarPropuesta(p) {
|
||||
}
|
||||
|
||||
export async function rechazarPropuesta(id) {
|
||||
const response = await fetch(`${API_URL}/rechazar/${id}`, {
|
||||
const response = await fetch(`${ADMIN_URL}/rechazar/${id}`, {
|
||||
method: "POST",
|
||||
headers: { "Content-Type": "application/json" },
|
||||
});
|
||||
@@ -80,7 +86,7 @@ export async function rechazarPropuesta(id) {
|
||||
}
|
||||
|
||||
export async function deleteLocal(id) {
|
||||
const response = await fetch(`${API_URL}/locales/${id}`, {
|
||||
const response = await fetch(`${ADMIN_URL}/locales/${id}`, {
|
||||
method: "DELETE",
|
||||
});
|
||||
return response.json();
|
||||
@@ -91,22 +97,65 @@ export async function confirmarLocal(id) {
|
||||
return response.json();
|
||||
}
|
||||
|
||||
export async function reportarLocal(id, motivo, comentario) {
|
||||
export async function reportarLocal(id, motivo, comentario, resenaId) {
|
||||
const response = await fetch(`${API_URL}/locales/${id}/reportar`, {
|
||||
method: "POST",
|
||||
headers: { "Content-Type": "application/json" },
|
||||
body: JSON.stringify({ motivo, comentario }),
|
||||
body: JSON.stringify({ motivo, comentario, resenaId }),
|
||||
});
|
||||
return response.json();
|
||||
}
|
||||
|
||||
// --- Reseñas anónimas por local (issue #6) ---
|
||||
// Identidad v1: deviceId del navegador. Con ?deviceId= el servidor marca
|
||||
// esPropia en cada reseña (para precargar el formulario) sin exponer el
|
||||
// deviceId completo (solo la huella corta por local).
|
||||
export async function listarResenas(localId, deviceId) {
|
||||
const q = deviceId ? `?deviceId=${encodeURIComponent(deviceId)}` : "";
|
||||
const response = await fetch(`${API_URL}/locales/${localId}/resenas${q}`);
|
||||
return response.json();
|
||||
}
|
||||
|
||||
// Crear o editar (upsert) la reseña del dispositivo en el local.
|
||||
export async function enviarResena(localId, { deviceId, puntuacion, comentario }) {
|
||||
const response = await fetch(`${API_URL}/locales/${localId}/resenas`, {
|
||||
method: "POST",
|
||||
headers: { "Content-Type": "application/json" },
|
||||
body: JSON.stringify({ deviceId, puntuacion, comentario }),
|
||||
});
|
||||
const datos = await response.json().catch(() => ({}));
|
||||
if (!response.ok) throw new Error(datos.error || "No se pudo guardar la reseña");
|
||||
return datos;
|
||||
}
|
||||
|
||||
// Borrar la reseña propia del dispositivo en el local.
|
||||
export async function borrarResena(localId, deviceId) {
|
||||
const response = await fetch(`${API_URL}/locales/${localId}/resenas?deviceId=${encodeURIComponent(deviceId)}`, {
|
||||
method: "DELETE",
|
||||
});
|
||||
const datos = await response.json().catch(() => ({}));
|
||||
if (!response.ok) throw new Error(datos.error || "No se pudo borrar la reseña");
|
||||
return datos;
|
||||
}
|
||||
|
||||
// Moderación: listado completo y borrado de cualquier reseña (admin).
|
||||
export async function obtenerResenas() {
|
||||
const response = await fetch(`${ADMIN_URL}/resenas`);
|
||||
return response.json();
|
||||
}
|
||||
|
||||
export async function borrarResenaAdmin(id) {
|
||||
const response = await fetch(`${ADMIN_URL}/resenas/${id}`, { method: "DELETE" });
|
||||
return response.json();
|
||||
}
|
||||
|
||||
export async function obtenerReportes() {
|
||||
const response = await fetch(`${API_URL}/reportes`);
|
||||
const response = await fetch(`${ADMIN_URL}/reportes`);
|
||||
return response.json();
|
||||
}
|
||||
|
||||
export async function descartarReporte(id) {
|
||||
const response = await fetch(`${API_URL}/reportes/${id}/descartar`, { method: "POST" });
|
||||
const response = await fetch(`${ADMIN_URL}/reportes/${id}/descartar`, { method: "POST" });
|
||||
return response.json();
|
||||
}
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
import { useState } from "react";
|
||||
import { useRef, useState } from "react";
|
||||
import CategoriaBadge from "./CategoriaBadge.jsx";
|
||||
import StarRating from "./StarRating.jsx";
|
||||
import ResenasLocal from "./ResenasLocal.jsx";
|
||||
import ReportarLocal from "./ReportarLocal.jsx";
|
||||
import Toast from "./Toast.jsx";
|
||||
import useFavoritos from "../hooks/useFavoritos.js";
|
||||
@@ -24,12 +24,26 @@ function mesesDesde(fecha) {
|
||||
return (Date.now() - date.getTime()) / (1000 * 60 * 60 * 24 * 30);
|
||||
}
|
||||
|
||||
const botonBarra = (activo) => ({
|
||||
flex: 1, display: "flex", flexDirection: "column", alignItems: "center", gap: 2,
|
||||
background: "none", border: "none", padding: "6px 2px 2px", cursor: "pointer",
|
||||
fontSize: 11, fontWeight: 500, lineHeight: 1.2,
|
||||
color: activo ? "#8B0000" : "var(--color-text-secondary)",
|
||||
});
|
||||
|
||||
// Tarjeta de local (rediseño de usabilidad): cabecera limpia (nombre y
|
||||
// provincia), categoría, dirección y enlaces; la DESCRIPCIÓN del local en
|
||||
// bloque propio ENCIMA de la sección de reseñas (vista previa de 2 + detalle
|
||||
// en `ResenasLocal`); fecha en pequeñito y, como pie, la barra inferior de
|
||||
// acciones a ancho completo: Comentar · Reportar · Marcar · Compartir.
|
||||
export default function LocalCard({ local, distanciaKm }) {
|
||||
const { esFavorito, alternarFavorito } = useFavoritos();
|
||||
const { toast, mostrarToast } = useToast();
|
||||
const [confirmando, setConfirmando] = useState(false);
|
||||
const [confirmado, setConfirmado] = useState(false);
|
||||
const [fechaConfirmacion, setFechaConfirmacion] = useState(local.fechaConfirmacion || local.fecha);
|
||||
const [reportando, setReportando] = useState(false);
|
||||
const resenasRef = useRef(null);
|
||||
|
||||
const gmUrl = local.enlaceGoogleMaps || enlaceGoogleMapsDesdeLocal(local);
|
||||
const wazeUrl = enlaceWazeDesdeLocal(local);
|
||||
@@ -78,25 +92,13 @@ export default function LocalCard({ local, distanciaKm }) {
|
||||
onMouseEnter={(e) => { e.currentTarget.style.borderColor = "var(--color-border-secondary)"; }}
|
||||
onMouseLeave={(e) => { e.currentTarget.style.borderColor = "var(--color-border-tertiary)"; }}
|
||||
>
|
||||
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "flex-start", gap: 8 }}>
|
||||
<div style={{ flex: 1, minWidth: 0 }}>
|
||||
<p style={{ fontWeight: 500, fontSize: 16, margin: 0 }}>{local.nombre}</p>
|
||||
<p style={{ fontSize: 13, color: "var(--color-text-secondary)", margin: "2px 0 0" }}>
|
||||
{local.provincia}
|
||||
{distanciaKm != null && <span style={{ color: "var(--color-text-tertiary)" }}> · {formatearDistancia(distanciaKm)}</span>}
|
||||
</p>
|
||||
</div>
|
||||
<div style={{ display: "flex", gap: 4, flexShrink: 0 }}>
|
||||
<button type="button" onClick={compartir} title="Compartir"
|
||||
style={{ background: "none", border: "none", cursor: "pointer", fontSize: 16, color: "var(--color-text-tertiary)", padding: 4 }}>
|
||||
<i className="ti ti-share-2" aria-hidden="true"></i>
|
||||
</button>
|
||||
<button type="button" onClick={handleAlternarFavorito} title={favorito ? "Quitar de favoritos" : "Guardar en favoritos"}
|
||||
aria-pressed={favorito}
|
||||
style={{ background: "none", border: "none", cursor: "pointer", fontSize: 16, color: favorito ? "#8B0000" : "var(--color-text-tertiary)", padding: 4 }}>
|
||||
<i className={favorito ? "ti ti-heart-filled" : "ti ti-heart"} aria-hidden="true"></i>
|
||||
</button>
|
||||
</div>
|
||||
{/* Cabecera: solo nombre y provincia (las acciones viven en la barra inferior) */}
|
||||
<div>
|
||||
<p style={{ fontWeight: 500, fontSize: 16, margin: 0 }}>{local.nombre}</p>
|
||||
<p style={{ fontSize: 13, color: "var(--color-text-secondary)", margin: "2px 0 0" }}>
|
||||
{local.provincia}
|
||||
{distanciaKm != null && <span style={{ color: "var(--color-text-tertiary)" }}> · {formatearDistancia(distanciaKm)}</span>}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<CategoriaBadge categoria={local.categoria} subcategoria={local.subcategoria} />
|
||||
@@ -134,12 +136,19 @@ export default function LocalCard({ local, distanciaKm }) {
|
||||
</div>
|
||||
)}
|
||||
|
||||
<StarRating value={local.puntuacion} readOnly />
|
||||
|
||||
{/* Descripción del local: bloque propio, ENCIMA de las reseñas */}
|
||||
{local.descripcion && (
|
||||
<p style={{ fontSize: 13, color: "var(--color-text-secondary)", margin: 0, fontStyle: "italic" }}>"{local.descripcion}"</p>
|
||||
)}
|
||||
|
||||
{/* Reseñas: vista previa de 2 + expansión animada (media y total aquí) */}
|
||||
<ResenasLocal
|
||||
ref={resenasRef}
|
||||
localId={local.id}
|
||||
totalInicial={local.totalResenas || 0}
|
||||
mediaInicial={local.puntuacion || 0}
|
||||
/>
|
||||
|
||||
{sinConfirmarReciente && !confirmado && (
|
||||
<div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 8, flexWrap: "wrap", background: "#FDF2E9", border: "1px solid #F5CBA7", borderRadius: "var(--border-radius-md)", padding: "6px 10px" }}>
|
||||
<span style={{ fontSize: 12, color: "#784212", display: "flex", alignItems: "center", gap: 5 }}>
|
||||
@@ -155,11 +164,30 @@ export default function LocalCard({ local, distanciaKm }) {
|
||||
<p style={{ fontSize: 12, color: "#1E8449", margin: 0 }}>✅ Gracias por confirmar que sigue activo.</p>
|
||||
)}
|
||||
|
||||
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", gap: 8, flexWrap: "wrap" }}>
|
||||
{fechaFormateada && (
|
||||
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: 0 }}>Publicado {fechaFormateada}</p>
|
||||
)}
|
||||
<ReportarLocal localId={local.id} />
|
||||
{/* Formulario de reporte (se abre desde la barra inferior) */}
|
||||
{reportando && (
|
||||
<ReportarLocal localId={local.id} inicialAbierto onCerrar={() => setReportando(false)} />
|
||||
)}
|
||||
|
||||
{/* Fecha, en pequeñito, justo encima de la barra */}
|
||||
{fechaFormateada && (
|
||||
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: 0 }}>Publicado {fechaFormateada}</p>
|
||||
)}
|
||||
|
||||
{/* Barra inferior de acciones: cubre todo el pie de la tarjeta */}
|
||||
<div style={{ display: "flex", gap: 2, marginTop: 2, paddingTop: 6, borderTop: "0.5px solid var(--color-border-tertiary)", flexWrap: "wrap" }}>
|
||||
<button type="button" onClick={() => resenasRef.current?.comentar()} style={botonBarra(false)}>
|
||||
<i className="ti ti-message-dots" aria-hidden="true" style={{ fontSize: 18 }}></i> Comentar
|
||||
</button>
|
||||
<button type="button" onClick={() => setReportando(true)} style={botonBarra(false)}>
|
||||
<i className="ti ti-flag" aria-hidden="true" style={{ fontSize: 18 }}></i> Reportar
|
||||
</button>
|
||||
<button type="button" onClick={handleAlternarFavorito} aria-pressed={favorito} style={botonBarra(favorito)}>
|
||||
<i className={`ti ${favorito ? "ti-heart-filled" : "ti-heart"}`} aria-hidden="true" style={{ fontSize: 18 }}></i> {favorito ? "Marcado" : "Marcar"}
|
||||
</button>
|
||||
<button type="button" onClick={compartir} style={botonBarra(false)}>
|
||||
<i className="ti ti-share-2" aria-hidden="true" style={{ fontSize: 18 }}></i> Compartir
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<Toast toast={toast} />
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
import { useEffect, useRef, useState } from "react";
|
||||
import useEsMovil from "../hooks/useEsMovil.js";
|
||||
import PasoUbicacion from "./PasoUbicacion.jsx";
|
||||
import PasoNombre from "./PasoNombre.jsx";
|
||||
import PasoProvincia from "./PasoProvincia.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
|
||||
@@ -12,10 +12,10 @@ import PasoResumen from "./PasoResumen.jsx";
|
||||
// gestiona su propio botón de envío en PasoResumen.
|
||||
const PASOS = [
|
||||
{ id: "ubicacion", titulo: "Ubicación", Componente: PasoUbicacion, puedeContinuar: (f) => f.lat != null && f.lng != null },
|
||||
{ id: "nombre", titulo: "Nombre", Componente: PasoNombre, puedeContinuar: (f) => (f.nombre || "").trim().length >= 2 },
|
||||
{ id: "provincia", titulo: "Provincia", Componente: PasoProvincia, puedeContinuar: (f) => !!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: "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 },
|
||||
];
|
||||
|
||||
|
||||
@@ -0,0 +1,73 @@
|
||||
import { inputStyle } from "../styles/shared.js";
|
||||
import { PROVINCIAS } from "../constants/provincias.js";
|
||||
|
||||
const etiqueta = { fontSize: 12, color: "var(--color-text-secondary)", display: "block", marginBottom: 4 };
|
||||
|
||||
// Paso 2 de la pasarela: los datos inferidos desde la ubicación (nombre,
|
||||
// provincia y dirección), pre-rellenados y editables en una misma pantalla.
|
||||
// Si la inferencia falló o no casó con el listado, llegan vacíos y se
|
||||
// rellenan a mano, sin bloquear la pasarela.
|
||||
export default function PasoDatosLocal({ form, setForm }) {
|
||||
const algunoInferido = !!(form.nombre || form.provincia || form.direccion);
|
||||
return (
|
||||
<div style={{ display: "flex", flexDirection: "column", gap: 12 }}>
|
||||
{algunoInferido && (
|
||||
<div role="status" style={{
|
||||
display: "flex", alignItems: "flex-start", gap: 6,
|
||||
background: "#EAFAF1", color: "#1E8449",
|
||||
padding: "6px 10px", borderRadius: "var(--border-radius-md)", fontSize: 12,
|
||||
}}>
|
||||
<i className="ti ti-sparkles" aria-hidden="true" style={{ fontSize: 14, flexShrink: 0, marginTop: 1 }}></i>
|
||||
<span style={{ lineHeight: 1.4 }}>
|
||||
Rellenados automáticamente desde la ubicación: compruébalos y corrige lo que haga falta.
|
||||
</span>
|
||||
</div>
|
||||
)}
|
||||
|
||||
<div>
|
||||
<label htmlFor="paso-nombre" style={etiqueta}>
|
||||
Nombre del local <span style={{ color: "#8B0000" }}>*</span>
|
||||
</label>
|
||||
<input
|
||||
id="paso-nombre"
|
||||
style={inputStyle}
|
||||
autoComplete="off"
|
||||
placeholder="Bar El Olivo, Clínica San José..."
|
||||
value={form.nombre}
|
||||
onChange={(e) => setForm((f) => ({ ...f, nombre: e.target.value }))}
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div>
|
||||
<label htmlFor="paso-provincia" style={etiqueta}>
|
||||
Provincia <span style={{ color: "#8B0000" }}>*</span>
|
||||
</label>
|
||||
<select
|
||||
id="paso-provincia"
|
||||
style={inputStyle}
|
||||
value={form.provincia}
|
||||
onChange={(e) => setForm((f) => ({ ...f, provincia: e.target.value }))}
|
||||
>
|
||||
<option value="">Selecciona provincia...</option>
|
||||
{PROVINCIAS.map((p) => <option key={p} value={p}>{p}</option>)}
|
||||
</select>
|
||||
</div>
|
||||
|
||||
<div>
|
||||
<label htmlFor="paso-direccion" style={etiqueta}>Dirección</label>
|
||||
<input
|
||||
id="paso-direccion"
|
||||
style={inputStyle}
|
||||
autoComplete="off"
|
||||
placeholder="Calle, número, ciudad"
|
||||
value={form.direccion}
|
||||
onChange={(e) => setForm((f) => ({ ...f, direccion: e.target.value }))}
|
||||
aria-describedby="paso-direccion-ayuda"
|
||||
/>
|
||||
<p id="paso-direccion-ayuda" style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: "4px 0 0" }}>
|
||||
Opcional: se rellena automáticamente desde la ubicación; corrígela si hace falta.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -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>
|
||||
);
|
||||
}
|
||||
@@ -1,26 +0,0 @@
|
||||
import { inputStyle } from "../styles/shared.js";
|
||||
|
||||
// Paso 2 de la pasarela: nombre del local, pre-rellenado con lo inferido
|
||||
// desde la ubicación (editable). Si la inferencia falló, llega vacío.
|
||||
export default function PasoNombre({ form, setForm }) {
|
||||
return (
|
||||
<div>
|
||||
<label htmlFor="paso-nombre" style={{ fontSize: 12, color: "var(--color-text-secondary)", display: "block", marginBottom: 4 }}>
|
||||
Nombre del local <span style={{ color: "#8B0000" }}>*</span>
|
||||
</label>
|
||||
<input
|
||||
id="paso-nombre"
|
||||
style={inputStyle}
|
||||
autoComplete="off"
|
||||
placeholder="Bar El Olivo, Clínica San José..."
|
||||
value={form.nombre}
|
||||
onChange={(e) => setForm((f) => ({ ...f, nombre: e.target.value }))}
|
||||
/>
|
||||
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: "6px 0 0" }}>
|
||||
{form.nombre
|
||||
? "Si el nombre se rellenó automáticamente desde la ubicación, comprueba que es correcto antes de continuar."
|
||||
: "El nombre con el que la gente conoce el negocio."}
|
||||
</p>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -1,26 +0,0 @@
|
||||
import { inputStyle } from "../styles/shared.js";
|
||||
import { PROVINCIAS } from "../constants/provincias.js";
|
||||
|
||||
// Paso 3 de la pasarela: provincia, pre-rellenada con lo inferido desde la
|
||||
// ubicación (si la inferencia falló o no casó con el listado, llega vacía).
|
||||
export default function PasoProvincia({ form, setForm }) {
|
||||
return (
|
||||
<div>
|
||||
<label htmlFor="paso-provincia" style={{ fontSize: 12, color: "var(--color-text-secondary)", display: "block", marginBottom: 4 }}>
|
||||
Provincia <span style={{ color: "#8B0000" }}>*</span>
|
||||
</label>
|
||||
<select
|
||||
id="paso-provincia"
|
||||
style={inputStyle}
|
||||
value={form.provincia}
|
||||
onChange={(e) => setForm((f) => ({ ...f, provincia: e.target.value }))}
|
||||
>
|
||||
<option value="">Selecciona provincia...</option>
|
||||
{PROVINCIAS.map((p) => <option key={p} value={p}>{p}</option>)}
|
||||
</select>
|
||||
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: "6px 0 0" }}>
|
||||
Si se rellenó automáticamente desde la ubicación, verifica que es correcta.
|
||||
</p>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -45,12 +45,18 @@ export default function PasoResumen({
|
||||
<span style={clave}>📂 Categoría</span>
|
||||
<span style={valor}>{categoria ? `${categoria.emoji} ${form.categoria}` : ""}</span>
|
||||
</div>
|
||||
<div style={{ ...fila, borderBottom: "none" }}>
|
||||
<div style={fila}>
|
||||
<span style={clave}>🔖 Tipo específico</span>
|
||||
<span style={{ ...valor, fontWeight: form.subcategoria ? 500 : 400, color: form.subcategoria ? "inherit" : "var(--color-text-tertiary)" }}>
|
||||
{form.subcategoria || "—"}
|
||||
</span>
|
||||
</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>
|
||||
|
||||
<label style={{ display: "flex", alignItems: "flex-start", gap: 8, marginBottom: 12, fontSize: 12, color: "var(--color-text-secondary)", cursor: "pointer" }}>
|
||||
|
||||
@@ -8,8 +8,12 @@ const MOTIVOS = [
|
||||
{ id: "otro", label: "Otro motivo" },
|
||||
];
|
||||
|
||||
export default function ReportarLocal({ localId }) {
|
||||
const [abierto, setAbierto] = useState(false);
|
||||
// Formulario de reporte de un local (cerrado / datos incorrectos /
|
||||
// inapropiado / otro). Controlado desde fuera: la barra de acciones de la
|
||||
// tarjeta lo monta con `inicialAbierto` (al pulsar "Reportar") y lo cierra
|
||||
// vía `onCerrar`. Si se monta sin `inicialAbierto`, se comporta como antes.
|
||||
export default function ReportarLocal({ localId, onCerrar, inicialAbierto = false }) {
|
||||
const [abierto, setAbierto] = useState(inicialAbierto);
|
||||
const [motivo, setMotivo] = useState("cerrado");
|
||||
const [comentario, setComentario] = useState("");
|
||||
const [enviando, setEnviando] = useState(false);
|
||||
@@ -20,12 +24,7 @@ export default function ReportarLocal({ localId }) {
|
||||
}
|
||||
|
||||
if (!abierto) {
|
||||
return (
|
||||
<button type="button" onClick={() => setAbierto(true)}
|
||||
style={{ display: "inline-flex", alignItems: "center", gap: 4, background: "none", border: "none", padding: 0, fontSize: 12, color: "var(--color-text-tertiary)", cursor: "pointer", width: "fit-content" }}>
|
||||
<i className="ti ti-flag" aria-hidden="true"></i> Reportar
|
||||
</button>
|
||||
);
|
||||
return null;
|
||||
}
|
||||
|
||||
const enviar = async () => {
|
||||
@@ -53,7 +52,7 @@ export default function ReportarLocal({ localId }) {
|
||||
style={{ fontSize: 12, background: "#8B0000", color: "white", border: "none", borderRadius: "var(--border-radius-md)", padding: "5px 12px", cursor: "pointer" }}>
|
||||
{enviando ? "Enviando..." : "Enviar aviso"}
|
||||
</button>
|
||||
<button type="button" onClick={() => setAbierto(false)}
|
||||
<button type="button" onClick={() => (onCerrar ? onCerrar() : setAbierto(false))}
|
||||
style={{ fontSize: 12, background: "none", border: "none", color: "var(--color-text-tertiary)", cursor: "pointer" }}>
|
||||
Cancelar
|
||||
</button>
|
||||
|
||||
@@ -0,0 +1,330 @@
|
||||
import { forwardRef, useEffect, useImperativeHandle, useRef, useState } from "react";
|
||||
import StarRating from "./StarRating.jsx";
|
||||
import { borrarResena, enviarResena, listarResenas, reportarLocal } from "../firebase.js";
|
||||
import { obtenerDeviceId } from "../utils/dispositivo.js";
|
||||
|
||||
const MAX_COMENTARIO = 500;
|
||||
// Reseñas visibles sin expandir (en fila, ocupando el ancho) y duración de
|
||||
// la animación de revelado (ms), sincronizada con la transición CSS.
|
||||
const VISTA_PREVIA = 3;
|
||||
const DURACION_TRANSICION = 350;
|
||||
|
||||
const gridResenas = {
|
||||
display: "grid",
|
||||
gridTemplateColumns: "repeat(auto-fit, minmax(120px, 1fr))",
|
||||
gap: 6,
|
||||
};
|
||||
|
||||
function formatearFechaCorta(fecha) {
|
||||
const d = new Date(fecha);
|
||||
return Number.isNaN(d.getTime()) ? "" : d.toLocaleDateString("es-ES", { day: "numeric", month: "short" });
|
||||
}
|
||||
|
||||
const accionTarjeta = {
|
||||
background: "none",
|
||||
border: "0.5px solid var(--color-border-secondary)",
|
||||
borderRadius: "var(--border-radius-md)",
|
||||
padding: "2px 6px",
|
||||
fontSize: 10,
|
||||
cursor: "pointer",
|
||||
color: "var(--color-text-secondary)",
|
||||
};
|
||||
|
||||
// Tarjeta de reseña (celda del grid): estrellas, comentario acotado a 3
|
||||
// líneas, autor anónimo con huella + fecha corta y acciones por tarjeta —
|
||||
// "Borrar" solo en las propias, "Reportar" solo en las ajenas.
|
||||
function Reseña({ r, reportada, onReportar, onBorrar }) {
|
||||
const autor = `Anónimo ${r.huella} · ${formatearFechaCorta(r.fecha)}${r.fechaEdicion ? " · ed." : ""}`;
|
||||
return (
|
||||
<div style={{
|
||||
background: "var(--color-background-secondary)",
|
||||
borderRadius: "var(--border-radius-md)",
|
||||
padding: "12px 12px 8px",
|
||||
display: "flex", flexDirection: "column", gap: 10, minWidth: 0,
|
||||
border: r.esPropia ? "0.5px solid var(--color-border-secondary)" : "none",
|
||||
}}>
|
||||
<StarRating value={r.puntuacion} readOnly size={12} />
|
||||
{r.comentario && (
|
||||
<p
|
||||
title={r.comentario}
|
||||
style={{
|
||||
margin: 10, fontSize: 12, color: "var(--color-text-secondary)",
|
||||
display: "-webkit-box", WebkitLineClamp: 3, WebkitBoxOrient: "vertical", overflow: "hidden",
|
||||
}}
|
||||
>
|
||||
{r.comentario}
|
||||
</p>
|
||||
)}
|
||||
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", gap: 4, marginTop: "auto", flexWrap: "wrap" }}>
|
||||
<span title={autor} style={{ fontSize: 10, color: "var(--color-text-tertiary)", whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis", minWidth: 0 }}>
|
||||
{r.esPropia ? "Tú" : `Anónimo ${r.huella}`}
|
||||
</span>
|
||||
<span style={{ display: "flex", gap: 4, flexShrink: 0 }}>
|
||||
{r.esPropia ? (
|
||||
<button type="button" onClick={() => onBorrar(r)} style={{ ...accionTarjeta, color: "#922B21" }}>Borrar</button>
|
||||
) : reportada === r.id ? (
|
||||
<span style={{ fontSize: 10, color: "#1E8449" }}>✅</span>
|
||||
) : (
|
||||
<button type="button" onClick={() => onReportar(r)} style={accionTarjeta}>Reportar</button>
|
||||
)}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
// Sección de reseñas de la tarjeta del local (issue #6 + rediseño de
|
||||
// usabilidad, iteración 2): carga al montar y muestra VISTA_PREVIA reseñas
|
||||
// en fila ocupando el ancho; la cabecera "★ media · Reseñas (N)" alterna con
|
||||
// una animación (grid-template-rows 0fr→1fr) que revela el resto en el mismo
|
||||
// grid y el formulario inline PLANO (sin caja propia). Cierre por tres vías:
|
||||
// cabecera, "Comentar" (toggle, desde la barra de la tarjeta) y "Cerrar" en
|
||||
// el formulario. Identidad anónima con huella corta por local.
|
||||
const ResenasLocal = forwardRef(function ResenasLocal({ localId, totalInicial = 0, mediaInicial = 0 }, ref) {
|
||||
const [abierto, setAbierto] = useState(false);
|
||||
const [resenas, setResenas] = useState(null); // null = aún sin cargar
|
||||
const [cargando, setCargando] = useState(false);
|
||||
const [total, setTotal] = useState(totalInicial);
|
||||
const [media, setMedia] = useState(mediaInicial);
|
||||
const [tienePropia, setTienePropia] = useState(false);
|
||||
const [puntuacion, setPuntuacion] = useState(0);
|
||||
const [comentario, setComentario] = useState("");
|
||||
const [enviando, setEnviando] = useState(false);
|
||||
const [error, setError] = useState("");
|
||||
const [reportada, setReportada] = useState(null);
|
||||
const formRef = useRef(null);
|
||||
|
||||
const cargar = async () => {
|
||||
setCargando(true);
|
||||
setError("");
|
||||
try {
|
||||
const datos = await listarResenas(localId, obtenerDeviceId());
|
||||
setResenas(datos.resenas || []);
|
||||
setTotal(datos.total || 0);
|
||||
const propia = (datos.resenas || []).find((r) => r.esPropia);
|
||||
setTienePropia(!!propia);
|
||||
setPuntuacion(propia?.puntuacion || 0);
|
||||
setComentario(propia?.comentario || "");
|
||||
} catch (e) {
|
||||
console.error(e);
|
||||
setError("No se pudieron cargar las reseñas.");
|
||||
}
|
||||
setCargando(false);
|
||||
};
|
||||
|
||||
// La vista previa debe existir sin interacción: carga al montar la tarjeta.
|
||||
// Se refresca al expandir y tras cada escritura.
|
||||
useEffect(() => { cargar(); /* eslint-disable-line react-hooks/exhaustive-deps */ }, []);
|
||||
|
||||
const expandir = (conFoco = false) => {
|
||||
setAbierto(true);
|
||||
if (conFoco) {
|
||||
// Espera al fin de la transición para no pelearse con la animación.
|
||||
setTimeout(() => {
|
||||
formRef.current?.scrollIntoView?.({ behavior: "smooth", block: "nearest" });
|
||||
formRef.current?.querySelector("button")?.focus();
|
||||
}, DURACION_TRANSICION + 30);
|
||||
}
|
||||
};
|
||||
|
||||
// API imperativa para la barra de acciones de la tarjeta: ALTERNA (abre con
|
||||
// foco / cierra). El cierre también está en la cabecera y en "Cerrar".
|
||||
useImperativeHandle(ref, () => ({
|
||||
comentar: () => (abierto ? setAbierto(false) : expandir(true)),
|
||||
}));
|
||||
|
||||
const alternar = () => {
|
||||
if (abierto) {
|
||||
setAbierto(false);
|
||||
} else {
|
||||
expandir(false);
|
||||
if (resenas === null && !cargando) cargar();
|
||||
}
|
||||
};
|
||||
|
||||
const enviar = async () => {
|
||||
if (puntuacion < 1) return;
|
||||
setEnviando(true);
|
||||
setError("");
|
||||
try {
|
||||
const datos = await enviarResena(localId, {
|
||||
deviceId: obtenerDeviceId(),
|
||||
puntuacion,
|
||||
comentario: comentario.trim(),
|
||||
});
|
||||
setMedia(datos.media ?? media);
|
||||
setTienePropia(true);
|
||||
await cargar();
|
||||
} catch (e) {
|
||||
setError(e.message || "No se pudo guardar la reseña.");
|
||||
}
|
||||
setEnviando(false);
|
||||
};
|
||||
|
||||
// Borrado desde la propia tarjeta de reseña (solo propias).
|
||||
const borrarPropia = async () => {
|
||||
setEnviando(true);
|
||||
setError("");
|
||||
try {
|
||||
const datos = await borrarResena(localId, obtenerDeviceId());
|
||||
setMedia(datos.media ?? media);
|
||||
setTienePropia(false);
|
||||
setPuntuacion(0);
|
||||
setComentario("");
|
||||
await cargar();
|
||||
} catch (e) {
|
||||
setError(e.message || "No se pudo borrar la reseña.");
|
||||
}
|
||||
setEnviando(false);
|
||||
};
|
||||
|
||||
const reportar = async (resena) => {
|
||||
try {
|
||||
await reportarLocal(localId, "inapropiado", "", resena.id);
|
||||
setReportada(resena.id);
|
||||
} catch (e) {
|
||||
console.error(e);
|
||||
}
|
||||
};
|
||||
|
||||
const lista = resenas || [];
|
||||
// La vista previa son siempre las primeras VISTA_PREVIA; el resto vive
|
||||
// dentro de la zona animada (se revela al expandir, sin duplicar render).
|
||||
const visibles = lista.slice(0, VISTA_PREVIA);
|
||||
const resto = lista.slice(VISTA_PREVIA);
|
||||
|
||||
return (
|
||||
<div style={{ display: "flex", flexDirection: "column", gap: 8 }}>
|
||||
{/* Cabecera plegable: media + número de reseñas */}
|
||||
<button
|
||||
type="button"
|
||||
onClick={alternar}
|
||||
aria-expanded={abierto}
|
||||
style={{
|
||||
display: "flex", alignItems: "center", gap: 8, width: "fit-content",
|
||||
background: "none", border: "none", padding: 0, cursor: "pointer",
|
||||
fontSize: 12, color: "var(--color-text-secondary)",
|
||||
}}
|
||||
>
|
||||
<StarRating value={media} readOnly size={14} />
|
||||
<span>
|
||||
Reseñas ({total})
|
||||
<i
|
||||
className={`ti ${abierto ? "ti-chevron-up" : "ti-chevron-down"}`}
|
||||
aria-hidden="true"
|
||||
style={{ fontSize: 14, marginLeft: 4, color: "var(--color-text-tertiary)" }}
|
||||
/>
|
||||
</span>
|
||||
</button>
|
||||
|
||||
{/* Vista previa: siempre a la vista, en fila ocupando el ancho */}
|
||||
{cargando && resenas === null && (
|
||||
<p style={{ fontSize: 12, color: "var(--color-text-tertiary)", margin: 0 }}>Cargando reseñas…</p>
|
||||
)}
|
||||
{resenas !== null && lista.length === 0 && (
|
||||
<p style={{ fontSize: 12, color: "var(--color-text-tertiary)", margin: 0 }}>
|
||||
Aún no hay reseñas. ¡Sé el primero!
|
||||
</p>
|
||||
)}
|
||||
<div style={gridResenas} aria-label="Vista previa de reseñas">
|
||||
{visibles.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} onBorrar={borrarPropia} />)}
|
||||
</div>
|
||||
|
||||
{/* Pista de expansión cuando hay más reseñas que la vista previa */}
|
||||
{!abierto && total > VISTA_PREVIA && (
|
||||
<button
|
||||
type="button"
|
||||
onClick={() => expandir(false)}
|
||||
style={{
|
||||
background: "none", border: "none", padding: 0, width: "fit-content",
|
||||
fontSize: 12, color: "#8B0000", cursor: "pointer", fontWeight: 500,
|
||||
}}
|
||||
>
|
||||
Ver las {total} reseñas <i className="ti ti-chevron-down" aria-hidden="true"></i>
|
||||
</button>
|
||||
)}
|
||||
|
||||
{/* Zona animada: resto de reseñas (mismo grid) + formulario plano. La
|
||||
altura anima de 0fr a 1fr; el contenido permanece montado para que
|
||||
la transición sea fluida y se oculta del árbol accesible plegado. */}
|
||||
<div
|
||||
aria-hidden={!abierto}
|
||||
style={{
|
||||
display: "grid",
|
||||
gridTemplateRows: abierto ? "1fr" : "0fr",
|
||||
transition: `grid-template-rows ${DURACION_TRANSICION}ms ease`,
|
||||
}}
|
||||
>
|
||||
<div style={{ overflow: "hidden" }}>
|
||||
<div style={{ display: "flex", flexDirection: "column", gap: 8, paddingTop: abierto ? 8 : 0 }}>
|
||||
{resto.length > 0 && (
|
||||
<div style={gridResenas}>
|
||||
{resto.map((r) => <Reseña key={r.id} r={r} reportada={reportada} onReportar={reportar} onBorrar={borrarPropia} />)}
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Formulario inline PLANO (sin caja): solo un borde que lo separa */}
|
||||
<div ref={formRef} style={{ paddingTop: 8, borderTop: "0.5px solid var(--color-border-tertiary)", display: "flex", flexDirection: "column", gap: 8 }}>
|
||||
<p style={{ margin: 0, fontSize: 12, fontWeight: 500 }}>
|
||||
{tienePropia ? "Tu reseña (anónima) — edítala o bórrala desde su tarjeta" : "Deja tu reseña (anónima)"}
|
||||
</p>
|
||||
{/* Las estrellas usan lineHeight 0 (caja de línea de altura 0:
|
||||
el glifo desborda y se solapa con el título). El wrapper con
|
||||
lineHeight normal aporta el soporte de línea que falta. */}
|
||||
<div style={{ lineHeight: "26px" }}>
|
||||
<StarRating value={puntuacion} onChange={setPuntuacion} size={20} />
|
||||
</div>
|
||||
<textarea
|
||||
value={comentario}
|
||||
onChange={(e) => setComentario(e.target.value)}
|
||||
maxLength={MAX_COMENTARIO}
|
||||
rows={2}
|
||||
placeholder="Comentario opcional (máx. 500 caracteres)…"
|
||||
aria-label="Comentario de la reseña"
|
||||
style={{
|
||||
fontSize: 12, padding: "5px 8px", borderRadius: "var(--border-radius-md)",
|
||||
border: "0.5px solid var(--color-border-secondary)",
|
||||
background: "var(--color-background-primary)", color: "var(--color-text-primary)",
|
||||
resize: "vertical", fontFamily: "inherit",
|
||||
}}
|
||||
/>
|
||||
{error && (
|
||||
<p role="alert" style={{ margin: 0, fontSize: 12, color: "#922B21" }}>
|
||||
<i className="ti ti-alert-triangle" aria-hidden="true"></i> {error}
|
||||
</p>
|
||||
)}
|
||||
<div style={{ display: "flex", gap: 6, alignItems: "center" }}>
|
||||
<button
|
||||
type="button"
|
||||
onClick={enviar}
|
||||
disabled={puntuacion < 1 || enviando}
|
||||
style={{
|
||||
fontSize: 12, background: puntuacion >= 1 ? "#8B0000" : "var(--color-background-secondary)",
|
||||
color: puntuacion >= 1 ? "white" : "var(--color-text-tertiary)",
|
||||
border: "none", borderRadius: "var(--border-radius-md)", padding: "5px 12px",
|
||||
cursor: puntuacion >= 1 && !enviando ? "pointer" : "not-allowed", fontWeight: 500,
|
||||
}}
|
||||
>
|
||||
{enviando ? "Guardando…" : tienePropia ? "Actualizar" : "Publicar"}
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
onClick={() => setAbierto(false)}
|
||||
style={{
|
||||
fontSize: 12, background: "none", border: "0.5px solid var(--color-border-secondary)",
|
||||
borderRadius: "var(--border-radius-md)", padding: "5px 12px", cursor: "pointer",
|
||||
color: "var(--color-text-secondary)",
|
||||
}}
|
||||
>
|
||||
Cerrar
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
});
|
||||
|
||||
export default ResenasLocal;
|
||||
@@ -8,6 +8,11 @@ export {
|
||||
deleteLocal,
|
||||
confirmarLocal,
|
||||
reportarLocal,
|
||||
listarResenas,
|
||||
enviarResena,
|
||||
borrarResena,
|
||||
obtenerResenas,
|
||||
borrarResenaAdmin,
|
||||
obtenerReportes,
|
||||
descartarReporte,
|
||||
enviarPropuesta,
|
||||
|
||||
+9
-3
@@ -3,11 +3,17 @@ import { createRoot } from "react-dom/client";
|
||||
import App from "./App.jsx";
|
||||
import AdminPanel from "./AdminPanel.jsx";
|
||||
|
||||
// Enrutador mínimo sin dependencias extra
|
||||
const ruta = window.location.pathname.replace(/\/$/, "");
|
||||
// Enrutador mínimo sin dependencias extra.
|
||||
// El panel de administración vive en la RAÍZ del prefijo configurado
|
||||
// (LOCALESP_ADMIN_PREFIX: la misma variable única que backend y build).
|
||||
// La ruta fija /admin dejó de existir: cualquier otra ruta muestra la web
|
||||
// pública, así que el panel solo aparece en la URL prefijada.
|
||||
const ADMIN_RUTA = String(import.meta.env.LOCALESP_ADMIN_PREFIX || "")
|
||||
.trim().replace(/\/+$/, "");
|
||||
const ruta = window.location.pathname.replace(/\/+$/, "");
|
||||
|
||||
function Root() {
|
||||
if (ruta === "/admin") return <AdminPanel />;
|
||||
if (ADMIN_RUTA && ruta === ADMIN_RUTA) return <AdminPanel />;
|
||||
return <App />;
|
||||
}
|
||||
|
||||
|
||||
@@ -0,0 +1,19 @@
|
||||
// Identidad anónima v1 para las reseñas (issue #6): un identificador de
|
||||
// dispositivo aleatorio persistido en localStorage. Sin datos personales y
|
||||
// sin cuentas ("estilo 4chan"); cuando lleguen las cuentas se migrará
|
||||
// deviceId -> userId (ver design de resenas-por-local).
|
||||
const CLAVE = "localesp_device_id";
|
||||
|
||||
export function obtenerDeviceId() {
|
||||
try {
|
||||
let id = localStorage.getItem(CLAVE);
|
||||
if (!id) {
|
||||
id = globalThis.crypto?.randomUUID?.() || `dev-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
|
||||
localStorage.setItem(CLAVE, id);
|
||||
}
|
||||
return id;
|
||||
} catch {
|
||||
// Almacenamiento no disponible (p. ej. modo privado): identidad efímera.
|
||||
return `eph-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,83 @@
|
||||
// @vitest-environment jsdom
|
||||
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
|
||||
import { cleanup, fireEvent, render, screen, waitFor } from "@testing-library/react";
|
||||
|
||||
// Mock del cliente API: LocalCard importa confirmarLocal vía firebase.js y
|
||||
// ResenasLocal importa las funciones de reseñas por la misma vía.
|
||||
vi.mock("../../src/api.js", () => ({
|
||||
confirmarLocal: vi.fn(),
|
||||
listarResenas: vi.fn(async () => ({ resenas: [], total: 0 })),
|
||||
enviarResena: vi.fn(),
|
||||
borrarResena: vi.fn(),
|
||||
reportarLocal: vi.fn(),
|
||||
}));
|
||||
|
||||
import LocalCard from "../../src/components/LocalCard.jsx";
|
||||
|
||||
beforeEach(() => { vi.clearAllMocks(); localStorage.clear(); });
|
||||
afterEach(cleanup);
|
||||
|
||||
const LOCAL = {
|
||||
id: "loc-1", nombre: "Bar Prueba", provincia: "Madrid", categoria: "Restauración",
|
||||
subcategoria: "", direccion: "Calle Mayor 5", enlaceGoogleMaps: "",
|
||||
descripcion: "Panadería artesana de barrio", puntuacion: 4, totalResenas: 2,
|
||||
fecha: "2026-10-01T10:00:00.000Z",
|
||||
};
|
||||
|
||||
describe("LocalCard (rediseño de usabilidad)", () => {
|
||||
it("la descripción va en bloque propio ENCIMA de la sección de reseñas", () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
const descripcion = screen.getByText(/Panadería artesana/i);
|
||||
const cabeceraResenas = screen.getByRole("button", { name: /reseñas \(2\)/i });
|
||||
expect(
|
||||
descripcion.compareDocumentPosition(cabeceraResenas) & Node.DOCUMENT_POSITION_FOLLOWING,
|
||||
).toBeTruthy();
|
||||
});
|
||||
|
||||
it("la barra inferior cubre el pie con Comentar · Reportar · Marcar · Compartir", () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
for (const nombre of [/^comentar$/i, /^reportar$/i, /^marcar$/i, /^compartir$/i]) {
|
||||
expect(screen.getByRole("button", { name: nombre })).toBeTruthy();
|
||||
}
|
||||
// la fecha queda en pequeñito encima de la barra
|
||||
expect(screen.getByText(/^publicado /i)).toBeTruthy();
|
||||
});
|
||||
|
||||
it("Marcar alterna el favorito (aria-pressed + persistencia)", () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
const marcar = screen.getByRole("button", { name: /^marcar$/i });
|
||||
expect(marcar.getAttribute("aria-pressed")).toBe("false");
|
||||
|
||||
fireEvent.click(marcar);
|
||||
const marcado = screen.getByRole("button", { name: /marcado/i });
|
||||
expect(marcado.getAttribute("aria-pressed")).toBe("true");
|
||||
expect(JSON.parse(localStorage.getItem("localesp_favoritos"))).toContain("loc-1");
|
||||
|
||||
fireEvent.click(marcado);
|
||||
expect(screen.getByRole("button", { name: /^marcar$/i }).getAttribute("aria-pressed")).toBe("false");
|
||||
});
|
||||
|
||||
it("Reportar abre el formulario controlado encima de la barra; Cancelar lo cierra", () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
fireEvent.click(screen.getByRole("button", { name: /^reportar$/i }));
|
||||
expect(screen.getByText(/¿Qué está mal con este local\?/i)).toBeTruthy();
|
||||
|
||||
fireEvent.click(screen.getByRole("button", { name: /cancelar/i }));
|
||||
expect(screen.queryByText(/¿Qué está mal/i)).toBeNull();
|
||||
});
|
||||
|
||||
it("Comentar expande la sección de reseñas y enfoca el formulario", async () => {
|
||||
render(<LocalCard local={LOCAL} />);
|
||||
fireEvent.click(screen.getByRole("button", { name: /^comentar$/i }));
|
||||
|
||||
await waitFor(() => expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy(), { timeout: 3000 });
|
||||
await waitFor(
|
||||
() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/),
|
||||
{ timeout: 3000 },
|
||||
);
|
||||
|
||||
// Comentar ALTERNA: la segunda pulsación cierra la sección
|
||||
fireEvent.click(screen.getByRole("button", { name: /^comentar$/i }));
|
||||
await waitFor(() => expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull());
|
||||
});
|
||||
});
|
||||
@@ -1,5 +1,6 @@
|
||||
// @vitest-environment jsdom
|
||||
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
|
||||
import { useState } from "react";
|
||||
import { cleanup, fireEvent, render, screen } from "@testing-library/react";
|
||||
import ModalPasarela from "../../src/components/ModalPasarela.jsx";
|
||||
|
||||
@@ -9,7 +10,7 @@ beforeEach(() => {
|
||||
afterEach(cleanup);
|
||||
|
||||
const FORM_VACIO = {
|
||||
nombre: "", provincia: "", categoria: "", subcategoria: "",
|
||||
nombre: "", provincia: "", categoria: "", subcategoria: "", descripcion: "",
|
||||
direccion: "", enlaceGoogleMaps: "", lat: null, lng: null,
|
||||
entradaUbicacion: "", proveedorUbicacion: "",
|
||||
};
|
||||
@@ -20,6 +21,7 @@ const FORM_RESUELTO = {
|
||||
proveedorUbicacion: "coordenadas",
|
||||
lat: 41.3851, lng: 2.1734,
|
||||
nombre: "Bar X", provincia: "Barcelona",
|
||||
direccion: "Calle Mayor 5, Alcalá de Henares",
|
||||
categoria: "Restauración", subcategoria: "Tapas y raciones",
|
||||
};
|
||||
|
||||
@@ -45,7 +47,6 @@ describe("ModalPasarela", () => {
|
||||
render(<ModalPasarela {...propsBase} form={FORM_VACIO} />);
|
||||
expect(screen.getByLabelText(/ubicación del local/i)).toBeTruthy();
|
||||
expect(screen.getByText(/paso 1 de 6/i)).toBeTruthy();
|
||||
expect(screen.getAllByRole("generic", { hidden: true })).toBeTruthy();
|
||||
// indicador de progreso: 6 barras
|
||||
const barras = document.querySelectorAll('[aria-hidden="true"] span[style*="width: 16px"]');
|
||||
expect(barras.length).toBe(6);
|
||||
@@ -56,12 +57,14 @@ describe("ModalPasarela", () => {
|
||||
expect(siguiente().disabled).toBe(true);
|
||||
});
|
||||
|
||||
it("Siguiente habilitado con datos válidos y navega; Atrás conserva los datos", () => {
|
||||
it("Siguiente habilitado con datos válidos y navega; los datos inferidos comparten pantalla; Atrás conserva", () => {
|
||||
render(<ModalPasarela {...propsBase} form={FORM_RESUELTO} />);
|
||||
expect(siguiente().disabled).toBe(false);
|
||||
fireEvent.click(siguiente());
|
||||
// paso 2: nombre pre-rellenado con lo inferido
|
||||
// paso 2: datos del local (nombre, provincia y dirección) en la misma pantalla
|
||||
expect(screen.getByLabelText(/nombre del local/i).value).toBe("Bar X");
|
||||
expect(screen.getByLabelText(/provincia/i).value).toBe("Barcelona");
|
||||
expect(screen.getByLabelText(/^dirección/i).value).toBe("Calle Mayor 5, Alcalá de Henares");
|
||||
|
||||
fireEvent.click(screen.getByRole("button", { name: /atrás/i }));
|
||||
// vuelve a ubicación con la entrada conservada
|
||||
@@ -109,4 +112,29 @@ describe("ModalPasarela", () => {
|
||||
expect(screen.getByRole("button", { name: /enviar propuesta/i })).toBeTruthy();
|
||||
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");
|
||||
});
|
||||
});
|
||||
|
||||
@@ -10,6 +10,7 @@ afterEach(cleanup);
|
||||
|
||||
const FORM_BASE = {
|
||||
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,
|
||||
entradaUbicacion: "40.4168, -3.7038", proveedorUbicacion: "coordenadas",
|
||||
};
|
||||
@@ -35,10 +36,17 @@ describe("PasoResumen", () => {
|
||||
expect(screen.getByText("Madrid")).toBeTruthy();
|
||||
expect(screen.getByText(/🍽️ Restauración/)).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(/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", () => {
|
||||
render(<PasoResumen {...propsBase} />);
|
||||
const boton = screen.getByRole("button", { name: /enviar propuesta/i });
|
||||
|
||||
@@ -2,18 +2,17 @@
|
||||
import { afterEach, describe, expect, it } from "vitest";
|
||||
import { useState } from "react";
|
||||
import { cleanup, fireEvent, render, screen } from "@testing-library/react";
|
||||
import PasoNombre from "../../src/components/PasoNombre.jsx";
|
||||
import PasoProvincia from "../../src/components/PasoProvincia.jsx";
|
||||
import PasoDatosLocal from "../../src/components/PasoDatosLocal.jsx";
|
||||
import PasoCategoria from "../../src/components/PasoCategoria.jsx";
|
||||
import PasoSubcategoria from "../../src/components/PasoSubcategoria.jsx";
|
||||
import PasoDescripcion from "../../src/components/PasoDescripcion.jsx";
|
||||
import { PROVINCIAS } from "../../src/constants/provincias.js";
|
||||
import { CATEGORIAS, NOMBRES_CATEGORIAS } from "../../src/constants/categorias.js";
|
||||
|
||||
afterEach(cleanup);
|
||||
|
||||
// Harness con useState real: los pasos escriben a través de setForm y el
|
||||
// estado resultante se lee desde fuera (más fiel que espiar el updater,
|
||||
// cuya evaluación diferida pierde el valor del evento en React 18).
|
||||
// estado resultante se lee desde fuera (más fiel que espiar el updater).
|
||||
function renderPaso(Componente, inicial) {
|
||||
const estado = { form: inicial };
|
||||
function Wrapper() {
|
||||
@@ -25,35 +24,38 @@ function renderPaso(Componente, inicial) {
|
||||
return estado;
|
||||
}
|
||||
|
||||
describe("PasoNombre", () => {
|
||||
it("muestra el nombre inferido y es editable", () => {
|
||||
const estado = renderPaso(PasoNombre, { nombre: "Bar El Olivo" });
|
||||
const input = screen.getByLabelText(/nombre del local/i);
|
||||
expect(input.value).toBe("Bar El Olivo");
|
||||
fireEvent.change(input, { target: { value: "Bar La Plaza" } });
|
||||
describe("PasoDatosLocal (datos inferidos en una pantalla)", () => {
|
||||
it("muestra los tres campos pre-rellenados con lo inferido, en la misma pantalla", () => {
|
||||
renderPaso(PasoDatosLocal, { nombre: "Puerta del Sol", provincia: "Madrid", direccion: "Puerta del Sol, 28013 Madrid" });
|
||||
expect(screen.getByLabelText(/nombre del local/i).value).toBe("Puerta del Sol");
|
||||
expect(screen.getByLabelText(/provincia/i).value).toBe("Madrid");
|
||||
expect(screen.getByLabelText(/^dirección/i).value).toBe("Puerta del Sol, 28013 Madrid");
|
||||
// aviso de que vienen de la inferencia
|
||||
expect(screen.getByText(/Rellenados automáticamente desde la ubicación/i)).toBeTruthy();
|
||||
});
|
||||
|
||||
it("todos editables: nombre (input), provincia (select PROVINCIAS), dirección (input)", () => {
|
||||
const estado = renderPaso(PasoDatosLocal, { nombre: "Bar X", provincia: "Barcelona", direccion: "Calle 1" });
|
||||
|
||||
fireEvent.change(screen.getByLabelText(/nombre del local/i), { target: { value: "Bar La Plaza" } });
|
||||
expect(estado.form.nombre).toBe("Bar La Plaza");
|
||||
});
|
||||
|
||||
it("vacío si la inferencia falló", () => {
|
||||
renderPaso(PasoNombre, { nombre: "" });
|
||||
expect(screen.getByLabelText(/nombre del local/i).value).toBe("");
|
||||
});
|
||||
});
|
||||
|
||||
describe("PasoProvincia", () => {
|
||||
it("es un select con el listado PROVINCIAS y la provincia pre-rellenada", () => {
|
||||
renderPaso(PasoProvincia, { provincia: "La Coruña" });
|
||||
const select = screen.getByLabelText(/provincia/i);
|
||||
expect(select.value).toBe("La Coruña");
|
||||
const opciones = [...select.options].map((o) => o.value);
|
||||
expect(opciones).toEqual(["", ...PROVINCIAS]);
|
||||
fireEvent.change(select, { target: { value: "Madrid" } });
|
||||
// (la aserción de estado se cubre con el harness en el resto de pasos)
|
||||
fireEvent.change(select, { target: { value: "Gerona" } });
|
||||
expect(estado.form.provincia).toBe("Gerona");
|
||||
|
||||
fireEvent.change(screen.getByLabelText(/^dirección/i), { target: { value: "Calle Nueva 2" } });
|
||||
expect(estado.form.direccion).toBe("Calle Nueva 2");
|
||||
});
|
||||
|
||||
it("sin coincidencia queda vacío (selección manual)", () => {
|
||||
renderPaso(PasoProvincia, { provincia: "" });
|
||||
it("vacíos y sin aviso de inferencia cuando la inferencia falló", () => {
|
||||
renderPaso(PasoDatosLocal, { nombre: "", provincia: "", direccion: "" });
|
||||
expect(screen.getByLabelText(/nombre del local/i).value).toBe("");
|
||||
expect(screen.getByLabelText(/provincia/i).value).toBe("");
|
||||
expect(screen.getByLabelText(/^dirección/i).value).toBe("");
|
||||
expect(screen.queryByText(/Rellenados automáticamente/i)).toBeNull();
|
||||
});
|
||||
});
|
||||
|
||||
@@ -83,3 +85,21 @@ describe("PasoSubcategoria", () => {
|
||||
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();
|
||||
});
|
||||
});
|
||||
|
||||
@@ -0,0 +1,164 @@
|
||||
// @vitest-environment jsdom
|
||||
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
|
||||
import { act, cleanup, fireEvent, render, screen, waitFor, within } from "@testing-library/react";
|
||||
|
||||
// Mock del cliente API (firebase.js re-exporta api.js: el mock intercepta la
|
||||
// resolución del módulo y cubre ambas vías).
|
||||
vi.mock("../../src/api.js", () => ({
|
||||
listarResenas: vi.fn(),
|
||||
enviarResena: vi.fn(),
|
||||
borrarResena: vi.fn(),
|
||||
reportarLocal: vi.fn(),
|
||||
}));
|
||||
|
||||
import { createRef } from "react";
|
||||
import ResenasLocal from "../../src/components/ResenasLocal.jsx";
|
||||
import { borrarResena, enviarResena, listarResenas, reportarLocal } from "../../src/api.js";
|
||||
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks();
|
||||
localStorage.clear();
|
||||
});
|
||||
afterEach(cleanup);
|
||||
|
||||
const ISO = "2026-10-11T10:00:00.000Z";
|
||||
const reseña = (id, huella, puntuacion, comentario, extra = {}) => ({
|
||||
id, huella, puntuacion, comentario, fecha: ISO, fechaEdicion: null, esPropia: false, ...extra,
|
||||
});
|
||||
const CUATRO = [
|
||||
reseña("r1", "#111111", 5, "Uno"),
|
||||
reseña("r2", "#222222", 4, "Dos"),
|
||||
reseña("r3", "#333333", 3, "Tres"),
|
||||
reseña("r4", "#444444", 2, "Cuatro"),
|
||||
];
|
||||
const PROPIA = reseña("r9", "#999999", 5, "Mi favorito", { esPropia: true });
|
||||
|
||||
const cabecera = () => screen.getByRole("button", { name: /reseñas \(\d+\)/i });
|
||||
|
||||
describe("ResenasLocal (grid + cierre por tres vías)", () => {
|
||||
it("carga al montar y muestra 3 en fila; la 4ª y el formulario quedan plegados", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
|
||||
render(<ResenasLocal localId="loc-1" totalInicial={4} mediaInicial={4} />);
|
||||
|
||||
await waitFor(() => expect(listarResenas).toHaveBeenCalledWith("loc-1", expect.any(String)));
|
||||
expect(await screen.findByText("Uno")).toBeTruthy();
|
||||
expect(screen.getByText("Dos")).toBeTruthy();
|
||||
expect(screen.getByText("Tres")).toBeTruthy();
|
||||
|
||||
// la vista previa contiene solo las 3 primeras
|
||||
const previa = screen.getByLabelText(/vista previa de reseñas/i);
|
||||
expect(within(previa).queryByText("Cuatro")).toBeNull();
|
||||
// pista y formulario plegado (aria-hidden excluye los roles)
|
||||
expect(screen.getByRole("button", { name: /ver las 4 reseñas/i })).toBeTruthy();
|
||||
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
|
||||
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
|
||||
});
|
||||
|
||||
it("expandir revela el resto en el mismo grid y el formulario; la cabecera vuelve a cerrar", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText("Uno");
|
||||
|
||||
fireEvent.click(cabecera());
|
||||
expect(await screen.findByText("Cuatro")).toBeTruthy();
|
||||
expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy();
|
||||
expect(screen.getByRole("button", { name: /cerrar/i })).toBeTruthy();
|
||||
expect(screen.queryByRole("button", { name: /ver las 4 reseñas/i })).toBeNull();
|
||||
expect(cabecera().getAttribute("aria-expanded")).toBe("true");
|
||||
|
||||
// cierre vía cabecera
|
||||
fireEvent.click(cabecera());
|
||||
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
|
||||
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
|
||||
});
|
||||
|
||||
it("el botón Cerrar del formulario pliega la sección", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText("Uno");
|
||||
|
||||
fireEvent.click(cabecera());
|
||||
fireEvent.click(await screen.findByRole("button", { name: /cerrar/i }));
|
||||
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
|
||||
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
|
||||
});
|
||||
|
||||
it("comentar() (barra de acciones) alterna: abre con foco y vuelve a cerrar", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
|
||||
const ref = createRef();
|
||||
render(<ResenasLocal ref={ref} localId="loc-1" />);
|
||||
await waitFor(() => expect(listarResenas).toHaveBeenCalled());
|
||||
|
||||
act(() => ref.current.comentar());
|
||||
await waitFor(() => expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy(), { timeout: 3000 });
|
||||
await waitFor(
|
||||
() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/),
|
||||
{ timeout: 3000 },
|
||||
);
|
||||
|
||||
act(() => ref.current.comentar());
|
||||
await waitFor(() => expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull());
|
||||
});
|
||||
|
||||
it("elegir estrellas y publicar llama a enviarResena con el deviceId", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
|
||||
enviarResena.mockResolvedValue({ ok: true, media: 4, total: 1 });
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText(/aún no hay reseñas/i);
|
||||
|
||||
fireEvent.click(cabecera());
|
||||
fireEvent.click(await screen.findByRole("radio", { name: "4 estrellas" }));
|
||||
fireEvent.change(screen.getByLabelText(/comentario de la reseña/i), { target: { value: "Muy bien" } });
|
||||
fireEvent.click(screen.getByRole("button", { name: /publicar/i }));
|
||||
|
||||
await waitFor(() => expect(enviarResena).toHaveBeenCalledWith("loc-1", {
|
||||
deviceId: expect.any(String),
|
||||
puntuacion: 4,
|
||||
comentario: "Muy bien",
|
||||
}));
|
||||
expect(localStorage.getItem("localesp_device_id")).toMatch(/./);
|
||||
});
|
||||
|
||||
it("la propia aparece como «Tú» con botón Borrar en su tarjeta; el formulario se precarga (Actualizar)", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [PROPIA], total: 1 });
|
||||
borrarResena.mockResolvedValue({ ok: true, media: 0, total: 0 });
|
||||
render(<ResenasLocal localId="loc-1" totalInicial={1} mediaInicial={5} />);
|
||||
const previa = screen.getByLabelText(/vista previa de reseñas/i);
|
||||
await waitFor(() => expect(within(previa).getByText("Mi favorito")).toBeTruthy());
|
||||
|
||||
// tarjeta propia en la vista previa: etiqueta «Tú» + Borrar (sin Reportar)
|
||||
const tarjeta = within(previa).getByText("Mi favorito").closest("div");
|
||||
expect(within(tarjeta).getByText(/^tú$/i)).toBeTruthy();
|
||||
fireEvent.click(within(tarjeta).getByRole("button", { name: /borrar/i }));
|
||||
await waitFor(() => expect(borrarResena).toHaveBeenCalledWith("loc-1", expect.any(String)));
|
||||
|
||||
// el formulario expandido sigue precargando la propia (Actualizar)
|
||||
fireEvent.click(cabecera());
|
||||
expect(await screen.findByRole("button", { name: /actualizar/i })).toBeTruthy();
|
||||
expect(screen.getByLabelText(/comentario de la reseña/i).value).toBe("Mi favorito");
|
||||
});
|
||||
|
||||
it("las reseñas ajenas tienen botón Reportar por tarjeta y queda marcada", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [CUATRO[0]], total: 1 });
|
||||
reportarLocal.mockResolvedValue({ ok: true });
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText("Uno");
|
||||
|
||||
const tarjeta = screen.getByText("Uno").closest("div");
|
||||
fireEvent.click(within(tarjeta).getByRole("button", { name: /reportar/i }));
|
||||
await waitFor(() => expect(reportarLocal).toHaveBeenCalledWith("loc-1", "inapropiado", "", "r1"));
|
||||
await waitFor(() => expect(within(tarjeta).getByText("✅")).toBeTruthy());
|
||||
});
|
||||
|
||||
it("errores del servidor (palabras no permitidas, 429) se muestran como aviso", async () => {
|
||||
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
|
||||
enviarResena.mockRejectedValue(new Error("El comentario contiene palabras no permitidas"));
|
||||
render(<ResenasLocal localId="loc-1" />);
|
||||
await screen.findByText(/aún no hay reseñas/i);
|
||||
|
||||
fireEvent.click(cabecera());
|
||||
fireEvent.click(await screen.findByRole("radio", { name: "3 estrellas" }));
|
||||
fireEvent.click(screen.getByRole("button", { name: /publicar/i }));
|
||||
expect((await screen.findByRole("alert")).textContent).toMatch(/no permitidas/i);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,15 @@
|
||||
import request from "supertest";
|
||||
|
||||
// Sin LOCALESP_ADMIN_PREFIX el servidor debe negarse a arrancar (fail-fast,
|
||||
// sin valor por defecto). Se fija la cadena vacía en el entorno para que el
|
||||
// test sea hermético aunque exista un `.env` configurado en el repo.
|
||||
process.env.LOCALESP_DB = ":memory:";
|
||||
process.env.LOCALESP_ADMIN_PREFIX = "";
|
||||
|
||||
describe("LOCALESP_ADMIN_PREFIX obligatorio — fail-fast sin configurar", () => {
|
||||
it("importar el servidor sin prefijo configurado lanza error", async () => {
|
||||
await expect(import("../../server/index.js")).rejects.toThrow(
|
||||
"LOCALESP_ADMIN_PREFIX no configurado",
|
||||
);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,54 @@
|
||||
import { expect, beforeAll, describe, it } from "vitest";
|
||||
import request from "supertest";
|
||||
|
||||
// Rate-limit de reseñas con su PROPIA instancia de app y un máximo bajo,
|
||||
// para poder agotar la cuota sin interferir en otras suites (vitest aísla
|
||||
// los módulos por fichero).
|
||||
process.env.LOCALESP_DB = ":memory:";
|
||||
process.env.LOCALESP_ADMIN_PREFIX = "/prefijo-admin-rl";
|
||||
process.env.LOCALESP_RESENAS_RATELIMIT_MAX = "2";
|
||||
|
||||
const server = (await import("../../server/index.js")).default;
|
||||
const PREFIX = "/prefijo-admin-rl";
|
||||
|
||||
let localId;
|
||||
|
||||
beforeAll(async () => {
|
||||
const propuesta = await request(server)
|
||||
.post("/api/propuestas")
|
||||
.send({ nombre: "Bar Limitado", provincia: "Madrid" })
|
||||
.expect(201);
|
||||
await request(server).post(`${PREFIX}/aprobar/${propuesta.body.id}`).expect(200);
|
||||
const locales = (await request(server).get("/api/locales").expect(200)).body;
|
||||
localId = locales.find((l) => l.nombre === "Bar Limitado").id;
|
||||
});
|
||||
|
||||
describe("Rate limit de escrituras de reseñas (anti-boicot base)", () => {
|
||||
it("las dos primeras escrituras pasan y la tercera recibe 429", async () => {
|
||||
await request(server)
|
||||
.post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: "device-rl-aaaa-0001", puntuacion: 5 })
|
||||
.expect(201);
|
||||
|
||||
await request(server)
|
||||
.post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: "device-rl-aaaa-0001", puntuacion: 4 }) // edición
|
||||
.expect(200);
|
||||
|
||||
const tercera = await request(server)
|
||||
.post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: "device-rl-bbbb-0002", puntuacion: 3 });
|
||||
expect(tercera.status).toBe(429);
|
||||
expect(tercera.body.error).toBeTruthy();
|
||||
expect(tercera.headers["retry-after"]).toBeTruthy();
|
||||
|
||||
// el DELETE también está limitado…
|
||||
const borrado = await request(server)
|
||||
.delete(`/api/locales/${localId}/resenas?deviceId=device-rl-aaaa-0001`);
|
||||
expect(borrado.status).toBe(429);
|
||||
|
||||
// …pero la LECTURA sigue disponible
|
||||
const lista = await request(server).get(`/api/locales/${localId}/resenas`).expect(200);
|
||||
expect(lista.body.total).toBe(1);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,170 @@
|
||||
import request from "supertest";
|
||||
|
||||
// BD en memoria, prefijo admin y rate-limit holgado para las pruebas de
|
||||
// comportamiento (el límite se prueba aparte, con su propio proceso):
|
||||
// deben configurarse ANTES de importar la app.
|
||||
process.env.LOCALESP_DB = ":memory:";
|
||||
process.env.LOCALESP_ADMIN_PREFIX = "/prefijo-admin-test";
|
||||
process.env.LOCALESP_RESENAS_RATELIMIT_MAX = "100";
|
||||
|
||||
// Se importa después de fijar las variables de entorno.
|
||||
const server = (await import("../../server/index.js")).default;
|
||||
|
||||
const PREFIX = "/prefijo-admin-test";
|
||||
const DEV_A = "device-aaaaaaaa-1111";
|
||||
const DEV_B = "device-bbbbbbbb-2222";
|
||||
|
||||
let localId;
|
||||
|
||||
beforeAll(async () => {
|
||||
// Publicar un local (propuesta → aprobación) para tener dónde reseñar.
|
||||
const propuesta = await request(server)
|
||||
.post("/api/propuestas")
|
||||
.send({ nombre: "Bar Reseñable", provincia: "Madrid", categoria: "Restauración" })
|
||||
.expect(201);
|
||||
await request(server).post(`${PREFIX}/aprobar/${propuesta.body.id}`).expect(200);
|
||||
const locales = (await request(server).get("/api/locales").expect(200)).body;
|
||||
localId = locales.find((l) => l.nombre === "Bar Reseñable").id;
|
||||
});
|
||||
|
||||
describe("Reseñas — creación, upsert y listado público", () => {
|
||||
it("GET /api/locales incluye totalResenas por local", async () => {
|
||||
const locales = (await request(server).get("/api/locales").expect(200)).body;
|
||||
const bar = locales.find((l) => l.id === localId);
|
||||
expect(bar.totalResenas).toBe(0);
|
||||
});
|
||||
|
||||
it("POST crea la reseña (201) y recalcula la media; GET lista con huella y sin deviceId", async () => {
|
||||
const res = await request(server)
|
||||
.post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: DEV_A, puntuacion: 5, comentario: " Pan excelente " })
|
||||
.expect(201);
|
||||
expect(res.body.creada).toBe(true);
|
||||
expect(res.body.media).toBe(5);
|
||||
expect(res.body.total).toBe(1);
|
||||
|
||||
const lista = (await request(server).get(`/api/locales/${localId}/resenas`).expect(200)).body;
|
||||
expect(lista.total).toBe(1);
|
||||
const [r] = lista.resenas;
|
||||
expect(r.huella).toMatch(/^#[0-9a-f]{3}$/);
|
||||
expect(r.puntuacion).toBe(5);
|
||||
expect(r.comentario).toBe("Pan excelente"); // trim
|
||||
expect(r.deviceId).toBeUndefined(); // nunca se expone
|
||||
expect(r.esPropia).toBe(false); // sin ?deviceId=
|
||||
|
||||
// con ?deviceId= se marca la propia
|
||||
const propia = (await request(server).get(`/api/locales/${localId}/resenas?deviceId=${DEV_A}`).expect(200)).body;
|
||||
expect(propia.resenas[0].esPropia).toBe(true);
|
||||
|
||||
// y la media queda en el local
|
||||
const local = (await request(server).get("/api/locales").expect(200)).body.find((l) => l.id === localId);
|
||||
expect(local.puntuacion).toBe(5);
|
||||
expect(local.totalResenas).toBe(1);
|
||||
});
|
||||
|
||||
it("POST del mismo dispositivo edita (200, fechaEdicion) sin duplicar", async () => {
|
||||
const res = await request(server)
|
||||
.post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: DEV_A, puntuacion: 4, comentario: "Bajó algo el nivel" })
|
||||
.expect(200);
|
||||
expect(res.body.creada).toBe(false);
|
||||
expect(res.body.total).toBe(1); // sigue habiendo UNA reseña
|
||||
|
||||
const lista = (await request(server).get(`/api/locales/${localId}/resenas?deviceId=${DEV_A}`)).body;
|
||||
expect(lista.resenas).toHaveLength(1);
|
||||
expect(lista.resenas[0].fechaEdicion).toBeTruthy();
|
||||
expect(lista.resenas[0].comentario).toBe("Bajó algo el nivel");
|
||||
});
|
||||
|
||||
it("la media se recalcula al crear, editar y borrar (ROUND de SQLite)", async () => {
|
||||
// estado: DEV_A=4 → añade DEV_B=5 → media ROUND(4.5)=5
|
||||
await request(server).post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: DEV_B, puntuacion: 5 }).expect(201);
|
||||
expect((await request(server).get("/api/locales")).body.find((l) => l.id === localId).puntuacion).toBe(5);
|
||||
|
||||
// edita DEV_B a 1 → media ROUND(2.5)=3 (round half away from zero)
|
||||
await request(server).post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: DEV_B, puntuacion: 1 }).expect(200);
|
||||
expect((await request(server).get("/api/locales")).body.find((l) => l.id === localId).puntuacion).toBe(3);
|
||||
|
||||
// borra DEV_B → solo queda DEV_A=4
|
||||
await request(server).delete(`/api/locales/${localId}/resenas?deviceId=${DEV_B}`).expect(200);
|
||||
expect((await request(server).get("/api/locales")).body.find((l) => l.id === localId).puntuacion).toBe(4);
|
||||
});
|
||||
|
||||
it("DELETE de la propia reseña inexistente → 404; sin deviceId → 400", async () => {
|
||||
await request(server).delete(`/api/locales/${localId}/resenas?deviceId=${DEV_B}`).expect(404);
|
||||
await request(server).delete(`/api/locales/${localId}/resenas`).expect(400);
|
||||
});
|
||||
});
|
||||
|
||||
describe("Reseñas — validaciones del contrato", () => {
|
||||
it("400: puntuacion ausente, 0, 6, no entera", async () => {
|
||||
for (const puntuacion of [undefined, 0, 6, 3.5, "cuatro"]) {
|
||||
await request(server).post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: DEV_B, puntuacion }).expect(400);
|
||||
}
|
||||
});
|
||||
|
||||
it("400: deviceId ausente/corto/largo y comentario >500", async () => {
|
||||
await request(server).post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: "", puntuacion: 3 }).expect(400);
|
||||
await request(server).post(`/api/locales/${localId}/resenas`)
|
||||
.send({ puntuacion: 3 }).expect(400);
|
||||
await request(server).post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: "x".repeat(65), puntuacion: 3 }).expect(400);
|
||||
await request(server).post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: DEV_B, puntuacion: 3, comentario: "y".repeat(501) }).expect(400);
|
||||
});
|
||||
|
||||
it("404: local inexistente en GET/POST", async () => {
|
||||
const idFantasma = "00000000-0000-4000-8000-000000000000";
|
||||
await request(server).get(`/api/locales/${idFantasma}/resenas`).expect(404);
|
||||
await request(server).post(`/api/locales/${idFantasma}/resenas`)
|
||||
.send({ deviceId: DEV_B, puntuacion: 3 }).expect(404);
|
||||
});
|
||||
|
||||
it("400: comentario con palabra prohibida (filtro de palabras)", async () => {
|
||||
await request(server).post("/api/config/filtro_palabras")
|
||||
.send({ palabras: ["timonestro"] }).expect(200);
|
||||
const res = await request(server).post(`/api/locales/${localId}/resenas`)
|
||||
.send({ deviceId: DEV_B, puntuacion: 1, comentario: "Sitio timonestro" }).expect(400);
|
||||
expect(res.body.error).toMatch(/no permitidas/i);
|
||||
// la reseña no se creó ni modificó
|
||||
const lista = (await request(server).get(`/api/locales/${localId}/resenas`)).body;
|
||||
expect(lista.resenas.some((r) => r.comentario?.includes("timonestro"))).toBe(false);
|
||||
await request(server).post("/api/config/filtro_palabras").send({ palabras: [] });
|
||||
});
|
||||
});
|
||||
|
||||
describe("Reseñas — reportes y moderación admin", () => {
|
||||
it("reportar una reseña concreta (resenaId) llega a la lista admin", async () => {
|
||||
const lista = (await request(server).get(`/api/locales/${localId}/resenas`)).body;
|
||||
const objetivo = lista.resenas[0];
|
||||
|
||||
await request(server).post(`/api/locales/${localId}/reportar`)
|
||||
.send({ motivo: "inapropiado", comentario: "", resenaId: objetivo.id })
|
||||
.expect(201);
|
||||
|
||||
const reportes = (await request(server).get(`${PREFIX}/reportes`).expect(200)).body;
|
||||
const reporte = reportes.find((r) => r.resenaId === objetivo.id);
|
||||
expect(reporte).toBeDefined();
|
||||
expect(reporte.localNombre).toBe("Bar Reseñable");
|
||||
|
||||
// resenaId que no existe → 404
|
||||
await request(server).post(`/api/locales/${localId}/reportar`)
|
||||
.send({ resenaId: "no-existe" }).expect(404);
|
||||
});
|
||||
|
||||
it("admin: listado completo y borrado con recálculo de media", async () => {
|
||||
const resenas = (await request(server).get(`${PREFIX}/resenas`).expect(200)).body;
|
||||
expect(resenas).toHaveLength(1);
|
||||
expect(resenas[0].localNombre).toBe("Bar Reseñable");
|
||||
|
||||
await request(server).delete(`${PREFIX}/resenas/${resenas[0].id}`).expect(200);
|
||||
// sin reseñas → media 0
|
||||
expect((await request(server).get("/api/locales")).body.find((l) => l.id === localId).puntuacion).toBe(0);
|
||||
// borrar de nuevo → 404
|
||||
await request(server).delete(`${PREFIX}/resenas/${resenas[0].id}`).expect(404);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,183 @@
|
||||
import request from "supertest";
|
||||
|
||||
// BD en memoria y prefijo admin de prueba: deben configurarse ANTES de
|
||||
// importar la app (server/db.js y server/index.js los leen al cargarse).
|
||||
process.env.LOCALESP_DB = ":memory:";
|
||||
process.env.LOCALESP_ADMIN_PREFIX = "/prefijo-admin-test";
|
||||
|
||||
// Se importa después de fijar las variables de entorno.
|
||||
const server = (await import("../../server/index.js")).default;
|
||||
|
||||
const PREFIX = "/prefijo-admin-test";
|
||||
|
||||
describe("Rutas públicas — funcionan sin cambios (sección 5.1)", () => {
|
||||
it("GET /api/locales → 200 con lista", async () => {
|
||||
const res = await request(server).get("/api/locales").expect(200);
|
||||
expect(Array.isArray(res.body)).toBe(true);
|
||||
});
|
||||
|
||||
it("POST /api/propuestas → 201 con la propuesta creada", async () => {
|
||||
const res = await request(server)
|
||||
.post("/api/propuestas")
|
||||
.send({ nombre: "Cafetería Única Test", provincia: "Madrid", categoria: "Cafetería" })
|
||||
.expect(201);
|
||||
expect(res.body.nombre).toBe("Cafetería Única Test");
|
||||
expect(res.body.estado).toBe("pendiente");
|
||||
});
|
||||
|
||||
it("GET / sirve el fallback SPA (dist/index.html)", async () => {
|
||||
const res = await request(server).get("/").expect(200);
|
||||
// El build emite `<!doctype html>` en minúscula: comparar sin distinción.
|
||||
expect(res.text.toLowerCase()).toContain("<!doctype html>");
|
||||
});
|
||||
});
|
||||
|
||||
describe("Rutas admin conocidas — ya no existen bajo /api (404)", () => {
|
||||
it("GET /api/pendientes → 404", async () => {
|
||||
await request(server).get("/api/pendientes").expect(404);
|
||||
});
|
||||
|
||||
it("GET /api/reportes → 404", async () => {
|
||||
await request(server).get("/api/reportes").expect(404);
|
||||
});
|
||||
|
||||
it("POST /api/aprobar/:id → 404 (la acción no se ejecuta)", async () => {
|
||||
await request(server).post("/api/aprobar/123").expect(404);
|
||||
});
|
||||
|
||||
it("POST /api/rechazar/:id → 404", async () => {
|
||||
await request(server).post("/api/rechazar/123").expect(404);
|
||||
});
|
||||
|
||||
it("DELETE /api/locales/:id → 404", async () => {
|
||||
await request(server).delete("/api/locales/123").expect(404);
|
||||
});
|
||||
|
||||
it("POST /api/reportes/:id/descartar → 404", async () => {
|
||||
await request(server).post("/api/reportes/1/descartar").expect(404);
|
||||
});
|
||||
|
||||
it("variantes de enumeración → sin fuga de datos", async () => {
|
||||
await request(server).get("/api/pendientes.json").expect(404);
|
||||
await request(server).get("/api/xpendientes").expect(404);
|
||||
// Con prefijo configurado, las variantes de caja no tienen handler API y
|
||||
// caen al fallback SPA (HTML genérico, sin datos).
|
||||
const res = await request(server).get("/API/PENDIENTES");
|
||||
expect([200, 404]).toContain(res.status);
|
||||
expect(res.body).toEqual({});
|
||||
});
|
||||
});
|
||||
|
||||
describe("Rutas admin bajo el prefijo configurable — funcionan", () => {
|
||||
it("GET $PREFIX/pendientes → 200 con la propuesta pendiente", async () => {
|
||||
const res = await request(server).get(`${PREFIX}/pendientes`).expect(200);
|
||||
expect(Array.isArray(res.body)).toBe(true);
|
||||
expect(res.body.some((p) => p.nombre === "Cafetería Única Test")).toBe(true);
|
||||
});
|
||||
|
||||
it("POST $PREFIX/aprobar/:id → mueve la propuesta a locales", async () => {
|
||||
const pendientes = (await request(server).get(`${PREFIX}/pendientes`)).body;
|
||||
const propuesta = pendientes.find((p) => p.nombre === "Cafetería Única Test");
|
||||
expect(propuesta).toBeDefined();
|
||||
|
||||
await request(server).post(`${PREFIX}/aprobar/${propuesta.id}`).expect(200);
|
||||
|
||||
const locales = (await request(server).get("/api/locales")).body;
|
||||
expect(locales.some((l) => l.nombre === "Cafetería Única Test")).toBe(true);
|
||||
|
||||
const despues = (await request(server).get(`${PREFIX}/pendientes`)).body;
|
||||
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 () => {
|
||||
const creada = await request(server)
|
||||
.post("/api/propuestas")
|
||||
.send({ nombre: "Propuesta Rechazable", provincia: "Cádiz" })
|
||||
.expect(201);
|
||||
|
||||
await request(server).post(`${PREFIX}/rechazar/${creada.body.id}`).expect(200);
|
||||
|
||||
const pendientes = (await request(server).get(`${PREFIX}/pendientes`)).body;
|
||||
expect(pendientes.some((p) => p.id === creada.body.id)).toBe(false);
|
||||
});
|
||||
|
||||
it("ciclo de reportes: reportar (público) → listar y descartar (admin)", async () => {
|
||||
const locales = (await request(server).get("/api/locales")).body;
|
||||
const local = locales.find((l) => l.nombre === "Cafetería Única Test");
|
||||
expect(local).toBeDefined();
|
||||
|
||||
// El reporte lo envía cualquier usuario desde la web pública.
|
||||
const reporte = await request(server)
|
||||
.post(`/api/locales/${local.id}/reportar`)
|
||||
.send({ motivo: "cerrado", comentario: "prueba" })
|
||||
.expect(201);
|
||||
expect(reporte.body.ok).toBe(true);
|
||||
|
||||
const reportes = (await request(server).get(`${PREFIX}/reportes`).expect(200)).body;
|
||||
const creado = reportes.find((r) => r.id === reporte.body.id);
|
||||
expect(creado).toBeDefined();
|
||||
expect(creado.localNombre).toBe("Cafetería Única Test");
|
||||
|
||||
await request(server).post(`${PREFIX}/reportes/${creado.id}/descartar`).expect(200);
|
||||
const despues = (await request(server).get(`${PREFIX}/reportes`)).body;
|
||||
expect(despues.some((r) => r.id === creado.id)).toBe(false);
|
||||
});
|
||||
|
||||
it("POST /api/locales/:id/confirmar (público) → renueva fechaConfirmacion", async () => {
|
||||
const locales = (await request(server).get("/api/locales")).body;
|
||||
const local = locales.find((l) => l.nombre === "Cafetería Única Test");
|
||||
const res = await request(server).post(`/api/locales/${local.id}/confirmar`).expect(200);
|
||||
expect(res.body.fechaConfirmacion).toBeDefined();
|
||||
});
|
||||
|
||||
it("DELETE $PREFIX/locales/:id → borra el local y sus reportes", async () => {
|
||||
const locales = (await request(server).get("/api/locales")).body;
|
||||
const local = locales.find((l) => l.nombre === "Cafetería Única Test");
|
||||
await request(server).delete(`${PREFIX}/locales/${local.id}`).expect(200);
|
||||
|
||||
const despues = (await request(server).get("/api/locales")).body;
|
||||
expect(despues.some((l) => l.id === local.id)).toBe(false);
|
||||
});
|
||||
|
||||
it("POST /api/check-duplicado → contrato `coincidencias` intacto", async () => {
|
||||
await request(server)
|
||||
.post("/api/propuestas")
|
||||
.send({ nombre: "Bar Duplicado", provincia: "Sevilla", lat: 37.39, lng: -5.99 })
|
||||
.expect(201);
|
||||
|
||||
const res = await request(server)
|
||||
.post("/api/check-duplicado")
|
||||
.send({ nombre: "bar duplicado", provincia: "Sevilla" })
|
||||
.expect(200);
|
||||
expect(res.body.duplicado).toBe(true);
|
||||
expect(Array.isArray(res.body.coincidencias)).toBe(true);
|
||||
expect(res.body.coincidencias.length).toBeGreaterThan(0);
|
||||
});
|
||||
|
||||
it("GET /api/config/filtro_palabras → 200", async () => {
|
||||
const res = await request(server).get("/api/config/filtro_palabras").expect(200);
|
||||
expect(res.body.palabras).toEqual([]);
|
||||
});
|
||||
});
|
||||
+35
-8
@@ -1,13 +1,40 @@
|
||||
import { defineConfig } from 'vite'
|
||||
import { defineConfig, loadEnv } from 'vite'
|
||||
import react from '@vitejs/plugin-react'
|
||||
|
||||
export default defineConfig({
|
||||
plugins: [react()],
|
||||
server: {
|
||||
proxy: {
|
||||
'/api': {
|
||||
target: 'http://localhost:3000',
|
||||
changeOrigin: true,
|
||||
// Una sola variable de configuración: LOCALESP_ADMIN_PREFIX (ver .env.example).
|
||||
// - El servidor la lee en arranque (obligatoria, fail-fast).
|
||||
// - Vite la expone al frontend vía envPrefix (dev y build la recogen de .env
|
||||
// o del entorno) y la usa aquí para proxyar el prefijo al backend.
|
||||
export default defineConfig(({ mode, command }) => {
|
||||
const env = loadEnv(mode, process.cwd(), '')
|
||||
const raw = (env.LOCALESP_ADMIN_PREFIX || process.env.LOCALESP_ADMIN_PREFIX || '').trim()
|
||||
const adminPrefix = raw ? (raw.startsWith('/') ? raw : `/${raw}`).replace(/\/+$/, '') : ''
|
||||
|
||||
if (!adminPrefix && command === 'build') {
|
||||
throw new Error(
|
||||
'[config] Falta LOCALESP_ADMIN_PREFIX (obligatoria, sin valor por defecto).' +
|
||||
' Copia .env.example a .env y asigna el prefijo de administración.',
|
||||
)
|
||||
}
|
||||
if (!adminPrefix) {
|
||||
console.warn('[config] LOCALESP_ADMIN_PREFIX sin configurar: el proxy de desarrollo no cubrirá las rutas admin (el servidor tampoco arrancará sin ella).')
|
||||
}
|
||||
|
||||
return {
|
||||
plugins: [react()],
|
||||
envPrefix: ['VITE_', 'LOCALESP_'],
|
||||
server: {
|
||||
proxy: {
|
||||
'/api': {
|
||||
target: 'http://localhost:3000',
|
||||
changeOrigin: true,
|
||||
},
|
||||
...(adminPrefix && adminPrefix !== '/api' ? {
|
||||
[adminPrefix]: {
|
||||
target: 'http://localhost:3000',
|
||||
changeOrigin: true,
|
||||
},
|
||||
} : {}),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user