Naar de hoofdinhoud

Plane

Plane is een zelf gehoste opensource-issuetracker (Apache 2.0). Hetzelfde model met projectsleutel en issuenummer als Jira en Linear (bijv. WORK-123). Het grote verschil met de gehoste alternatieven: het draait in je eigen infrastructuur, dus er is geen externe subverwerker voor commitmetadata.

Dit is de aanbevolen combinatie voor fremforge-klanten die voor EU-soevereiniteit kiezen.

Forgejo-kant: externe issuetracker

Repository-instellingen → Onderdelen → Issues → Gebruik externe issue tracker.

VeldWaarde
External issue tracker URLhttps://plane.example.com/<workspace>/projects/<project-id>/issues?peekIssue={user}-{index}
External issue tracker URL formathttps://plane.example.com/<workspace>/projects/<project-id>/issues?peekIssue={user}-{index}
External issue tracker number formatRegexp
External issue tracker number format regexp([A-Z][A-Z0-9]+)-([0-9]+)

Vervang plane.example.com, <workspace> en <project-id> door de waarden van je Plane-installatie. De URL-vorm van Plane gebruikt peekIssue om het issue in een zijpaneel te tonen zonder de workspaceweergave te verlaten; dat werkt prettig vanuit een fremforge-link.

Gebruik je meerdere Plane-projecten voor één fremforge-repository, stel dan de issue style op repositoryniveau in in plaats van een project-ID in de URL vast te leggen. peekIssue=<KEY>-<INDEX> van Plane werkt over projecten heen, zolang de sleutel binnen de hele workspace uniek is.

Aanbevolen formaat voor commitberichten

fix(billing): periodisering reversal on day-30 cancel

WORK-892

De REST API van Plane ondersteunt magic words in opmerkingen bij gekoppelde commits rechtstreeks (in te stellen op workspaceniveau; zie de documentatie van Plane over Configuring linked-PR automation). Met fixes WORK-892 zet de automatisering van Plane het issue op “Done” zodra de inkomende webhook met het event voor een gemergede PR binnenkomt.

Trackerkant: inkomende webhook (aanbevolen)

Plane heeft sinds Plane 0.18 (release van mei 2026) eigen ondersteuning voor Forgejo-webhooks:

  1. Plane-workspace → Settings → Integrations → Forgejo / Gitea → Connect new repository.
  2. Plak de URL van je fremforge-repository (bijv. https://frem.sh/<your-org>/<your-repo>).
  3. Plane geeft een webhook-URL en een ondertekeningssecret terug. In fremforge: Repository-instellingen → Webhooks → Webhook toevoegen → Forgejo → plak beide.

De integratie regelt:

  • Gekoppelde commits en PR’s verschijnen bij elk Plane-issue.
  • Een PR-merge met magic words (closes WORK-892) zet het issue automatisch op “Done”.
  • Een branch aanmaken vanuit de issuedetails in Plane (“Create branch in fremforge”) stuurt een POST naar de Forgejo-API van fremforge en maakt een branch met de naam <key>-<index>/<issue-slug>.

Dit is de enige tracker in deze sectie met een vrijwel tweerichtingsintegratie zonder relaycode aan beheerderszijde, omdat Plane zich upstream goed op Forgejo afstemt (het team van maintainers test er uitdrukkelijk tegen).

Gevolgen voor subverwerkers

Zelf gehost = geen enkele subverwerker. Plane draait in je eigen infrastructuur; commitmetadata verlaat je eigen omgeving nooit:

  • Er is geen DPA-addendum nodig naast de opzet van je eigen Plane-installatie.
  • Het soevereiniteitsverhaal blijft intact: zowel fremforge als Plane blijven in de EU gehost (of waar je ze ook hebt uitgerold).
  • De commerciële cloudvariant van Plane (Plane Cloud) draait op AWS US-east; kies je die, dan zijn de gevolgen voor subverwerkers dezelfde als bij Linear. De zelf gehoste editie is de juiste keuze voor soevereiniteitsgevoelige workloads.

Wat dit niet doet

  • Modules, cycles, pages en views van Plane zijn alleen in Plane zichtbaar; fremforge blijft op het niveau van issuelinks. In de PR-weergave van fremforge zie je dus niet “deze PR hoort bij cycle Sprint 14”.
  • Links tussen workspaces worden niet ondersteund: elk gekoppeld issue moet in de workspace staan waarvoor de integratie is ingericht.
  • Een branch aanmaken vanuit een issue vereist dat de OAuth-toestemming Plane → fremforge de scope write:repository heeft (de wizard van de integratie vraagt hierom; weiger je, dan werken de gekoppelde commits nog steeds in één richting).

Waarom we Plane aanbevelen

Voor klanten die voor EU-soevereiniteit kiezen, past Plane het best bij fremforge: hetzelfde governancemodel (zelf gehost, Apache 2.0, in de EU te draaien), dezelfde beveiligingsopzet en geen gegevensstroom naar derden. De integratie loopt het soepelst van alle trackers in deze sectie, omdat het team van Plane rechtstreeks op de webhookvorm van Forgejo bouwt.

Voor klanten die al Jira, Azure Boards of Linear gebruiken: houd wat je hebt; de externe issuetracker in fremforge werkt prima met al die trackers. Plane past beter bij nieuwe projecten die vanaf nul beginnen.