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
+47 -1
View File
@@ -1,2 +1,48 @@
# LocalESP
Registro colaborativo de negocios españoles
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:
```bash
cp .env.example .env # y rellena LOCALESP_ADMIN_PREFIX
```
- **Servidor:** lee `LOCALESP_ADMIN_PREFIX` del entorno y de `.env` (el
fichero no sobrescribe variables ya presentes).
- **Frontend:** Vite expone `LOCALESP_ADMIN_PREFIX` al código cliente vía
`envPrefix` (`.env` o entorno en dev/build); `npm run build` falla si falta.
- **Desarrollo:** `npm run dev` proxya `/api` y el prefijo admin al backend
en `localhost: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.