Manuale · 1

Configurazione iniziale

Al primissimo avvio di IllusionDB esistono due modi per creare il primo account amministratore:

Usare la pagina di configurazione: avviare senza altre impostazioni e compilare la finestra di configurazione che appare nel browser.
Impostare le variabili d’ambiente: impostare ADMIN_EMAIL e ADMIN_PASSWORD prima dell’avvio – IllusionDB crea automaticamente l’account (comodo per Docker e installazioni non presidiate).

Le due opzioni della configurazione

Sotto nome utente e password, la finestra di configurazione offre due caselle:

Casella	Predefinito	Cosa succede
Installa il manuale	attiva	Questo manuale compare come fonte dati «Handbuch» a sé stante nella barra laterale – una tabella per lingua, ognuna con una vista wiki.
Installa i dati demo	disattiva	Crea un’agenzia di esempio «Brightline Studio» come fonte dati SQLite «Demo» (contenuto sotto).

La configurazione con le opzioni richiede qualche secondo; nel frattempo la pagina mostra un indicatore di caricamento. Se una delle opzioni non riesce, il tuo account esiste comunque e hai già effettuato l’accesso – la pagina mostra il messaggio e il pulsante Continua senza.

I dati demo sono disponibili solo durante la configurazione. Puoi rimuoverli in qualsiasi momento: elimina la fonte dati «Demo» in Gestire le fonti dati (insieme ai gruppi Project team, Finance e Marketing, agli script, al modello di documento Invoice e alle cartelle della mediateca, se non ti servono).

Cosa contengono i dati demo

Una piccola agenzia digitale con dati di esempio coerenti in inglese – appuntamenti e scadenze sono relativi al giorno dell’installazione, così calendario e Gantt mostrano subito qualcosa:

Tabelle clients, people, projects, tasks, time_entries, invoices, invoice_items, meetings, wiki_pages, blog_posts e inoltre contacts (creata tramite l’importazione CSV) e services (tramite l’importazione SQL).
Tutti i tipi di campo: testo, testo lungo (Markdown), numero, decimale, sì/no, data, data+ora, UUID, JSON, numero automatico, allegato, chiave esterna 1:n (anche autoreferenziale), link n:m, lookup, rollup, formula e record figli – e tutti i formati di visualizzazione (etichetta, tag, data, valuta, dimensione dati, durata, e-mail, telefono, URL, colore, pulsante, Markdown).
Tutte le viste: griglia con filtro, ordinamento, raggruppamento e totali, Kanban (bacheca attività), calendario (riunioni, scadenze), Gantt (pianificazione con sottoattività, dipendenze e milestone; roadmap dei progetti), wiki (wiki aziendale), CMS (blog, team, clienti) e vista documenti (fatture).
Mediateca: loghi, foto e PDF in cartelle virtuali, un file riutilizzato più volte.
Automazione: un endpoint personalizzato pubblico GET /api/v1/scripts/demo/hello, uno autenticato GET /api/v1/scripts/demo/projects/:id/summary e un hook che sposta su Done le attività al 100 %; due snippet SQL salvati.
Modello di documento Invoice per le fatture.
Gruppi Project team, Finance e Marketing con permessi sulle tabelle – ma nessun account utente aggiuntivo, nessun token API e nessun webhook.

Variabili d'ambiente per la prima configurazione

Quando il primo amministratore viene creato tramite ADMIN_EMAIL/ADMIN_PASSWORD, due variabili sostituiscono le caselle:

Variabile	Predefinito	Significato
`INSTALL_MANUAL`	`true`	installa il manuale
`INSTALL_DEMO`	`false`	installa i dati demo

Entrambe valgono solo per il primissimo avvio di un’installazione vuota. Le installazioni esistenti restano invariate – il manuale vi viene sempre creato una sola volta e non viene ripristinato dopo l’eliminazione.

Prosegui direttamente con Panoramica dell’interfaccia.