Prise en main
De l'installation à la première facture en cinq étapes. Comptez 10 minutes pour un déploiement neuf.
1. Installer l'application
Integra est mono-tenant : un déploiement par entreprise, sur son propre hébergement (type Hostinger, VPS, serveur mutualisé PHP). L'installateur est le point de passage obligé — tant qu'il n'a pas tourné, l'application redirige vers lui.
Pré-requis serveur
| Composant | Minimum |
|---|---|
| PHP | 8.1+ avec extensions mb_* et pdo_mysql (vérifiées par l'installateur) |
| Base de données | MySQL 5.7+ / MariaDB 10.3+ (collation utf8mb4_unicode_ci) |
| Racine web | Pointée sur public/ (le reste du code reste hors racine) |
| Composer | Optionnel — un autoloader PSR-4 maison prend le relais en son absence |
Au choix : installation web ou CLI
- Pointer la racine web sur
public/. À défaut, le.htaccessracine réécrit automatiquement verspublic/. - Ouvrir l'installateur web à l'adresse
…/install.php. Le formulaire demande : identifiants base, nom de l'entreprise, compte administrateur global, langue, et modules à activer. Il teste la connexion, importe le schéma et écritconfig/config.php. - Ou en ligne de commande (voir bloc ci-dessous).
- Sécuriser : une fois installé, l'installateur se neutralise — supprimez
public/install.phpdu serveur.
# Installation CLI (arguments)
php public/install.php \
--db-name=erp --db-user=root \
--admin-email=admin@entreprise.fr --admin-pass=•••••• \
--lang=fr --modules=clients,invoices,quotes,stock2. Se connecter
Rendez-vous sur la page /login avec l'email et le mot de passe du compte administrateur créé à l'installation.
Écran de connexion — le branding (logo, fond) est personnalisable dans Paramètres.
Si la double authentification (2FA) est activée sur votre compte, un code à 6 chiffres (TOTP) vous sera demandé après le mot de passe. Voir Authentification.
3. Comprendre la navigation
L'interface se compose de trois zones constantes :
- Barre latérale (gauche)
- Les modules actifs, groupés en sections — Navigation, Interne, Administration. C'est exactement la structure des onglets de cette documentation.
- Barre supérieure
- Fil d'Ariane, recherche, bascule de thème clair / sombre, et menu compte (profil, déconnexion).
- Corps de page
- Le contenu du module : liste, formulaire ou éditeur. Les actions principales (Nouveau, Exporter…) sont en haut à droite.
Disposition générale : barre latérale des modules + corps de page.
4. Activer / désactiver des modules
Le système de modules est à deux niveaux (détaillé dans Concepts) :
- Catalogue — l'univers des modules que le code embarque (fixé par les développeurs).
- Actif — parmi le catalogue, ce qui est allumé pour votre entreprise. Réglable en direct, sans toucher au code.
- Ouvrez Paramètres → Modules (section Administration).
- Basculez l'interrupteur de chaque module. Un module éteint disparaît de la navigation et n'est plus instancié.
- Les modules core — Tableau de bord et Paramètres — ne peuvent pas être désactivés (sinon vous vous verrouilleriez dehors).
5. Créer votre première facture
- Renseignez l'entreprise — Paramètres → Identité (raison sociale, SIRET, TVA, coordonnées). Ces données alimentent l'en-tête des documents.
- Créez un client — module Clients → Nouveau client.
- Émettez la facture — module Factures → Nouvelle facture, ajoutez les lignes, validez. Le numéro légal est attribué automatiquement.
- Envoyez / encaissez — exportez le PDF, marquez la facture payée. Si la Comptabilité est active, l'écriture se génère.