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

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:

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.

S
Description
No description provided
Readme
3.7 MiB
Languages
JavaScript 94.1%
Shell 4.7%
HTML 1.2%