From 4d7d9e19dcd2eb1afdaac0912f61ce2f2589826e Mon Sep 17 00:00:00 2001 From: Edgar Friendly Date: Sat, 3 Oct 2026 14:33:34 +0200 Subject: [PATCH] =?UTF-8?q?feat(panel):=20el=20panel=20admin=20vive=20en?= =?UTF-8?q?=20la=20ra=C3=ADz=20del=20prefijo,=20/admin=20desaparece?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- README.md | 7 +++++-- openspec/changes/hide-admin-route/design.md | 5 +++++ .../hide-admin-route/specs/route-obfuscation/spec.md | 10 +++++++--- src/AdminPanel.jsx | 4 ++-- src/main.jsx | 12 +++++++++--- 5 files changed, 28 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 32063f4..000a023 100644 --- a/README.md +++ b/README.md @@ -7,8 +7,11 @@ Registro colaborativo de negocios españoles. 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. Esto oculta la superficie admin de la -enumeración de rutas sin añadir autenticación (ocultación, no seguridad real). +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 | |---|---| diff --git a/openspec/changes/hide-admin-route/design.md b/openspec/changes/hide-admin-route/design.md index 129b582..d3374ee 100644 --- a/openspec/changes/hide-admin-route/design.md +++ b/openspec/changes/hide-admin-route/design.md @@ -21,6 +21,11 @@ > 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. ## Context diff --git a/openspec/changes/hide-admin-route/specs/route-obfuscation/spec.md b/openspec/changes/hide-admin-route/specs/route-obfuscation/spec.md index 9b3f2ec..2709c7a 100644 --- a/openspec/changes/hide-admin-route/specs/route-obfuscation/spec.md +++ b/openspec/changes/hide-admin-route/specs/route-obfuscation/spec.md @@ -64,8 +64,9 @@ Admin endpoints under the prefix: ### Requirement: Admin panel routes are fully discoverable **Reason**: Security concern — admin routes should be harder to discover -**Migration**: Admin users access the panel at `/admin`; its API calls go to -the configured prefix — the same single `LOCALESP_ADMIN_PREFIX` variable at build time +**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 @@ -77,9 +78,12 @@ The requirement SHALL: `/api/pendientes` returns 404 when a prefix is configured) #### 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 `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 diff --git a/src/AdminPanel.jsx b/src/AdminPanel.jsx index eb86ca6..b0eb24b 100644 --- a/src/AdminPanel.jsx +++ b/src/AdminPanel.jsx @@ -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, diff --git a/src/main.jsx b/src/main.jsx index 1a14531..d9042e6 100644 --- a/src/main.jsx +++ b/src/main.jsx @@ -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 ; + if (ADMIN_RUTA && ruta === ADMIN_RUTA) return ; return ; }