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
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. - Despliegue CI (entorno por rama): el prefijo de cada entorno se declara
en
scripts/entornos.env(mappingslug=prefijo, en el repo): el workflow de deploy lo incrusta en el build ydeploy.shlo 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.