---
title: Audit avant livraison client
description: 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.
---

# 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=true` et `MVP_AUDIT_ISSUES_ENABLED=true`, avec la GitHub App en **Contents** lecture et **Issues** écriture. Voir [GitHub App et interrupteurs](../08-deploiement-et-exploitation/06-github-app-et-fonctionnalites.md).
- Le dépôt `atelier-exemple/site-vitrine` est 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

1. Dominique ouvre le projet, puis **Audits** dans la barre **Espace projet**.
2. Dans la carte **Audit du dépôt**, il choisit `atelier-exemple/site-vitrine` dans **Dépôt à auditer**. Il ne coche aucun contrôle dynamique.
3. 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](../04-audits-et-banc-d-essai/02-prerequis-et-lancement.md) et [Lire un audit](../04-audits-et-banc-d-essai/03-lire-un-audit.md).

### Qualifier les constats

4. 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.
5. Il clique sur **Valider** pour le fichier de verrouillage manquant, qui est un vrai problème.
6. Il vérifie le fichier d'exemple, constate que la valeur est fictive, puis clique sur **Rejeter**.
7. Il répète jusqu'à ce qu'aucun constat ne reste **À qualifier**.

Voir [Qualifier les constats](../04-audits-et-banc-d-essai/04-qualifier-les-constats.md).

### Ouvrir une issue sur le constat de dépendance

8. Morgan fait une [vérification récente](../01-prise-en-main/05-session-et-verification-recente.md), puis ouvre le dossier d'audit.
9. Sur le constat **Validé** du fichier de verrouillage, il déplie **Préparer une issue GitHub** et lit l'avertissement.
10. 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.**
11. 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](../04-audits-et-banc-d-essai/05-ouvrir-une-issue-depuis-un-constat.md).

> [!TIP]
> Si le dépôt est surveillé, cette nouvelle issue peut à son tour démarrer une exécution de maintenance, comme dans [De l'issue à la PR brouillon](03-de-l-issue-a-la-pr-brouillon.md).

### Produire le rapport final

12. 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.
13. La page présente les **Constats validés**, sans les constats rejetés.
14. 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**.
15. Il clique sur **Télécharger** et remet le PDF au client.

Voir [Rapports PDF](../05-rapports-usage-et-couts/01-rapports-pdf.md) et [Contenu des rapports](../05-rapports-usage-et-couts/02-contenu-des-rapports.md).

## 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](../06-administration-et-supervision/06-journal-des-actions.md), 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](../08-deploiement-et-exploitation/06-github-app-et-fonctionnalites.md) |
| Dépôt absent de **Dépôt à auditer** | [Prérequis et lancement](../04-audits-et-banc-d-essai/02-prerequis-et-lancement.md) |
| Lien **Ouvrir le rapport final** absent | [Qualifier les constats](../04-audits-et-banc-d-essai/04-qualifier-les-constats.md) |
| **Préparer une issue GitHub** absent ou refusé | [Ouvrir une issue depuis un constat](../04-audits-et-banc-d-essai/05-ouvrir-une-issue-depuis-un-constat.md) |

Pour un contrôle de la recette en ligne (accessibilité, sécurité), un accord de recette est nécessaire : voir [Accord de recette](../04-audits-et-banc-d-essai/06-accord-de-recette.md).

## Pour continuer

Pilotez exécutions et audits depuis vos propres outils : [Piloter depuis un outil externe](05-piloter-depuis-un-outil-externe.md).
