Fiche technique detaillee

Mise en ligne du systeme K-BUSINESS / KBCSAL sur o2switch

Guide complet pour publier le site public, le back-office kbcsalgestion, la base MySQL, les documents avec QR code, les sauvegardes et les controles de sécurité.

Projet : Kouroussa Business Center Supply & Logistics SARLU
Dossier admin : kbcsalgestion
Date : 1er juin 2026
Usage : installation, controle technique, maintenance et transfert vers production.

Sommaire

  1. Architecture du systeme
  2. Prerequis o2switch
  3. Preparation avant transfert
  4. Transfert des fichiers
  5. Creation et importation de la base MySQL
  6. Configuration production
  7. Domaine, SSL et HTTPS
  8. Emails et notifications
  9. Dossiers uploads et permissions
  10. Sécurité du back-office
  11. Tests fonctionnels apres mise en ligne
  12. Sauvegarde et restauration
  13. Depannage rapide
  14. PV de recette technique

1. Architecture du systeme

PartieCheminRole
Site public/Pages HTML publiques : accueil, services, granite, equipe, contact, demande de devis.
Administration/kbcsalgestion/admin/Connexion, tableau de bord, utilisateurs, devis, factures, caisse, stock, RH, boutique, messagerie.
API publique/kbcsalgestion/api/Reception des formulaires public, FAQ locale et contenus dynamiques.
Fichiers televerses/kbcsalgestion/uploads/Photos de profil, documents RH, images boutique, pieces jointes, images de reference.
Base de donneeskbcsalgestion/database.sqlStructure MySQL du systeme.
Configurationkbcsalgestion/config.production.phpParamètres de production : base MySQL, URL, email, WhatsApp, sécurité QR.
Le lien principal du back-office apres mise en ligne sera : https://votre-domaine.com/kbcsalgestion/admin/login.php.

2. Prerequis o2switch

Acces cPanel
Identifiant, mot de passe et domaine rattache a l'hebergement.
PHP
PHP 8.1 ou plus recommande. Activer les extensions PDO, pdo_mysql, fileinfo, mbstring, openssl.
MySQL/MariaDB
Une base dediee au projet et un utilisateur MySQL avec tous les privileges sur cette base.
Domaine
Domaine principal ou sous-domaine deja pointe vers o2switch.
SSL
Certificat AutoSSL actif pour forcer l'acces en HTTPS.
Client de transfert
Gestionnaire de fichiers cPanel ou FileZilla/FTP.

3. Preparation avant transfert

  1. Verifier que le dossier local K-BUSINESS contient bien index.html, css, js, images, docs et kbcsalgestion.
  2. Verifier que le dossier kbcsalgestion contient admin, api, uploads, config.php, config.production.example.php, database.sql.
  3. Controler que le fichier .htaccess principal existe a la racine du site.
  4. Faire une copie de sauvegarde du dossier local avant toute mise en ligne.
  5. Preparer les informations MySQL fournies par o2switch : nom de base, utilisateur, mot de passe.
  6. Preparer l'adresse publique finale du site, par exemple https://k-business-gn.com.

4. Transfert des fichiers vers o2switch

Option A : Gestionnaire de fichiers cPanel

  1. Ouvrir cPanel puis Gestionnaire de fichiers.
  2. Entrer dans public_html si le domaine principal utilise ce dossier.
  3. Envoyer le dossier complet K-BUSINESS, ou envoyer directement son contenu dans public_html selon l'organisation souhaitee.
  4. Si le site doit etre accessible a la racine du domaine, les fichiers index.html, css, js, images et kbcsalgestion doivent se trouver directement dans le dossier public du domaine.
  5. Verifier que les fichiers caches comme .htaccess sont bien visibles et transferes.

Option B : FTP / FileZilla

  1. Creer ou utiliser un compte FTP dans cPanel.
  2. Se connecter avec FileZilla.
  3. Envoyer tous les fichiers dans le dossier public du domaine.
  4. Attendre la fin complete du transfert avant de tester le site.
Ne pas envoyer uniquement les pages HTML. Le dossier kbcsalgestion est indispensable pour les formulaires, l'administration, les documents, la messagerie et la base de donnees.

5. Creation et importation de la base MySQL

Creer la base

  1. Dans cPanel, ouvrir Bases de donnees MySQL.
  2. Creer une base, par exemple cpaneluser_kbusiness.
  3. Creer un utilisateur, par exemple cpaneluser_kbuser.
  4. Attribuer un mot de passe fort a l'utilisateur.
  5. Ajouter l'utilisateur a la base avec tous les privileges.

