Projet

Général

Profil

Guide WPForge » Historique » Version 6

Johnny Fontaine, 15/04/2026 17:28

1 5 Johnny Fontaine
# <img style="width: 180px;" src="clipboard-202603161125-sbyni.png"> Guide d'utilisation WPForge
2 1 Johnny Fontaine
3 2 Johnny Fontaine
> [!Note] Ce guide décrit les actions courantes pour les professeurs dans WPForge.
4 1 Johnny Fontaine
5 6 Johnny Fontaine
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.
6 1 Johnny Fontaine
7 6 Johnny Fontaine
```
8
┌─────────────────────────────────────────────────────────────┐
9
│                    Architecture WPForge                      │
10
├─────────────────────────────────────────────────────────────┤
11
│                                                             │
12
│   ┌──────────────┐     ┌──────────────┐     ┌───────────┐  │
13
│   │  Navigateur  │────▶│   Frontend   │────▶│  Backend │  │
14
│   │ (React/Vite) │     │   (Vite)     │     │(FastAPI) │  │
15
│   └──────────────┘     └──────────────┘     └─────┬─────┘  │
16
│                                                   │        │
17
│                              ┌─────────────────────┼────┐  │
18
│                              │                     ▼    ▼  │
19
│                              │                 ┌────────┐ │
20
│                              └───────────────▶│ WP-CLI │ │
21
│                                                  └────────┘ │
22
│                                                  ▲         │
23
│                              ┌───────────────────┴─────────┤  │
24
│                              │                     ▼        ▼  │
25
│                              │                 ┌────────┐  │
26
│                              └───────────────▶│  MySQL  │  │
27
│                                                  └────────┘  │
28
└─────────────────────────────────────────────────────────────┘
29
```
30 1 Johnny Fontaine
31 6 Johnny Fontaine
## ✨ Fonctionnalités
32 1 Johnny Fontaine
33 6 Johnny Fontaine
- 🌍 **Gestion des sites** — Lister, ajouter, supprimer des installations WordPress
34
- 👥 **Gestion des utilisateurs et rôles** — Gérer les accès et permissions
35
- 🔌 **Opérations sur les plugins** — Installer, activer, mettre à jour, supprimer
36
- 🎨 **Gestion des thèmes** — Parcourir et gérer les thèmes WordPress
37
- 📸 **Capture d'écrans** — Capturer des screenshots pour la surveillance
38
- 💓 **Surveillance et vérifications** — Maintenir les sites en bonne santé
39
- 💾 **Sauvegardes automatiques** — Sauvegarde via WP-CLI
40
- 🔗 **API REST** — Pour l'extensibilité et l'automatisation
41 1 Johnny Fontaine
42 6 Johnny Fontaine
## 🚦 Démarrage rapide
43 1 Johnny Fontaine
44 6 Johnny Fontaine
### 📋 Prérequis
45 1 Johnny Fontaine
46 6 Johnny Fontaine
- 🐍 Python 3.8+
47
- 🟢 Node.js 14+
48
- 🐳 Docker (optionnel, pour la production)
49
- 📦 WP-CLI (pour les opérations WordPress)
50 1 Johnny Fontaine
51 6 Johnny Fontaine
### 🖥️ Configuration du Backend
52 1 Johnny Fontaine
53 6 Johnny Fontaine
```bash
54
cd backend
55
python3 -m venv venv
56
source venv/bin/activate
57
pip install -r requirements.txt
58
uvicorn main:app --reload --host 127.0.0.1 --port 8000
59
```
60 1 Johnny Fontaine
61 6 Johnny Fontaine
### 🖼️ Configuration du Frontend
62 1 Johnny Fontaine
63 6 Johnny Fontaine
```bash
64
cd frontend
65
npm install
66
npm run dev  # serveur de dev sur http://localhost:5173
67
```
68 1 Johnny Fontaine
69 6 Johnny Fontaine
### 🏗️ Build de production
70 1 Johnny Fontaine
71 6 Johnny Fontaine
```bash
72
cd frontend
73
npm run build  # sortie dans frontend/dist/
74
```
75 1 Johnny Fontaine
76 6 Johnny Fontaine
### 🚀 Déploiement
77 1 Johnny Fontaine
78 6 Johnny Fontaine
Utilisez le script de déploiement fourni (nécessite root) :
79 1 Johnny Fontaine
80 6 Johnny Fontaine
```bash
81
sudo scripts/deploy.sh [--update]
82
```
83 1 Johnny Fontaine
84 6 Johnny Fontaine
```
85
┌────────────────────────────────────────┐
86
│            Flux de déploiement        │
87
├────────────────────────────────────────┤
88
│                                        │
89
│   ./deploy.sh                          │
90
│        │                               │
91
│        ▼                               │
92
│   ┌─────────────┐                      │
93
│   │Installation │                     │
94
│   │  dépendances│                      │
95
│   └──────┬──────┘                      │
96
│          ▼                             │
97
│   ┌─────────────┐                      │
98
│   │Build frontend│                     │
99
│   └──────┬──────┘                      │
100
│          ▼                             │
101
│   ┌─────────────┐  ┌──────────────┐    │
102
│   │  Nginx     │  │ Systemd      │    │
103
│   │  Config    │  │ Service      │    │
104
│   └─────────────┘  └──────────────┘    │
105
│          │             │              │
106
│          ▼             ▼              │
107
│   ┌─────────────────────────────┐     │
108
│   │      ✅ Terminé !          │     │
109
│   └─────────────────────────────┘     │
110
└────────────────────────────────────────┘
111
```
112 1 Johnny Fontaine
113 6 Johnny Fontaine
## 📚 Documentation
114 1 Johnny Fontaine
115 6 Johnny Fontaine
- 📖 [Guide utilisateur](GUIDE.md) — Instructions détaillées pour les utilisateurs
116
- 📡 [API Docs](http://127.0.0.1:8000/docs) — Interface Swagger interactive (quand le backend tourne)
117 1 Johnny Fontaine
118 6 Johnny Fontaine
## 📜 Licence
119 1 Johnny Fontaine
120 6 Johnny Fontaine
MIT%