Configuración inicial

En el primerísimo inicio de IllusionDB hay dos formas de crear la primera cuenta de administrador:

• Usar la página de configuración: iniciar sin más ajustes y completar el diálogo de configuración que aparece en el navegador.
• Establecer variables de entorno: definir ADMIN_EMAIL y ADMIN_PASSWORD antes de iniciar – IllusionDB crea entonces la cuenta automáticamente (práctico para Docker e instalaciones desatendidas).

Las dos opciones de la configuración

Debajo del nombre de usuario y la contraseña, el diálogo de configuración ofrece dos casillas:

Casilla	Por defecto	Qué ocurre
Instalar el manual	activada	Este manual aparece como fuente de datos propia «Handbuch» en la barra lateral – una tabla por idioma, cada una con una vista wiki.
Instalar datos de demostración	desactivada	Crea una agencia de ejemplo «Brightline Studio» como fuente de datos SQLite «Demo» (contenido más abajo).

La configuración con las opciones tarda unos segundos; mientras tanto, la página muestra un indicador de carga. Si una de las opciones falla, tu cuenta se crea igualmente y ya has iniciado sesión – la página muestra el mensaje y el botón Continuar sin ella.

Los datos de demostración solo se ofrecen durante la configuración. Puedes eliminarlos en cualquier momento: borra la fuente de datos «Demo» en Gestionar fuentes de datos (además de los grupos Project team, Finance y Marketing, los scripts, la plantilla de documento Invoice y las carpetas de la mediateca, si no los necesitas).

Qué contienen los datos de demostración

Una pequeña agencia digital con datos de ejemplo coherentes en inglés – las citas y los plazos son relativos al día de la instalación, así que el calendario y el Gantt muestran algo desde el primer momento:

• Tablas clients, people, projects, tasks, time_entries, invoices, invoice_items, meetings, wiki_pages, blog_posts, además de contacts (creada con la importación CSV) y services (con la importación SQL).
• Todos los tipos de campo: texto, texto largo (Markdown), número, decimal, sí/no, fecha, fecha+hora, UUID, JSON, número automático, adjunto, clave foránea 1:n (también autorreferenciada), enlaces n:m, lookup, rollup, fórmula y registros hijos – y todos los formatos de visualización (etiqueta, tags, fecha, moneda, tamaño de datos, duración, correo, teléfono, URL, color, botón, Markdown).
• Todas las vistas: cuadrícula con filtro, orden, agrupación y totales, Kanban (tablero de tareas), calendario (reuniones, plazos), Gantt (planificación con subtareas, dependencias e hitos; hoja de ruta de proyectos), wiki (wiki de la empresa), CMS (blog, equipo, clientes) y vista de documentos (facturas).
• Mediateca: logotipos, fotos y PDF en carpetas virtuales, un archivo reutilizado varias veces.
• Automatización: un endpoint personalizado público GET /api/v1/scripts/demo/hello, uno autenticado GET /api/v1/scripts/demo/projects/:id/summary y un hook que pasa a Done las tareas con un 100 % de progreso; dos snippets SQL guardados.
• Plantilla de documento Invoice para las facturas.
• Grupos Project team, Finance y Marketing con permisos sobre tablas – pero ninguna cuenta de usuario adicional, ningún token de API y ningún webhook.

Variables de entorno para la primera configuración

Cuando el primer administrador se crea mediante ADMIN_EMAIL/ADMIN_PASSWORD, dos variables sustituyen a las casillas:

Variable	Por defecto	Significado
INSTALL_MANUAL	true	instalar el manual
INSTALL_DEMO	false	instalar los datos de demostración

Ambas solo se aplican al primerísimo inicio de una instalación vacía. Las instalaciones existentes no cambian – el manual se sigue creando una sola vez y no se restaura tras borrarlo.

Después, continúa directamente con La interfaz de un vistazo.

Proteger la configuración (SETUP_TOKEN)

Mientras no exista ninguna cuenta, cualquiera que llegue a la instancia en el navegador puede crear la primera cuenta de administrador. Si inicias la instancia de forma pública y quieres completar la configuración en el navegador, define antes SETUP_TOKEN con un secreto de tu elección: la página de configuración lo pedirá y sin el token correcto no se crea ninguna cuenta. Por la API se envía como setup_token en el cuerpo o en la cabecera X-Setup-Token. Sin SETUP_TOKEN no cambia nada. Con ADMIN_EMAIL/ADMIN_PASSWORD no hace falta: la cuenta ya existe al arrancar.