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 :
Date : 1er juin 2026
Usage : installation, controle technique, maintenance et transfert vers production.
Dossier admin :
kbcsalgestionDate : 1er juin 2026
Usage : installation, controle technique, maintenance et transfert vers production.
Sommaire
- Architecture du systeme
- Prerequis o2switch
- Preparation avant transfert
- Transfert des fichiers
- Creation et importation de la base MySQL
- Configuration production
- Domaine, SSL et HTTPS
- Emails et notifications
- Dossiers uploads et permissions
- Sécurité du back-office
- Tests fonctionnels apres mise en ligne
- Sauvegarde et restauration
- Depannage rapide
- PV de recette technique
1. Architecture du systeme
| Partie | Chemin | Role |
|---|---|---|
| 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 donnees | kbcsalgestion/database.sql | Structure MySQL du systeme. |
| Configuration | kbcsalgestion/config.production.php | Paramè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.
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.
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.
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.
Domaine principal ou sous-domaine deja pointe vers o2switch.
SSL
Certificat AutoSSL actif pour forcer l'acces en HTTPS.
Certificat AutoSSL actif pour forcer l'acces en HTTPS.
Client de transfert
Gestionnaire de fichiers cPanel ou FileZilla/FTP.
Gestionnaire de fichiers cPanel ou FileZilla/FTP.
3. Preparation avant transfert
- Verifier que le dossier local
K-BUSINESScontient bienindex.html,css,js,images,docsetkbcsalgestion. - Verifier que le dossier
kbcsalgestioncontientadmin,api,uploads,config.php,config.production.example.php,database.sql. - Controler que le fichier
.htaccessprincipal existe a la racine du site. - Faire une copie de sauvegarde du dossier local avant toute mise en ligne.
- Preparer les informations MySQL fournies par o2switch : nom de base, utilisateur, mot de passe.
- 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
- Ouvrir cPanel puis Gestionnaire de fichiers.
- Entrer dans
public_htmlsi le domaine principal utilise ce dossier. - Envoyer le dossier complet
K-BUSINESS, ou envoyer directement son contenu danspublic_htmlselon l'organisation souhaitee. - Si le site doit etre accessible a la racine du domaine, les fichiers
index.html,css,js,imagesetkbcsalgestiondoivent se trouver directement dans le dossier public du domaine. - Verifier que les fichiers caches comme
.htaccesssont bien visibles et transferes.
Option B : FTP / FileZilla
- Creer ou utiliser un compte FTP dans cPanel.
- Se connecter avec FileZilla.
- Envoyer tous les fichiers dans le dossier public du domaine.
- 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
- Dans cPanel, ouvrir Bases de donnees MySQL.
- Creer une base, par exemple
cpaneluser_kbusiness. - Creer un utilisateur, par exemple
cpaneluser_kbuser. - Attribuer un mot de passe fort a l'utilisateur.
- Ajouter l'utilisateur a la base avec tous les privileges.
Importer les tables
- Ouvrir phpMyAdmin.
- Selectionner la base creee.
- Cliquer sur Importer.
- Choisir le fichier
kbcsalgestion/database.sql. - Lancer l'importation.
- 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
- Dans
kbcsalgestion, copierconfig.production.example.php. - Renommer la copie en
config.production.php. - 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;
| Parametre | Explication |
|---|---|
$APP_ENV | Mettre production pour masquer les erreurs techniques au public. |
$APP_BASE_URL | Adresse publique du dossier de gestion. Important pour les QR codes de verification. |
$DB_HOST | Generalement localhost chez o2switch. |
$DB_NAME | Nom complet de la base MySQL creee dans cPanel. |
$DB_USER | Nom complet de l'utilisateur MySQL. |
$DB_PASS | Mot de passe MySQL. |
$DOCUMENT_VERIFICATION_SECRET | Cle 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
- Dans cPanel, ouvrir SSL/TLS Status ou Let's Encrypt / AutoSSL.
- Verifier que le domaine est couvert par un certificat valide.
- Tester
https://votre-domaine.com. - Tester
https://votre-domaine.com/kbcsalgestion/admin/login.php. - 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.
| Mode | Avantage | Configuration |
|---|---|---|
| PHP mail simple | Rapide a tester | $SMTP_ENABLED = false; |
| SMTP o2switch | Plus fiable pour les notifications | Renseigner 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.
| Dossier | Contenu | Controle |
|---|---|---|
uploads/profiles | Photos de profil | Tester depuis Mon profil. |
uploads/messages | Pieces jointes messagerie | Envoyer une image et un PDF. |
uploads/document-items | Images de reference devis/factures | Ajouter une ligne avec image. |
uploads/shop | Images boutique | Ajouter un produit avec image. |
uploads/hr | Documents RH | Televerser un document employe. |
uploads/site | Images du site public gerees depuis l'admin | Publier 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
- Changer le mot de passe du compte administrateur general des la premiere connexion.
- Creer un compte personnel pour chaque employe.
- Ne jamais partager un meme compte entre plusieurs personnes.
- Attribuer uniquement les modules necessaires : devis, facturation, caisse, stock, RH.
- Bloquer les comptes des employes qui quittent l'entreprise.
- Verifier regulierement la page
kbcsalgestion/admin/security.php. - Verifier les traces dans
kbcsalgestion/admin/audit.php. - Conserver la cle de verification QR confidentielle.
- 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
| Test | Procedure | Resultat attendu |
|---|---|---|
| Site public | Ouvrir l'accueil, services, granite, contact. | Pages visibles, images chargees, responsive mobile. |
| Demande de devis | Soumettre le formulaire public. | Demande enregistree dans l'admin et notification envoyee. |
| Connexion admin | Aller sur /kbcsalgestion/admin/login.php. | Connexion reussie, tableau de bord affiche. |
| Creation utilisateur | Creer un compte test avec poste et acces limite. | Le compte se connecte uniquement aux modules autorises. |
| Messagerie | Envoyer un message avec image et PDF. | Le destinataire voit le message, telecharge les pieces jointes. |
| Devis | Creer un devis avec plusieurs lignes et une image de reference. | Le devis s'enregistre, se valide et s'imprime. |
| Facture | Creer une facture et imprimer. | QR code visible, montants corrects, pied de page entreprise present. |
| Verification QR | Scanner le QR code. | Page officielle de verification affichee. |
| Caisse | Ajouter entree et sortie. | Tableau caisse mensuel et graphique mis a jour. |
| Stock | Ajouter produit, mouvement entree/sortie. | Quantité et alerte stock correctes. |
| RH | Ajouter employe, document, absence ou conge. | Information visible dans le module RH. |
| Maintenance | Activer mode maintenance depuis admin. | Site public affiche le message de maintenance. |
| Sauvegarde | Telecharger une sauvegarde SQL. | Fichier SQL telecharge sans erreur. |
12. Sauvegarde et restauration
Sauvegarde recommandee
| Element | Frequence | Méthode |
|---|---|---|
| Base MySQL | Quotidienne ou hebdomadaire | Admin Backup, phpMyAdmin ou sauvegarde cPanel. |
Dossier uploads | Hebdomadaire | cPanel ou FTP. |
| Dossier complet du site | Avant chaque grande modification | Archive ZIP via cPanel. |
| Fichier configuration | Apres chaque changement | Copie securisee hors hebergement. |
Restauration
- Mettre le site en mode maintenance si possible.
- Restaurer les fichiers du site.
- Restaurer le dossier
kbcsalgestion/uploads. - Restaurer la base via phpMyAdmin.
- Verifier
config.production.php. - Tester connexion, devis, facture, QR code et uploads.
13. Depannage rapide
| Probleme | Cause probable | Solution |
|---|---|---|
| Page blanche | Erreur PHP ou mauvaise version PHP | Verifier la version PHP, activer temporairement les logs, consulter les erreurs cPanel. |
| Connexion impossible a la base | Identifiants MySQL incorrects | Verifier $DB_NAME, $DB_USER, $DB_PASS dans config.production.php. |
| Formulaire devis ne s'enregistre pas | API inaccessible ou base non importee | Tester /kbcsalgestion/api/submit_quote.php et verifier les tables. |
| Images non visibles | Chemin ou permission uploads | Verifier kbcsalgestion/uploads et les chemins en base. |
| QR code invalide | $APP_BASE_URL ou cle modifiee apres validation | Verifier l'URL publique et conserver la meme cle de verification. |
| Email non recu | SMTP non configure ou email bloque | Configurer SMTP, tester la boite d'envoi, verifier spam. |
| Erreur 403 | .htaccess ou permission | Verifier les droits du dossier et les regles Apache. |
| Upload refuse | Fichier trop lourd ou type interdit | Reduire 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.
| Controle | Statut | Observation |
|---|---|---|
| Site public accessible en HTTPS | OK / Non | |
Back-office accessible via /kbcsalgestion/admin/login.php | OK / Non | |
| Base MySQL importee | OK / Non | |
| Connexion admin testee | OK / Non | |
| Mot de passe admin change | OK / Non | |
| Compte utilisateur test cree | OK / Non | |
| Formulaire devis public teste | OK / Non | |
| Facture avec QR code testee | OK / Non | |
| Messagerie avec pieces jointes testee | OK / Non | |
| Uploads produits, RH et profil testes | OK / Non | |
| Mode maintenance teste | OK / Non | |
| Sauvegarde SQL telechargee | OK / Non |
Si tous les controles sont OK, le systeme peut etre ouvert progressivement aux utilisateurs internes.