---
title: Rétention du journal et rôles PostgreSQL
description: Exporter puis purger les entrées anciennes du journal des actions, et comprendre les trois rôles PostgreSQL de l'instance.
---

# Rétention du journal et rôles PostgreSQL

Le journal des actions grandit sans cesse. Une tâche dédiée exporte les entrées anciennes puis les purge, de façon bornée. Elle repose sur trois rôles PostgreSQL distincts, présentés ici.

**Qui peut le faire :** l'exploitant, sur le serveur Docker.

## Durées de conservation

| Donnée | Durée par défaut | Réglage | Mécanisme |
| --- | --- | --- | --- |
| Journal des actions | 180 jours | `MVP_AUDIT_RETENTION_DAYS` (180 à 3 650) | Export puis purge, profil `maintenance` |
| Alertes résolues | 90 jours | `MVP_ALERT_RETENTION_DAYS` (7 à 3 650) | Automatique, par le worker |
| Journaux techniques | 5 fichiers de 10 Mo par conteneur | Compose | Rotation Docker |
| Sauvegardes | 14 jours proposés | Planification de l'hôte | Hors application |

Descendre sous 180 jours est refusé par la base. Une obligation plus longue se règle en augmentant `MVP_AUDIT_RETENTION_DAYS`.

## Lancer une rétention

1. Créez sur l'hôte un dossier privé, propriété de l'UID 1000, droits 0700.
2. Renseignez `AUDIT_EXPORT_DIR` avec ce dossier.
3. Lancez :

```bash
docker compose -p <projet> -f compose.mvp.yaml --env-file <env> --profile maintenance run --rm retention
```

4. Chiffrez puis archivez l'export hors du serveur, comme une sauvegarde.

Planifiez cette commande sur l'hôte (cron ou tâche planifiée). La page Exploitation affiche la **Dernière purge bornée (31 jours)**.

> [!WARNING]
> La purge supprime définitivement les entrées antérieures au seuil. Elles ne subsistent que dans le fichier d'export : ne le supprimez pas, chiffrez-le et archivez-le. Ne lancez pas de rétention en même temps qu'un import de données anciennes.

### Ce que fait la tâche

Pour chaque organisation :

1. **Export.** Elle écrit les entrées antérieures au seuil dans un fichier JSON Lines privé (fichier 0600), au plus `MVP_AUDIT_RETENTION_MAX_ROWS` lignes. Si ce plafond est atteint, le seuil de purge recule : une entrée supprimée figure toujours dans l'export.
2. **Preuve de l'export.** Elle inscrit `data.audit_export` au journal, avec le nombre d'entrées et l'empreinte SHA-256 du fichier.
3. **Purge.** Elle supprime les entrées exportées par lots de 1 000 au plus. Chaque lot laisse une preuve `operations.retention_purge`.

La purge n'est jamais lancée si l'export a échoué. Les entrées qui servent encore de preuve à un travail en cours sont conservées.

## Les trois rôles PostgreSQL

| Rôle | Nom par défaut | Attributs | Utilisé par |
| --- | --- | --- | --- |
| Migration | `maintain_owner` | Connexion, propriétaire de la base, ni superutilisateur ni création de rôles | `release`, `legacy-import`, `retention` (export) |
| Runtime | `maintain_runtime` | Connexion, droits limités accordés explicitement | `web`, `worker` |
| Maintenance | `maintain_retention` | Sans connexion, seulement la fonction de purge bornée | `retention` (purge), endossé par le rôle de migration |

Le superutilisateur `postgres` sert à l'initialisation, aux sauvegardes et à l'exploitation. Il n'est transmis à aucun service applicatif.

### Pourquoi trois rôles

- Le rôle runtime ne peut ni modifier ni supprimer une entrée du journal. Une faille de l'application ne peut donc pas effacer les traces.
- La release refuse un superutilisateur et des rôles confondus.
- `/readyz` refuse un rôle runtime qui posséderait le schéma : la capacité `database` reste indisponible.
- Les opérations d'exploitation (migrations, sauvegardes, restaurations, exports) écrivent au journal avec les privilèges du rôle runtime, jamais avec ceux du propriétaire.

### Création des rôles

Les rôles et leurs mots de passe sont créés **une seule fois**, à l'initialisation d'un volume PostgreSQL vide. Le journal du premier démarrage affiche `Rôles MVP initialisés`. Les mots de passe ne sont jamais affichés.

Changer une variable de mot de passe après coup ne change pas le rôle : voir [Mises à jour et retour arrière](09-mises-a-jour-et-retour-arriere.md), section « Changer un mot de passe de rôle PostgreSQL ».

### Volume initialisé par une version plus ancienne

Si le rôle de migration ne peut pas endosser le rôle de maintenance, la purge échoue. Accordez ce droit une fois avec le superutilisateur :

```bash
docker exec -it <conteneur-postgres> psql -U postgres -d maintain -c 'GRANT maintain_retention TO maintain_owner WITH INHERIT FALSE, SET TRUE, ADMIN FALSE'
```

## Pour continuer

Pour reprendre les données d’une installation antérieure, voyez la [page de migration des données](11-migrer-depuis-le-poc.md).
