# 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:

1. la inició esa misma persona, para esa empresa;
2. es admin de la empresa en ZPX Forge;
3. 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 |
