Aller au contenu principal

Plane

Plane est un outil de suivi des tickets auto-hébergé et open source (Apache 2.0). Il suit le même modèle clé de projet + numéro de ticket que Jira et Linear (par ex. WORK-123). La grande différence avec les solutions hébergées : il tourne dans votre propre infrastructure, sans sous-traitant tiers pour les métadonnées de commit.

C’est l’association recommandée pour les clients fremforge qui suivent la voie de la souveraineté européenne.

Côté Forgejo : suivi de tickets externe

Paramètres du dépôt → Fonctionnalités → Tickets → Utiliser un système de suivi d’issues externe.

ChampValeur
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]+)

Remplacez plane.example.com, <workspace> et <project-id> par les valeurs de votre déploiement Plane. Les URL de Plane utilisent peekIssue pour afficher le ticket dans un panneau latéral sans quitter la vue de l’espace de travail, ce qui est agréable depuis un lien fremforge.

Si plusieurs projets Plane sont associés à un même dépôt fremforge, configurez le style de ticket au niveau du dépôt plutôt que d’inscrire un identifiant de projet dans l’URL. Le peekIssue=<KEY>-<INDEX> de Plane se résout d’un projet à l’autre tant que la clé est unique dans tout l’espace de travail.

Format de message de commit recommandé

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

WORK-892

L’API REST de Plane prend nativement en charge les mots magiques dans les commentaires de commits liés (configurables au niveau de l’espace de travail ; voir la documentation de Plane, Configuring linked-PR automation). Écrire fixes WORK-892 déclenche l’automatisation de Plane, qui passe le ticket à « Done » quand le webhook entrant arrive avec l’événement de fusion de la pull request.

Côté outil de suivi : webhook entrant (recommandé)

Plane prend nativement en charge les webhooks Forgejo depuis Plane 0.18 (version de mai 2026) :

  1. Espace de travail Plane → Settings → Integrations → Forgejo / Gitea → Connect new repository.
  2. Collez l’URL de votre dépôt fremforge (par ex. https://frem.sh/<your-org>/<your-repo>).
  3. Plane renvoie une URL de webhook et un secret de signature. Dans fremforge : Paramètres du dépôt → Webhooks → Ajouter un webhook → Forgejo → collez les deux.

L’intégration prend en charge :

  • L’affichage des commits et pull requests liés sur chaque ticket Plane.
  • Le passage automatique du ticket à « Done » lors de la fusion d’une pull request contenant des mots magiques (closes WORK-892).
  • La création de branche depuis la vue détaillée d’un ticket Plane (« Create branch in fremforge »), qui envoie un POST à l’API Forgejo de fremforge et crée une branche nommée <key>-<index>/<issue-slug>.

C’est le seul outil de suivi de cette section à offrir une intégration quasi bidirectionnelle sans code de relais à écrire de votre côté, car Plane est ouvert à Forgejo en amont (l’équipe de mainteneurs teste explicitement avec lui).

Conséquences en matière de sous-traitance

Auto-hébergé = aucune empreinte de sous-traitance. Plane tourne dans votre infrastructure ; les métadonnées de commit ne quittent jamais votre périmètre :

  • Aucun avenant au DPA n’est nécessaire au-delà de la position de votre propre déploiement Plane.
  • La souveraineté reste intacte : fremforge et Plane restent tous deux hébergés dans l’UE (ou là où vous les avez déployés).
  • La variante cloud commerciale de Plane (Plane Cloud) est hébergée chez AWS US-east : si vous la choisissez, les conséquences en matière de sous-traitance sont les mêmes que pour Linear. L’édition auto-hébergée est le bon choix pour les charges de travail attentives à la souveraineté.

Ce que cette intégration ne fait pas

  • Les modules, cycles, pages et vues de Plane ne s’affichent que dans Plane ; fremforge reste au niveau du lien vers le ticket. Vous ne verrez pas « cette pull request fait partie du cycle Sprint 14 » dans la vue des pull requests de fremforge.
  • Les liens entre espaces de travail ne sont pas pris en charge : chaque ticket lié doit se trouver dans l’espace de travail pour lequel l’intégration a été configurée.
  • La création de branche depuis un ticket exige que l’autorisation OAuth Plane → fremforge porte le scope write:repository (l’assistant d’intégration le demande ; si vous refusez, l’affichage des commits liés fonctionne toujours, à sens unique).

Pourquoi nous recommandons Plane

Pour les clients attachés à la souveraineté européenne, Plane est l’association naturelle : même modèle de gouvernance que fremforge (auto-hébergé, Apache 2.0, déployable dans l’UE), même posture de sécurité, aucun flux de données vers un tiers. C’est l’intégration la plus fluide de cette section, car l’équipe de Plane développe directement à partir du format des webhooks Forgejo.

Pour les clients déjà sur Jira, Azure Boards ou Linear : gardez ce que vous avez ; la primitive de suivi externe de fremforge fonctionne très bien avec chacun d’eux. Plane convient mieux aux nouveaux projets.

TrelloServiceNow