Manual de utilizare SIMBA

Platformă IoT complexă pentru monitorizarea și gestionarea rețelei de dispozitive

Prezentare generală

Sistemul SiMBA este o platformă IoT complexă pentru colectarea automată, procesarea, facturarea și vizualizarea analitică a datelor de la dispozitive bazate pe tehnologia LoRaWAN.

Module principale ale sistemului

Modul Descriere
1. Introducere Sistemul SiMBA este o platformă IoT complexă pentru colectarea automată, procesarea, facturarea și vizualizarea analitică a datelor de la dispozitive bazate pe tehnologia LoRaWAN. Platforma este destinată monitorizării și gestionării rețelei de dispozitive IoT în timp real.
2. Panou de bord Panoul de control este pagina de start a sistemului SiMBA și oferă o imagine de ansamblu asupra stării întregii rețele IoT în timp real. Este destinat evaluării rapide a indicatorilor cheie de performanță.
3. Gateway-uri Această pagină oferă o listă detaliată a tuturor gateway-urilor LoRaWAN înregistrate în sistemul SiMBA. Este destinată administratorilor de rețea și inginerilor.
4. Consumatori Pagina "Consumers" este destinată gestionării bazei de date a utilizatorilor finali ale căror contoare sunt conectate la sistemul SiMBA.
5. Contoare Această pagină este secțiunea cheie pentru gestionarea și monitorizarea dispozitivelor de măsurare în sistemul SiMBA.
6. Dispozitive WUM Această secțiune este destinată gestionării dispozitivelor WUM, care sunt contoare electrice cu radiomodule integrate.
7. Organizații Această pagină din SiMBA este destinată gestionării organizațiilor care utilizează sistemul sau ale căror dispozitive sunt întreținute.
8. Harta Este elementul vizual central, unde poți vedea localizarea geografică a tuturor dispozitivelor (contoare) și gateway-urilor din rețea.
9. Alerte Pagina "Alerte" este concepută pentru a afișa toate avertismentele și notificările generate de Contoare.
10. Rapoarte Generarea și accesul la diverse rapoarte analitice privind sistemul și consumul.
11. Utilizatori Gestionarea conturilor de utilizator din sistem. Permite adăugarea, editarea și organizarea utilizatorilor.
12. Jurnale Pagina "Logs" oferă acces centralizat la jurnalele de sistem, permițând urmărirea acțiunilor utilizatorilor și evenimentelor de sistem.
13. Dispozitive acceptate Vizualizarea și gestionarea tipurilor de dispozitive care pot fi adăugate în sistem.
14. Șabloane de contor Gestionarea configurațiilor standardizate (șabloane) pentru diferite tipuri de contoare.

Tablou de bord implicit (Default Dashboard)

Componente și funcționalități

Componentă / Buton Funcție / Descriere
Hartă principală (Map)
Hartă principală
Gateway-uri (Gateways)
Gateway-uri
Stare dispozitive (Device Status)
Stare dispozitive
Consum lunar (Monthly Consumption)
Consum lunar
Consum zilnic (Daily Consumption)
Consum zilnic
Încărcarea dispozitivului (Device Charge)
Încărcarea dispozitivului
Alerte (Alerts)
Alerte
Consum pe ore (Hourly Consumption)
Consum pe ore
SIMBA Assistant Bot
SIMBA Assistant Bot

Gateway-uri

Această pagină prezintă o listă detaliată a tuturor gateway-urilor LoRaWAN înregistrate în sistemul SiMBA.

Scopul paginii

Această pagină prezintă o listă detaliată a tuturor gateway-urilor LoRaWAN înregistrate în sistemul SiMBA. Este destinată administratorilor de rețea și inginerilor care au nevoie de control complet și acces rapid la informațiile despre fiecare dispozitiv hardware gateway.

Funcționalitatea principală

  • Filtrarea listei de gateway-uri după parametri
  • Vizualizare detalii gateway
  • Coordonate geografice exacte
  • Monitorizare stare (ACTIVE/INACTIVE)

Structura datelor Gateway-urilor

Câmp Descriere
UID

Identificator unic al gateway-ului, DevEUI

UID Gateway
STARE

Starea actuală:

  • ACTIVE – online și funcțional
  • INACTIVE – offline sau cu probleme de conectivitate
Stare Gateway
COORDONATE
Coordonate Gateway
ADRESA
Adresa Gateway
DESCRIERE
Descriere Gateway

Monitorizare și gestionare

Pagina permite vizualizarea rapidă a sănătății infrastructurii de rețea datorită statusului gateway-urilor. Un număr mare de gateway-uri inactive semnalează probleme care pot necesita intervenție.

Detalii Gateway-uri