Importer les tables

  1. Ouvrir phpMyAdmin.
  2. Selectionner la base creee.
  3. Cliquer sur Importer.
  4. Choisir le fichier kbcsalgestion/database.sql.
  5. Lancer l'importation.
  6. Verifier que les tables apparaissent : users, quote_requests, business_documents, cash_entries, stock_items, audit_logs, etc.
Si l'importation echoue a cause de la taille du fichier, utiliser l'importation partielle phpMyAdmin ou demander a o2switch d'augmenter temporairement la limite d'import.

6. Configuration production

  1. Dans kbcsalgestion, copier config.production.example.php.
  2. Renommer la copie en config.production.php.
  3. Modifier les informations ci-dessous avec les valeurs reelles de l'hebergement.
<?php
$APP_ENV = 'production';
$APP_BASE_URL = 'https://votre-domaine.com/kbcsalgestion';

$DB_HOST = 'localhost';
$DB_NAME = 'cpaneluser_kbusiness';
$DB_USER = 'cpaneluser_kbuser';
$DB_PASS = 'mot-de-passe-mysql';

$BUSINESS_EMAILS = [
    'centraleachat@k-business-gn.com',
    'direction@k-business-gn.com',
    'accountpayable@k-business-gn.com',
];

$WHATSAPP_NUMBER = '224664003142';
$DOCUMENT_VERIFICATION_SECRET = 'votre-cle-secrete-confidentielle';

$SMTP_ENABLED = false;
ParametreExplication
$APP_ENVMettre production pour masquer les erreurs techniques au public.
$APP_BASE_URLAdresse publique du dossier de gestion. Important pour les QR codes de verification.
$DB_HOSTGeneralement localhost chez o2switch.
$DB_NAMENom complet de la base MySQL creee dans cPanel.
$DB_USERNom complet de l'utilisateur MySQL.
$DB_PASSMot de passe MySQL.
$DOCUMENT_VERIFICATION_SECRETCle confidentielle utilisee pour signer les QR codes. Elle ne doit pas etre partagee.
Ne jamais laisser un fichier config.production.php accessible en telechargement. Le fichier .htaccess du projet bloque deja les acces directs, mais il faut quand meme eviter de le transmettre.

7. Domaine, SSL et HTTPS

  1. Dans cPanel, ouvrir SSL/TLS Status ou Let's Encrypt / AutoSSL.
  2. Verifier que le domaine est couvert par un certificat valide.
  3. Tester https://votre-domaine.com.
  4. Tester https://votre-domaine.com/kbcsalgestion/admin/login.php.
  5. Utiliser uniquement l'adresse HTTPS dans $APP_BASE_URL.
Le HTTPS est indispensable pour la connexion admin, les mots de passe, les sessions, les televersements et les documents officiels.

8. Emails et notifications

Le systeme peut fonctionner en mode simple sans SMTP, mais pour les notifications fiables en production il est preferable de configurer un SMTP professionnel.

ModeAvantageConfiguration
PHP mail simpleRapide a tester$SMTP_ENABLED = false;
SMTP o2switchPlus fiable pour les notificationsRenseigner host, port, utilisateur, mot de passe, email expediteur.
$SMTP_ENABLED = true;
$SMTP_HOST = 'mail.votre-domaine.com';
$SMTP_PORT = 465;
$SMTP_USERNAME = 'centraleachat@k-business-gn.com';
$SMTP_PASSWORD = 'mot-de-passe-email';
$SMTP_FROM_EMAIL = 'centraleachat@k-business-gn.com';
$SMTP_FROM_NAME = 'K-BUSINESS';
Apres mise en ligne, faire un test de demande de devis et verifier que l'email arrive dans la boite centraleachat@k-business-gn.com.

9. Dossiers uploads et permissions

Le dossier kbcsalgestion/uploads doit permettre l'ecriture de fichiers par PHP.

DossierContenuControle
uploads/profilesPhotos de profilTester depuis Mon profil.
uploads/messagesPieces jointes messagerieEnvoyer une image et un PDF.
uploads/document-itemsImages de reference devis/facturesAjouter une ligne avec image.
uploads/shopImages boutiqueAjouter un produit avec image.
uploads/hrDocuments RHTeleverser un document employe.
uploads/siteImages du site public gerees depuis l'adminPublier une section avec image.
Si un televersement echoue, verifier les permissions du dossier, la limite de taille PHP et l'espace disque disponible.

