Fiche technique

Mise en ligne du site public et du système KBCSAL

Procédure complète pour publier K-BUSINESS / Kouroussa Business Center Supply & Logistics SARLU sur un hébergement o2switch avec PHP, MySQL, SSL, back-office, documents QR code et gestion des contenus.

Projet : Kouroussa Business Center Supply & Logistics SARLU (KBCSAL)
Back-office : /kbcsalgestion/admin/
Version du document : 03 juin 2026
Public : administrateur général, technicien de mise en ligne, support informatique.

Sommaire

  1. Architecture du projet
  2. Prérequis o2switch
  3. Préparation locale
  4. Création et importation MySQL
  5. Transfert des fichiers
  6. Configuration production
  7. Sécurité et accès
  8. Emails, WhatsApp et notifications
  9. Tests après mise en ligne
  10. Maintenance et sauvegardes
  11. Dépannage rapide

1. Architecture du projet

PartieCheminRôle
Site public/Pages publiques : accueil, à propos, services, granite, boutique, leadership, partenaires, devis, contact.
Back-office/kbcsalgestion/admin/Connexion, tableau de bord, utilisateurs, devis, facturation, caisse, stock, RH, boutique, archives, carrière, site public.
API publique/kbcsalgestion/api/Demandes clients, boutique publique, FAQ locale, contenus dynamiques, prix et médias du site.
Uploads/kbcsalgestion/uploads/Images, pièces jointes, photos de profil, documents RH, archives scannées, médias du site.
Base de données/kbcsalgestion/database.sqlStructure MySQL complète du système.
Configuration/kbcsalgestion/config.phpParamètres de connexion, URL, email, WhatsApp et clé de vérification QR.
Après mise en ligne, le lien d'administration sera du type : https://votre-domaine.com/kbcsalgestion/admin/.

2. Prérequis o2switch

cPanel
Accès complet au compte o2switch.
Domaine
Domaine ou sous-domaine pointé vers l'hébergement.
PHP
PHP 8.1 ou plus recommandé.
Extensions PHP
pdo_mysql, fileinfo, mbstring, openssl, gd.
MySQL/MariaDB
Une base dédiée et un utilisateur MySQL avec tous les privilèges.
Emails
Adresses professionnelles : centrale achat, direction, comptabilité.

3. Préparation locale avant transfert

  1. Faire une copie complète du dossier local K-BUSINESS.
  2. Vérifier la présence de index.html, css, js, images, docs et kbcsalgestion.
  3. Vérifier que kbcsalgestion/database.sql est présent.
  4. Vérifier que les dossiers kbcsalgestion/uploads et kbcsalgestion/uploads/site existent.
  5. Noter le lien public souhaité : domaine principal ou sous-domaine.
Ne publiez pas les identifiants temporaires dans un document public. Après la première connexion, changez immédiatement les mots de passe.

4. Création et importation MySQL

  1. Dans cPanel, ouvrir Bases de données MySQL.
  2. Créer une base, par exemple cpaneluser_kbcsal.
  3. Créer un utilisateur MySQL avec un mot de passe fort.
  4. Associer l'utilisateur à la base avec tous les privilèges.
  5. Ouvrir phpMyAdmin, sélectionner la base, cliquer sur Importer.
  6. Importer le fichier kbcsalgestion/database.sql.
  7. Contrôler que les tables users, requests, documents, cash_entries, site_media, shop_products et internal_messages existent.

5. Transfert des fichiers

Option recommandée : gestionnaire de fichiers cPanel

  1. Compresser le dossier K-BUSINESS en fichier ZIP.
  2. Envoyer le ZIP dans public_html ou le dossier du sous-domaine.
  3. Extraire le ZIP.
  4. Si le contenu est dans un sous-dossier K-BUSINESS, déplacer son contenu à la racine du domaine si nécessaire.
  5. Vérifier que les fichiers cachés .htaccess sont bien présents.

Permissions conseillées

ÉlémentPermissionCommentaire
Dossiers755Lecture/exécution par le serveur.
Fichiers644Lecture par le serveur.
kbcsalgestion/uploads755 ou 775Doit permettre les téléversements.

