Guide d'utilisation WPForge¶

WPForge est une plateforme complète de gestion WordPress construite avec FastAPI (backend) et React/Vite (frontend). Elle propose des outils pour gérer les sites WordPress, utilisateurs, plugins, thèmes et bien plus via une interface web élégante.

┌─────────────────────────────────────────────────────────────┐
│                    Architecture WPForge                      │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   ┌──────────────┐     ┌──────────────┐     ┌───────────┐  │
│   │  Navigateur  │────▶│   Frontend   │────▶│  Backend │  │
│   │ (React/Vite) │     │   (Vite)     │     │(FastAPI) │  │
│   └──────────────┘     └──────────────┘     └─────┬─────┘  │
│                                                   │        │
│                              ┌─────────────────────┼────┐  │
│                              │                     ▼    ▼  │
│                              │                 ┌────────┐ │
│                              └───────────────▶│ WP-CLI │ │
│                                                  └────────┘ │
│                                                  ▲         │
│                              ┌───────────────────┴─────────┤  │
│                              │                     ▼        ▼  │
│                              │                 ┌────────┐  │
│                              └───────────────▶│  MySQL  │  │
│                                                  └────────┘  │
└─────────────────────────────────────────────────────────────┘

✨ Fonctionnalités¶

• 🌍 Gestion des sites — Lister, ajouter, supprimer des installations WordPress
• 👥 Gestion des utilisateurs et rôles — Gérer les accès et permissions
• 🔌 Opérations sur les plugins — Installer, activer, mettre à jour, supprimer
• 🎨 Gestion des thèmes — Parcourir et gérer les thèmes WordPress
• 📸 Capture d'écrans — Capturer des screenshots pour la surveillance
• 💓 Surveillance et vérifications — Maintenir les sites en bonne santé
• 💾 Sauvegardes automatiques — Sauvegarde via WP-CLI
• 🔗 API REST — Pour l'extensibilité et l'automatisation

🚦 Démarrage rapide¶

📋 Prérequis¶

• 🐍 Python 3.8+
• 🟢 Node.js 14+
• 🐳 Docker (optionnel, pour la production)
• 📦 WP-CLI (pour les opérations WordPress)

🖥️ Configuration du Backend¶

cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload --host 127.0.0.1 --port 8000

🖼️ Configuration du Frontend¶

cd frontend
npm install
npm run dev  # serveur de dev sur http://localhost:5173

🏗️ Build de production¶

cd frontend
npm run build  # sortie dans frontend/dist/

🚀 Déploiement¶

Utilisez le script de déploiement fourni (nécessite root) :

sudo scripts/deploy.sh [--update]

┌────────────────────────────────────────┐
│            Flux de déploiement        │
├────────────────────────────────────────┤
│                                        │
│   ./deploy.sh                          │
│        │                               │
│        ▼                               │
│   ┌─────────────┐                      │
│   │Installation │                     │
│   │  dépendances│                      │
│   └──────┬──────┘                      │
│          ▼                             │
│   ┌─────────────┐                      │
│   │Build frontend│                     │
│   └──────┬──────┘                      │
│          ▼                             │
│   ┌─────────────┐  ┌──────────────┐    │
│   │  Nginx     │  │ Systemd      │    │
│   │  Config    │  │ Service      │    │
│   └─────────────┘  └──────────────┘    │
│          │             │              │
│          ▼             ▼              │
│   ┌─────────────────────────────┐     │
│   │      ✅ Terminé !          │     │
│   └─────────────────────────────┘     │
└────────────────────────────────────────┘

📚 Documentation¶

• 📖 Guide utilisateur — Instructions détaillées pour les utilisateurs
• 📡 API Docs — Interface Swagger interactive (quand le backend tourne)

📜 Licence¶

MIT%