---
title: Embarquer une équipe sur un projet
description: Scénario complet pour inviter trois personnes, créer un projet, rattacher son dépôt, attribuer les rôles et activer la surveillance.
---

# Embarquer une équipe sur un projet

Camille, Administrateur d'**Atelier Exemple**, prépare le projet **Site vitrine** et y fait entrer son équipe.

## Objectif

Une équipe de trois personnes travaille sur le projet **Site vitrine**, dont le dépôt `atelier-exemple/site-vitrine` est rattaché, actif et surveillé.

## Rôles nécessaires

| Personne | Rôle visé |
| --- | --- |
| Camille | Administrateur (déjà en place) |
| Morgan | Responsable du projet |
| Dominique | Opérateur |
| Alex | Lecteur |

## Prérequis

- L'instance est installée et la messagerie fonctionne. Voir [Installer une instance de zéro](01-installer-une-instance-de-zero.md).
- La GitHub App de l'instance est installée sur `atelier-exemple/site-vitrine`, et ses identifiants sont configurés par l'exploitant. Voir [GitHub App et interrupteurs](../08-deploiement-et-exploitation/06-github-app-et-fonctionnalites.md).
- Camille a fait une vérification récente : depuis **Sécurité**, **Vérifier à nouveau mon identité**. Elle dure 5 minutes ; Camille la renouvelle au besoin entre les étapes.

## Étapes

### Inviter l'équipe

1. Camille ouvre **Utilisateurs**.
2. Dans **Inviter un collaborateur**, elle saisit **Nom du collaborateur** `Morgan Exemple` et **Adresse e-mail du collaborateur** `morgan@maintain.example`, puis clique sur **Créer l'invitation**.
3. Elle répète pour `dominique@maintain.example` et `alex@maintain.example`.
4. Les trois comptes apparaissent à l'état **Invité**. Chacun reçoit un e-mail, choisit son mot de passe et se connecte. Les comptes passent à **Actif**.

Voir [Comptes et invitations](../06-administration-et-supervision/01-comptes-et-invitations.md).

### Créer le projet

5. Camille ouvre **Projets**. Dans **Créer un projet**, elle saisit **Nom du projet** `Site vitrine` et **Identifiant court** `site-vitrine`, puis clique sur **Créer le projet**.

Voir [Portefeuille et création d'un projet](../02-projets-et-depots/01-portefeuille-et-creation-de-projet.md).

### Rattacher le dépôt

6. Sur la page du projet, dans **Rattacher un dépôt**, elle clique sur **Afficher les dépôts de l'organisation**, cherche `site-vitrine` dans **Rechercher un dépôt** et le choisit. Le nom et la **Branche par défaut** se remplissent.
7. Dans **Identifiant du responsable GitHub**, elle saisit le login `responsable-demo`, sans `@`, ou clique sur **Choisir parmi les membres de l'organisation**.
8. Elle clique sur **Rattacher le dépôt**. Le rattachement à la GitHub App est vérifié dans la foulée.
9. Sur la page du dépôt, dans **Identité et arrêt du dépôt**, elle coche **Autoriser les travaux sur ce dépôt**, puis clique sur **Enregistrer le dépôt**. Un dépôt naît toujours à l'arrêt.

Voir [Rattacher un dépôt](../02-projets-et-depots/03-rattacher-un-depot.md) et [Lier le dépôt à la GitHub App](../02-projets-et-depots/04-liaison-github-app.md).

### Attribuer les rôles

10. Sur la page du projet, carte **Membres du projet**, elle choisit Morgan dans **Compte**, **Responsable** dans **Rôle**, puis clique sur **Attribuer le rôle**.
11. Elle répète avec Dominique en **Opérateur** et Alex en **Lecteur**.

Voir [Membres et rôles du projet](../02-projets-et-depots/07-membres-et-roles-du-projet.md).

### Régler la surveillance

12. Morgan, désormais Responsable, fait une vérification récente, puis ouvre la page du dépôt, carte **Paramètres de maintenance**.
13. Il coche **Surveiller les nouvelles issues**. Il laisse **Nombre maximal d'exécutions** à 1 pour commencer et règle **Nombre maximal de tokens** selon le budget convenu.
14. Il clique sur **Enregistrer les paramètres**.

Voir [Surveillance et politique du dépôt](../02-projets-et-depots/05-surveillance-et-politique.md).

### Préparer la notification avant publication

15. Camille, Administrateur, ouvre la carte **Notification avant publication** du dépôt. Dans **Canal**, elle choisit l'e-mail et, dans **Compte vérifié (pour l'e-mail)**, le compte de Morgan. Elle clique sur **Enregistrer le canal**.

Voir [Responsable GitHub et notification avant publication](../02-projets-et-depots/06-responsable-github-et-notification.md).

## Résultat attendu

| Personne | Ce qu'elle voit |
| --- | --- |
| Morgan | Le projet **Site vitrine**, la carte **Paramètres de maintenance** modifiable, la gestion des membres |
| Dominique | Le projet, le bouton **Demander une exécution** sur les issues, le lancement d'audits |
| Alex | Le projet en lecture seule |

Dans le [journal des actions](../06-administration-et-supervision/06-journal-des-actions.md), filtré sur le projet, figurent la création du projet, le rattachement, les rôles et le changement de politique.

## Si ça bloque

| Symptôme | Cause probable | Voir |
| --- | --- | --- |
| « Authentification complète et récente requise. » | Vérification de plus de 5 minutes | [Session et vérification récente](../01-prise-en-main/05-session-et-verification-recente.md) |
| Aucun dépôt listé | GitHub App absente de l'organisation | [Lier le dépôt à la GitHub App](../02-projets-et-depots/04-liaison-github-app.md) |
| Saisie manuelle du responsable GitHub imposée | Permission **Members** non accordée à l'App | [GitHub App et interrupteurs](../08-deploiement-et-exploitation/06-github-app-et-fonctionnalites.md) |
| Un compte n'apparaît pas dans **Compte** | Compte encore **Invité** | [Comptes et invitations](../06-administration-et-supervision/01-comptes-et-invitations.md) |

## Pour continuer

L'équipe est prête à traiter sa première issue : [De l'issue à la PR brouillon](03-de-l-issue-a-la-pr-brouillon.md).