Detaliile despre setarea unui Gateway:

  1. Fiecare Gateway are un ID unic și o adresă unde se află montat
  2. Adresa dispozitivului Gateway
  3. Starea lui dacă e Activ / Inactiv
  4. Coordonatele dispozitivului
  5. Informații suplimentare despre dispozitiv
Detalii Gateway

Consumatori

Gestionarea bazei de date a utilizatorilor finali ale căror contoare sunt conectate la sistemul SiMBA.

Scopul paginii

Pagina "Consumatori" este destinată gestionării bazei de date a utilizatorilor finali (consumatori) ale căror contoare sunt conectate la sistemul SiMBA.

Funcții principale

  • Vizualizare tabelară
  • Adăugare consumatori noi
  • Editare/ștergere consumatori
  • Filtrare și căutare rapidă
  • Generare rapoarte

Butoane și elemente principale

Buton/Element Funcție
OBȚINEȚI RAPORT

Generează rapoarte detaliate pentru consumatorii selectați. Rapoartele pot fi descărcate în format .csv

Obținere raport
CREEAZĂ CONSUMATOR

Formularul de adăugare a unui nou consumator, cu introducerea adresei și a altor date necesare despre el.

Creează consumator

Structura listei consumatorilor

Câmp Descriere
ID

Identificator unic al consumatorului.

ID Consumator
Adresă completă

Oraș, Sector, Strada, Numărul casei, Apartament - Adresă detaliată pentru identificare precisă.

Adresă consumator
Organizație

Organizația asociată (ex: "Chisinau-Gaz").

Organizație
Instrumente
  1. Editare individuală a consumatorului respectiv.
  2. Ștergere individuală a consumatorului respectiv.
Instrumente consumator

Formular pentru editarea consumatorului

Editare consumator

Contoare

Secțiunea cheie pentru gestionarea și monitorizarea dispozitivelor de măsurare în sistemul SiMBA.

Funcțiile principale ale paginii

Vizualizare listă contoare: afișează toate contoarele înregistrate în sistem, cu posibilitate de filtrare după tip, stare, perioadă.

Detalii contor: accesarea informațiilor detaliate despre un contor selectat.

Filtrare avansată: permite aplicarea mai multor criterii de căutare și filtrare.

Monitorizare consum: afișarea valorilor de consum preluate de la fiecare contor.

Elemente de control și funcționalități

Element Funcționalitate
Filter Deschide dialogul de filtre avansate pentru căutare după criterii diverse (adresă, serie, tip, stare etc.)
Upload Permite încărcarea unui fișier cu date despre contoare (pentru adăugare sau actualizare în masă)
Export Descarcă lista contoarelor filtrate sau toate datele aflate în vizualizare
View/Details Accesează pagina cu informații detaliate pentru contorul selectat
Status indicator Afișează starea curentă: activ/inactiv (LED colorat sau simbol specific)

Detalii contor

Informații de bază:

  1. Model contor
  2. Număr de serie contor
  3. Tipul contorului, extern sau intern
  4. Imaginea contorului
  5. Posibilitatea modificării/adăugării pozelor
  6. Actualizarea coordonatelor contorului
  7. Afișarea stării contorului [activ / inactiv]

Date de consum și gestionare:

  1. Volumul total consumat
  2. Informații/comentarii suplimentare
  3. Resetarea tuturor datelor
  4. Editarea contorului
  5. Ștergerea contorului
  6. Consumul lunar înregistrat
Detalii contor

Dispozitive WUM

Gestionarea dispozitivelor WUM - contoare cu radiomodul integrat, parte a ecosistemului SiMBA și FireFly.

Despre dispozitivele WUM

Pagina Dispozitive WUM este secțiunea centrală pentru managementul și monitorizarea tuturor contoarelor cu radiomodul WUM (apă, gaz, electricitate).

În această pagină poți:

  • Găsi toate dispozitivele WUM administrate
  • Adăuga, șterge sau edita dispozitive
  • Vezi statusul fiecărui dispozitiv
  • Filtrare avansată și rapoarte

Caracteristici principale:

  • • Monitorizare stare (ACTIVE/INACTIVE)
  • • Monitorizare nivel baterie
  • • Identificare unică prin DevEUI
  • • Asociere cu organizații
  • • Tipuri diverse: impulse, rs485

Structura tabelului dispozitivelor WUM

Coloană Descriere
Dispozitiv EUI

Identificator global și unic pentru fiecare dispozitiv WUM.

Dispozitiv EUI
Tip

Tipul dispozitivului (ex: impulse, rs485).

Tip dispozitiv
Stare

Starea dispozitivului (ACTIVE sau INACTIVE).

Stare dispozitiv
Baterie

Nivelul bateriei, dacă este cazul (ex: 3.543 V).

Baterie dispozitiv
Instrumente

Icoane pentru editare sau vizualizare informații suplimentare.

Instrumente dispozitiv

Formular pentru editarea dispozitivului

