# PMEPro — Guide d'installation sur cPanel (sans SSH/console)

Cette version est spécialement conçue pour fonctionner sans accès terminal. Tout se fait via le navigateur.

## Méthode A : Upload via File Manager (recommandée)

### 1. Préparation dans cPanel
- Connectez-vous à cPanel
- Allez dans **Bases de données MySQL**
- Créez une base de données (ex : `pmepro_db`) et un utilisateur
- Notez : nom de la base, nom d'utilisateur, mot de passe, hôte (souvent `localhost` ou `127.0.0.1`)

### 2. Upload du projet
- Allez dans **File Manager**
- Naviguez vers `public_html/` (ou le dossier de votre sous-domaine)
- **Upload** le fichier `pmepro.zip` (archive livrée)
- Cliquez sur le zip → **Extract** (extraire)
- Vérifiez que le dossier `public/` du projet est bien présent. Si nécessaire, déplacez le contenu de `public/` à la racine du dossier du site (ou configurez le Document Root dans cPanel)

### 3. Configuration via navigateur
- Dans votre navigateur, accédez à :
  `https://votresite.com/install.php`
- Suivez les étapes :
  - Vérification système (PHP 8.1+, pdo_mysql, mbstring)
  - Saisie des informations de la base de données MySQL
  - Génération automatique du `.env`

### 4. Finalisation
Après l'installation web, le script vous indiquera de finaliser. Comme il n'y a pas de console, deux options :

**Option 1 — Si votre hébergeur propose un "Terminal" dans cPanel :**
```
cd ~/public_html
php artisan migrate --force --seed
```

**Option 2 — Si le dossier `vendor/` est inclus dans l'archive :**
Le script `install.php` exécute automatiquement les migrations. Vérifiez que le dossier `vendor/` existe dans le File Manager. Si non, téléchargez le package complet avec `vendor/` inclus (disponible sur demande).

### 5. Sécurité
Après installation réussie :
- **Supprimez** le fichier `public/install.php` via le File Manager
- Vérifiez que `.env` est bien créé et que ses permissions sont sécurisées (`chmod 640` ou `600`)

## Méthode B : Si le projet est déjà sur le serveur (sans zip)

1. Uploadez tous les fichiers (y compris `vendor/`) via File Manager
2. Copiez `.env.example` vers `.env` et modifiez manuellement dans le File Manager (clic droit → Edit)
3. Modifiez ces lignes dans `.env` :
```
DB_HOST=localhost
DB_DATABASE=votre_base
DB_USERNAME=votre_utilisateur
DB_PASSWORD=votre_mot_de_passe
APP_URL=https://votresite.com
APP_KEY=base64:... (générez via un outil en ligne ou laissez vide au début)
```
4. Accédez au site directement

## Notes importantes pour cPanel

| Problème courant | Solution |
|---|---|
| **Erreur "PHP version"** | Dans cPanel → **Select PHP Version** → choisissez PHP 8.1 ou supérieur |
| **Erreur "Class not found"** | Assurez-vous que le dossier `vendor/` est présent. Sans SSH, utilisez le package complet avec `vendor/` |
| **Page blanche** | Vérifiez que `.env` existe et que `APP_DEBUG=true` temporairement pour voir l'erreur |
| **Images non chargées** | Vérifiez que le Document Root pointe vers le dossier `public/` du projet Laravel |
| **Permissions** | Les dossiers `storage/` et `bootstrap/cache/` doivent être en `755` et leurs fichiers en `644` |

## Vérification rapide après installation

- Site vitrine : `https://votresite.com/`
- Connexion : `https://votresite.com/login`
- Dashboard : `https://votresite.com/dashboard`
- Utilisateur test : `admin@pmepro.demo` / `password`

---
*Ce guide est conçu pour fonctionner entièrement sans accès SSH. Si vous rencontrez un blocage, vérifiez d'abord la présence du dossier `vendor/` et la version PHP dans cPanel.*