Audit avant livraison client
Avant de livrer une nouvelle version du Site vitrine à son client, l'équipe d'Atelier Exemple vérifie le dépôt avec un audit statique et remet un rapport PDF.
Objectif#
Disposer d'un audit qualifié du dépôt, d'une issue GitHub pour le constat à corriger, et d'un rapport final PDF à remettre au client.
Rôles nécessaires#
| Personne | Rôle | Intervient pour |
|---|---|---|
| Dominique | Opérateur | Lancer l'audit, qualifier, générer le PDF |
| Morgan | Responsable | Ouvrir l'issue GitHub |
Prérequis#
- L'exploitant a activé les audits et l'ouverture d'issues :
MVP_REPOSITORY_AUDITS_ENABLED=trueetMVP_AUDIT_ISSUES_ENABLED=true, avec la GitHub App en Contents lecture et Issues écriture. Voir GitHub App et interrupteurs. - Le dépôt
atelier-exemple/site-vitrineest actif (Autoriser les travaux sur ce dépôt) et rattaché (Vérifier et rattacher). - Pour ouvrir une issue, la case Autoriser la proposition de correctifs est cochée dans Paramètres de maintenance.
L'audit statique est en lecture seule et n'utilise aucun modèle IA. Il ne coûte aucun jeton.
Étapes#
Lancer l'audit#
- Dominique ouvre le projet, puis Audits dans la barre Espace projet.
- Dans la carte Audit du dépôt, il choisit
atelier-exemple/site-vitrinedans Dépôt à auditer. Il ne coche aucun contrôle dynamique. - Il clique sur Lancer l'audit. Le dossier d'audit s'ouvre : En file, puis En cours, puis Terminé ou Partiel. Le bouton Actualiser recharge l'état.
Voir Prérequis et lancement et Lire un audit.
Qualifier les constats#
- Dans Constats à examiner, Dominique lit chaque constat. L'audit signale par exemple :
- un Fichier de verrouillage manquant : le projet utilise npm sans fichier de verrouillage versionné ;
- un Secret potentiel dans un fichier d'exemple, qui contient en réalité une valeur fictive.
- Il clique sur Valider pour le fichier de verrouillage manquant, qui est un vrai problème.
- Il vérifie le fichier d'exemple, constate que la valeur est fictive, puis clique sur Rejeter.
- Il répète jusqu'à ce qu'aucun constat ne reste À qualifier.
Voir Qualifier les constats.
Ouvrir une issue sur le constat de dépendance#
- Morgan fait une vérification récente, puis ouvre le dossier d'audit.
- Sur le constat Validé du fichier de verrouillage, il déplie Préparer une issue GitHub et lit l'avertissement.
- Si le dépôt est public ou interne, il coche J'autorise le suivi générique si le dépôt est public ou interne.
- Il clique sur Confirmer l'ouverture. L'état passe de En file à Issue #<numéro>, avec un lien vers GitHub.
Voir Ouvrir une issue depuis un constat.
Produire le rapport final#
- Dans l'en-tête du dossier, Dominique clique sur Ouvrir le rapport final. Le lien n'apparaît qu'une fois tous les constats qualifiés.
- La page présente les Constats validés, sans les constats rejetés.
- Dans la carte Rapport PDF client, il clique sur Générer une édition PDF. L'édition passe de En file à En cours, puis à Prêt.
- Il clique sur Télécharger et remet le PDF au client.
Voir Rapports PDF et Contenu des rapports.
Résultat attendu#
- Un audit Terminé ou Partiel, dont tous les constats sont Validé ou Rejeté.
- Une issue
[Audit]ouverte sur GitHub pour le fichier de verrouillage manquant. Elle ne contient jamais la valeur d'un secret. - Un rapport final PDF attribué à Dominique, sans coût ni consommation.
- Dans le journal des actions, famille Audits : le lancement, les qualifications, l'ouverture d'issue et la génération du rapport.
Si ça bloque#
| Symptôme | Voir |
|---|---|
| Audits désactivés sur cette instance | GitHub App et interrupteurs |
| Dépôt absent de Dépôt à auditer | Prérequis et lancement |
| Lien Ouvrir le rapport final absent | Qualifier les constats |
| Préparer une issue GitHub absent ou refusé | Ouvrir une issue depuis un constat |
Pour un contrôle de la recette en ligne (accessibilité, sécurité), un accord de recette est nécessaire : voir Accord de recette.
Pour continuer#
Pilotez exécutions et audits depuis vos propres outils : Piloter depuis un outil externe.