From fd1cbd9e68d66b5fabf36c1bae21812ce0af710b Mon Sep 17 00:00:00 2001 From: William Phetsinorath Date: Mon, 19 Oct 2026 07:48:25 +0200 Subject: [PATCH] doc: documenter l'archivage fiable d'un projet Co-authored-by: Automata --- docs/administration/projets.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/administration/projets.md b/docs/administration/projets.md index f3a06f5..31801dc 100644 --- a/docs/administration/projets.md +++ b/docs/administration/projets.md @@ -18,3 +18,15 @@ En cliquant sur le projet concerné, une autre page s'ouvre sur laquelle les inf - La configuration des plugins pour ce projet en particulier ![projet détail](/img/console_admin/projet_detail.png) + +## Archivage d'un projet + +La suppression d'un projet déclenche d'abord le nettoyage de l'ensemble de ses ressources externes (dépôts, environnements...), puis son archivage en base. + +Le projet est verrouillé avant le nettoyage : toute modification est refusée pendant l'opération. + +- Si le nettoyage échoue sur un service, le projet passe au statut « échoué » et l'API renvoie une erreur 422. Les nettoyages étant idempotents, la suppression peut être rejouée telle quelle. +- Si le projet est modifié pendant le nettoyage, l'API renvoie une erreur 409 et l'archivage est refusé ; rejouez la demande. +- En cas de succès, les ressources externes sont supprimées, le slug est suffixé et le projet passe au statut « archivé ». + +Un projet « échoué » reste verrouillé : un administrateur peut le déverrouiller puis relancer la suppression.