Documentation

Démarrage

Prérequis, installation, première connexion et données de démonstration.

Prérequis

Un serveur web avec réécriture d’URL (Apache mod_rewrite ou l’équivalent nginx), HTTPS recommandé.
PHP 8.1 ou plus récent avec les extensions usuelles (pdo_mysql, mbstring, intl, gd, curl, zip).
MySQL 8 ou MariaDB 10.6+.
Composer, et un accès cron pour la file de tâches (Google, QuickBooks, rappels).

Installation

Clonez ou téléchargez le dépôt et copiez les fichiers sur votre serveur.
Depuis .admin/, installez les dépendances PHP :
```
cd .admin
composer install --no-dev
```
Copiez .env.example vers .env et remplissez les identifiants de base de données, les chemins du projet et l’utilisateur root.
Lancez l’installateur depuis le navigateur : https://votre-domaine/.admin/public/install.php. Il crée les tables et le compte root.
Ajoutez l’entrée cron pour que les tâches en file s’exécutent chaque minute :
```
* * * * * php /chemin/vers/.admin/config/cron.php >/dev/null 2>&1
```
Ouvrez /.admin et connectez-vous avec l’utilisateur root configuré.

Les éléments optionnels — Google Workspace, QuickBooks en ligne, le serveur MCP, le temps réel — ont chacun leur page dans cette documentation et s’activent indépendamment.

Premiers pas

Paramètres → Config : nom de l’entreprise, langue par défaut, devise, taxes.
Paramètres → Utilisateurs / Groupes : créez votre équipe et assignez les droits (voir Utilisateurs, groupes et sécurité).
Paramètres CRM → Produits, Taxes, Sources, Gabarits de courriel : les données de référence à partir desquelles soumissions et courriels sont construits.
Paramètres → Gabarit : téléversez votre logo et définissez l’en-tête et le pied de page des PDF.

Données de démonstration

Le dépôt fournit config/custom_testdata.sql avec trois utilisateurs de démonstration et un ensemble d’entreprises, contacts, soumissions et factures d’exemple. Chargez-le dans une base de données vierge pour explorer — jamais en production.

Mise à niveau

Récupérez la nouvelle version, relancez composer install dans .admin/, puis ouvrez de nouveau install.php : il applique les migrations de schéma en attente sans toucher à vos données. Sauvegardez la base de données d’abord.