Documentation Administrateurs & Développeurs

Exigences du Serveur

Manu Pro est basé sur le framework Laravel et nécessite un environnement serveur spécifique. Assurez-vous que votre serveur répond aux exigences suivantes pour garantir une performance et une stabilité optimales :

• PHP >= 8.0.2
• Extension PHP BCMath
• Extension PHP Ctype
• Extension PHP Fileinfo
• Extension PHP JSON
• Extension PHP Mbstring
• Extension PHP OpenSSL
• Extension PHP PDO
• Extension PHP XML

Note : La plupart des fournisseurs d'hébergement populaires satisfont ces exigences par défaut. En cas de problème, notre équipe de support est disponible pour vous assister.

Processus d'Installation

L'installation de Manu Pro est conçue pour être aussi simple que possible, similaire à d'autres systèmes basés sur PHP et Laravel. Suivez ce guide pas à pas pour un déploiement réussi sur votre serveur.

Note : Ce guide est orienté vers une installation sur Cpanel (hébergement mutualisé). Si vous préférez un serveur cloud, FileZilla, ou toute autre méthode, veuillez contacter notre support pour une assistance personnalisée.

1

Préparation des fichiers source

Décompressez le code source téléchargé. Vous trouverez un dossier nommé "Manu Pro-v4.0.1" contenant le fichier `Manu Pro.zip`. Ce fichier contient l'ensemble de l'application.

2

Téléchargement sur le serveur

Uploadez le contenu du fichier `Manu Pro.zip` (après l'avoir décompressé) vers le répertoire racine de votre projet sur votre serveur web (par exemple, `public_html` pour Cpanel).

3

Configuration de la base de données

Créez une nouvelle base de données MySQL et un utilisateur pour cette base de données via votre panneau de contrôle d'hébergement (Cpanel, Plesk, etc.). Notez bien les identifiants (nom de la base de données, nom d'utilisateur, mot de passe).

4

Configuration de l'environnement (.env)

Dans le répertoire racine de votre projet, renommez le fichier `.env.example` en `.env`. Ouvrez ce fichier et mettez à jour les informations de connexion à la base de données avec celles que vous avez créées à l'étape précédente.

DB_DATABASE=votre_nom_de_bdd
DB_USERNAME=votre_utilisateur_bdd
DB_PASSWORD=votre_mot_de_passe_bdd

5

Exécution des migrations et seeders

Accédez à votre serveur via SSH (ou utilisez l'outil "Terminal" de votre Cpanel) et naviguez jusqu'au répertoire racine de votre projet. Exécutez les commandes suivantes pour créer les tables de la base de données et les données initiales :

php artisan migrate --seed

6

Génération de la clé d'application

Toujours via SSH dans le répertoire de votre projet, exécutez la commande suivante pour générer une clé d'application unique :

php artisan key:generate

7

Configuration des permissions de dossier

Assurez-vous que les dossiers `storage` et `bootstrap/cache` ont les permissions d'écriture appropriées (généralement 775 ou 777, selon votre hébergeur). Cela permet à Laravel de stocker les fichiers de cache et de session.

8

Accès à l'application

Ouvrez votre navigateur web et accédez à l'URL de votre application (ex: `http://votredomaine.com` ou `http://votredomaine.com/manupro`). Vous devriez voir la page de connexion de Manu Pro. Utilisez les identifiants par défaut (souvent `admin@example.com` / `password` ou spécifiés dans la documentation du fichier `Manu Pro.zip`) pour votre première connexion.

Note importante : Si vous rencontrez des difficultés, notre équipe de support est disponible via notre portail pour vous assister personnellement. Votre satisfaction est notre priorité.

Processus de Mise à Jour

La mise à jour de Manu Pro est un processus simple qui préserve votre base de données. Suivez ces étapes pour une transition en douceur vers la dernière version.

1. Téléchargez le dernier code source depuis votre compte Envato.
2. **Sauvegardez** vos fichiers sources actuels (répertoire racine du projet) et votre base de données. **Ceci est une étape cruciale.**
3. Supprimez tous les fichiers et dossiers de votre répertoire de projet, **SAUF** le fichier `.env`, le dossier `storage`, et le dossier `images` (situé dans `public/images/`).
4. Téléchargez le nouveau code source dans le répertoire racine de votre projet et décompressez-le.
5. Restaurez le fichier `.env`, le dossier `storage`, et le dossier `images` à partir de votre sauvegarde dans le nouveau code source.
6. Connectez-vous à l'application, allez dans le menu "Mettre à jour l'application" (Update Application) depuis la barre latérale, et cliquez sur le bouton "Vérifier les mises à jour" (Check for Update). Le système se mettra à jour automatiquement.

En cas de problème pendant la mise à jour, n'hésitez pas à contacter notre équipe de support.

Paramètres Généraux (Technique)

Cette interface permet de définir les identifiants de l'entreprise et les préfixes des numéros de documents, éléments cruciaux pour l'intégrité des données.

Les champs marqués d'une étoile rouge sont obligatoires. Assurez-vous que les préfixes sont uniques et cohérents avec votre nomenclature interne.

Configuration E-mail & SMS

Configurez les paramètres SMTP pour l'envoi d'e-mails et intégrez votre compte Twilio pour les notifications SMS. Ces configurations sont vitales pour la communication automatisée de l'application.

Un test de connexion est disponible pour valider vos paramètres.

Gestion des Rôles et Permissions

Définissez des rôles personnalisés et attribuez des permissions granulaires pour chaque module et action. Cette fonctionnalité est essentielle pour la sécurité et la conformité des accès utilisateurs.

Chaque rôle peut être assigné à un ou plusieurs employés, contrôlant précisément ce qu'ils peuvent voir et faire dans l'application.

Gestion des Devises, Unités, Taux de Taxe et Marques

Ces configurations de base sont nécessaires pour la création des produits et la gestion des transactions financières.

• Devises : Créez et gérez les devises supportées, et définissez la devise par défaut.
• Unités : Définissez les unités de mesure pour vos produits (ex: pièce, kg, mètre).
• Taux de Taxe : Configurez les différents taux de taxe (TVA) applicables à vos produits et services.
• Marques : Gérez les marques de vos produits pour une meilleure organisation du catalogue.