GitHub

Dans LaunchCal, un lancement peut suivre son travail dans GitHub : un projet d'une organisation, ou un jalon d'un dépôt. Son statut change quand celui du projet ou du jalon change, il affiche leur avancement, et les points d'étape d'un projet apparaissent sur le lancement.

Taktoria ne fait que lire dans GitHub : il n'y crée, n'y modifie et n'y commente jamais rien. Il est connecté en tant qu'app installée sur votre organisation plutôt qu'en tant que personne : il ne voit donc que les dépôts choisis par l'organisation, et continue de fonctionner, quelle que soit la personne qui l'a connecté.

Seul un propriétaire ou un administrateur de l'espace de travail peut connecter GitHub.

1. Ouvrez Paramètres → Intégrations.
2. Sous Outils de ticketing, sélectionnez Connecter GitHub.
3. Sur GitHub, installez l'app Taktoria sur l'organisation, choisissez les dépôts qu'elle peut lire, et approuvez.

L'app demande à lire les projets de l'organisation, ainsi que les tickets, les pull requests et les métadonnées de ses dépôts. Si un propriétaire de l'organisation doit d'abord l'approuver, Taktoria vous le signale : sélectionnez à nouveau Connecter GitHub une fois que c'est fait. La carte indique alors à quelle organisation elle est connectée. Chaque espace de travail Taktoria en connecte une.

Toute personne qui peut modifier un lancement peut le lier, le synchroniser ou le dissocier.

1. Ouvrez l'onglet Détails du lancement.
2. Sous Projet de ticketing, collez dans Lien du projet l'adresse du projet de l'organisation, ou du jalon du dépôt.
3. Sélectionnez Lier le projet.

Un projet doit appartenir à l'organisation connectée, et un jalon se trouver dans un dépôt que l'app peut lire. Il se synchronise aussitôt. Un dépôt, ou toute autre chose dans GitHub, est conservé comme simple lien, de même qu'un lien collé avant que GitHub soit connecté, jusqu'à ce qu'il le soit.

Un assistant IA connecté à LaunchCal, ainsi que l'API REST, peuvent aussi lier, synchroniser et dissocier un lancement, selon les mêmes règles.

Un lancement lié est synchronisé une fois par jour jusqu'à son lancement, et chaque fois que quelqu'un sélectionne Synchroniser maintenant.

Pour un projet :

• Statut : c'est le point d'étape le plus récent du projet qui le donne. En bonne voie, à risque ou hors de la bonne voie devient En développement (un lancement déjà en Conception ou en Tests y reste), inactif devient En pause, et achevé le rend terminé. Tant qu'il n'y a aucun point d'étape, le lancement reste en Cadrage jusqu'à ce qu'un des éléments du projet soit terminé. Un projet fermé est terminé, sauf s'il était inactif.
• Avancement : la part de ses éléments fermés, fusionnés ou dans une colonne terminée.
• Points d'étape : chacun devient un point d'étape du lancement dans son onglet Activité, marqué Depuis GitHub avec un lien vers l'original, et la santé du lancement suit le plus récent.

Pour un jalon : ouvert sans aucun ticket fermé, il donne Cadrage ; ouvert avec des tickets fermés, En développement ; et fermé, il est terminé. Son avancement est la part de ses tickets fermés. Un jalon n'a pas de points d'étape.

Quand le projet ou le jalon est terminé, le lancement indique qu'il est prêt et ses responsables sont prévenus. Un statut que vous choisissez dans LaunchCal tient jusqu'à ce que celui de GitHub change de nouveau. Ce qu'une synchronisation modifie est attribué à GitHub, dans l'historique du lancement, dans ce qui est envoyé à ses responsables et dans le journal d'audit.

• Il ne lance jamais rien. Un projet ou un jalon terminé rend le lancement prêt ; quelqu'un doit encore sélectionner Appuyez pour lancer! une fois ses relectures obligatoires décidées.
• Il ne modifie jamais un lancement déjà lancé.
• Il n'écrit jamais dans GitHub.
• Il ne lit jamais un dépôt que l'organisation ne lui a pas donné.

Dissocier, dans l'onglet Détails du lancement, arrête la synchronisation de ce lancement ; ce qui a été importé reste.

Déconnecter, dans Paramètres → Intégrations, arrête la synchronisation de tous les lancements depuis GitHub et met fin immédiatement à l'accès de Taktoria. Les lancements gardent ce qu'ils lient et tout ce qui a été synchronisé jusque-là, et reprennent dès que GitHub est de nouveau connecté. L'app reste installée sur l'organisation jusqu'à ce qu'un de ses propriétaires la désinstalle dans les paramètres de l'organisation sur GitHub.

• Le projet est introuvable : il a été supprimé, ou se trouve là où l'app ne peut pas le voir, comme un dépôt que l'organisation ne lui a pas donné. Un propriétaire de l'organisation peut ajouter le dépôt à l'accès de l'app dans ses paramètres sur GitHub ; sinon, liez son adresse actuelle.
• GitHub a refusé la connexion : l'app a été désinstallée ou suspendue. Un propriétaire ou un administrateur de l'espace de travail reconnecte GitHub dans Paramètres → Intégrations.
• L'app attend une approbation : un propriétaire de l'organisation l'approuve sur GitHub, puis sélectionnez à nouveau Connecter GitHub.
• GitHub n'a pas répondu lors de la dernière synchronisation : la prochaine réessaiera, ou sélectionnez Synchroniser maintenant plus tard.
• Il est conservé comme simple lien : GitHub n'est pas encore connecté, ou l'adresse n'est ni celle d'un projet d'organisation ni celle d'un jalon.