# 101Maintain > 101Maintain est une plateforme de maintenance assistée de dépôts GitHub. Des agents IA analysent les issues et préparent des correctifs proposés en PR brouillon ; la plateforme réalise aussi des audits de dépôt en lecture seule, produit des rapports PDF et comptabilise chaque appel au modèle. L'équipe du dépôt garde la décision de fusion. Cette documentation, en français, s'adresse aux utilisateurs de la plateforme (Administrateur, Responsable, Opérateur, Lecteur), aux intégrateurs de l'API et aux exploitants. Points clés pour un agent : - L'API externe v1 (`/api/v1`) s'authentifie par clé personnelle dans `Authorization: Bearer 101m_.`. Les droits effectifs sont l'intersection des scopes de la clé, du projet de la clé et du rôle actuel de son propriétaire. - Contrat OpenAPI 3.1 complet : `/openapi.json` et `/openapi.yaml` sur ce site. Chaque opération porte `operationId`, `x-required-scope` et souvent `x-agent-hints`. - Les créations (`POST …/runs`, `POST …/audits`) sont asynchrones (202 + `Location`) et exigent un en-tête `Idempotency-Key`. - Quota : 120 requêtes par minute au plus, par clé et par projet ; 429 avec `Retry-After`. - L'API ne permet ni qualification, ni publication, ni administration : ces actions sont réservées aux personnes dans l'interface. - Chaque page HTML a sa source Markdown à la même adresse avec l'extension `.md`. ## Prise en main - [Présentation de 101Maintain](https://doc.101maintain.102.lu/01-prise-en-main/01-presentation.md): Ce que fait la plateforme de maintenance assistée, ce qu'elle ne fait jamais et à qui elle s'adresse. - [Les concepts clés](https://doc.101maintain.102.lu/01-prise-en-main/02-concepts.md): Organisation, projet, dépôt, issue, exécution, audit, PR brouillon et politique du dépôt, avec un exemple fil rouge. - [Rôles et droits](https://doc.101maintain.102.lu/01-prise-en-main/03-roles-et-droits.md): Les rôles Administrateur, Responsable, Opérateur et Lecteur, et le tableau de ce que chacun peut faire. - [Première connexion](https://doc.101maintain.102.lu/01-prise-en-main/04-premiere-connexion.md): Accepter l'invitation, choisir un mot de passe et se connecter en deux étapes avec le code de sécurité. - [Session et vérification récente](https://doc.101maintain.102.lu/01-prise-en-main/05-session-et-verification-recente.md): Durées de session, moment où la vérification récente est demandée et limites des codes de sécurité. - [Naviguer dans la plateforme](https://doc.101maintain.102.lu/01-prise-en-main/06-naviguer-dans-la-plateforme.md): La barre du compte, la barre Espace projet et la barre Supervision, et où trouver chaque fonction. - [Premiers pas selon votre rôle](https://doc.101maintain.102.lu/01-prise-en-main/07-premiers-pas-par-role.md): Une liste d'étapes courte pour chaque rôle, avec les renvois vers les chapitres utiles. - [Glossaire](https://doc.101maintain.102.lu/01-prise-en-main/08-glossaire.md): Les termes employés dans la plateforme et dans cette documentation, avec leur définition et les formulations à éviter. ## Projets et dépôts - [Portefeuille et création d'un projet](https://doc.101maintain.102.lu/02-projets-et-depots/01-portefeuille-et-creation-de-projet.md): La liste Projets, l'état vide, la pagination et la création d'un projet par un Administrateur. - [L'espace projet](https://doc.101maintain.102.lu/02-projets-et-depots/02-espace-projet.md): La page d'un projet, la barre Espace projet, la liste des dépôts et ce que voit chaque rôle. - [Rattacher un dépôt](https://doc.101maintain.102.lu/02-projets-et-depots/03-rattacher-un-depot.md): Déclarer un dépôt GitHub dans un projet, le choisir dans la liste de la GitHub App et l'autoriser à travailler. - [Lier le dépôt à la GitHub App](https://doc.101maintain.102.lu/02-projets-et-depots/04-liaison-github-app.md): Vérifier et rattacher l'installation de la GitHub App, comprendre les statuts et utiliser le repli par identifiants. - [Surveillance et politique du dépôt](https://doc.101maintain.102.lu/02-projets-et-depots/05-surveillance-et-politique.md): La carte Paramètres de maintenance champ par champ, avec ses bornes, les conflits de version et la vérification récente. - [Responsable GitHub et notification avant publication](https://doc.101maintain.102.lu/02-projets-et-depots/06-responsable-github-et-notification.md): Désigner le responsable GitHub d'un dépôt et choisir le canal qui le prévient avant toute écriture sur GitHub. - [Membres et rôles du projet](https://doc.101maintain.102.lu/02-projets-et-depots/07-membres-et-roles-du-projet.md): Attribuer, changer et retirer un rôle de projet, comptes inactifs et limite d'affichage. - [Réception des issues GitHub](https://doc.101maintain.102.lu/02-projets-et-depots/08-reception-des-issues.md): Ce qui se passe quand une issue s'ouvre, se modifie, se ferme ou se rouvre, et les cas où rien ne démarre. - [Arrêter ou corriger un dépôt](https://doc.101maintain.102.lu/02-projets-et-depots/09-arreter-corriger-un-depot.md): Arrêter un dépôt, corriger son nom avant liaison, suivre un renommage GitHub et réagir à un accès retiré. ## Maintenance assistée - [Vue d'ensemble de la maintenance](https://doc.101maintain.102.lu/03-maintenance-assistee/01-vue-d-ensemble.md): Le cycle d'une issue GitHub jusqu'à la PR brouillon, et ce que 101Maintain ne fait jamais. - [Issues et exécutions](https://doc.101maintain.102.lu/03-maintenance-assistee/02-issues-et-executions.md): Retrouver les issues d'un projet, filtrer la liste et lire l'historique des tentatives d'une issue. - [Demander une exécution](https://doc.101maintain.102.lu/03-maintenance-assistee/03-demander-une-execution.md): Démarrer le traitement d'une issue automatiquement par la surveillance ou manuellement avec le bouton Demander une exécution. - [Les cinq agents](https://doc.101maintain.102.lu/03-maintenance-assistee/04-les-cinq-agents.md): Le rôle des agents Exploration, Analyse, Conception, Développement et Revue, et la lecture de l'onglet Agents et besoin. - [Répondre aux questions](https://doc.101maintain.102.lu/03-maintenance-assistee/05-repondre-aux-questions.md): Débloquer une exécution en état Précisions requises depuis la plateforme ou par la commande /answer sur la PR brouillon. - [Relancer, annuler, archiver](https://doc.101maintain.102.lu/03-maintenance-assistee/06-relancer-annuler-archiver.md): Reprendre une exécution à partir d'un agent, refaire le code d'une PR, annuler une exécution en cours et ranger l'historique. - [Lire le diff](https://doc.101maintain.102.lu/03-maintenance-assistee/07-lire-le-diff.md): Comparer le correctif proposé au fichier d'origine dans l'onglet Diff, et comprendre la vue de repli. - [Notification avant publication (effet)](https://doc.101maintain.102.lu/03-maintenance-assistee/08-notification-avant-publication.md): Comment la notification préalable conditionne chaque écriture sur GitHub, et comment lire ses états dans l'onglet Suivi. - [PR brouillon et suivi](https://doc.101maintain.102.lu/03-maintenance-assistee/09-pr-brouillon-et-suivi.md): Comment 101Maintain ouvre la PR brouillon, demande la revue, suit la CI et reprend le travail après une demande de modifications. - [États et erreurs](https://doc.101maintain.102.lu/03-maintenance-assistee/10-etats-et-erreurs.md): Référence des badges d'une exécution, des motifs d'interruption et des messages de refus, avec la conduite à tenir. ## Audits et banc d'essai - [Vue d'ensemble des audits](https://doc.101maintain.102.lu/04-audits-et-banc-d-essai/01-vue-d-ensemble-des-audits.md): Ce que contrôle un audit de dépôt, en lecture seule et sans IA, et ce qui n'est jamais conservé. - [Prérequis et lancement](https://doc.101maintain.102.lu/04-audits-et-banc-d-essai/02-prerequis-et-lancement.md): Préparer un dépôt pour l'audit, lancer l'audit depuis la page Audits et comprendre les refus de lancement. - [Lire un audit](https://doc.101maintain.102.lu/04-audits-et-banc-d-essai/03-lire-un-audit.md): Comprendre le dossier d'un audit, la couverture de chaque contrôle, les sévérités et les durées. - [Qualifier les constats](https://doc.101maintain.102.lu/04-audits-et-banc-d-essai/04-qualifier-les-constats.md): Valider ou rejeter chaque constat d'un audit pour ouvrir le rapport final. - [Ouvrir une issue depuis un constat](https://doc.101maintain.102.lu/04-audits-et-banc-d-essai/05-ouvrir-une-issue-depuis-un-constat.md): Transformer un constat statique validé en issue GitHub, avec confirmation explicite pour un dépôt public ou interne. - [Accord de recette](https://doc.101maintain.102.lu/04-audits-et-banc-d-essai/06-accord-de-recette.md): Enregistrer, vérifier et retirer l'autorisation écrite du client qui permet les contrôles dynamiques sur son environnement de recette. - [Contrôles dynamiques](https://doc.101maintain.102.lu/04-audits-et-banc-d-essai/07-controles-dynamiques.md): Ajouter l'analyse axe des pages rendues ou le balayage actif ZAP à un audit, avec budget de requêtes et garde-fous. - [Banc d'essai (benchmark)](https://doc.101maintain.102.lu/04-audits-et-banc-d-essai/08-banc-d-essai.md): Évaluer et comparer des modèles sur le témoin synthétique mini-boutique, en simulation ou en mesure réelle. ## Rapports, usage et coûts - [Rapports PDF](https://doc.101maintain.102.lu/05-rapports-usage-et-couts/01-rapports-pdf.md): Générer, suivre et télécharger le rapport d'incident d'une exécution et le rapport final d'un audit au format PDF. - [Contenu des rapports](https://doc.101maintain.102.lu/05-rapports-usage-et-couts/02-contenu-des-rapports.md): Ce que contiennent le rapport d'incident et le rapport final d'audit, et ce qu'ils excluent toujours. - [Comprendre la consommation](https://doc.101maintain.102.lu/05-rapports-usage-et-couts/03-comprendre-la-consommation.md): Les états d'un appel au modèle, la différence entre usage inconnu, consommation nulle et reprise réutilisée, et le calcul des coûts. - [Budgets et plafonds](https://doc.101maintain.102.lu/05-rapports-usage-et-couts/04-budgets-et-plafonds.md): Le plafond par exécution, le budget de l'issue et de ses reprises, le seuil d'alerte de 80 % et le blocage sur usage inconnu. - [Page Consommation et export CSV](https://doc.101maintain.102.lu/05-rapports-usage-et-couts/05-page-consommation-et-export-csv.md): Consulter la consommation d'un projet ou de toute l'organisation, la filtrer, la regrouper et l'exporter en CSV. ## Administration et supervision - [Comptes et invitations](https://doc.101maintain.102.lu/06-administration-et-supervision/01-comptes-et-invitations.md): Inviter un collaborateur, lire l'état des comptes de l'organisation, suspendre ou supprimer un compte. - [Sécurité du compte](https://doc.101maintain.102.lu/06-administration-et-supervision/02-securite-du-compte.md): Changer son mot de passe ou son adresse e-mail, et comprendre pourquoi ces changements révoquent sessions et clés API. - [Sessions](https://doc.101maintain.102.lu/06-administration-et-supervision/03-sessions.md): Voir ses sessions ouvertes, connaître leurs durées, révoquer une session ou se déconnecter partout. - [Accès perdu et récupération](https://doc.101maintain.102.lu/06-administration-et-supervision/04-acces-perdu-et-recuperation.md): Retrouver l'accès après un mot de passe oublié, ou après la perte de sa boîte e-mail avec une récupération nominative. - [File de travail](https://doc.101maintain.102.lu/06-administration-et-supervision/05-file-de-travail.md): Suivre les tentatives de maintenance de tous vos projets, repérer celles à examiner et arrêter une tentative. - [Journal des actions](https://doc.101maintain.102.lu/06-administration-et-supervision/06-journal-des-actions.md): Retrouver qui a fait quoi, quand et avec quel résultat, suivre une PR de bout en bout et exporter le journal en CSV. - [Inventaire des clés API](https://doc.101maintain.102.lu/06-administration-et-supervision/07-inventaire-des-cles-api.md): Contrôler toutes les clés API personnelles de l'organisation, leur créateur, leurs droits et leur activité, et révoquer une clé. - [Page Exploitation](https://doc.101maintain.102.lu/06-administration-et-supervision/08-page-exploitation.md): Lire les alertes et les indicateurs techniques de l'instance sur la page Exploitation, réservée à l'Administrateur. - [Arrêt global](https://doc.101maintain.102.lu/06-administration-et-supervision/09-arret-global.md): Suspendre d'un seul geste tous les effets automatiques de l'organisation, comprendre ce qui est différé, puis lever l'arrêt. ## Intégration API - [Vue d'ensemble de l'API](https://doc.101maintain.102.lu/07-integration-api/01-vue-d-ensemble.md): Ce que l'API externe de 101Maintain permet de faire avec une clé personnelle, et ce qu'elle ne permet pas. - [Clés API personnelles](https://doc.101maintain.102.lu/07-integration-api/02-cles-api-personnelles.md): Créer, renouveler et révoquer une clé API personnelle depuis l'écran Mes clés API. - [Authentification et scopes](https://doc.101maintain.102.lu/07-integration-api/03-authentification-et-scopes.md): Présenter la clé dans l'en-tête Authorization et comprendre comment l'autorisation effective est calculée à chaque appel. - [Idempotence, pagination et quotas](https://doc.101maintain.102.lu/07-integration-api/04-idempotence-et-quotas.md): Réessayer une création sans doublon avec Idempotency-Key, parcourir les listes avec after et respecter le quota par clé et par projet. - [Erreurs](https://doc.101maintain.102.lu/07-integration-api/05-erreurs.md): Codes HTTP, codes d'erreur stables et conduite à tenir pour chaque refus de l'API. - [Recettes d'intégration](https://doc.101maintain.102.lu/07-integration-api/06-recettes.md): Exemples complets avec curl, fetch, Python et GitHub Actions pour demander et suivre exécutions, audits, rapports et consommation. - [Ressources pour agents IA](https://doc.101maintain.102.lu/07-integration-api/07-agent-ia.md): Adresses web stables du site de documentation (OpenAPI, llms.txt, sources Markdown, plan du site) et bonnes pratiques pour confier l'API à un agent IA. - [Référence de l'API](https://doc.101maintain.102.lu/07-integration-api/reference-api.md): Toutes les opérations de 101Maintain API 1.0.0, générées depuis le contrat OpenAPI 3.1.0. ## Déploiement et exploitation - [Architecture et processus](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/01-architecture-et-processus.md): Les services de l'instance (web, worker, release, PostgreSQL, Redis), les profils optionnels, les réseaux et le rôle du worker. - [Variables d'environnement](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/02-variables-d-environnement.md): Toutes les variables du Compose de l'instance, regroupées par famille, avec leur rôle, leur valeur par défaut et leur caractère secret. - [Déployer sur Coolify](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/03-deployer-sur-coolify.md): Créer la ressource Coolify de l'instance pas à pas, du dépôt aux contrôles après le premier déploiement, et publier le site de documentation. - [Premier administrateur et récupération](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/04-premier-administrateur-et-recuperation.md): Créer une seule fois le premier Administrateur avec identity:bootstrap, puis récupérer un compte dont la boîte e-mail est perdue avec identity:recover. - [Messagerie et codes de sécurité](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/05-messagerie-et-codes.md): Configurer l'envoi des e-mails (SMTP ou Resend) et la clé des codes de sécurité, comprendre le résultat d'envoi inconnu et l'absence de repli. - [GitHub App et interrupteurs](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/06-github-app-et-fonctionnalites.md): Préparer la GitHub App (webhook, permissions), activer chaque fonction par sa variable et mettre en place les profils scanner et benchmark. - [Santé, métriques et alertes](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/07-sante-metriques-et-alertes.md): Les sondes /healthz et /readyz, les métriques internes protégées, les sept alertes, leurs canaux et la démarche de diagnostic. - [Sauvegarde et restauration](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/08-sauvegarde-et-restauration.md): Sauvegarder la base, le stockage privé et la configuration avec backup.sh, puis restaurer sur une pile neuve avec restore.sh. - [Mises à jour et retour arrière](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/09-mises-a-jour-et-retour-arriere.md): Séquence d'un déploiement, règle des migrations additives, retour à la version précédente et critères GO ou NO-GO. - [Rétention du journal et rôles PostgreSQL](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/10-retention-et-roles-postgresql.md): Exporter puis purger les entrées anciennes du journal des actions, et comprendre les trois rôles PostgreSQL de l'instance. - [Migrer depuis le POC](https://doc.101maintain.102.lu/08-deploiement-et-exploitation/11-migrer-depuis-le-poc.md): Importer les données d'une installation POC (SQLite) dans l'instance avec legacy:import, de la vérification préalable au retour arrière, puis basculer. ## Exemples de mise en place - [Installer une instance de zéro](https://doc.101maintain.102.lu/09-exemples-de-mise-en-place/01-installer-une-instance-de-zero.md): Scénario complet, d'un serveur Coolify vide au premier Administrateur connecté, avec /readyz au vert. - [Embarquer une équipe sur un projet](https://doc.101maintain.102.lu/09-exemples-de-mise-en-place/02-embarquer-une-equipe-sur-un-projet.md): Scénario complet pour inviter trois personnes, créer un projet, rattacher son dépôt, attribuer les rôles et activer la surveillance. - [De l'issue à la PR brouillon](https://doc.101maintain.102.lu/09-exemples-de-mise-en-place/03-de-l-issue-a-la-pr-brouillon.md): Scénario complet, d'une issue « l'image ne démarre pas » jusqu'à la PR brouillon relue par l'équipe et au coût visible dans Consommation. - [Audit avant livraison client](https://doc.101maintain.102.lu/09-exemples-de-mise-en-place/04-audit-avant-livraison-client.md): Scénario complet pour auditer un dépôt avant livraison, qualifier les constats, ouvrir une issue sur un constat de dépendance et remettre le rapport final PDF. - [Piloter depuis un outil externe](https://doc.101maintain.102.lu/09-exemples-de-mise-en-place/05-piloter-depuis-un-outil-externe.md): Scénario complet avec une clé API à droits restreints, une demande d'exécution idempotente par curl, son suivi, l'export de consommation et la mise en attente pendant un arrêt global. ## Ressources pour agents - [Contrat OpenAPI 3.1 (JSON)](https://doc.101maintain.102.lu/openapi.json): 101Maintain API 1.0.0, toutes les opérations, schémas et extensions x-required-scope, x-agent-hints, x-not-exposed - [Contrat OpenAPI 3.1 (YAML)](https://doc.101maintain.102.lu/openapi.yaml): même contrat au format YAML - [Documentation complète](https://doc.101maintain.102.lu/llms-full.txt): toutes les pages Markdown concaténées - [Plan du site](https://doc.101maintain.102.lu/sitemap.xml): toutes les pages HTML ## Optional - [Accueil](https://doc.101maintain.102.lu/index.md): Guide d'utilisation, d'intégration et d'exploitation de la plateforme 101Maintain, avec exemples de mise en place.