Aller au contenu

🛠️ Outils en ligne de commande

LibreFolio fournit le script dev.py pour les tâches d'administration. Cette page couvre les commandes les plus pertinentes pour les administrateurs système.

👩‍💻 Pour les développeurs

Pour les commandes spécifiques au développement (build frontend, exécuteur de tests, synchronisation API, audit i18n), consultez le Guide d'installation pour développeurs.

🚀 Installation

Installer toutes les dépendances du projet (Python et Node.js) :

./dev.py install

🖥️ Serveur (Production)

▶️ Démarrer le serveur

# Démarrage standard
./dev.py server

# Avec des workers calculés automatiquement (2 × (CPU-1))
./dev.py server --workers N

# Termine le processus existant sur le port avant de démarrer
./dev.py server --force

Multi-worker

En production, utilisez --workers pour exécuter plusieurs workers Uvicorn. Cela améliore le débit et est recommandé pour tout déploiement avec plus d'un cœur de CPU.

👤 Gestion des utilisateurs

La gestion des utilisateurs se fait via les sous-commandes ./dev.py user :

# Créer un utilisateur (le premier utilisateur devient automatiquement administrateur)
./dev.py user create <nom_utilisateur> <email> <mot_de_passe>

# Lister tous les utilisateurs
./dev.py user list

# Réinitialiser le mot de passe d'un utilisateur
./dev.py user reset <nom_utilisateur> <nouveau_mot_de_passe>

# Promouvoir un utilisateur au rang d'administrateur
./dev.py user promote <nom_utilisateur>

# Rétrograder un administrateur en utilisateur standard
./dev.py user demote <nom_utilisateur>

⚙️ Gestion système

🔧 Initialiser les paramètres globaux

./dev.py user init-settings

Remplit la base de données avec les Paramètres Globaux par défaut s'ils n'existent pas déjà.

🗄️ Migrations de base de données

# Appliquer les migrations en attente
./dev.py db upgrade

🗄️ Réinitialisation de la base de données

./dev.py db create-clean recrée la base de données à partir de zéro — toutes les données sont perdues. À utiliser uniquement si vous avez besoin de partir de zéro.

📚 Documentation

# Générer et déployer la documentation MkDocs sur GitHub Pages
./dev.py mkdocs deploy

# Générer les captures d'écran de la galerie (nécessite un serveur en cours d'exécution + des données de test)
./dev.py mkdocs gallery

📋 Arborescence complète des commandes

Pour une liste complète de toutes les commandes disponibles :

./dev.py --help

👩‍💻 Commandes développeur

Commandes supplémentaires pour les workflows de développement :