Author SHA1 Message Date
edgar.friendly d34ebf7ca0 feat(pasarela): campo opcional de descripción en la pasarela de proponer local
deploy-branch / deploy (push) Successful in 3m11s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m27s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m0s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
Nueva pantalla "Descripción" (paso 5 de 6, opcional, máx. 200 caracteres)
entre Tipo específico y Revisión. La descripción viaja en la propuesta
(trim; vacía → ausente/NULL), el filtro de palabras prohibidas la cubre y
el resumen la muestra. Backend/BD ya la soportaban: cambio frontend-only.

Incluye el archivo del cambio hide-admin-route y la propuesta
openspec del nuevo cambio. Suite: 114/114.
2026-10-11 15:04:37 +02:00
edgar.friendly 695d59d31e ci(deploy): config por entorno en el repo (scripts/entornos.env)
deploy-branch / deploy (push) Successful in 3m18s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m15s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m25s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
La config de prefijo admin pasa del host (/etc/localesp/<slug>.env) al
repo, para que viaje con el código que despliega y se revise en PRs:

- scripts/entornos.env: mapping <slug>=<prefijo> (prototipo-yb01=
  /administrador; master y prototipo-yb01-ef como plantilla comentada)
- env.sh: servicio Config::admin_prefix lee el mapping; require_config
  falla con mensaje claro si la rama no tiene entrada; Env::deploy
  regenera <dest>/.env desde el repo (el servidor lo autocarga)
- deploy.yml: el build exporta el prefijo del mapping antes de compilar
2026-10-03 14:56:08 +02:00
edgar.friendly 4d7d9e19dc feat(panel): el panel admin vive en la raíz del prefijo, /admin desaparece
deploy-branch / deploy (push) Successful in 2m59s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m30s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m25s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
La ruta fija /admin del enrutador SPA mostraba el panel sin importar el
prefijo configurado. Ahora AdminPanel se monta solo cuando el pathname
coincide con la raíz de LOCALESP_ADMIN_PREFIX (misma variable única que
backend, build y API): con /administrador, el panel queda en
/administrador y /admin pasa a mostrar la web pública.

- src/main.jsx: enrutado por ADMIN_RUTA derivada del prefijo
- README y artefactos openspec (spec/design) actualizados
2026-10-03 14:33:34 +02:00
edgar.friendly 34bd421853 ci(deploy): config por entorno en /etc/localesp/<slug>.env
deploy-branch / deploy (push) Successful in 3m18s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m25s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m29s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
El build ahora exige LOCALESP_ADMIN_PREFIX (sin valor por defecto), así
que el CI necesita saber el prefijo de cada entorno de rama:

- deploy.yml: el paso de build carga /etc/localesp/<slug>.env del host
  (Slug::from de lib/env.sh) y falla con mensaje claro si no existe
- env.sh: Env::require_config valida la config, y Env::deploy la copia
  a <dest>/.env, que el servidor autocarga (sobrevive a rsync --delete)
- tests.yml: el smoke-build usa un prefijo placeholder (/admin-ci);
  comprueba que el build funciona, no la configuración del entorno
2026-10-02 22:09:06 +02:00
edgar.friendly 85a054d886 feat(seguridad): rutas admin bajo prefijo configurable obligatorio
deploy-branch / deploy (push) Failing after 3m7s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m17s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m10s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
Cambio openspec hide-admin-route: las rutas de administración se montan
bajo LOCALESP_ADMIN_PREFIX (única variable, obligatoria, sin valor por
defecto) y las rutas históricas /api/... dejan de existir (404 natural).

- server: autocarga de .env (sin pisar el entorno) y fail-fast claro si
  falta LOCALESP_ADMIN_PREFIX; reportar/confirmar siguen públicas
- frontend: src/api.js usa el prefijo expuesto por Vite (envPrefix);
  npm run build falla sin la variable; proxy de dev la lee vía loadEnv
- .env.example como template único de configuración
- tests: 109/109 en verde (rutas bajo prefijo, 404s históricos y
  fail-fast sin configurar)
- openspec: artefactos del cambio sincronizados (design/spec/tasks)
2026-10-02 21:57:02 +02:00
edgar.friendly 49e965b248 feat(pasarela): datos inferidos juntos en una pantalla "Datos del local"
deploy-branch / deploy (push) Successful in 2m18s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 2m23s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
tests / Unitarias + componente + build (push) Successful in 2m30s
tests / Integración (Nominatim real, opt-in) (push) Skipped
- Nuevo PasoDatosLocal con nombre, provincia y dirección (ahora editable)
  en la misma pantalla, con aviso cuando vienen de la inferencia
- El wizard pasa de 6 a 5 pasos: Ubicación → Datos del local → Categoría
  → Tipo específico → Resumen
- Eliminados PasoNombre y PasoProvincia (absorbidos)
- Spec principal actualizada al nuevo orden de pantallas
2026-09-12 19:00:33 +02:00
34 changed files with 1312 additions and 143 deletions
+20
View File
@@ -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=
+12
View File
@@ -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
+5
View File
@@ -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:
+54 -1
View File
@@ -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.
+11
View File
@@ -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
+45
View File
@@ -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
View File
@@ -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
View File
@@ -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
View File
@@ -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
View File
@@ -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();
}
+4 -4
View File
@@ -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 },
];
+73
View File
@@ -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>
);
}
+26
View File
@@ -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>
);
}
-26
View File
@@ -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>
);
}
-26
View File
@@ -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>
);
}
+7 -1
View File
@@ -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
View File
@@ -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 />;
}
+32 -4
View File
@@ -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");
});
});
+8
View File
@@ -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 });
+45 -25
View File
@@ -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",
);
});
});
+183
View File
@@ -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
View File
@@ -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,
},
} : {}),
}
}
}