Concetti chiave

Questa pagina definisce i termini usati in tutta la documentazione. Torna qui ogni volta che un termine non ti è chiaro.

Space (tenant)

Un Space è l'ambiente isolato di un singolo cliente, raggiungibile tramite un proprio sottodominio (es. acme.trackle.space). Tutto ciò che segue (template, asset, dashboard, utenti) vive dentro uno Space specifico.

Template

Un Template (Asset Template) è lo stampo da cui nascono gli asset: definisce metadati statici, come si integra con i device fisici (Trackle, MQTT, HTTP), i dati della telemetria, quali regole di allarme monitorano quelle variabili e quali dashboard sono disponibili per visualizzarle.

Approfondisci nel capitolo Template.

Asset

Un Asset è un'istanza reale creata a partire da un template: un impianto specifico, una macchina specifica, un sensore specifico. Ogni asset:

• appartiene a un template (che ne definisce la struttura);
• può essere collegato a un device fisico tramite il suo ID esterno;
• può appartenere a una o più organizzazioni/gruppi;
• ha una propria pagina di dettaglio con parametri, storico e allarmi.

Approfondisci nel capitolo Asset.

Device (collegamento fisico)

Con "device" ci si riferisce al dispositivo fisico collegato a un asset (un modulo Trackle, un client MQTT, un dispositivo Seneca, un dispositivo che chiama le API HTTP). Il collegamento avviene tramite un identificativo che nell'interfaccia è sempre chiamato ID esterno.

Organizzazioni e gruppi

Le organizzazioni e i gruppi permettono di segmentare gli asset (ad esempio per cliente finale, sede, area geografica) e di assegnare permessi di visibilità agli utenti.

Dashboard

Una dashboard è una composizione di widget (grafici, valori live, mappe, ecc.) che visualizza i dati di uno o più asset. Le dashboard possono essere:

• di template: condivise da tutti gli asset di un template;
• personali: create da un singolo utente per il proprio uso.

Approfondisci nel capitolo Dashboard.

Regole di allarme e storico allarmi

Le regole di allarme definiscono condizioni sulle variabili di un template (es. "temperatura > 80°") e sono condivise da tutti gli asset di quel template. Quando una condizione si verifica su un asset specifico, viene generato un allarme che appare nello storico allarmi di quell'asset. Approfondisci in Allarmi e Alert.

Ruoli utente

Gli utenti di uno Space hanno uno dei seguenti ruoli:

Ruolo	Descrizione
Admin	Accesso completo: gestione template, regole di allarme, dashboard, utenti, billing e impostazioni.
Support	Può consultare template, asset e regole di allarme per assistere i clienti, senza poterli modificare.
Customer	Utente finale che gestisce i propri asset (parametri, dashboard personali) senza accesso alle impostazioni globali.

Assistente AI

L'assistente AI è un pannello disponibile in ogni pagina (e come vista dedicata Home) che risponde a domande sul tuo Space e può proporre azioni (creare un asset, una dashboard, una regola di allarme...) che vengono sempre mostrate per conferma prima di essere eseguite. Approfondisci in Assistente AI.