sinp-aura-tickets

Ce dépôt sert à rassembler et organiser les tickets concernant l'infrastructure informatique et l'installation de GeoNature pour le SINP AURA.
Nous utiliserons pour cela le système de tickets de ce dépot ainsi qu'un Projet Sinp-Aura-Suivi Github.

Procédure

Comment saisir un nouveau ticket ?

1. S'identifiez sur Github
2. Rendez-vous sur la page de gestion des tickets de ce dépôt Github et ouvrez un nouveau ticket (bouton "New issue").
3. Saisissez un titre court ("Title") et représentatif du problème
4. Saisissez une description plus détaillée sous l'onget "Write". Et agrémentez ce texte de copie d'écran en glissant/déposant vos fichiers dans le même espace.
5. Dans la colonne de droite, sélectionnez un label de type outils préfixé par o: pour localiser votre problème.
6. Sélectionner éventuellement d'autres labels.
7. Valider l'ajout de votre ticket avec le bouton "Submit new issue".

Comment surveillez les nouveaux tickets ?

1. S'identifiez sur Github
2. Se rendre sur le dépôt cbn-alpin/sinp-aura-tickets
3. Cliquer sur le bouton "Watch" en haut à droite de la page.

Gestion des labels

Nous utiliserons les labels suivant :

• Type
• Outils
• Status
• Priorite
• Effort
• Audience
• Info

Il est possible de consulter le nombre de tickets associé à chaque label sur la page dédiée. Cette page permet aussi d'accèder aux tickets liés à chaque label.

Type [t] (#bfe5bf)

Permet d'indiquer le type de ticket. Les labels disponibles sont :

• t:bug : correction d'un mauvais fonctionnement nécessitant du développement.
• t:fonctionnalite : ajout d'une nouvelle fonctionnalité nécessitant du développement.
• t:amelioration : modification d'une fonctionnalité existante nécessitant du développement.
• t:tache : modification/amélioration/travail ne nécéssitant aucun développement (paramètrages, rédaction, ...).
• t:idee : une idée d'amélioration ou de fonctionnalité nécessitant des discussions avant change de type (=> t:fonctionnalite ou t:amelioration)
• t:question : une question en lien avec le projet nécessitant des explications détaillées.
• t:support : besoin d'aide pour résoudre un problème.

Outils [o] (#c7def8)

Permet d'indiquer le principal outil concerné par le ticket :

• o:atlas : l'application Atlas de GeoNature (https://atlas.biodiversite-aura.fr)
• o:cms : le CMS Wordpress (http://biodiversite-aura.fr)
• o:geonature : l'application GeoNature dans son ensemble (https://geonature.biodiversite-aura.fr).
  • o:gn:accueil : le module "Accueil" de GeoNature.
  • o:gn:admin : le module "Admin" de GeoNature dans son ensemble ou la page d'accueil du module.
  • o:gn:admin:demandes : le module "Gestion des demandes" d'accès aux données précises de GeoNature accessible depuis la page d'accueil du module "Admin".
  • o:gn:admin:permissions : le module "Gestion des permissions" de GeoNature accessible depuis la page d'accueil du module "Admin".
  • o:gn:dashboard : le module "Dashboard" de GeoNature (module optionnel).
  • o:gn:export : le module "Exports" de GeoNature (module optionnel).
  • o:gn:meta : le module "Métadonnées" de GeoNature
  • o:gn:occtax : le module "OccTax" de GeoNature
  • o:gn:synthese : le module "Synthèse" de GeoNature
  • o:gn:validation : le module "Validation" de GeoNature
• o:taxhub : l'application Taxhub (https://taxhub.biodiversite-aura.fr)
• o:usershub : l'application Usershub (https://usershub.biodiversite-aura.fr)

Status [s]

Permet d'indiquer l'état d'un ticket à un moment donné. Les labels disponibles sont :

• s:complement : le ticket nécessite un complément d'information pour être traité.
• s:discussion : le ticket nécessite un choix qui doit être discuté.

Priorité [p] (#f7c6c7)

Permet d'indiquer l'importance d'un ticket vis à vis des autres et donc l'ordre de traitement. Les labels disponibles sont :

• p:bloquant (#e11d21): le problème décrit dans le ticket bloque le fonctionnement normal du système.
• p:haut
• p:normal
• p:bas

Effort [e] (#d4c5f9)

Permet d'indiquer le temps nécessaire pour fermer le ticket. Une note de 1 (faible) à 3 (important). Les labels disponibles sont :

• e:1 : demande une effort faible.
• e:2 : demande une effort moyen.
• e:3 : demande une effort important.

Audience [a]

Permet d'ajouter des informations concernant le type d'utilisateur concerné par le ticket.
Non utilisé pour l'instant.

Info [i]

Permet d'ajouter des informations complémentaires au ticket.
Non utilisé pour l'instant.

Gestion des Milestones

Nous utiliserons 3 types de millestones ouvertes au maximum en parallèles :

• En cours : ce qui est en cours de traitement. Lorsque une mise en production a lieu, les tickets fermés de cette millestone viennent alimenter une nouvelle milestone dont le nom est par exemple v1 - 2021-03-25. La milestone nommé avec un numéro de version et une date sera fermé.
• Prochainement : cette millestones ne sera jamais fermée. Elle contient tous les tickets à traiter utlérieurement dont les développements ont été programmés/planifiés. Lorsqu'une mise en production a lieu certains tickets qu'elle héberge peuvent être transféré dans la milestone "En cours...".
• Non traités : cette millestones ne sera jamais fermée. Elle contient tous les tickets de type idée ou qui n'ont pas vocation a être traité.

Notes

Les milestones "En cours" et "Prochainement" font doublon avec les colonnes "In progress" et "Backlog" du projet. Nous allons voir à l'utilisation ce qui est le plus pratique.
Finalement les milestones "En cours" et "Prochainement" permettent de planifier sur le moyen/long terme les tickets à traiter alors que les colonnes In progress" et "Backlog" du projet servent aux developpeurs pour s'organiser sur une session de développement (~sprint).

Le label "s:en-cours" fait doublon avec la colonne "En cours" du projet lié. L'utilisation de la colonne dans le projet semble plus pratique pour gérer ce status de ticket. Nous n'utiliserons pas ce label.

Sources

How to manage a project using Github