Administration

Cette page s'adresse aux administrateurs. Elle décrit la gestion des comptes utilisateurs et des projets (réservée au super-administrateur), ainsi que la gestion des membres et des versions d'un projet.

Gérer les utilisateurs

Réservé au super-administrateur. Depuis l'en-tête, cliquez sur Utilisateurs. La liste affiche tous les comptes, avec le nom, l'adresse e-mail et l'indication des super-administrateurs.

Liste des utilisateurs de la plate-forme avec le bouton de création

Cliquez sur Nouvel utilisateur pour créer un compte. Renseignez le nom, l'adresse e-mail et un mot de passe (au moins 8 caractères). Cochez Super-administrateur de la plate-forme pour accorder les droits transverses.

Le bouton Modifier d'une ligne permet de changer le nom, l'adresse e-mail, le statut de super-administrateur, et de réinitialiser le mot de passe (laissez le champ vide pour conserver le mot de passe actuel).

Modérer les demandes de compte

Réservé au super-administrateur, et visible seulement si la demande de compte publique a été activée sur la plate-forme (voir INSTALL.md). Dans ce cas, la page de connexion propose un lien Demander un accès : la personne y saisit son nom, son adresse e-mail, éventuellement le projet qui la concerne et le motif de sa demande. Aucun compte n'est créé à cet instant et aucun mot de passe ne lui est demandé.

Vous recevez un e-mail à chaque nouvelle demande. Depuis l'en-tête, cliquez sur Demandes pour les traiter. La page présente les demandes en attente, puis l'historique des demandes déjà traitées avec la décision, la personne qui l'a prise et le motif d'un éventuel refus.

Deux actions sont possibles sur une demande en attente :

Approuver : le compte est créé avec le nom et l'adresse indiqués, et la personne reçoit un e-mail contenant un lien pour choisir son mot de passe. Ce lien est valable une heure ; passé ce délai, elle utilise Mot de passe oublié ? sur la page de connexion pour en recevoir un nouveau.
Refuser : aucun compte n'est créé. Vous pouvez saisir un motif, qui est transmis dans l'e-mail d'information et conservé dans l'historique.

Le projet mentionné par le demandeur n'est qu'une indication : approuver une demande ne rattache la personne à aucun projet. Rendez-vous ensuite dans la page Membres du projet concerné pour lui donner un rôle (voir plus bas).

Gérer les projets

Réservé au super-administrateur. Depuis l'en-tête, cliquez sur Admin projets. La liste affiche tous les projets, avec leur référence, leur libellé, leur préfixe de cas et leur état (Actif ou Archivé).

Liste d'administration des projets avec les références et les actions

Cliquez sur Nouveau projet pour en créer un. Le formulaire comporte :

Référence (slug unique) : un identifiant court et unique, par exemple smartinterventions.
Libellé : le nom affiché du projet.
Préfixe des cas : le préfixe des références de points, par exemple TC-SI. Lettres, chiffres et tirets uniquement. Les cas seront numérotés <préfixe>-001, <préfixe>-002, etc.
URL du dépôt (optionnel) : un lien vers le dépôt de code.
Description : une description libre.
Projet actif : décochez pour archiver le projet.

Formulaire de création d'un projet avec la référence, le préfixe des cas et la description

Le bouton Modifier permet d'ajuster ces informations par la suite.

Gérer les membres d'un projet

Accessible à un administrateur de projet (ou au super-administrateur). Depuis la todolist d'un projet, cliquez sur Membres (ou depuis la liste d'administration des projets).

Page de gestion des membres d'un projet avec le formulaire d'enrôlement et la liste des membres

Pour enrôler un utilisateur, choisissez-le dans la liste, attribuez-lui un rôle (Administrateur, Développeur ou Testeur) et cliquez sur Enrôler. Si l'utilisateur est déjà membre, son rôle est mis à jour.

La liste des membres affiche le nom, l'adresse e-mail et le rôle de chacun. Le bouton Retirer révoque l'accès d'un membre au projet (une confirmation est demandée). Le détail des rôles est décrit dans Rôles et permissions.

Gérer les versions

Accessible à un développeur ou à un administrateur de projet. Depuis la todolist, cliquez sur Versions.

Page de gestion des versions avec le formulaire de création et la liste des versions

Pour créer une version, renseignez :

Numéro : le numéro de version, par exemple 2.0.65.6 (obligatoire et unique pour le projet).
Libellé : un libellé facultatif, par exemple RC1 ou beta.
Date de sortie : la date de mise à disposition, facultative.

Cliquez sur Créer. La nouvelle version apparaît dans la liste et ouvre aussitôt une campagne de recette vierge : tous les points y repassent à "non testé". Les verdicts des versions précédentes restent attachés à leur version.

Attention : l'ordre des versions est déterminé par le numéro de version, comparé composant par composant (par exemple 2.0.65.6 se lit [2, 0, 65, 6]). La date de sortie ne sert qu'à départager deux numéros non comparables. C'est ce numéro, et non la date, qui fonde le calcul de la couverture automatique : saisissez-le avec soin.