Risorse della piattaforma

Tutto ciò che gestisci in Mirox è organizzato in tre risorse annidate — organizzazione, portfolio e parco — che insieme definiscono cosa puoi vedere, chi può accedervi e come sono raggruppati i tuoi dati per il monitoraggio e la reportistica. Comprendere questa gerarchia è la base per lavorare con la piattaforma e le sue API.

Organizzazione

L'organizzazione è l'entità di livello superiore che rappresenta un'entità commerciale che utilizza la piattaforma Mirox.

Caratteristiche principali

• Entità commerciale primaria: rappresenta un'azienda, un'istituzione o un'altra entità commerciale
• Contenitore di utenti: contiene gli utenti che appartengono all'organizzazione
• Proprietario delle risorse: possiede i portfolio e le relative risorse sottostanti
• Entità di fatturazione: funge da entità per la fatturazione e la gestione dell'account
• Confine dei permessi: definisce il confine dei permessi di livello più alto

Struttura dell'organizzazione

Le organizzazioni hanno tipicamente i seguenti componenti:

• Membri: utenti che appartengono all'organizzazione con ruoli e permessi diversi
• Informazioni: dettagli commerciali come nome, informazioni di contatto e tipo di attività
• Impostazioni: impostazioni e preferenze a livello di organizzazione
• Partner di cooperazione: altre organizzazioni con cui l'organizzazione collabora

Portfolio

I portfolio sono raccolte di parchi gestiti come un'unica unità. Rappresentano raggruppamenti logici di asset di energia rinnovabile.

Caratteristiche principali

• Raccolta di asset: raggruppa più parchi a fini gestionali
• Unità organizzativa: rappresenta un'unità di business, un cliente o una regione geografica
• Livello di permessi: abilita il controllo degli accessi a livello di portfolio
• Unità di reportistica: funge da base per la reportistica aggregata

Struttura del portfolio

I portfolio contengono tipicamente:

• Parchi: i singoli parchi solari o altri impianti di energia rinnovabile
• Contatti: persone associate al portfolio che possono ricevere report o notifiche
• Impostazioni: impostazioni e configurazioni a livello di portfolio
• Metriche di performance: dati aggregati di tutti i parchi contenuti

Parco

Un parco rappresenta un singolo impianto di energia rinnovabile, tipicamente un parco solare.

Caratteristiche principali

• Asset fisico: rappresenta un impianto di energia rinnovabile reale
• Soggetto di monitoraggio: entità principale di cui viene monitorata la performance
• Sorgente dati: genera dati di serie temporali sul proprio funzionamento
• Entità geografica: ha una posizione specifica e caratteristiche fisiche

Struttura del parco

I parchi includono tipicamente:

• Componenti: i componenti fisici dell'impianto (inverter, stringhe, quadri di campo del generatore, contatori, sensori di irraggiamento, logger, dispositivi di rete). La maggior parte dei componenti viene rilevata automaticamente dai tuoi logger e sincronizzata in automatico — li metti in evidenza e li perfezioni anziché inserirli a mano.
• Dettagli tecnici: specifiche come potenza installata, limite dell'inverter, orientamento e target mensili di performance ratio.
• Informazioni sulla posizione: coordinate geografiche e indirizzo.
• Metriche di performance: dati operativi come produzione di energia, resa specifica e rapporti di efficienza.
• Eventi: segnali operativi rilevati automaticamente come disconnessioni dalla rete, sovrapproduzione e cambiamenti di disponibilità delle sorgenti.

Relazioni tra le risorse

Queste risorse formano una struttura gerarchica:

1. Organizzazione: l'entità di livello superiore

   • Contiene più portfolio
   • Contiene i membri dell'organizzazione (utenti)

2. Portfolio: l'entità di livello intermedio

   • Appartiene a un'organizzazione
   • Contiene più parchi
   • Ha contatti specifici del portfolio

3. Parco: l'entità operativa di livello più basso

   • Appartiene a un portfolio
   • Contiene più componenti
   • Genera dati operativi ed eventi

Identificatori delle risorse

Tutte le risorse nella piattaforma Mirox sono identificate da:

• UID: una stringa esadecimale maiuscola univoca di 12 caratteri (ad es. "A1B2C3D4E5F6") assegnata alla creazione e non modificabile. Questo identificatore statico è essenziale per l'automazione tramite script e per un riferimento coerente all'interno della piattaforma.
• Nome: un nome leggibile per scopi di visualizzazione che può essere modificato dagli utenti.

Risorse di supporto

Oltre alla gerarchia principale, alcune risorse condivise ti aiutano a descrivere e documentare i tuoi asset:

• Schede tecniche: schede di specifiche del produttore riutilizzabili per inverter, pannelli solari e accumulo a batteria, box, moduli e celle. Le mantieni una sola volta a livello di organizzazione e le colleghi ai componenti corrispondenti su qualsiasi parco, in modo che le specifiche delle apparecchiature rimangano coerenti in tutta la tua flotta.
• Archiviazione documenti: ogni parco dispone di un esplora file per archiviare documenti di supporto — report di irraggiamento, contratti, schede tecniche, foto e altro. I file caricati vengono taggati automaticamente con l'aiuto dell'Assistente AI, rendendoli facili da ritrovare in seguito.

Operazioni comuni

Operazioni sull'organizzazione

• Gestione utenti (aggiunta/rimozione di utenti)
• Gestione delle impostazioni dell'organizzazione
• Stabilire partnership di cooperazione
• Gestione dei controlli di accesso a livello di organizzazione

Operazioni sul portfolio

• Creazione e gestione dei parchi
• Assegnazione dei parchi ai portfolio
• Reportistica a livello di portfolio
• Gestione dei contatti del portfolio

Operazioni sul parco

• Monitoraggio della performance del parco
• Analisi degli eventi del parco
• Generazione dei report del parco
• Gestione dei componenti del parco

Modello dei permessi

La gerarchia delle risorse definisce anche il modello dei permessi:

• I permessi a livello di organizzazione concedono l'accesso a tutti i portfolio e i parchi all'interno dell'organizzazione
• I permessi a livello di portfolio concedono l'accesso a tutti i parchi all'interno del portfolio
• I permessi a livello di parco concedono l'accesso a un solo parco specifico

Questo modello di accesso gerarchico garantisce che gli utenti vedano solo le risorse a cui dovrebbero avere accesso. I ruoli e le regole di accesso granulari sovrapposte a questa gerarchia sono trattati nel Sistema dei permessi.

Funzionalità correlate

• Sistema dei permessi — ruoli e regole di accesso tra organizzazioni, portfolio e parchi
• Panoramica dell'impianto — cosa monitora ciascun parco e come sono strutturati i suoi dati
• Primi passi — configura la tua organizzazione, il portfolio e il primo parco
• Assistente AI e wizard — tagging automatico dei documenti e onboarding guidato