# Guide Complet d'Administration : Paymenter (Portail Client & Facturation)

*Dernière mise à jour : 09 Septembre 2026*  
*Machine dédiée : CT 103 (`192.168.1.53`) | Domaine : `https://client.forgium.fr`*

---

## 1. Vue d'Ensemble & Fonctionnement

**Paymenter** est l'ERP / CRM open-source moderne qui gère toute la partie commerciale et transactionnelle de Forgium Cloud :
- **Espace Public Visiteur** : Catalogue des offres découpé par univers (Minecraft, Bots Discord, VPS Cloud, Web/Cloud).
- **Inscription & Authentification** : Les clients créent leur compte, gèrent leurs mots de passe, leurs profils et leurs sessions de manière autonome.
- **Cycle de Commande (0.00 €)** : Le client choisit son offre, la place dans son panier et valide la commande. Pour les formules à 0.00 €, **aucun moyen de paiement bancaire n'est réclamé**.
- **Facturation & Invoices** : Génération automatique de factures PDF numérotées au format `INV-XXXXX` acquittées à 0.00 €.
- **Ticketing & Support** : Système de tickets d'assistance intégré permettant aux clients d'échanger directement avec le support Forgium.

---

## 2. Accès au Panneau d'Administration (Backoffice)

- **URL Admin** : [`https://client.forgium.fr/admin`](https://client.forgium.fr/admin)
- **Compte Fondateur Créé** :
  - **Identifiant / Email** : `admin@forgium.fr`
  - **Mot de passe initial** : `ForgiumRoot2026Secure!`
  - **Rôle** : `admin` (Droits complets `*`)

> *Astuce sécurité* : Vous pouvez changer le mot de passe administrateur ou créer d'autres collaborateurs directement dans `Admin -> Users`.

---

## 3. Comment Configurer & Personnaliser Paymenter

### A. Gérer les Catégories d'Offres (`Admin -> Categories`)
Les offres sont scindées en 4 catégories distinctes (adresses directes) :
1. **Serveurs Minecraft** : `https://client.forgium.fr/products/minecraft`
2. **Bots Discord & Scripts** : `https://client.forgium.fr/products/bots`
3. **Serveurs VPS Cloud** : `https://client.forgium.fr/products/vps`
4. **Hébergement Web & Cloud** : `https://client.forgium.fr/products/web-cloud`

*Pour modifier ou ajouter une catégorie* :
- Rendez-vous sur `Categories -> Create Category`.
- Renseignez le nom, la description et le slug d'URL (ex: `vps`, `cloud-storage`).

---

### B. Créer un Produit & Définir son Prix (`Admin -> Products`)
Chaque produit appartient à une catégorie et dispose d'un plan tarifaire :

1. Cliquez sur **`Create Product`** :
   - **Name** : Nom public (ex: `Minecraft Paper - Starter Free`).
   - **Slug** : Identifiant d'URL unique (ex: `minecraft-free`).
   - **Category** : Sélectionnez l'univers correspondant.
   - **Server** : Choisissez `Forgium Pterodactyl Node Cluster` si le produit est déployé automatiquement sur le cluster de conteneurs, ou `None` si la mise en service est manuelle/externe.
2. **Onglet Plans & Tarifs** :
   - Ajoutez un plan de type **`Free`** (Gratuit).
   - Indiquez le tarif : **`0.00 €`**.
3. **Paramètres Spécifiques au Serveur** (si relié) :
   - Spécifiez la mémoire RAM en Mo (ex: `1536`), le disque SSD (ex: `5120`), le vCPU (`150`), le Nest ID et l'Egg ID.
4. Cliquez sur **`Save`**. Le produit est immédiatement disponible à la commande en ligne.

---

### C. Personnalisation de la Marque & Apparence (`Admin -> Settings`)
Dans la section `Settings` :
- **General** : Nom de la plateforme (`Forgium Cloud`), devise par défaut (`EUR €`), fuseau horaire (`Europe/Paris`), langue (`fr`).
- **Theme** : Couleurs du thème sombre, affichage du logo, texte d'accueil, activation du checkout direct en 1 clic.
- **Invoicing** : Préfixe de facture, mentions légales obligatoires, modèle de taxes (TVA 0% pour le moment).
- **Email Templates** : Personnalisation des emails de bienvenue, confirmation de commande et réponses aux tickets de support.

---

## 4. Liaison Automatisée avec le Moteur d'Hébergement

Paymenter communique via l'API locale avec votre cluster :
- **Serveur de Provisioning** configuré dans `Admin -> Servers` :
  - **Nom** : `Forgium Pterodactyl Node Cluster`
  - **Hôte** : `https://panel.forgium.fr`
  - **Authentification** : Clé d'API chiffrée avec droits globaux d'orchestration.
- **Comportement automatique** :
  - Quand le client finalise sa commande à 0.00 €, la file de tâches asynchrone (`paymenter.service`) prend le relais.
  - Le compte client est créé automatiquement.
  - Le serveur est déployé avec ses quotas de mémoire et de disque sur `wings-node-01` (CT 102).
  - Le client voit un bouton **"Accéder au Serveur"** qui l'ouvre directement.

---

## 5. Commandes Utiles en Ligne de Commande (Sur CT 103)

```bash
# Vérifier l'état de Paymenter et de son worker de tâches
pct exec 103 -- systemctl status paymenter nginx php8.3-fpm mariadb

# Vider les caches après une modification de configuration
pct exec 103 -- bash -c "cd /var/www/paymenter && php8.3 artisan optimize:clear"

# Créer un nouvel administrateur en CLI
pct exec 103 -- bash -c "cd /var/www/paymenter && php8.3 artisan app:user:create Prénom Nom email@forgium.fr MotDePasseSecurise! 1"

# Relancer le traitement de la file de commandes
pct exec 103 -- systemctl restart paymenter
```