leproide/forgium-website
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
forgium-website/Idées/03_SERVICES_ET_OFFRES/GUIDE_ADMINISTRATION_PAYMENTER.md

5.1 KiB
Raw Blame History

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
  • 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)

# 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