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, lanceur de tests, synchronisation API, audit i18n), consultez le Guide d'installation pour les développeurs.

🚀 Installation

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

./dev.py install

🖥️ Serveur (Production)

▶️ Démarrage du serveur

# Standard start
./dev.py server

# With auto-calculated workers (2 × (CPU-1))
./dev.py server --workers N

# Kill existing process on port before starting
./dev.py server --force

Multi-worker

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

👤 Gestion des utilisateurs

La gestion des utilisateurs s'effectue via les sous-commandes ./dev.py user :

# Create a user (first user becomes admin automatically)
./dev.py user create <username> <email> <password>

# List all users
./dev.py user list

# Reset a user's password
./dev.py user reset <username> <new_password>

# Promote a user to admin
./dev.py user promote <username>

# Demote an admin to regular user
./dev.py user demote <username>

⚙️ Gestion du 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 la base de données

# Apply pending migrations
./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 d'un nouveau départ.

📚 Documentation

# Build and deploy MkDocs documentation to GitHub Pages
./dev.py mkdocs deploy

# Generate gallery screenshots (requires running server + test data)
./dev.py mkdocs gallery

📋 Arborescence complète des commandes

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

./dev.py --help

👩‍💻 Commandes développeurs

Commandes supplémentaires pour les flux de travail de développement :