# GUIDE D'AUTOMATISATION : LE DUO PTERODACTYL + PAYMENTER

> Ce document explique pas à pas comment connecter un portail web moderne (Paymenter) avec Pterodactyl pour que la création de serveurs soit 100% automatique, sans aucune action humaine de ta part.

---

## 1. Pourquoi Paymenter ?
- **100% Open-Source & Gratuit** (écrit en Laravel/PHP, moderne et rapide).
- **Intégration Pterodactyl native** : Tu renseignes l'URL de ton panel et une clé API Administrateur.
- **Support des offres gratuites** : Tu peux créer un produit "Bot Discord Découverte" à 0.00 €, avec quota d'une commande par utilisateur.
- **Évolution future** : Quand tu souhaiteras ajouter des dons ou des offres payantes (via Ko-fi, Stripe, PayPal), le module est déjà prêt dans Paymenter.

---

## 2. Le Flux d'Automatisation (User Journey)

```
[ Utilisateur sur forgium.fr / client.forgium.fr ]
                     │
                     ▼
  1. Inscription / Connexion sur Paymenter
                     │
                     ▼
  2. Sélection de l'offre : "Bot Discord Bêta (Gratuit)"
                     │
                     ▼
  3. Validation de la commande (0,00 €)
                     │
                     ▼
[ API Paymenter ] ── (Appel API REST) ──► [ API Pterodactyl Panel ]
                                                    │
                                                    ▼
                                          Pterodactyl crée le serveur
                                          sur le Node Wings (Docker)
                                                    │
                                                    ▼
[ Utilisateur reçoit ses identifiants et le lien direct vers son panel ]
                                                    │
                                                    ▼
[ Le client uploade son bot et clique sur 'Démarrer' : le bot est en ligne ! ]
```

---

## 3. Configuration des Quotas par Produit (Exemples de Packages)

### Produit 1 : "Bot Discord Découverte (0€ - Bêta)"
- **Allocation CPU** : 30% d'un vCPU
- **RAM** : 512 Mo
- **Stockage SSD** : 2 Go
- **Ports réseau** : 1 port alloué
- **Bases de données MySQL** : 1 incluse (sur notre MariaDB mutualisée)
- **Sauvegardes automatiques** : 1 snapshot par semaine

### Produit 2 : "Bot Discord Pro / Élite (Futur Soutien Tipeee/Ko-fi)"
- **Allocation CPU** : 80% d'un vCPU
- **RAM** : 1024 Mo (1 Go)
- **Stockage SSD** : 5 Go
- **Sauvegardes automatiques** : 3 snapshots

---

## 4. Prérequis pour la Mise en Service
1. **Création de la Clé API sur Pterodactyl** :
   - Aller dans `Admin -> Application API`.
   - Créer une clé avec permissions complètes sur : `Nodes`, `Servers`, `Users`, `Locations`.
2. **Configuration dans Paymenter** :
   - Aller dans `Admin -> Extensions -> Pterodactyl`.
   - Coller l'URL (`https://panel.forgium.fr`) et la clé API générée.
   - Associer l'Egg Node.js / Python correspondant.
3. **Tester une fausse commande** :
   - Créer un compte de test.
   - Commander le produit gratuit.
   - Chronométrer le temps de création (cible : moins de 5 secondes).