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
This commit is contained in:
2026-10-03 14:33:34 +02:00
parent 34bd421853
commit 4d7d9e19dc
5 changed files with 28 additions and 10 deletions
+5 -2
View File
@@ -7,8 +7,11 @@ Registro colaborativo de negocios españoles.
Las rutas de administración **solo se sirven bajo un 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`, las rutas históricas (`/api/pendientes`, `/api/reportes`, `/api/aprobar/:id`,
`/api/rechazar/:id`, `DELETE /api/locales/:id`, `/api/reportes/:id/descartar`) `/api/rechazar/:id`, `DELETE /api/locales/:id`, `/api/reportes/:id/descartar`)
dejan de existir y devuelven 404. Esto oculta la superficie admin de la dejan de existir y devuelven 404. Además, **el propio panel admin vive en la
enumeración de rutas sin añadir autenticación (ocultación, no seguridad real). 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 | | Ruta admin | Método |
|---|---| |---|---|
@@ -21,6 +21,11 @@
> para servidor, proxy de desarrollo y frontend. Vite la expone al código > para servidor, proxy de desarrollo y frontend. Vite la expone al código
> cliente mediante `envPrefix: ["VITE_", "LOCALESP_"]` y `npm run build` > cliente mediante `envPrefix: ["VITE_", "LOCALESP_"]` y `npm run build`
> también falla si falta. > 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.
## Context ## Context
@@ -64,8 +64,9 @@ Admin endpoints under the prefix:
### Requirement: Admin panel routes are fully discoverable ### Requirement: Admin panel routes are fully discoverable
**Reason**: Security concern — admin routes should be harder to discover **Reason**: Security concern — admin routes should be harder to discover
**Migration**: Admin users access the panel at `/admin`; its API calls go to **Migration**: Admin users access the panel at the prefix root
the configured prefix — the same single `LOCALESP_ADMIN_PREFIX` variable at build time (`$ADMIN_PREFIX`, compiled with the same `LOCALESP_ADMIN_PREFIX`); its API
calls go to the configured prefix
## MODIFIED Requirements ## MODIFIED Requirements
@@ -77,9 +78,12 @@ The requirement SHALL:
`/api/pendientes` returns 404 when a prefix is configured) `/api/pendientes` returns 404 when a prefix is configured)
#### Scenario: Admin views pending proposals through the panel #### Scenario: Admin views pending proposals through the panel
- **WHEN** an admin opens the panel at `/admin` - **WHEN** an admin opens the panel at the prefix root (`$ADMIN_PREFIX`,
e.g. `/administrador`)
- **THEN** the panel fetches `$ADMIN_PREFIX/pendientes` (compiled with - **THEN** the panel fetches `$ADMIN_PREFIX/pendientes` (compiled with
`LOCALESP_ADMIN_PREFIX`) and renders the list exactly as before `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 **Design note**: This is obscurity, not security: the prefix ships in the
frontend bundle. It raises the cost of blind route enumeration only. Real frontend bundle. It raises the cost of blind route enumeration only. Real
+2 -2
View File
@@ -1,5 +1,5 @@
// AdminPanel.jsx — /admin // AdminPanel.jsx — raíz del prefijo admin configurado (LOCALESP_ADMIN_PREFIX)
// No aparece en ningún menú público. Acceso solo por URL directa. // No aparece en ningún menú público. Acceso solo por URL directa prefijada.
import { useState, useEffect } from "react"; import { useState, useEffect } from "react";
import { import {
escucharAuth, loginAdmin, registrarAdmin, cerrarSesion, escucharAuth, loginAdmin, registrarAdmin, cerrarSesion,
+9 -3
View File
@@ -3,11 +3,17 @@ import { createRoot } from "react-dom/client";
import App from "./App.jsx"; import App from "./App.jsx";
import AdminPanel from "./AdminPanel.jsx"; import AdminPanel from "./AdminPanel.jsx";
// Enrutador mínimo sin dependencias extra // Enrutador mínimo sin dependencias extra.
const ruta = window.location.pathname.replace(/\/$/, ""); // 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() { function Root() {
if (ruta === "/admin") return <AdminPanel />; if (ADMIN_RUTA && ruta === ADMIN_RUTA) return <AdminPanel />;
return <App />; return <App />;
} }