deploy-branch / deploy (push) Successful in 2m59s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m30s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m25s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
La ruta fija /admin del enrutador SPA mostraba el panel sin importar el prefijo configurado. Ahora AdminPanel se monta solo cuando el pathname coincide con la raíz de LOCALESP_ADMIN_PREFIX (misma variable única que backend, build y API): con /administrador, el panel queda en /administrador y /admin pasa a mostrar la web pública. - src/main.jsx: enrutado por ADMIN_RUTA derivada del prefijo - README y artefactos openspec (spec/design) actualizados
52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
# 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:
|
|
|
|
```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.
|