GitHub Pull Requests#
Spezifikationsknoten mit GitHub Pull Requests verknüpfen — z. B. Requirement → Implementierungs-PR. OakCore spiegelt Titel, Status, Branches und Labels schreibgeschützt und setzt einen Backlink-Kommentar auf dem PR.
Connection-Setup nutzt dieselbe GitHub-Repository-Verbindung wie Issues — keine zweite Connection pro Repo.
Pull Request binden#
- Knoten mit Pull-Request-Binding öffnen.
- Sidebar Info → Bindings → Pull requests.
- Connection wählen, PR-Referenz einfügen.
Erfordert eine GitHub-Repository-Verbindung für das Ziel-Repo.
Akzeptierte Referenzen:
| Format | Beispiel |
|---|---|
| Pull-URL | https://github.com/acme/widgets/pull/7 |
| Nummer | 7 oder #7 |
Issue-URLs (/issues/) werden hier abgelehnt.
Nach dem Verknüpfen:
- Snapshot ziehen.
- Backlink-Kommentar auf dem PR setzen oder aktualisieren (Issue-Comment-API) — ein verwalteter Kommentar pro PR, unabhängig vom Status (offen/geschlossen/merged).
Landing-URL im Backlink:
{oakcore-url}/integration-pull-request?projectId={project_id}&artifactId={artifact_id}
Weitere Knoten: Verknüpfst du denselben PR mit einem weiteren OakCore-Knoten, aktualisiert OakCore denselben Kommentar.
Refresh: Manueller Refresh schreibt den Backlink ebenfalls neu.
Beim Lösen des letzten Knotens entfernt OakCore den Kommentar. Bleiben andere Knoten verknüpft, listet der Kommentar nur noch die verbleibenden Anker.
Hinweis — gesperrte Konversationen: Auf gesperrten Pull Requests können keine neuen Kommentare gesetzt werden. OakCore legt das Binding an und hält den Snapshot, aber der Backlink-Kommentar scheitert, bis die Konversation entsperrt ist. Nach dem Entsperren Refresh ausführen.
Snapshot-Felder#
| Feld | Bedeutung |
|---|---|
state_category |
open, closed, merged |
draft |
Entwurfs-PR |
base_branch / head_branch |
Ziel- und Quell-Branch |
Webhook-Events#
Am GitHub-Webhook Pull requests zusätzlich zu Issues aktivieren (falls beide Familien genutzt werden).
Fehlerbehebung#
| Symptom | Prüfen |
|---|---|
| Bind abgelehnt | Issue- statt Pull-URL; falsches Repo |
| PR-Änderungen fehlen | Webhook-Event Pull requests |
| Kein Backlink | Pull requests → Read and write; Konversation ggf. gesperrt |