Exploitation et contribution

Santé et journaux

/health vérifie le processus API ; /ready vérifie ses dépendances et le schéma. Les services Compose possèdent leurs healthchecks. logs-init termine normalement avec le statut exited (0).

docker compose ps
docker compose logs -f api
docker compose logs -f fivem
docker compose logs -f bot
docker compose logs -f docs

Les fichiers de plus de 10 Mio sont archivés toutes les cinq minutes et cinq rotations sont conservées.

Validation

docker compose exec api pytest
docker compose exec api ruff check .
node --check admin/public/app.js
docker compose build docs

Le dernier contrôle exécute mkdocs build --strict dans l'image et échoue sur les avertissements.

Règle de contribution documentaire

Chaque modification de code, configuration, infrastructure ou comportement doit :

1. mettre à jour la documentation fonctionnelle concernée ;
2. mettre à jour la documentation technique concernée ;
3. synchroniser mkdocs.yml si une page change ;
4. valider le build strict avant le commit.

Cette règle figure aussi dans .agents/AGENTS.md afin qu'elle fasse partie du workflow de toutes les futures interventions.

Sauvegardes

Sauvegarder régulièrement PostgreSQL et les volumes fivem_txdata et fivem_resources. Redis n'est pas la source de vérité, mais son volume peut être conservé pour préserver les états temporaires lors d'une restauration complète.