---
title: Les concepts clés
description: Organisation, projet, dépôt, issue, exécution, audit, PR brouillon et politique du dépôt, avec un exemple fil rouge.
---

# Les concepts clés

Cette page présente les objets que vous manipulez dans 101Maintain et la façon dont ils s'emboîtent. Les définitions complètes sont dans le [glossaire](08-glossaire.md).

**Qui peut le faire :** lecture libre pour tous les rôles.

## Les objets et leurs relations

```text
Organisation (l'entreprise qui exploite l'instance)
├── Comptes (Administrateur, ou compte sans droit projet tant qu'aucun rôle n'est attribué)
└── Projets
    ├── Membres du projet (Responsable, Opérateur, Lecteur)
    └── Dépôts (organisation/dépôt sur GitHub)
        ├── Politique du dépôt (surveillance, plafonds, publication)
        ├── Issues
        │   └── Exécutions (tentatives) -> cinq agents -> PR brouillon
        └── Audits
            └── Constats -> qualification -> issue GitHub ou rapport PDF
```

## Définitions courtes

- **Organisation.** L'entreprise qui exploite l'instance. Elle réunit les comptes et les projets.
- **Projet.** Un ensemble de dépôts maintenus pour un produit ou un client. Ce n'est pas un GitHub Project.
- **Dépôt.** Un dépôt GitHub rattaché à un projet, nommé `organisation/dépôt`. Un dépôt appartient à un seul projet.
- **Responsable GitHub.** Le login GitHub de la personne à prévenir avant toute écriture sur le dépôt et à qui la revue est demandée. Il se distingue du rôle **Responsable**, qui est un droit dans la plateforme.
- **Issue.** Une issue GitHub du dépôt. La plateforme en garde une trace quand le dépôt est surveillé.
- **Exécution.** Un traitement de maintenance d'une issue. Une reprise liée à la même issue est une **tentative** de plus dans l'historique.
- **Agents.** Les étapes d'une exécution : Exploration, Analyse, Conception, Développement, Revue.
- **PR brouillon.** Une pull request ouverte en brouillon par 101Maintain. La décision de la fusionner appartient à l'équipe du dépôt.
- **Audit.** Un contrôle en lecture seule d'un dépôt. Chaque résultat est un **constat**, que vous qualifiez.
- **Politique du dépôt.** Les réglages d'un dépôt : surveillance des nouvelles issues, plafonds, brouillon précoce, publication, reprise automatique, origine de recette. Voir [Surveillance et politique du dépôt](../02-projets-et-depots/05-surveillance-et-politique.md).

## Exemple fil rouge

Tout au long de cette documentation, nous suivons une équipe fictive.

- L'entreprise **Atelier Exemple** exploite l'instance sur `maintenance.maintain.example`.
- L'Administrateur crée le projet **Site vitrine**, identifiant court `site-vitrine`.
- Il rattache le dépôt `atelier-exemple/site-vitrine`, branche `main`, avec le responsable GitHub `responsable-demo`.
- Camille est **Responsable** du projet. Dominique en est **Opérateur**. Alex en est **Lecteur**.
- Une issue « Le bouton Contact ne répond pas » s'ouvre sur le dépôt. Une exécution démarre, les agents préparent un correctif, et une PR brouillon apparaît pour relecture.

> [!NOTE]
> Les noms, logins et adresses de cet exemple sont fictifs. Remplacez-les par les vôtres.

## Pourquoi un projet avant tout

La plateforme s'organise par projet. Vos droits sont attribués projet par projet, et toute action indique le projet et le dépôt concernés. Un projet auquel vous n'avez pas accès n'apparaît pas dans vos listes. Ouvrir son adresse directement affiche « Projet ou dépôt introuvable. »

## Pour continuer

Voyez qui peut faire quoi dans [Rôles et droits](03-roles-et-droits.md).
