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.
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 PDFDé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.
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, branchemain, avec le responsable GitHubresponsable-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.
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.