Overview

Scaffolding iniziale

Questa pagina descrive il bootstrap iniziale quando AppSettings.firstRun = true.

Con il pacchetto tutorial non c'e' niente da scaffoldare

Lo scaffolding di cui parla questa pagina — leggere le tabelle di un database e registrarle in

_metadati__tabelle / _metadati__colonne — riguarda solo la modalita' "DB esistente" del

wizard di primo avvio: e' li' che compare la casella *Esegui scaffold automatico delle tabelle

del DB selezionato*.

Nei pacchetti tutorial quella casella non esiste. Il database metadati arriva gia' popolato

(route, colonne, menu, traduzioni, dashboard di esempio) e il wizard si limita a ripristinarlo e

a creare l'utente admin. Vedere route gia' pronte subito dopo il primo avvio non e' quindi il

risultato di uno scaffolding: e' il contenuto del tutorial.

Modalita' del wizardCosa succede ai metadata
Tutorial WideWorldImportersMetadata gia' pronti, ripristinati dal pacchetto. Nessuno scaffolding.
DB esistente, casella spentaDB metadati creato vuoto: le route si registrano a mano, o dopo dalla pagina Scaffolding.
DB esistente, casella accesaA fine installazione ogni tabella del database scelto viene registrata come route.

Il resto di questa pagina vale per le ultime due righe della tabella.

Quando usarlo

  • Nuova installazione (DB metadata/dati non ancora pronti).
  • Ambiente locale da riallineare con setup iniziale.
  • Primo avvio dopo deploy dove vuoi forzare la procedura guidata di provisioning.

Comportamento con firstRun=true

  • L'endpoint GET /api/Meta/FirstRunStatus espone firstRun: true.
  • In login compare il flusso di primo avvio (es. azione Aggiorna nello screen).
  • Il setup applica le configurazioni base (connessioni, impostazioni runtime, bootstrap metadata).

Operazioni tipiche

  • Verifica AppSettings.firstRun a true in appsettings.{Environment}.json dell'host che stai eseguendo.
  • Avvia applicazione e completa la procedura di scaffolding iniziale da UI.
  • Controlla che connessioni e parametri principali risultino coerenti (dbms, DataDBName, ConnectionStrings).

Dopo il provisioning

  • La procedura di setup porta firstRun a false per evitare riesecuzioni ad ogni avvio.
  • Esegui login standard e valida l'accesso alle route principali.
  • Con firstRun = false i metodi del wizard (es. configure_wuic) rispondono solo agli amministratori.
  • Installazioni Oracle e installazioni MySQL con il tutorial create con pacchetti fino alla 1.7.12: gli script di primo avvio contenevano gli utenti dei test e2e (wuic_e2e_admin*, guest_1), che non devono esistere in produzione. Controlla la tabella utenti ed elimina o disattiva quegli utenti; dalla 1.7.13 gli script non li contengono piu'.

Screenshot

scaffolding-iniziale / install-main
scaffolding-iniziale / install-main