10. Sécurité du back-office

  1. Changer le mot de passe du compte administrateur general des la premiere connexion.
  2. Creer un compte personnel pour chaque employe.
  3. Ne jamais partager un meme compte entre plusieurs personnes.
  4. Attribuer uniquement les modules necessaires : devis, facturation, caisse, stock, RH.
  5. Bloquer les comptes des employes qui quittent l'entreprise.
  6. Verifier regulierement la page kbcsalgestion/admin/security.php.
  7. Verifier les traces dans kbcsalgestion/admin/audit.php.
  8. Conserver la cle de verification QR confidentielle.
  9. Eviter les mots de passe courts, simples ou reutilises.
Le systeme conserve les traces d'action afin d'identifier quel utilisateur a cree, modifie, valide ou consulte certaines informations.

11. Tests fonctionnels apres mise en ligne

TestProcedureResultat attendu
Site publicOuvrir l'accueil, services, granite, contact.Pages visibles, images chargees, responsive mobile.
Demande de devisSoumettre le formulaire public.Demande enregistree dans l'admin et notification envoyee.
Connexion adminAller sur /kbcsalgestion/admin/login.php.Connexion reussie, tableau de bord affiche.
Creation utilisateurCreer un compte test avec poste et acces limite.Le compte se connecte uniquement aux modules autorises.
MessagerieEnvoyer un message avec image et PDF.Le destinataire voit le message, telecharge les pieces jointes.
DevisCreer un devis avec plusieurs lignes et une image de reference.Le devis s'enregistre, se valide et s'imprime.
FactureCreer une facture et imprimer.QR code visible, montants corrects, pied de page entreprise present.
Verification QRScanner le QR code.Page officielle de verification affichee.
CaisseAjouter entree et sortie.Tableau caisse mensuel et graphique mis a jour.
StockAjouter produit, mouvement entree/sortie.Quantité et alerte stock correctes.
RHAjouter employe, document, absence ou conge.Information visible dans le module RH.
MaintenanceActiver mode maintenance depuis admin.Site public affiche le message de maintenance.
SauvegardeTelecharger une sauvegarde SQL.Fichier SQL telecharge sans erreur.

12. Sauvegarde et restauration

Sauvegarde recommandee

ElementFrequenceMéthode
Base MySQLQuotidienne ou hebdomadaireAdmin Backup, phpMyAdmin ou sauvegarde cPanel.
Dossier uploadsHebdomadairecPanel ou FTP.
Dossier complet du siteAvant chaque grande modificationArchive ZIP via cPanel.
Fichier configurationApres chaque changementCopie securisee hors hebergement.

Restauration

  1. Mettre le site en mode maintenance si possible.
  2. Restaurer les fichiers du site.
  3. Restaurer le dossier kbcsalgestion/uploads.
  4. Restaurer la base via phpMyAdmin.
  5. Verifier config.production.php.
  6. Tester connexion, devis, facture, QR code et uploads.

13. Depannage rapide

ProblemeCause probableSolution
Page blancheErreur PHP ou mauvaise version PHPVerifier la version PHP, activer temporairement les logs, consulter les erreurs cPanel.
Connexion impossible a la baseIdentifiants MySQL incorrectsVerifier $DB_NAME, $DB_USER, $DB_PASS dans config.production.php.
Formulaire devis ne s'enregistre pasAPI inaccessible ou base non importeeTester /kbcsalgestion/api/submit_quote.php et verifier les tables.
Images non visiblesChemin ou permission uploadsVerifier kbcsalgestion/uploads et les chemins en base.
QR code invalide$APP_BASE_URL ou cle modifiee apres validationVerifier l'URL publique et conserver la meme cle de verification.
Email non recuSMTP non configure ou email bloqueConfigurer SMTP, tester la boite d'envoi, verifier spam.
Erreur 403.htaccess ou permissionVerifier les droits du dossier et les regles Apache.
Upload refuseFichier trop lourd ou type interditReduire le fichier ou augmenter upload_max_filesize dans cPanel.

14. PV de recette technique

Avant d'ouvrir le systeme aux utilisateurs, cocher les points suivants.

ControleStatutObservation
Site public accessible en HTTPSOK / Non
Back-office accessible via /kbcsalgestion/admin/login.phpOK / Non
Base MySQL importeeOK / Non
Connexion admin testeeOK / Non
Mot de passe admin changeOK / Non
Compte utilisateur test creeOK / Non
Formulaire devis public testeOK / Non
Facture avec QR code testeeOK / Non
Messagerie avec pieces jointes testeeOK / Non
Uploads produits, RH et profil testesOK / Non
Mode maintenance testeOK / Non
Sauvegarde SQL telechargeeOK / Non
Si tous les controles sont OK, le systeme peut etre ouvert progressivement aux utilisateurs internes.