Cambio openspec hide-admin-route: las rutas de administración se montan bajo LOCALESP_ADMIN_PREFIX (única variable, obligatoria, sin valor por defecto) y las rutas históricas /api/... dejan de existir (404 natural). - server: autocarga de .env (sin pisar el entorno) y fail-fast claro si falta LOCALESP_ADMIN_PREFIX; reportar/confirmar siguen públicas - frontend: src/api.js usa el prefijo expuesto por Vite (envPrefix); npm run build falla sin la variable; proxy de dev la lee vía loadEnv - .env.example como template único de configuración - tests: 109/109 en verde (rutas bajo prefijo, 404s históricos y fail-fast sin configurar) - openspec: artefactos del cambio sincronizados (design/spec/tasks)
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.