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
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. Esto 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.