Scripts d'Automatisation FTP & Téléversement
Le dossier deploy/ contient des scripts automatisés en Python 3 et batch Windows (.bat) pour téléverser l'intégralité du projet en une commande, gérer les différences (MD5 manifest), créer récursivement les répertoires distants et sauvegarder le fichier par défaut de DirectAdmin.
Lancement en 1 Clic (Windows Batch)
Moteur Python CLI (Multi-Plateforme)
Configuration FTP Enregistrée (deploy/ftp_config.json)
CONFIDENTIEL • GITIGNORED
Topologie des 3 Sous-Domaines & Routage
Le serveur DirectAdmin est structuré pour faire correspondre chaque sous-domaine à son sous-dossier respectif dans /home/admin/domains/kms.cm/public_html.
kms.cm
Site public vitrine, moteur de recherche de domaines, grille tarifaire dynamique en XAF, simulateur de profit et pages de services.
. (Racine)/public_html/index.phpmy.kms.cm
Portail client sécurisé, facturation automatisée WHMCS, passerelles Mobile Money (CamPay, Fapshi), gestion des tickets et renouvellements.
my//public_html/my/my/index.phpservers.kms.cm
Portail de statut de l'infrastructure, moniteur des 4 serveurs DNS autoritaires (ns1-ns4.kms.cm), et lien vers DirectAdmin (:2222).
servers//public_html/servers/servers/index.phpRôle & Responsabilité des 54+ Fichiers
Chaque fichier du projet a été conçu selon des normes strictes de séparation des responsabilités. Utilisez la table interactive ci-dessous pour inspecter les rôles et points d'attention de maintenance.
| Dossier / Fichier | Catégorie | Taille | Rôle & Fonction Système | Conseil de Maintenance & Dépannage |
|---|---|---|---|---|
| index.php | Frontend Master | 71.5 KB | Page d'accueil principale, héro avec particules, baromètre de statut, sélecteur mensuel/annuel XAF, présentation des 3 forfaits, marquee partenaires, simulateur 100k XAF. | Si une page blanche apparaît, vérifier les chemins d'inclusion includes/header.php et config/brand.php. |
| robots.txt | SEO Crawler | 0.9 KB | Directives d'exploration pour les moteurs de recherche (Google, Bing, Yandex) et pointeur vers sitemap.xml. | Garder l'accès libre sur les pages de services ; exclure /api/ et les journaux cron. |
| sitemap.xml | SEO Sitemap | 7.0 KB | Plan de site XML avec priorités, dates de mise à jour et balises hreflang trilingues (FR/EN/ES) pour Google Search Console. | Mettre à jour la date <lastmod> lors de l'ajout de nouvelles pages de services. |
| .env.example | Template Config | 12.5 KB | Gabarit d'environnement exhaustif répertoriant les 30+ clés secrètes d'APIs (CamPay, Fapshi, CinetPay, Flutterwave, Zoho, Bedrock, Turnstile). | Ne jamais téléverser le fichier .env réel sur Git. Copier manuellement en .env sur le serveur sécurisé. |
| config/hosting_packages.php | Config Forfaits | 16.9 KB | Tableau PHP des 3 forfaits d'hébergement : Starter (9 500 XAF/an), Business (22 900 XAF/an), Unlimited (49 900 XAF/an) et leurs quotas CloudLinux LVE. | Modifier ici les prix ou quotas pour que toutes les pages (index, hosting, whmcs) se synchronisent automatiquement. |
| config/domain_pricing.php | Config Domaines | 27.4 KB | Matrice tarifaire de 25+ extensions (.cm, .com, .net, .io, .ai) avec calcul automatique d'une marge minimale de 35% sur le prix de gros. | Ajuster la variable 'markup_percentage' => 35 pour augmenter la marge globale. |
| config/vps_packages.php | Config VPS | 16.0 KB | Définition des tranches VPS basées sur InterServer (de 1 à 16 cœurs CPU, jusqu'à 64 Go RAM, stockage NVMe Gen4). | Permet d'ajouter des options de licences cPanel/DirectAdmin/CloudLinux gérées. |
| config/email_products.php | Config Email | 24.3 KB | Packs de messagerie professionnelle : PrivateEmail (Namecheap), Google Workspace, Microsoft 365 Exchange et ResellerClub Titan. | Contient les prix par utilisateur et les fonctionnalités de sécurité anti-spam intégrées. |
| config/reseller_packages.php | Config Revendeur | 17.9 KB | 4 paliers revendeurs (Bronze, Silver, Gold, Platinum) pour agences web avec comptes cPanel/DirectAdmin illimités et marque blanche. | Gère la rentabilité du modèle d'agence pour le bootstrap financier CEMAC. |
| config/brand.php | Identité Marque | 16.6 KB | Palette de couleurs Titanium Goose (Slate Navy #0F172A, Silver #E2E8F0, Blue #1E3A8A, Emerald #059669), coordonnées géographiques et réseaux. | Modifier ici les numéros WhatsApp et adresses support pour mise à jour globale. |
| includes/header.php | Layout Header | 10.6 KB | En-tête HTML5 universel avec balises OpenGraph, Twitter Cards, polices Orbitron/Rajdhani, Tailwind CDN et snippets GA / Clarity. | Contient les ID de tracking Google Analytics et Microsoft Clarity. |
| includes/nav.php | Navigation Bar | 14.6 KB | Barre de navigation adhésive (sticky), tiroir mobile animé, sélecteur de langue trilingue et bouton Espace Client vers my.kms.cm. |
Pour ajouter un lien au menu, éditer le tableau associatif $nav_items. |
| includes/footer.php | Layout Footer | 22.9 KB | Pied de page à 4 colonnes, badges de moyens de paiement (MoMo, Cartes, Crypto), inscription newsletter et chargement des scripts JS. | Inclut l'appel du widget chatbot IA et du bouton flottant WhatsApp. |
| pages/hosting.php | Page Produit | 66.3 KB | Page détaillée d'hébergement web : comparaison des forfaits Starter, Business et Unlimited, tableau technique complet et FAQ. | Boutons de commande liés aux ID de produits WHMCS via localAPI. |
| pages/domains.php | Page Produit | 48.8 KB | Interface de recherche de noms de domaine avec vérification en direct via /api/dns-checker.php et grille tarifaire. |
Vérifier les quotas de requêtes Dynadot/Namecheap en production. |
| pages/vps.php | Page Produit | 53.9 KB | Page des serveurs VPS haute performance jusqu'à 56 combinaisons de processeurs, mémoire et stockage NVMe avec choix d'OS. | Mettre à jour les tranches de prix en synchronisation avec InterServer slices. |
| pages/reseller.php | Page Produit | 53.7 KB | Offre d'hébergement revendeur pour freelances et agences web de la zone CEMAC avec marque blanche et DirectAdmin Pro. | Met en valeur l'avantage de facturer ses clients finaux en Mobile Money. |
| pages/email.php | Page Produit | 45.3 KB | Messagerie professionnelle sécurisée comparant PrivateEmail, Google Workspace et Microsoft 365 Exchange. | Aide au choix interactive selon la taille de l'entreprise. |
| pages/webdev.php | Page Service | 32.6 KB | Services de création de sites web sur-mesure, e-commerce WooCommerce/Laravel et transformation digitale pour PME. | Inclut l'offre d'hébergement gratuit pendant 1 an pour tout projet signé. |
| pages/networking.php | Page Service | 40.5 KB | Réseaux d'entreprise, déploiement d'équipements MikroTik, points d'accès UniFi, câblage structuré et vidéo IP. | Présente les contrats de maintenance avec SLA 99.9% et support sur site. |
| pages/dns-checker.php | Outil Lead Magnet | 62.8 KB | Outil gratuit de diagnostic DNS et SSL (A, AAAA, MX, TXT, SPF, DMARC, certificats) agissant comme aimant à prospects. | Interroge l'endpoint /api/dns-checker.php en AJAX asynchrone avec mise en cache. |
| pages/contact.php | Contact & Lead | 64.9 KB | Formulaire de contact avancé avec géolocalisation IPinfo, détection du pays visiteur, protection Turnstile et envoi SMTP2GO. | Redirige vers pages/thank-you.php lors d'une soumission réussie. |
| pages/thank-you.php | Remerciement | 22.9 KB | Page de confirmation avec bouton de contact direct WhatsApp et rappel des délais de prise en charge sous 2 heures. | Sert de page d'atterrissage pour mesurer les conversions publicitaires (Google Ads / Meta Pixel). |
| my/index.php | Sous-Domaine my | 7.2 KB | Portail passerelle pour le sous-domaine my.kms.cm, redirigeant vers WHMCS clientarea.php ou affichant les raccourcis de facturation. |
Permet aux clients d'accéder à leurs factures et tickets même avant l'installation finale de WHMCS. |
| servers/index.php | Sous-Domaine servers | 8.1 KB | Tableau de bord pour servers.kms.cm / service.kms.cm affichant le statut du cluster et les serveurs de noms. |
Fournit le lien direct vers DirectAdmin Pro en HTTPS sur le port :2222. |
| modules/gateways/campay.php | Passerelle WHMCS | 16.5 KB | Module passerelle WHMCS pour MTN MoMo & Orange Money Cameroun via l'API CamPay (collecte /api/collect/). | Vérifier les identifiants d'application CamPay dans WHMCS -> Passerelles de paiement. |
| modules/gateways/callback/campay.php | Callback Webhook | 5.0 KB | Récepteur webhook pour CamPay vérifiant la signature HMAC et interrogeant l'API avant d'appeler localAPI('AddInvoicePayment'). |
Ne jamais marquer une facture comme payée sans vérification serveur-à-serveur. |
| modules/gateways/fapshi.php | Passerelle WHMCS | 12.9 KB | Module de secours Mobile Money Cameroun via Fapshi avec limiteur strict de 6 requêtes/minute par transaction. | Gérer l'erreur 404 temporaire sans interruption de la commande. |
| modules/gateways/cinetpay.php | Passerelle WHMCS | 12.2 KB | Paiement régional CEMAC et UEMOA (Cameroun, Gabon, Congo, Côte d'Ivoire) avec arrondi obligatoire des XAF au multiple de 5. | Applique la règle souveraine : ceil($amount / 5) * 5. |
| modules/gateways/flutterwave.php | Passerelle WHMCS | 11.7 KB | Paiements internationaux par cartes bancaires (Visa, Mastercard) et portefeuilles panafricains avec signature verif-hash. | Vérifier que la devise correspondante (XAF ou USD) correspond au montant validé. |
| modules/gateways/nowpayments.php | Passerelle WHMCS | 12.3 KB | Règlement en cryptomonnaies USDT (TRC20, BEP20) et Bitcoin avec vérification IPN par tri alphabétique des clés et HMAC-SHA512. | Alimente la trésorerie en dollars pour autofinancer les dépôts de domaines Namecheap/Dynadot. |
| includes/hooks/kms_zoho_sync.php | WHMCS Hook | 21.9 KB | Synchronisation automatique des nouveaux clients vers Zoho CRM et des factures payées vers le grand livre Zoho Books. | Renouvelle le jeton OAuth2 Zoho via cron ; vérifier les permissions dans Zoho Developer Console. |
| includes/hooks/kms_whatsapp_smtp2go.php | WHMCS Hook | 21.4 KB | Notifications automatiques par WhatsApp (Twilio/Lominai) et e-mails transactionnels haute délivrabilité (SMTP2GO). | Utilise des modèles approuvés WhatsApp Business pour éviter tout blocage. |
| includes/hooks/kms_geo_currency.php | WHMCS Hook | 10.9 KB | Détection géographique de l'IP du visiteur (IPinfo) pour basculer automatiquement la devise en XAF (CEMAC) ou USD et ajuster la langue. | Met en cache le pays dans la session utilisateur pour économiser les requêtes IPinfo. |
| includes/hooks/kms_registrar_float_guard.php | WHMCS Hook | 18.1 KB | Surveillance horaire des soldes prépayés Dynadot, Namecheap et ResellerClub ; alerte à < $100 et bascule en commande manuelle à < $40. | Empêche les échecs de commande de domaine lorsque le compte prépayé est épuisé. |
| api/dns-checker.php | API Publique | 30.5 KB | Endpoint JSON public effectuant les requêtes DNS (dns_get_record) et vérification de validité de certificats SSL avec limite de 30 req/min/IP. | Vérifier que les fonctions socket et DNS sont activées dans php.ini sur DirectAdmin. |
| api/bedrock-chat.php | API Chatbot | 20.9 KB | Passerelle sécurisée vers Amazon Bedrock (Claude 3.5 Haiku) intégrant la base de connaissances KMS.cm et l'escalade vers WhatsApp. | Nécessite les clés AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY dans le .env serveur. |
| crons/float_guard.php | Tâche Cron | 20.3 KB | Script autonome exécuté par le crontab Linux pour interroger les registrars et dispatcher les alertes WhatsApp/Email. | Ajouter au crontab : 0 * * * * php /home/admin/domains/kms.cm/public_html/crons/float_guard.php. |
| assets/css/style.css | CSS Styles | 22.7 KB | Feuille de styles complète : animations néon, grilles cybernétiques, keyframes du marquee partenaires, cartes en verre et thème Titanium. | Compilé avec des propriétés CSS modernes compatibles avec tous les navigateurs récents. |
| assets/js/main.js | JavaScript UI | 23.0 KB | Logique frontend : bascule mensuel/annuel, tiroir mobile, carrousels, requêtes AJAX pour la recherche de domaine et bannières cookies. | Code vanilla JS sans dépendance jQuery lourd, assurant un score Google PageSpeed maximal. |
| assets/js/chatbot.js | Chatbot Widget | 17.9 KB | Bouton flottant interactif (en bas à droite ou gauche), fenêtre de discussion IA trilingue, indicateur de frappe et raccourci WhatsApp. | Sauvegarde l'historique de conversation dans sessionStorage pour préserver le contexte utilisateur. |
Spécifications des 15+ APIs & Règles de Sécurité
6 Règles de Sécurité Non-Négociables
-
✓
Zéro Secret en Dur : Aucun mot de passe ni clé d'API dans le code source ; tout transite par
$_ENVou les tables chiffrées de WHMCS. -
✓
Vérification Cryptographique HMAC : Chaque webhook de paiement valide une signature HMAC-SHA256 ou HMAC-SHA512 avant tout traitement de facture.
-
✓
Re-Vérification Serveur-à-Serveur : Ne jamais faire confiance à l'URL de retour du navigateur client ; interroger systématiquement l'API du prestataire.
-
✓
Arrondi Régional XAF : Tous les montants CinetPay sont arrondis au multiple supérieur de 5 XAF (
ceil($amount / 5) * 5). -
✓
Limiteur de Débit Fapshi : Maximum 6 vérifications de statut par minute et par ID pour éviter les erreurs HTTP 429.
-
✓
Requêtes Préparées Obligatoires : Utilisation exclusive d'Illuminate Capsule ORM ou PDO prepared statements sans injection directe.
Matrice des 15 APIs Connectées
Procédure de Test des Formulaires & Fonctionnalités
1. Test du Formulaire de Contact Avancé (pages/contact.php)
Rendez-vous sur https://kms.cm/pages/contact.php. Remplissez les champs (Nom, Téléphone avec indicatif +237, email, besoin et message). Soumettez le formulaire : le système doit valider le jeton Turnstile, interroger IPinfo pour rattacher les coordonnées géographiques au message, expédier un e-mail récapitulatif via SMTP2GO et vous rediriger avec animation sur pages/thank-you.php.
2. Test de l'Outil de Diagnostic DNS & SSL (pages/dns-checker.php)
Entrez un nom de domaine (ex: kms.cm ou google.com) et cliquez sur "Analyser le Domaine". L'outil interroge /api/dns-checker.php et affiche instantanément les enregistrements A, AAAA, MX, TXT, SPF, DMARC et l'état du certificat SSL avec code couleur vert/jaune/rouge.
3. Test du Widget Chatbot IA & Bouton Flottant WhatsApp (assets/js/chatbot.js)
Cliquez sur la bulle de chat en bas à droite de l'écran. Posez une question sur les prix (ex: "Quel est le prix du forfait Starter ?"). L'agent IA doit répondre en français, anglais ou espagnol en citant le tarif exact de 9 500 XAF/an. Cliquez sur le bouton "Parler à un humain" pour tester l'ouverture de WhatsApp avec message pré-rempli.
Matrice de Dépannage & Diagnostic des Erreurs
| Symptôme Constaté | Cause Racine Probable | Action Corrective Immédiate |
|---|---|---|
| Page par défaut DirectAdmin s'affiche au lieu de index.php | Le fichier index.html par défaut de DirectAdmin est prioritaire sur index.php dans la configuration d'OpenLiteSpeed. |
Renommer ou supprimer index.html en index.html.default.bak (géré automatiquement par deploy/upload.py). |
| Erreur 550 Can't change directory to /home/admin/... | L'utilisateur FTP father@kms.cm est chrooté dans le dossier du domaine par Pure-FTPd. Le chemin racine en FTP est donc /public_html. |
Définir "remote_root": "/public_html" dans ftp_config.json. |
| Erreur SSL Hostname Mismatch sur https://kms.cm | Le certificat SSL Let's Encrypt ou Cloudflare n'est pas encore émis pour le domaine ou le DNS pointe encore vers l'IP brute. | Activer le certificat SSL Let's Encrypt gratuit dans DirectAdmin -> Gestionnaire SSL, ou passer les DNS par Cloudflare avec proxy actif (nuage orange). |
| Page Blanche (White Screen of Death) | Erreur fatale PHP masquée par display_errors = Off en environnement de production. |
Consulter les logs d'erreurs dans DirectAdmin -> Journal des erreurs, ou inspecter /home/admin/domains/kms.cm/logs/error.log. |
| Paiement Mobile Money non crédité dans WHMCS | Échec de la validation de la signature HMAC du webhook ou IP du serveur externe non autorisée. | Vérifier le secret webhook dans les paramètres de la passerelle CamPay/Fapshi et contrôler la table tblgatewaylog de WHMCS. |