feat(seguridad): rutas admin bajo prefijo configurable obligatorio
deploy-branch / deploy (push) Failing after 3m7s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m17s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m10s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped

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)
This commit is contained in:
2026-10-02 21:57:02 +02:00
parent 49e965b248
commit 85a054d886
12 changed files with 743 additions and 43 deletions
+20
View File
@@ -0,0 +1,20 @@
# Configuración de LocalESP — copia este fichero a `.env` y rellena los valores.
# cp .env.example .env
#
# El servidor carga `.env` automáticamente al arrancar (no sobrescribe
# variables ya presentes en el entorno) y Vite lo lee en dev y build.
# Prefijo bajo el que se sirven las rutas de administración (OBLIGATORIO,
# sin valor por defecto: servidor y build fallan si no está configurada).
#
# - Es la ÚNICA variable: servidor (`node server/index.js`), proxy de
# desarrollo (`npm run dev`) y frontend (`npm run build`) leen esta misma.
# - Empieza por "/" y no lo publiques: es lo que oculta /admin de la
# enumeración de rutas. Usa algo difícil de adivinar, p. ej. /gestion-x7k2
# - Las rutas históricas (/api/pendientes, /api/reportes, ...) dejan de
# existir; el panel /admin llama a `$LOCALESP_ADMIN_PREFIX/...`
LOCALESP_ADMIN_PREFIX=
# Opcional: ruta de la base de datos SQLite (por defecto localesp.db del
# repo; en pruebas se usa ":memory:").
# LOCALESP_DB=