deploy-branch / deploy (push) Successful in 3m18s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m15s
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 config de prefijo admin pasa del host (/etc/localesp/<slug>.env) al repo, para que viaje con el código que despliega y se revise en PRs: - scripts/entornos.env: mapping <slug>=<prefijo> (prototipo-yb01= /administrador; master y prototipo-yb01-ef como plantilla comentada) - env.sh: servicio Config::admin_prefix lee el mapping; require_config falla con mensaje claro si la rama no tiene entrada; Env::deploy regenera <dest>/.env desde el repo (el servidor lo autocarga) - deploy.yml: el build exporta el prefijo del mapping antes de compilar
56 lines
2.5 KiB
Markdown
56 lines
2.5 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`.
|
|
- **Despliegue CI (entorno por rama):** el prefijo de cada entorno se declara
|
|
en `scripts/entornos.env` (mapping `slug=prefijo`, en el repo): el workflow
|
|
de deploy lo incrusta en el build y `deploy.sh` lo materializa como
|
|
`<dest>/.env`. Sin entrada para la rama, el deploy falla con mensaje claro.
|
|
|
|
> 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.
|