Manuel · 1

Configuration initiale

Au tout premier démarrage d’IllusionDB, il existe deux façons de créer le premier compte administrateur :

  • Utiliser la page de configuration : démarrer sans autre réglage et remplir le dialogue de configuration affiché dans le navigateur.
  • Définir des variables d’environnement : définir ADMIN_EMAIL et ADMIN_PASSWORD avant le démarrage – IllusionDB crée alors le compte automatiquement (pratique pour Docker et les installations sans surveillance).

Les deux options de la configuration

Sous le nom d’utilisateur et le mot de passe, le dialogue de configuration propose deux cases à cocher :

Case Par défaut Effet
Installer le manuel cochée Ce manuel apparaît comme source de données « Handbuch » à part entière dans la barre latérale – une table par langue, chacune avec une vue wiki.
Installer les données de démonstration décochée Crée une agence fictive « Brightline Studio » comme source de données SQLite « Demo » (contenu ci-dessous).

La configuration avec ces options prend quelques secondes ; la page affiche pendant ce temps un indicateur de chargement. Si l’une des options échoue, votre compte existe malgré tout et vous êtes connecté – la page affiche le message et un bouton Continuer sans.

Les données de démonstration ne sont proposées que lors de la configuration. Vous pouvez les supprimer à tout moment : supprimez la source de données « Demo » sous Gérer les sources de données (ainsi que les groupes Project team, Finance et Marketing, les scripts, le modèle de document Invoice et les dossiers de la médiathèque si vous n’en avez pas besoin).

Contenu des données de démonstration

Une petite agence digitale avec des données d’exemple cohérentes en anglais – les rendez-vous et échéances sont relatifs au jour de l’installation, de sorte que le calendrier et le Gantt affichent immédiatement quelque chose :

  • Tables clients, people, projects, tasks, time_entries, invoices, invoice_items, meetings, wiki_pages, blog_posts, ainsi que contacts (créée via l’import CSV) et services (via l’import SQL).
  • Tous les types de champs : texte, texte long (Markdown), nombre, décimal, oui/non, date, date+heure, UUID, JSON, numéro automatique, pièce jointe, clé étrangère 1:n (aussi auto-référencée), liens n:m, lookup, rollup, formule et enregistrements enfants – ainsi que tous les formats d’affichage (étiquette, tags, date, devise, taille de données, durée, e-mail, téléphone, URL, couleur, bouton, Markdown).
  • Toutes les vues : grille avec filtre, tri, regroupement et totaux, Kanban (tableau des tâches), calendrier (réunions, échéances), Gantt (planning avec sous-tâches, dépendances et jalons ; feuille de route des projets), wiki (wiki de l’entreprise), CMS (blog, équipe, clients) et vue documents (factures).
  • Médiathèque : logos, photos et PDF dans des dossiers virtuels, un fichier réutilisé plusieurs fois.
  • Automatisation : un endpoint personnalisé public GET /api/v1/scripts/demo/hello, un endpoint authentifié GET /api/v1/scripts/demo/projects/:id/summary et un hook qui passe les tâches à 100 % sur Done ; deux snippets SQL enregistrés.
  • Modèle de document Invoice pour les factures.
  • Groupes Project team, Finance et Marketing avec des droits sur les tables – mais aucun compte utilisateur supplémentaire, aucun jeton d’API et aucun webhook.

Variables d'environnement pour la première configuration

Lorsque le premier administrateur est créé via ADMIN_EMAIL/ADMIN_PASSWORD, deux variables remplacent les cases à cocher :

Variable Par défaut Signification
INSTALL_MANUAL true installer le manuel
INSTALL_DEMO false installer les données de démonstration

Les deux ne s’appliquent qu’au tout premier démarrage d’une installation vide. Les installations existantes restent inchangées – le manuel y est toujours créé une seule fois et n’est pas restauré après suppression.

Ensuite, direction Vue d’ensemble de l’interface.