---
title: "Administration"
weight: 70
description: "Gérer les comptes, les projets, les membres et les versions."
---

# 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](screenshots/admin-utilisateurs.webp)

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](screenshots/admin-projets.webp)

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](screenshots/admin-projet-formulaire.webp)

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](screenshots/admin-membres.webp)

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](/captests/roles-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](screenshots/admin-versions.webp)

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.