6. Configuration production

  1. Ouvrir kbcsalgestion/config.php sur l'hébergement.
  2. Remplacer les paramètres locaux par les informations MySQL o2switch.
  3. Renseigner l'URL de production dans la variable d'URL de base si elle existe.
  4. Mettre la clé $DOCUMENT_VERIFICATION_SECRET avec votre valeur privée.
  5. Vérifier le numéro WhatsApp, les emails de réception et les paramètres SMTP si utilisés.
Exemple à adapter :
DB_HOST = localhost
DB_NAME = cpaneluser_kbcsal
DB_USER = cpaneluser_user
DB_PASS = mot_de_passe_fort
APP_BASE_URL = https://votre-domaine.com/kbcsalgestion
DOCUMENT_VERIFICATION_SECRET = valeur_privee_longue_et_confidentielle
La clé de vérification QR doit rester privée. Elle sert à empêcher la falsification des factures, devis, proformas, bons et écritures de caisse imprimés.

7. Sécurité et accès

  1. Changer le mot de passe de l'administrateur général dès la première connexion.
  2. Créer un compte par employé, ne pas partager les comptes.
  3. Attribuer uniquement les modules nécessaires : devis, facturation, caisse, stock, RH, boutique, archive, carrière, site.
  4. Bloquer les comptes des utilisateurs sortants au lieu de supprimer l'historique.
  5. Utiliser des mots de passe forts et renouvelés régulièrement.
  6. Conserver les journaux d'activité pour suivre les validations, modifications et suppressions autorisées.
  7. Activer HTTPS avec AutoSSL et forcer l'accès sécurisé.

8. Emails, WhatsApp et notifications

FonctionÀ vérifier
Demandes de devisLes notifications arrivent à l'adresse commerciale configurée.
WhatsApp publicLe numéro est modifiable depuis l'administration, dans la gestion des prix ou paramètres commerciaux.
Boutique publiqueLes réservations peuvent être enregistrées et/ou envoyées via WhatsApp.
Réponse admin WhatsAppLe bouton ouvre une conversation avec le client et un message prérempli.
Documents QRLe lien de vérification doit pointer vers le domaine réel en HTTPS.

9. Tests fonctionnels après mise en ligne

  1. Ouvrir la page d'accueil et vérifier les images, menus, boutique, contact et devis.
  2. Tester le sélecteur de langue Google Traduction.
  3. Envoyer une demande de devis depuis le site public.
  4. Créer une commande de réservation depuis la boutique publique.
  5. Se connecter à l'administration.
  6. Créer un utilisateur, lui attribuer un module, puis tester sa connexion.
  7. Créer un devis avec plusieurs lignes et une image de référence.
  8. Valider le devis et vérifier que la modification devient limitée.
  9. Créer une facture, un proforma, un bon de commande et un bon de livraison.
  10. Imprimer un document et scanner le QR code de vérification.
  11. Tester caisse, stock, RH, archive, carrière et boutique.
  12. Modifier une image dans Gestion du site public > Médias du site et vérifier le changement sur le site.
  13. Activer le mode maintenance, contrôler le site public, puis désactiver.

10. Maintenance et sauvegardes

Sauvegarde régulière

Mises à jour de contenu

11. Dépannage rapide

ProblèmeCause probableSolution
Page blancheErreur PHP ou configuration incorrecteVérifier config.php, activer temporairement l'affichage d'erreurs ou consulter les logs o2switch.
Connexion admin impossibleBase non importée ou mauvais identifiants MySQLVérifier les informations DB et la table users.
Upload impossiblePermission dossier ou taille fichierVérifier uploads, taille PHP upload_max_filesize et post_max_size.
QR code invalideURL ou clé de vérification changéeContrôler APP_BASE_URL et DOCUMENT_VERIFICATION_SECRET.
Email non reçuFonction mail bloquée ou mauvaise adresseTester avec une adresse du domaine ou configurer SMTP.
Images non mises à jourCache navigateur ou média désactivéVider le cache et vérifier Médias du site dans l'admin.