Editare dispozitiv WUM

Organizații

Gestionarea organizațiilor care utilizează SiMBA sau dețin dispozitive monitorizate în sistem.

Scop pagină

Această pagină este dedicată gestionării organizațiilor care utilizează SiMBA sau dețin dispozitive monitorizate în sistem.

Structura tabel și coloane

Câmp Descriere
ID

Identificator unic al organizației, folosit pentru referință internă.

ID Organizație
Template

Șablonul de setări aplicat organizației (ex: ELSTER PREMAGAS, HONEYWELL ELSTER). Dacă este gol, se folosește o setare individuală

Template organizație
Buton Editare

Iconiță de creion – permite modificarea informațiilor pentru organizația selectată.

Editare organizație

Funcționalități importante

  • Crearea și vizualizarea listei de organizații
  • Maparea dispozitivelor, utilizatorilor și rapoartelor
  • Asocierea șabloanelor pentru implementare rapidă
  • Gestionare prin serviciul "config-store"

Formular editare organizație

Formular editare 1
Formular editare 2

Harta (Map)

Elementul vizual central pentru localizarea geografică a tuturor dispozitivelor și gateway-urilor din rețea.

Funcționalități principale

  • Vezi localizarea geografică a tuturor dispozitivelor (contoare) și gateway-urilor din rețea
  • Fiecare tip de dispozitiv (apă, gaz, electricitate) are propria iconiță și culori diferite
  • Poți vedea instant dacă un dispozitiv e activ, inactiv sau în stare de avarie
  • Harta te ajută rapid să vezi cât de densă este rețeaua ta și să identifici zonele de concentrare

Beneficii vizualizare

Dispozitive active
Dispozitive inactive
Stare de avertizare
Gateway-uri

Alerte

Centrul de comandă unde vezi toate semnalele de alarmă și avertismentele generate de întreg sistemul.

Elemente de control

Element Rol / Funcție
Lista alertelor Vezi toate alertele generate – dinamic și în timp real.
Filter (Filtru) Filtrează alertele după tip, dispozitiv sau dată, ca să găsești exact ce contează acum.
Get Report (Obține raport) Generează un raport cu privire la alertele afișate, pentru descărcare sau analiză.

Structura tabelului de alerte

Câmp Descriere
Dispozitiv EUI

Identificator unic pentru dispozitivul care a generat alerta.

Dispozitiv EUI Alert
Probleme

Tip scurt al problemei (ex: isMagnet, isOpening, isPosition).

Probleme Alert
Mesaj

Detalii despre alertă, inclusiv cauza exactă a problemei.

Mesaj Alert
Data

Data și ora la care a apărut alerta.

Data Alert

Caracteristici avansate

  • • Notificările pot fi trimise prin email, Telegram, Slack/Teams sau Webhook
  • • Alertele sunt de mai multe tipuri: critice, avertismente, notificări informative
  • • Pagina "Alerte" a fost creată pentru ca tu să prinzi problemele înainte să devină dezastre

Rapoarte

Generarea și accesul la diverse rapoarte analitice privind sistemul și consumul.

Lista rapoartelor disponibile

Lista rapoartelor din tabel care pot fi descărcate fiecare individual:

Raport privind citirile contoarelor (internal)
Raport privind citirile contoarelor (external)
Raport privind statisticile utilizatorilor
Raport privind numărul de dispozitive
Consum zilnic
Consum pe oră
Consum pe perioadă
Lista rapoarte

Detalii tehnice

  • • Rapoartele sunt generate de serviciul config-store
  • • Datele pentru rapoarte sunt colectate din baza de date PostgreSQL și pot fi exportate
  • • Poți vizualiza rapoarte analitice și chiar automatiza exportul pentru anumite intervale

Utilizatori

Centrul pentru gestionarea tuturor conturilor de utilizator din sistem.

Elementele și butoanele esențiale

Element / Buton Rol / Acțiune
+ Create User

Buton situat în colțul din dreapta sus; deschide formularul pentru adăugarea unui cont nou de utilizator în sistem.

Creează utilizator
Edit User

Editarea datelor unui utilizator existent (nume, email, rol). Apare ca iconiță la fiecare utilizator listat.

Editare utilizator
Date utilizator

Nume, Email, Rol, Organizația, Oraș - Acestea sunt date detaliate despre fiecare utilizator.

Date utilizator

Detalii utilizator

Informații de bază:

  1. Emailul utilizatorului cu care s-a înregistrat în sistem
  2. Rolul utilizatorului în sistem
  3. Numele / Prenumele utilizatorului
  4. Schimbarea parolei utilizatorului

Informații suplimentare:

  1. Informații / comentarii suplimentare
  2. Organizația care răspunde de utilizator
  3. Orașul în care se află utilizatorul
  4. Acțiunile efectuate și înregistrate
