> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ardoiseeduc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sauvegardes, vérification et restauration

> Sauvegarde scolaire vérifiée, fichiers et récupération PostgreSQL dans une cible isolée.

<Note>Cette page concerne l'installation School OHADA. Elle ne décrit pas une école autrichienne ni la sauvegarde d'un institut Marketplace.</Note>

## Activer et surveiller la sauvegarde

Le fondateur autorise le Drive choisi depuis son tableau de bord et active la sauvegarde. Le service `backup_worker` du déploiement prévu exécute le traitement périodique ; il ne réussit que si la connexion, les droits et la configuration sont valides. Consultez l'état et la date du dernier résultat, pas seulement la présence d'une connexion Google.

Pour lancer le traitement manuellement sur l'installation :

```bash theme={null}
docker compose exec app python manage.py run_cloud_backup
```

## Contenu et vérification

L'archive ZIP comprend le dump de base, les fichiers médias et les pièces couvertes par la sauvegarde, ainsi que le manifeste `ardoise_manifest.json` avec contrôles d'intégrité. Selon l'installation, les artefacts complémentaires de stockage sont inclus lorsqu'ils ont été produits ; vérifiez le manifeste et les avertissements. Une archive ne prouve pas que des fichiers absents de sa source ont été sauvegardés.

Après avoir placé votre archive dans le conteneur, vérifiez-la sans restaurer la base active :

```bash theme={null}
docker compose exec app python manage.py verify_backup /app/data/backup.zip
```

Le chemin est un exemple à remplacer par votre archive. La vérification contrôle le manifeste, les membres, leurs empreintes et le dump ; elle ne prouve pas seule qu'une restauration PostgreSQL complète fonctionne. Copier uniquement `data/` exclut la base PostgreSQL, stockée dans un autre volume.

## Restaurer une installation PostgreSQL

1. Téléchargez l'archive retenue, vérifiez son intégrité et préparez une installation isolée, sans utilisateurs connectés ni données nouvelles.
2. L'administrateur restaure le dump indiqué dans le manifeste avec **`pg_restore`** dans la base PostgreSQL cible. Le fichier du dump peut porter une extension `.sql` mais est au format personnalisé PostgreSQL ; ne le chargez pas comme du SQL texte avec `psql`.
3. Restaurez les médias et les éventuels artefacts complémentaires dans les volumes correspondants. Vérifiez séparément la configuration locale et les secrets de la nouvelle installation ; la présence du dump ne les reconstitue pas automatiquement.
4. Redémarrez, vérifiez la santé, l'identité de l'école, les dossiers, pièces et rapports dans cette cible. Ne basculez l'installation utilisée qu'après contrôle par les responsables.

<Warning>
  La commande `restore_backup --check` restaure uniquement les archives SQLite de test/compatibilité dans une cible temporaire. Elle n'est pas une restauration PostgreSQL de production. Testez régulièrement une vraie récupération PostgreSQL isolée. Si le Drive est révoqué ou un traitement échoue, l'activité scolaire peut continuer sans nouvelle sauvegarde : corrigez l'erreur et contrôlez le nouveau résultat.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.