Files
localesp/README.md
T
edgar.friendly 695d59d31e
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
ci(deploy): config por entorno en el repo (scripts/entornos.env)
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
2026-10-03 14:56:08 +02:00

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.