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
2.2 KiB
LocalESP
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:
cp .env.example .env # y rellena LOCALESP_ADMIN_PREFIX
- Servidor: lee
LOCALESP_ADMIN_PREFIXdel entorno y de.env(el fichero no sobrescribe variables ya presentes). - Frontend: Vite expone
LOCALESP_ADMIN_PREFIXal código cliente víaenvPrefix(.envo entorno en dev/build);npm run buildfalla si falta. - Desarrollo:
npm run devproxya/apiy el prefijo admin al backend enlocalhost:3000, leyendo ambos del entorno o de.env.
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.