==================================================================
 BHL ATELIERPRO — GUIDE DE DÉPLOIEMENT (cPanel)
 دليل التنصيب على الاستضافة (cPanel)
==================================================================


==================  FRANÇAIS  ====================================

1) PRÉREQUIS
   - PHP 8.2 ou supérieur (extensions : intl, gd, pdo_mysql, mbstring, zip, fileinfo, openssl, curl)
   - Base de données MySQL
   - Composer

2) INSTALLATION (Upload & Extraction)
   - Connectez-vous à cPanel > Gestionnaire de fichiers.
   - Téléversez "bhl-gestion.zip" dans votre dossier personnel
     (ex. /home/UTILISATEUR/bhlgestion), PAS directement dans public_html.
   - Clic droit > Extraire.

3) RACINE DU DOCUMENT (Document Root)
   - cPanel > Domaines : faites pointer le domaine bhlgestion.com vers :
        .../bhlgestion/public
   - (Laravel se sert UNIQUEMENT du dossier /public comme racine web.)

4) BASE DE DONNÉES (.env)
   - cPanel > Bases de données MySQL : créez une base + un utilisateur,
     et associez l'utilisateur à la base (tous privilèges).
   - Modifiez le fichier ".env" à la racine du projet :
        APP_ENV=production
        APP_DEBUG=false
        APP_URL=https://bhlgestion.com
        DB_CONNECTION=mysql
        DB_HOST=localhost
        DB_PORT=3306
        DB_DATABASE=nom_de_la_base
        DB_USERNAME=utilisateur_mysql
        DB_PASSWORD=mot_de_passe
   - (Si APP_KEY est vide : exécutez  php artisan key:generate)

5) COMMANDES (cPanel > Terminal, dans le dossier du projet)
        composer install --no-dev --optimize-autoloader
        php artisan migrate --seed
        php artisan storage:link
        php artisan make:filament-user      (créer le compte administrateur)
        php artisan config:cache
        php artisan route:cache

6) PERMISSIONS DES FICHIERS
        chmod -R 775 storage bootstrap/cache
   (Ces dossiers doivent être accessibles en écriture par le serveur.)

7) TÂCHE CRON (Alertes d'échéance — chaque minute)
   - cPanel > Tâches Cron (Cron Jobs), ajoutez :
        * * * * * php /home/UTILISATEUR/bhlgestion/artisan schedule:run >> /dev/null 2>&1

   => Ouvrez ensuite https://bhlgestion.com et connectez-vous.
      Le sélecteur de langue (FR / العربية) se trouve en haut de la barre latérale.


==================  العربية  =====================================

١) المتطلبات
   - PHP الإصدار 8.2 أو أحدث (الإضافات: intl, gd, pdo_mysql, mbstring, zip, fileinfo, openssl, curl)
   - قاعدة بيانات MySQL
   - Composer

٢) التنصيب (الرفع وفك الضغط)
   - ادخل إلى cPanel < مدير الملفات (File Manager).
   - ارفع الملف "bhl-gestion.zip" إلى مجلدك الرئيسي
     (مثال: /home/USER/bhlgestion)، وليس مباشرة داخل public_html.
   - زر الفأرة الأيمن < فك الضغط (Extract).

٣) جذر المستند (Document Root)
   - cPanel < النطاقات (Domains): اجعل النطاق bhlgestion.com يشير إلى:
        .../bhlgestion/public
   - (لارافيل يستخدم مجلد /public فقط كجذر للموقع.)

٤) قاعدة البيانات (ملف .env)
   - cPanel < قواعد بيانات MySQL: أنشئ قاعدة بيانات ومستخدمًا،
     واربط المستخدم بالقاعدة مع كل الصلاحيات.
   - عدّل الملف ".env" في جذر المشروع:
        APP_ENV=production
        APP_DEBUG=false
        APP_URL=https://bhlgestion.com
        DB_CONNECTION=mysql
        DB_HOST=localhost
        DB_PORT=3306
        DB_DATABASE=اسم_القاعدة
        DB_USERNAME=مستخدم_mysql
        DB_PASSWORD=كلمة_المرور
   - (إذا كان APP_KEY فارغًا، نفّذ:  php artisan key:generate)

٥) الأوامر (cPanel < Terminal داخل مجلد المشروع)
        composer install --no-dev --optimize-autoloader
        php artisan migrate --seed
        php artisan storage:link
        php artisan make:filament-user      (إنشاء حساب المدير)
        php artisan config:cache
        php artisan route:cache

٦) صلاحيات الملفات
        chmod -R 775 storage bootstrap/cache
   (يجب أن يكون هذان المجلدان قابلين للكتابة من طرف الخادم.)

٧) مهمة Cron (تنبيهات الاستحقاق — كل دقيقة)
   - cPanel < المهام المجدولة (Cron Jobs)، أضف:
        * * * * * php /home/USER/bhlgestion/artisan schedule:run >> /dev/null 2>&1

   => بعد ذلك افتح https://bhlgestion.com وسجّل الدخول.
      مُبدّل اللغة (FR / العربية) يوجد أعلى الشريط الجانبي.

==================================================================
 BHL AtelierPro  —  بن حمة لحسن  /  B-H
==================================================================