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 :
Version du document : 03 juin 2026
Public : administrateur général, technicien de mise en ligne, support informatique.
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
| Partie | Chemin | Rô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.sql | Structure MySQL complète du système. |
| Configuration | /kbcsalgestion/config.php | Paramè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.
Accès complet au compte o2switch.
Domaine
Domaine ou sous-domaine pointé vers l'hébergement.
Domaine ou sous-domaine pointé vers l'hébergement.
PHP
PHP 8.1 ou plus recommandé.
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.
Une base dédiée et un utilisateur MySQL avec tous les privilèges.
Emails
Adresses professionnelles : centrale achat, direction, comptabilité.
Adresses professionnelles : centrale achat, direction, comptabilité.
3. Préparation locale avant transfert
- Faire une copie complète du dossier local
K-BUSINESS. - Vérifier la présence de
index.html,css,js,images,docsetkbcsalgestion. - Vérifier que
kbcsalgestion/database.sqlest présent. - Vérifier que les dossiers
kbcsalgestion/uploadsetkbcsalgestion/uploads/siteexistent. - 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
- Dans cPanel, ouvrir Bases de données MySQL.
- Créer une base, par exemple
cpaneluser_kbcsal. - Créer un utilisateur MySQL avec un mot de passe fort.
- Associer l'utilisateur à la base avec tous les privilèges.
- Ouvrir phpMyAdmin, sélectionner la base, cliquer sur Importer.
- Importer le fichier
kbcsalgestion/database.sql. - Contrôler que les tables
users,requests,documents,cash_entries,site_media,shop_productsetinternal_messagesexistent.
5. Transfert des fichiers
Option recommandée : gestionnaire de fichiers cPanel
- Compresser le dossier
K-BUSINESSen fichier ZIP. - Envoyer le ZIP dans
public_htmlou le dossier du sous-domaine. - Extraire le ZIP.
- Si le contenu est dans un sous-dossier
K-BUSINESS, déplacer son contenu à la racine du domaine si nécessaire. - Vérifier que les fichiers cachés
.htaccesssont bien présents.
Permissions conseillées
| Élément | Permission | Commentaire |
|---|---|---|
| Dossiers | 755 | Lecture/exécution par le serveur. |
| Fichiers | 644 | Lecture par le serveur. |
kbcsalgestion/uploads | 755 ou 775 | Doit permettre les téléversements. |
6. Configuration production
- Ouvrir
kbcsalgestion/config.phpsur l'hébergement. - Remplacer les paramètres locaux par les informations MySQL o2switch.
- Renseigner l'URL de production dans la variable d'URL de base si elle existe.
- Mettre la clé
$DOCUMENT_VERIFICATION_SECRETavec votre valeur privée. - 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
- Changer le mot de passe de l'administrateur général dès la première connexion.
- Créer un compte par employé, ne pas partager les comptes.
- Attribuer uniquement les modules nécessaires : devis, facturation, caisse, stock, RH, boutique, archive, carrière, site.
- Bloquer les comptes des utilisateurs sortants au lieu de supprimer l'historique.
- Utiliser des mots de passe forts et renouvelés régulièrement.
- Conserver les journaux d'activité pour suivre les validations, modifications et suppressions autorisées.
- Activer HTTPS avec AutoSSL et forcer l'accès sécurisé.
8. Emails, WhatsApp et notifications
| Fonction | À vérifier |
|---|---|
| Demandes de devis | Les notifications arrivent à l'adresse commerciale configurée. |
| WhatsApp public | Le numéro est modifiable depuis l'administration, dans la gestion des prix ou paramètres commerciaux. |
| Boutique publique | Les réservations peuvent être enregistrées et/ou envoyées via WhatsApp. |
| Réponse admin WhatsApp | Le bouton ouvre une conversation avec le client et un message prérempli. |
| Documents QR | Le lien de vérification doit pointer vers le domaine réel en HTTPS. |
9. Tests fonctionnels après mise en ligne
- Ouvrir la page d'accueil et vérifier les images, menus, boutique, contact et devis.
- Tester le sélecteur de langue Google Traduction.
- Envoyer une demande de devis depuis le site public.
- Créer une commande de réservation depuis la boutique publique.
- Se connecter à l'administration.
- Créer un utilisateur, lui attribuer un module, puis tester sa connexion.
- Créer un devis avec plusieurs lignes et une image de référence.
- Valider le devis et vérifier que la modification devient limitée.
- Créer une facture, un proforma, un bon de commande et un bon de livraison.
- Imprimer un document et scanner le QR code de vérification.
- Tester caisse, stock, RH, archive, carrière et boutique.
- Modifier une image dans Gestion du site public > Médias du site et vérifier le changement sur le site.
- Activer le mode maintenance, contrôler le site public, puis désactiver.
10. Maintenance et sauvegardes
Sauvegarde régulière
- Exporter la base MySQL depuis phpMyAdmin au moins une fois par semaine.
- Télécharger le dossier
kbcsalgestion/uploadsau moins une fois par semaine. - Conserver une copie hors hébergement : disque externe ou stockage sécurisé.
Mises à jour de contenu
- Utiliser Gestion du site public pour modifier textes, publications, sections, liens rapides, images et mode maintenance.
- Utiliser Prix pour gérer dynamiquement les articles et tarifs affichés.
- Utiliser Boutique pour publier les produits actifs sur le site public.
11. Dépannage rapide
| Problème | Cause probable | Solution |
|---|---|---|
| Page blanche | Erreur PHP ou configuration incorrecte | Vérifier config.php, activer temporairement l'affichage d'erreurs ou consulter les logs o2switch. |
| Connexion admin impossible | Base non importée ou mauvais identifiants MySQL | Vérifier les informations DB et la table users. |
| Upload impossible | Permission dossier ou taille fichier | Vérifier uploads, taille PHP upload_max_filesize et post_max_size. |
| QR code invalide | URL ou clé de vérification changée | Contrôler APP_BASE_URL et DOCUMENT_VERIFICATION_SECRET. |
| Email non reçu | Fonction mail bloquée ou mauvaise adresse | Tester avec une adresse du domaine ou configurer SMTP. |
| Images non mises à jour | Cache navigateur ou média désactivé | Vider le cache et vérifier Médias du site dans l'admin. |