Présentation de l'Installateur Web

FeedbackPulse SaaS comprend un magnifique installateur dans le navigateur. Aucune ligne de commande nécessaire (après le téléversement initial des fichiers et composer install).

Accéder à l'installateur

Naviguez vers :

https://yourdomain.com/install

L'installateur ne s'affiche pas ? Assurez-vous que :

Votre serveur web pointe vers le répertoire public/

Apache mod_rewrite est activé (ou Nginx a un try_files approprié)

Il n'y a PAS de fichier storage/installed.lock (ce fichier bloque l'installateur après la première installation)

Étape 1 : Accueil et licence

Le premier écran vous accueille et vous demande votre code d'achat Envato/CodeCanyon.

Où trouver votre code d'achat :

Connectez-vous à CodeCanyon
Allez dans Téléchargements → trouvez FeedbackPulse SaaS
Cliquez sur Télécharger → Certificat de licence et code d'achat
Le code d'achat ressemble à : a1b2c3d4-e5f6-7890-abcd-ef1234567890

Ce que cela fait :

Valide votre licence auprès de l'API Envato
Vérifie que vous disposez d'une copie légitime
Déverrouille la suite de l'installateur

Étape 2 : Vérification des prérequis

L'installateur analyse automatiquement votre serveur et vérifie :

Version PHP

PHP 8.4 ou supérieur est requis
Affiche votre version PHP actuelle

Dépendances Vendor

Vérifie que vendor/autoload.php existe (les dépendances Composer doivent être installées ou téléversées)

Extensions PHP

Les extensions suivantes sont vérifiées :

pdo_mysql — Connexion à la base de données
mbstring — Gestion des chaînes multi-octets
openssl — Chiffrement
tokenizer — Analyse du code
xml — Traitement XML
ctype — Validation des caractères
json — Traitement JSON
bcmath — Opérations mathématiques
fileinfo — Détection du type de fichier
curl — Appels API

Permissions des répertoires

storage/ — Doit être accessible en écriture
bootstrap/cache/ — Doit être accessible en écriture

Affichage des résultats

Coches vertes = prérequis satisfait
Croix rouges = prérequis NON satisfait (doit être corrigé avant de continuer)

Corriger les vérifications échouées :

# Installer les extensions PHP manquantes (Ubuntu)
sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-bcmath php8.4-curl php8.4-gd php8.4-zip

# Corriger les permissions
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache

# Redémarrer PHP
sudo systemctl restart php8.4-fpm

Étape 3 : Configuration de la base de données

Saisissez vos informations de connexion MySQL/MariaDB :

Champ	Exemple	Notes
Hôte de la base de données	`127.0.0.1`	Utilisez `127.0.0.1` plutôt que `localhost` pour plus de fiabilité
Port de la base de données	`3306`	Port MySQL par défaut
Nom de la base de données	`feedbackpulse`	Doit exister au préalable !
Nom d'utilisateur de la base de données	`feedbackpulse_user`	Avec tous les privilèges sur la base de données
Mot de passe de la base de données	`your_secure_password`	Le mot de passe de l'utilisateur

Avant cette étape

Vous devez d'abord créer la base de données :

-- Se connecter à MySQL
mysql -u root -p

-- Créer la base de données
CREATE DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Créer un utilisateur dédié (recommandé)
CREATE USER 'feedbackpulse_user'@'localhost' IDENTIFIED BY 'your_secure_password';
GRANT ALL PRIVILEGES ON feedbackpulse.* TO 'feedbackpulse_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Ce qui se passe lorsque vous cliquez sur "Configurer la base de données"

L'installateur teste la connexion
Enregistre vos identifiants de base de données dans le fichier .env
Exécute toutes les migrations de base de données (crée environ 30 tables)
Insère les données par défaut :
- 3 plans d'abonnement par défaut (Starter, Growth, Pro)
- Paramètres de plateforme par défaut
Affiche un message de succès

Remarque : Les drivers de session et de cache restent en file pendant l'installation pour la stabilité. Ils sont automatiquement basculés vers database à l'étape de finalisation.

Cette étape peut prendre 10 à 30 secondes selon votre serveur.

Étape 4 : Compte administrateur

Créez votre compte super-administrateur :

Champ	Exemple	Notes
Nom complet	Jean Dupont	Votre nom d'affichage
Adresse e-mail	[email protected]	Utilisée pour la connexion et les notifications
Mot de passe	(mot de passe fort)	Minimum 8 caractères. Utilisez un mot de passe robuste !
Confirmer le mot de passe	(doit correspondre)	Doit correspondre

Ce qui se passe

Crée votre compte utilisateur avec role = superadmin
C'est le seul compte super-administrateur créé automatiquement
Vous l'utiliserez pour vous connecter à /login et accéder à /admin/dashboard

Conseil de sécurité : Utilisez un mot de passe unique et robuste. Vous pourrez activer la double authentification (2FA) ultérieurement dans les Paramètres.

