Installation et permissions

HeadsUp est une app Atlassian Forge. Elle fonctionne entièrement sur l’infrastructure Atlassian, n’exploite aucun serveur propre et ne définit aucun point de terminaison externe. L’app est conçue pour remplir les critères du programme Runs on Atlassian d’Atlassian ; le badge n’est pas encore attribué.

Installation

L’installation se fait par site Jira Cloud via l’Atlassian Marketplace. Aucune configuration n’est nécessaire ensuite : chaque personne crée ses propres rappels et il n’y a aucun réglage à maintenir à l’échelle du site. Toute modification des permissions demandées exige un nouveau consentement de l’administration lors de la mise à jour.

Portées demandées

Portée	Pourquoi l’app en a besoin
read:jira-work	Lire les tickets, les commentaires et l’historique des modifications pour évaluer les déclencheurs, valider la JQL et charger les listes de statuts des sélecteurs
read:jira-user	Résoudre les noms affichés à partir des identifiants de compte (« assigné à Jane Doe »)
write:jira-work	Envoyer les notifications via l’API notify de Jira (e-mail) et publier les commentaires facultatifs sur le ticket
storage:app	Stocker les rappels, les notifications et les journaux d’audit dans le stockage hébergé de Forge
read:servicedesk-request	Lire les données SLA des demandes JSM ouvertes pour l’alerte anticipée de SLA (édition Advanced)
manage:jira-configuration	Utilisée dans un seul but : lire le nombre d’utilisateurs Jira sous licence, qui détermine le pool mensuel de crédits IA du site.

Sur ce dernier point : le nombre d’utilisateurs sous licence provient des métriques de licence de Jira, et Atlassian place ce domaine derrière cette portée. L’app lit un seul nombre par produit Jira et ne modifie rien. Chaque appel effectué par une app est visible pour l’administration dans le journal d’audit du site.

Commentaires restreints et utilisateur applicatif

HeadsUp fonctionne sous son propre utilisateur applicatif. Ce que cet utilisateur ne voit pas n’atteint pas l’app : un commentaire restreint à un rôle de projet n’est pas distribué à HeadsUp comme événement, un rappel portant dessus ne se déclenche donc pas. C’est le comportement par défaut et il ne demande aucune configuration.

Une personne administratrice du projet peut le changer pour un projet donné. L’utilisateur applicatif figure dans l’administration des rôles sous le nom Marketplace de l’app, HeadsUp: AI Reminders and Notifications for Jira. Ajoutez-le, dans les paramètres du projet, dans la zone consacrée aux personnes et aux rôles, au rôle auquel les commentaires sont restreints. À partir de là, l’événement atteint l’app et le rappel se déclenche.

Le contenu reste masqué dans les deux cas. Même pour un commentaire que l’app voit désormais, la notification, l’entrée de la boîte de réception et le journal d’audit portent la phrase neutre « Il y a un nouveau commentaire à visibilité restreinte. Son contenu n’apparaît pas ici, ouvrez le ticket pour le lire. », aucun commentaire automatique n’est écrit et les rappels IA ignorent le commentaire sans consommer de crédit. Les deux niveaux se complètent : l’appartenance au rôle décide s’il y a déclenchement, la suppression décide de ce qui est affiché.

Les notes internes dans Service Management se comportent autrement. L’app y dispose de la visibilité des agents, leurs événements arrivent donc toujours et seul le second niveau s’applique.

Éditions

	Standard	Advanced
Rappels de tickets, alertes de filtre, boîte de réception	✓	✓
Détection par IA	✓	✓
Crédits IA par utilisateur sous licence et par mois	20	200
Alerte anticipée de SLA (JSM)	✗	✓

L’édition suit automatiquement la licence du Marketplace, il n’y a rien à configurer dans l’app. Repasser d’Advanced à Standard a deux conséquences qu’il vaut mieux anticiper.

• Les alertes SLA existantes restent enregistrées, mais ne se déclenchent plus jamais. Dans l’édition Standard, la vérification horaire des SLA s’arrête immédiatement. Les alertes restent dans la liste et paraissent actives, et il n’est plus possible d’en créer. Une alerte de filtre ne peut pas non plus être basculée sur un autre déclencheur : la voie est donc de la supprimer et, au besoin, d’en créer une nouvelle avec un autre déclencheur. En revenant à Advanced, les alertes existantes se déclenchent de nouveau sans autre intervention.
• La limite de crédits IA est recalculée aussitôt. La limite suit l’édition en cours, tandis que le compteur de consommation du mois en cours reste en place. Un site qui a déjà consommé plus que ce que Standard autorise se retrouve au-dessus de la limite à partir de cet instant, et l’évaluation par l’IA s’arrête jusqu’au 1er du mois suivant. Tout le reste continue de fonctionner.