docs(portal): add comprehensive administration and configuration guide for Paymenter

Idées/03_SERVICES_ET_OFFRES/GUIDE_ADMINISTRATION_PAYMENTER.md

@@ -0,0 +1,101 @@
+# 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
+```