diff --git a/Idées/03_SERVICES_ET_OFFRES/GUIDE_ADMINISTRATION_PAYMENTER.md b/Idées/03_SERVICES_ET_OFFRES/GUIDE_ADMINISTRATION_PAYMENTER.md new file mode 100644 index 0000000..9f07db4 --- /dev/null +++ b/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 +```