Étape 5 : Configuration des e-mails

Configurez SMTP pour l'envoi des e-mails transactionnels :

Champ	Exemple	Notes
Hôte SMTP	`smtp.gmail.com`	Serveur SMTP de votre fournisseur d'e-mail
Port SMTP	`587`	587 pour TLS, 465 pour SSL
Nom d'utilisateur SMTP	`[email protected]`	Généralement votre adresse e-mail
Mot de passe SMTP	`your_app_password`	Mot de passe spécifique à l'application recommandé
Chiffrement	`tls`	TLS (recommandé) ou SSL
Adresse d'expéditeur	`[email protected]`	L'adresse "De" sur les e-mails sortants
Nom d'expéditeur	`FeedbackPulse`	Le nom "De" sur les e-mails sortants

Fournisseurs SMTP courants

Fournisseur	Hôte	Port	Chiffrement	Notes
Gmail	`smtp.gmail.com`	587	TLS	Nécessite un mot de passe d'application (pas le mot de passe habituel)
Mailgun	`smtp.mailgun.org`	587	TLS	Idéal pour les e-mails transactionnels
Amazon SES	`email-smtp.{region}.amazonaws.com`	587	TLS	Économique à grande échelle
SendGrid	`smtp.sendgrid.net`	587	TLS	Utilisez `apikey` comme nom d'utilisateur
Postmark	`smtp.postmarkapp.com`	587	TLS	Meilleure délivrabilité
Mailtrap	`sandbox.smtp.mailtrap.io`	587	TLS	Pour les tests uniquement !

Impossible de configurer les e-mails maintenant ? Vous pouvez ignorer cette étape et la configurer ultérieurement dans Admin → Paramètres → E-mail. La plateforme fonctionnera sans e-mail, mais les invitations, les résumés et les réinitialisations de mot de passe ne fonctionneront pas.

Étape 6 : Installation terminée !

Vous verrez une page de succès avec :

Base de données configurée et migrée
Compte administrateur créé
E-mail configuré
Fichier installed.lock créé
Drivers de session et de cache basculés vers database
CRON_TOKEN généré automatiquement pour le cron web
Avis d'hébergement partagé (si le lien symbolique n'a pas pu être créé)

Instructions pour la tâche cron (affichées sur la page de finalisation)

La page de finalisation affiche deux options de configuration cron avec des commandes prêtes à copier-coller :

Commande CLI — pour les serveurs VPS/dédiés :

* * * * * cd /path/to/project && php artisan schedule:run >> /dev/null 2>&1

URL/wget — pour l'hébergement partagé (utilise le CRON_TOKEN généré automatiquement) :
```
wget -q -O /dev/null "https://yourdomain.com/cron/run?token=YOUR_CRON_TOKEN"
```

Sauvegardez ces informations ! Copiez la commande cron depuis la page de finalisation avant de naviguer ailleurs. Vous pouvez également retrouver votre CRON_TOKEN dans le fichier .env.

Le fichier `installed.lock`

L'installateur crée storage/installed.lock pour empêcher quiconque de relancer l'installateur. C'est une mesure de sécurité.

Pour relancer l'installateur (ex. : installation fraîche), supprimez ce fichier :
rm storage/installed.lock
Puis visitez à nouveau /install.

Liste de vérification post-installation

Après la fin de l'installation :

Configurer la tâche cron en utilisant les instructions affichées sur la page de finalisation (voir Tâches cron et workers de file d'attente)
Connectez-vous à https://yourdomain.com/login avec vos identifiants super-administrateur
Visitez Admin → Plans — consultez et personnalisez les plans d'abonnement
Visitez Admin → Paramètres → Paiements — connectez Stripe/PayPal
Visitez Admin → Paramètres → E-mail — envoyez un e-mail de test
Visitez Admin → Page d'accueil — personnalisez votre page d'accueil publique
Configurez SSL (voir Certificats SSL)
Configurez optionnellement le DNS générique (voir Configuration DNS Wildcard)

Étapes suivantes

Configuration Apache ou Configuration Nginx
Variables d'environnement — affiner votre .env
Tâches cron et workers de file d'attente — configurer les tâches automatisées

Accéder à l'installateur​

Étape 1 : Accueil et licence​

Étape 2 : Vérification des prérequis​

Version PHP​

Dépendances Vendor​

Extensions PHP​

Permissions des répertoires​

Affichage des résultats​

Étape 3 : Configuration de la base de données​

Avant cette étape​

Ce qui se passe lorsque vous cliquez sur "Configurer la base de données"​

Étape 4 : Compte administrateur​

Ce qui se passe​

Étape 5 : Configuration des e-mails​

Fournisseurs SMTP courants​

Étape 6 : Installation terminée !​

Instructions pour la tâche cron (affichées sur la page de finalisation)​

Le fichier installed.lock​

Liste de vérification post-installation​

Étapes suivantes​