K
KMS.CM DOCS v1.0
Guide de Transmission & Architecture
Aller au Site ↗
Documentation Technique Officielle • Kestrel Managed Systems

Manuel de Transmission & Déploiement KMS.cm

Ce document détaille l'organisation complète des 54+ fichiers de production, les scripts d'automatisation de téléversement FTP, la topologie des 3 sous-domaines (kms.cm, my.kms.cm, servers.kms.cm), les protocoles de vérification des liens (MCP / Link Checker) et les procédures de dépannage.

Serveur de Production
163.245.192.41
InterServer Multi-Cœurs VPS
Pile d'Exécution
PHP 8.2 + OLS
OpenLiteSpeed + DirectAdmin
Sécurité & OS
CloudLinux 9
CageFS + Imunify360 AI
Passerelles de Paiement
MoMo + Crypto + CB
CamPay, Fapshi, CinetPay, NOW
Chapitre 1

Scripts d'Automatisation FTP & Téléversement

Opérationnel

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)

# Déploiement complet en production :
deploy\upload.bat
# Mode simulation (Dry-Run sans écriture) :
deploy\upload.bat --dry-run
# Vérification de santé des liens après mise en ligne :
deploy\check_links.bat
🐍

Moteur Python CLI (Multi-Plateforme)

# Téléversement d'un sous-dossier uniquement (ex: pages) :
python deploy/upload.py --only pages/
# Téléversement d'un fichier spécifique :
python deploy/upload.py --file index.php
# Vérification directe sur l'IP du serveur :
python deploy/check_links.py --ip 163.245.192.41

Configuration FTP Enregistrée (deploy/ftp_config.json)

CONFIDENTIEL • GITIGNORED
Hôte IP : 163.245.192.41
Nom d'Utilisateur FTP : father@kms.cm
Mot de Passe FTP : #BrentWood600
Racine FTP (Chroot Pure-FTPd) : /public_html
Chapitre 2

Topologie des 3 Sous-Domaines & Routage

Architecture Réseau

Le serveur DirectAdmin est structuré pour faire correspondre chaque sous-domaine à son sous-dossier respectif dans /home/admin/domains/kms.cm/public_html.

Domaine Principal En Ligne

kms.cm

Site public vitrine, moteur de recherche de domaines, grille tarifaire dynamique en XAF, simulateur de profit et pages de services.

Chemin local : . (Racine)
Chemin serveur : /public_html/
Point d'entrée : index.php
Espace Client & Factures Passerelle WHMCS

my.kms.cm

Portail client sécurisé, facturation automatisée WHMCS, passerelles Mobile Money (CamPay, Fapshi), gestion des tickets et renouvellements.

Chemin local : my/
Chemin serveur : /public_html/my/
Point d'entrée : my/index.php
Nœuds & DirectAdmin Infrastructure

servers.kms.cm

Portail de statut de l'infrastructure, moniteur des 4 serveurs DNS autoritaires (ns1-ns4.kms.cm), et lien vers DirectAdmin (:2222).

Chemin local : servers/
Chemin serveur : /public_html/servers/
Point d'entrée : servers/index.php
Chapitre 3

Rô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.
Chapitre 4

Spécifications des 15+ APIs & Règles de Sécurité

Standard Militaire

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 $_ENV ou 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

1. CamPay REST API MTN / Orange Cameroun
2. Fapshi API v1 Secours MoMo Cameroun
3. CinetPay v2 API CEMAC (CM, GA, CG, TD)
4. Flutterwave v3 Cartes Visa/Mastercard
5. NOWPayments API Crypto USDT / BTC
6. Dynadot RESTful v2 Registrar Principal
7. Namecheap XML API Registrar de Secours
8. ResellerClub API Titan Mail & Certificats
9. Cloudflare Turnstile Anti-Bot Invisible
10. SMTP2GO v3 API E-mails Transactionnels
11. Twilio / Lominai WhatsApp Business
12. AWS Bedrock Haiku Chatbot IA Support 24/7
13. Zoho CRM & Books Comptabilité & Prospects
14. IPinfo.io Geo Détection Devise & Pays
15. DirectAdmin API Provisionnement Comptes
Chapitre 5

Procédure de Test des Formulaires & Fonctionnalités

Assurance Qualité

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.

Chapitre 6

Matrice de Dépannage & Diagnostic des Erreurs

Solutions Éprouvées
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.