Compare commits
6
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
d34ebf7ca0 | ||
|
|
695d59d31e | ||
|
|
4d7d9e19dc | ||
|
|
34bd421853 | ||
|
|
85a054d886 | ||
|
|
49e965b248 |
@@ -0,0 +1,20 @@
|
||||
# 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=
|
||||
@@ -27,10 +27,22 @@ 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
|
||||
slug="$(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
|
||||
|
||||
|
||||
@@ -29,6 +29,11 @@ jobs:
|
||||
run: npm test
|
||||
|
||||
- name: Build de producción
|
||||
# Smoke build: el prefijo real lo aporta cada entorno en deploy.yml
|
||||
# (config /etc/localesp/<slug>.env del host). 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
|
||||
|
||||
integracion:
|
||||
|
||||
@@ -1,2 +1,55 @@
|
||||
# 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 |
|
||||
|
||||
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` y
|
||||
`GET/POST /api/config/filtro_palabras`.
|
||||
|
||||
### 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.
|
||||
@@ -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
|
||||
@@ -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) Revisión y envío.
|
||||
|
||||
#### Scenario: Primera pantalla
|
||||
- **WHEN** se abre la pasarela
|
||||
@@ -36,12 +36,12 @@ 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.
|
||||
### 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: Nombre y provincia pre-rellenados
|
||||
#### 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,7 +49,7 @@ 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.
|
||||
|
||||
@@ -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
|
||||
@@ -24,6 +24,7 @@
|
||||
|
||||
DOMAIN="localesp.es"
|
||||
PORT_BASE=8082 # 8080/8081 son entornos legacy
|
||||
ENV_CONFIG_FILE="scripts/entornos.env" # mapping slug=prefijo admin (fichero del repo)
|
||||
LOGGER_TAG="env"
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
@@ -61,6 +62,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.
|
||||
# ---------------------------------------------------------------------------
|
||||
@@ -390,14 +410,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]}"
|
||||
|
||||
|
||||
+70
-27
@@ -1,12 +1,55 @@
|
||||
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";
|
||||
|
||||
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")));
|
||||
|
||||
@@ -16,12 +59,6 @@ app.get("/api/locales", (_req, res) => {
|
||||
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 +108,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 +135,38 @@ 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 });
|
||||
});
|
||||
|
||||
// Confirmar que un local sigue activo (renueva fechaConfirmacion)
|
||||
app.post("/api/locales/:id/confirmar", (req, res) => {
|
||||
const { id } = req.params;
|
||||
@@ -130,24 +191,6 @@ app.post("/api/locales/:id/reportar", (req, res) => {
|
||||
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);
|
||||
});
|
||||
|
||||
// Descartar un reporte (el admin revisó y no hace falta actuar)
|
||||
app.post("/api/reportes/:id/descartar", (req, res) => {
|
||||
const { id } = req.params;
|
||||
db.prepare("UPDATE reportes SET estado = 'descartado' WHERE id = ?").run(id);
|
||||
res.json({ ok: true });
|
||||
});
|
||||
|
||||
// Config (palabras filtradas)
|
||||
app.get("/api/config/filtro_palabras", (_req, res) => {
|
||||
const config = db.prepare("SELECT datos FROM config WHERE id = ?").get("filtro_palabras");
|
||||
|
||||
+2
-2
@@ -1,5 +1,5 @@
|
||||
// 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,
|
||||
|
||||
+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;
|
||||
}
|
||||
|
||||
|
||||
+13
-7
@@ -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();
|
||||
@@ -101,12 +107,12 @@ export async function reportarLocal(id, motivo, comentario) {
|
||||
}
|
||||
|
||||
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,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" }}>
|
||||
|
||||
+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 />;
|
||||
}
|
||||
|
||||
|
||||
@@ -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,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,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