Passa al contenuto principale

Domain Model & Data

Questa sezione introduce il modello di dominio di Homsai e le principali entità con cui lavorerai: plants, devices, sensors e metadati collegati.

Overview​

Nel modello Homsai, un impianto energetico è descritto da un insieme di entità collegate tra loro:

In sintesi:

  • Un Plant rappresenta l’impianto nel suo complesso (abitazione, edificio, sito industriale).
  • Un Device è un dispositivo fisico o logico collegato al plant (inverter, batteria, pompa di calore, wallbox, ecc.).
  • Un Sensor è una sorgente dati che misura grandezze nel tempo (potenza, energia, temperatura, %, ecc.).
  • I Types definiscono le categorie tecniche di devices e sensors e i tipi di dato raccolti.
  • Le Load Signatures rappresentano i profili di carico tipici, utili per analisi e previsioni.
  • I Vendors modellano fornitori e integrazioni esterne associate a un plant.

Plants​

Un Plant è l’entità radice che rappresenta un impianto energetico logico, ad esempio:

  • una singola abitazione;
  • un condominio;
  • un edificio commerciale o industriale.

Tutti i devices e sensors appartengono a un plant.
Sul plant si basano:

  • la configurazione complessiva dell’impianto;
  • l’accesso ai dati di consumo/produzione;
  • il calcolo di previsioni e indicatori di salute.

Devices​

Un Device rappresenta un componente fisico o logico collegato a un plant, ad esempio:

  • inverter fotovoltaici;
  • batterie di accumulo;
  • pompe di calore;
  • wallbox / punti di ricarica;
  • carichi significativi (climatizzatori, pompe, motori, ecc.).

Caratteristiche principali:

  • ogni device appartiene a un solo Plant;
  • è classificato tramite un Device Type;
  • può avere uno o più Sensors associati che ne misurano stato e prestazioni.

I devices sono usati per modellare l’architettura fisica dell’impianto e per aggregare i dati misurati dai sensori.

Sensors​

Un Sensor è una sorgente di dati temporali, che misura una o più grandezze, come:

  • potenza istantanea (W);
  • energia (kWh) consumata o prodotta;
  • temperatura (°C), stato di carica (%), irraggiamento (W/m²);
  • altre grandezze elettriche o ambientali.

Caratteristiche principali:

  • ogni sensor appartiene a un Plant;
  • può essere collegato a un Device specifico o al plant nel suo complesso;
  • è classificato da un Sensor Type;
  • raccoglie uno o più Data Types Collects (tipi di dato, es. W, kWh, °C, %).

Le serie storiche e le metriche energetiche (consumi, produzioni, energy mix) derivano dai dati collezionati dai sensori.

Types​

I Types definiscono la semantica e la categoria delle entità principali:

  • Device Types
    Descrivono la categoria funzionale di un device (es. INVERTER, BATTERY, HEAT_PUMP, EV_CHARGER).
    Servono per:

    • classificare i dispositivi;
    • applicare logiche di business specifiche (es. previsioni per soli carichi consumatori);
    • filtrare e aggregare dati per tipo di dispositivo.

  • Sensor Types
    Descrivono la natura del sensore (es. POWER_SENSOR, ENERGY_SENSOR, TEMPERATURE_SENSOR, IRRADIANCE_SENSOR).
    Servono per:

    • definire che tipo di grandezza misura;
    • guidare interpretazione, unità di misura e algoritmi di aggregazione.

  • Data Types Collects
    Elencano i tipi di dato misurabili (es. energia attiva kWh, potenza attiva W, temperatura °C, stato di carica %, irraggiamento W/m²).
    Associare correttamente i data types ai sensori è fondamentale per ottenere metriche coerenti e previsioni accurate.

Load Signatures​

Le Load Signatures (firme di carico) modellano pattern tipici di consumo di uno specifico carico o categoria di carichi.

Esempi di utilizzo:

  • descrivere il profilo giornaliero di una pompa di calore;
  • supportare algoritmi di previsione dei carichi;
  • stimare i consumi di un carico anche quando non viene misurato in modo diretto.

In pratica, una load signature è un oggetto di configurazione che rappresenta “come consuma” energia un determinato tipo di dispositivo o carico.

Vendors​

I Vendors rappresentano fornitori, brand o integrazioni esterne associate a un plant, ad esempio:

  • produttori di inverter o batterie;
  • piattaforme cloud di terze parti;
  • sistemi IoT o piattaforme di gestione energetica integrati con Homsai.

Per ogni plant è possibile:

  • elencare i vendor già configurati;
  • vedere quali vendor sono disponibili ma non ancora attivi;
  • guidare l’utente nell’abilitazione di nuove integrazioni.

Example: PV + Battery​

Ecco un esempio concettuale di modellazione per un impianto fotovoltaico residenziale con batteria.

  • Plant

    • “Casa Rossi – Impianto FV + Batteria”

  • Devices

    • Device 1: Inverter fotovoltaico (Device Type: INVERTER)
    • Device 2: Batteria di accumulo (Device Type: BATTERY)

  • Sensors

    • Sensore A: potenza FV in uscita dall’inverter
      • Sensor Type: POWER_SENSOR
      • Data Type: W
    • Sensore B: energia giornaliera prodotta
      • Sensor Type: ENERGY_SENSOR
      • Data Type: kWh
    • Sensore C: potenza di carica/scarica batteria
      • Sensor Type: POWER_SENSOR
    • Sensore D: stato di carica batteria
      • Sensor Type: dedicato (es. STATE_OF_CHARGE_SENSOR)
      • Data Type: %
    • Sensore E: consumo totale casa a valle del contatore
      • Sensor Type: combinazione di POWER_SENSOR e ENERGY_SENSOR

  • Types & Load Signatures

    • Device Types per inverter e batteria.
    • Sensor Types coerenti con le grandezze misurate.
    • Eventuale Load Signature per un carico rilevante (es. pompa di calore) per analisi e previsioni.

A partire da questa modellazione, il backend può:

  • fornire metriche di consumo/produzione giornaliere e orarie;
  • calcolare previsioni di consumo e produzione;
  • valutare la salute dell’impianto fotovoltaico;
  • supportare ottimizzazioni e scenari di automazione energetica.