Aller au contenu principal

Guide de Démarrage Rapide

Lancez FeedbackPulse SaaS en 15 minutes. Voici la version express — pour des instructions détaillées, consultez le Guide d'installation complet.

Avant de commencer​

Assurez-vous d'avoir :

  • Un serveur ou VPS (Ubuntu 22.04+ recommandé)
  • PHP 8.4 ou supérieur
  • MySQL 8.0+ ou MariaDB 10.6+
  • Serveur web Apache ou Nginx
  • Un nom de domaine pointant vers votre serveur
  • Un compte e-mail SMTP (Gmail, Mailgun, etc.)

Étape 1 : Téléverser les fichiers​

Téléversez les fichiers FeedbackPulse SaaS dans le répertoire web de votre serveur :

# Exemple pour un VPS standard
cd /var/www
unzip feedbackpulse-saas.zip
cd feedbackpulse-saas

Étape 2 : Définir les permissions​

# Le stockage et le cache doivent être accessibles en écriture
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

Étape 3 : Pointer votre serveur web​

Votre serveur web doit pointer vers le répertoire public — c'est crucial !

Apache — Créez un hôte virtuel :

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /var/www/feedbackpulse-saas/public

    <Directory /var/www/feedbackpulse-saas/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Nginx — Créez un bloc serveur :

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/feedbackpulse-saas/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Crucial : La racine web doit être le dossier public, PAS la racine du projet. C'est une exigence de sécurité Laravel.

Étape 4 : Lancer l'installateur web​

Ouvrez votre navigateur et accédez à :

https://yourdomain.com/install

L'installateur vous guidera à travers 5 étapes :

  1. Licence — Saisissez votre code d'achat Envato (ou ignorez si vous n'utilisez pas Envato)
  2. Prérequis — Vérification automatique de la version PHP, des extensions et des permissions
  3. Base de données — Saisissez vos identifiants MySQL/MariaDB
  4. Administrateur — Créez votre compte super-administrateur
  5. E-mail — Configurez les paramètres SMTP

Astuce : Préparez vos identifiants de base de données et vos informations SMTP avant de lancer l'installateur.

Étape 5 : Configurer la tâche cron​

FeedbackPulse a besoin d'une tâche cron pour exécuter les tâches planifiées (résumés par e-mail, expiration des essais, conservation des données, etc.).

Sur VPS / Dédié :

crontab -e

Ajoutez cette ligne :

* * * * * cd /var/www/feedbackpulse-saas && php artisan schedule:run >> /dev/null 2>&1

Sur hébergement partagé (cron basé sur URL) :

Utilisez l'endpoint cron web avec le CRON_TOKEN affiché sur la page de finalisation de l'installateur :

wget -q -O /dev/null "https://yourdomain.com/cron/run?token=YOUR_CRON_TOKEN"

La page de finalisation de l'installateur affiche les deux options pré-remplies. Copiez-les simplement !

Étape 6 : Créer le lien symbolique de stockage​

Cela rend les fichiers téléversés (logos, photos) accessibles depuis le web :

php artisan storage:link

Hébergement partagé ? Si les liens symboliques ne sont pas pris en charge, ignorez cette étape. FeedbackPulse sert automatiquement les fichiers via une route de fallback PHP intégrée.

Étape 7 : Vérifier que ça fonctionne​

  1. Visitez https://yourdomain.com — vous devriez voir la page d'accueil
  2. Visitez https://yourdomain.com/login — connectez-vous avec vos identifiants super-administrateur
  3. Vous êtes dans le Panneau Super-Admin !

Que faire ensuite​

Maintenant que vous êtes installé, voici votre liste de vérification rapide :

En tant que Super-Admin :​

  1. Allez dans Admin → Plans — consultez les plans d'abonnement par défaut
  2. Allez dans Admin → Paramètres — configurez les passerelles de paiement (Stripe/PayPal)
  3. Allez dans Admin → Page d'accueil — personnalisez votre page d'accueil publique
  4. Allez dans Admin → Paramètres → E-mail — envoyez un e-mail de test pour vérifier SMTP

Créez votre premier locataire :​

  1. Ouvrez une nouvelle fenêtre de navigation privée/incognito
  2. Visitez https://yourdomain.com/register
  3. Remplissez le formulaire d'inscription (nom, e-mail, entreprise, sous-domaine)
  4. Vérifiez votre e-mail
  5. Connectez-vous — vous êtes maintenant dans le Tableau de bord locataire

Configurez votre premier produit et campagne :​

  1. Allez dans Produits → Créer — ajoutez votre premier produit
  2. Allez dans Campagnes → Créer — créez une campagne de retours pour ce produit
  3. Allez dans Paramètres → Image de marque — définissez vos couleurs et logo
  4. Visitez vos pages publiques :
    • https://yourdomain.com/p/{your-tenant-slug} — Hub Produit
    • https://yourdomain.com/wall/{your-tenant-slug} — Mur de retours
    • https://yourdomain.com/feedback/{campaign-slug} — Formulaire de retours
    • https://yourdomain.com/roadmap/{your-tenant-slug} — Feuille de route
    • https://yourdomain.com/changelog/{your-tenant-slug} — Journal des modifications

Vous êtes en ligne !​

Félicitations ! FeedbackPulse SaaS fonctionne maintenant sur votre serveur. Consultez les sections de documentation détaillées pour découvrir toutes les fonctionnalités :