Plataforma.md
GitHub
ZPX Forge se conecta a GitHub con una GitHub App que cada empresa instala en su cuenta u organización, eligiendo qué repos puede ver.
Instalación verificada
Al volver de GitHub, la instalación solo se vincula si:
- la inició esa misma persona, para esa empresa;
- es admin de la empresa en ZPX Forge;
- controla la cuenta de GitHub: es la suya o es admin de la organización.
Una instalación pertenece a una sola empresa.
Permisos que pide la app
| Permiso | Para qué |
|---|---|
| Contents · lectura y escritura | Leer specs/; proponer specs con pull requests |
| Pull requests · lectura y escritura | Seguir y abrir PRs |
| Checks y statuses · lectura y escritura | Consultar o publicar checks según la configuración |
| Deployments · escritura | Autorizar o rechazar el commit en el entorno de producción protegido con Forge Pro |
| Actions · lectura | Ver ejecuciones de CI |
| Administration · lectura y escritura | Proteger main y develop (opcional) |
| Members · lectura | Relacionar miembros de la organización |
Protección de ramas
Desde un proyecto, Proteger develop y main crea en el repo un ruleset
ZPX Forge · ramas protegidas: cambios solo por pull request, sin borrado ni force-push. Si ya existe,
lo actualiza.
Webhooks y actividad
Cada entrega se verifica con su firma (X-Hub-Signature-256), se guarda una sola vez aunque GitHub la
reintente y se procesa en segundo plano. Se convierte en actividad del proyecto:
| Evento de GitHub | Actividad |
|---|---|
push | push (marca si cambió specs/) |
pull_request | pr.opened, pr.merged, pr.closed, pr.reopened |
check_suite fallido | check.failed |
workflow_run fallido | ci.failed |
installation, installation_repositories | Sincroniza instalaciones y repos |