Detalii utilizator 1
Detalii utilizator 2

Jurnal acțiuni

Pagina "Jurnal acțiuni" (Logs) servește ca portavoce a tuturor evenimentelor și acțiunilor importante executate în sistem.

Descriere generală

Pagina oferă acces centralizat la jurnalele de sistem, permițând urmărirea acțiunilor utilizatorilor și evenimentelor de sistem. Aici poți urmări cine, când și ce a făcut, dar și ce s-a întâmplat automat la nivel de sistem.

Jurnal acțiuni

Funcționalități de monitorizare

  • Urmărirea acțiunilor utilizatorilor
  • Evenimentele automate de sistem
  • Timestamp precis pentru fiecare acțiune
  • Filtrare după utilizator, tip acțiune, dată

Securitate și audit

  • Audit trail complet
  • Detectarea activităților neautorizate
  • Istoric complet de modificări
  • Export pentru analiză externă

Registru de dispozitive

Centrul de comandă pentru vizualizarea, adăugarea și gestionarea tipurilor de dispozitive suportate în sistem.

Descriere generală

Pagina "Registru de dispozitive" din SiMBA este centrul de comandă pentru vizualizarea, adăugarea și gestionarea tipurilor de dispozitive suportate în sistem (WUM, contoare de gaz, apă, electricitate).

Funcționalități:

  • • Permite gestionarea tuturor șabloanelor de dispozitive
  • • Vizualizarea echipamentelor conectate în rețea
  • • Monitorizarea statusului (active/inactive)
  • • Detalii tehnice și date de conectivitate

Tipuri de dispozitive suportate:

  • Contoare de apă
  • Contoare de gaz
  • Contoare electrice
  • Dispozitive WUM

Structura tabelului principal

Coloană Descriere
Name Numele dispozitivului sau șablonului (ex. WUM_BAL_SE, WUM_CDC_L)
Type Tipul general (gaz, apă, electro, undefined)
Device Type Tip/protocol specific (impulse, rs485, etc.)
Manufacturer Producătorul (ex. IDonus Company, gol dacă nu există info)

Vizualizare registru dispozitive

Registru dispozitive

WUM Dispozitiv - Detalii

Informații dispozitiv:

  1. Numele dispozitivului
  2. Numele producătorului
  3. Tipul dispozitivului
  4. Site-ul oficial căruia îi aparține dispozitivul
  5. Descrierea detaliată
  6. Caracteristicile dispozitivului

Specificații tehnice:

  • • Protocol de comunicare
  • • Frecvența de transmisie
  • • Durata de viață a bateriei
  • • Rezistența la mediu
  • • Compatibilitate cu alte sisteme
WUM Dispozitiv 1
WUM Dispozitiv 2

Model de contoare

Specializată pe vizualizarea și gestionarea tipurilor și șabloanelor de contoare ce pot fi adăugate în sistem.

Despre modelele de contoare

Pagina "Model de contoare" din SiMBA este specializată pe vizualizarea și gestionarea tipurilor și șabloanelor de contoare ce pot fi adăugate în sistem. Pe această pagină, meniul afișează detalii esențiale pentru administrarea rapidă și coerentă a dispozitivelor.

Caracteristica elementelor

Coloană / Buton Descriere
Name Numele dispozitivului sau al șablonului (ex: MADDALENA E-BULK D100 (10 imp/l), ELSTER PREMAGAS (10 imp/l)).
Alias Pseudonim/denumire prescurtată pentru identificare rapidă.
Type Tipul resursei: gaz, apă, electro, etc.
Module Modulul asociat (ex: WUM_BAL_WG).
Metadata Parametri tehnici sau proprietăți suplimentare pentru implementări rapide.

Implementare tehnică

Toate șabloanele/modelările sunt gestionate de serviciul config-store, care se ocupă de profilurile dispozitivelor și facilitează implementarea rapidă cu setări predefinite.

Filtrarea

Proces de filtrare prezent în paginile Gateway-uri, Contoare și Dispozitive WUM.

Pagini cu funcționalitate de filtrare

Gateway-uri

Contoare

Dispozitive WUM

Funcționalități de filtrare

Nume buton Funcționalitate
1. Filtru Permite filtrarea tabelului de gateway-uri după diferite criterii pentru a găsi rapid dispozitivele dorite.
2. Șterge Ștergere toate filtrele selectate
3. Descarcă Descărcare fișier în format .json cu filtrele selectate
4. Upload Încărcare fișier în format .json descărcat anterior cu filtrele selectate
5. Găsește După adăugarea unor filtre noi, putem apăsa butonul "Căutare" sau butonul "Enter" de pe tastatură pentru a căuta dispozitivul dorit
6. Salvează Putem salva filtrele selectate într-un Tablou de bord nou [Dashboard nou]

Vizualizare interfață filtrare

Interfață filtrare