funktionsbeskrivning [Orbiq wiki]

Denna sida är skrivskyddad. Du kan titta på källkoden, men inte ändra den. Kontakta administratören om du anser att du bör kunna ändra sidan.
====== Orbiq – Operativ systemplattform för digital drift och teknisk fastighetsförvaltning ======

Orbiq är en operativ systemplattform för digital drift och teknisk fastighetsförvaltning. Plattformen hjälper fastighetsägare att skapa överblick över och få tillgång till sina befintliga fastighetstekniska system utan att behöva ersätta fungerande teknik.

I många fastighetsorganisationer består systemlandskapet av ett stort antal system från olika leverantörer, exempelvis:

  * styr- och övervakningssystem
  * energimätsystem
  * passersystem
  * IoT-plattformar
  * larm- och säkerhetssystem
  * specialiserade drift- eller analysverktyg

Dessa system har ofta olika tekniska gränssnitt och hanteras i separata miljöer.

Orbiq fungerar som ett överliggande systemlager som samlar dessa funktioner i en gemensam plattform. Plattformen centraliserar tre centrala funktioner:

  * överblick och säker åtkomst till befintliga system
  * central hantering av larm och avvikelser
  * insamling, lagring och analys av data från olika tekniska system

Genom Orbiq kan organisationen snabbt skapa en samlad operativ bild av sitt tekniska fastighetsbestånd och samtidigt behålla befintliga system och investeringar.

<mermaid>
flowchart TB
  Orbiq["Orbiq – operativ plattform<br>för digital drift och teknisk förvaltning"]

  subgraph P1["1. Överblick & åtkomst"]
    Portal["Teknikportal<br>(reverse proxy / RDP / VNC / länkar)"]
    Res["Resurser (systemkatalog)<br>kopplat till objekt"]
  end

  subgraph P2["2. Larm & avvikelser"]
    InAlarm["Larm in<br>(API / Miner / e-post)"]
    Rules["Regler, kategorisering<br>& notifieringar"]
    Ops["Operativ översikt<br>& statistik"]
  end

  subgraph P3["3. Data & analys"]
    TS["Tidsseriedata"]
    Meta["Metadata / grafmodell"]
    Viz["Dashboards / KPI / analys"]
  end

  Orbiq --> P1
  Orbiq --> P2
  Orbiq --> P3

</mermaid>

===== Grundläggande principer =====

Orbiq är utvecklat utifrån några centrala principer som är särskilt viktiga för större fastighetsorganisationer.

==== Öppenhet ====

Plattformen är utformad för att kunna integrera med ett brett spektrum av befintliga system och tekniker. Organisationen kan fortsätta använda sina befintliga lösningar och successivt bygga upp en mer sammanhållen digital miljö.

==== Transparens ====

Genom tydliga gränssnitt mot underliggande system blir det möjligt att konkurrensutsätta leverantörer och system utan att behöva förändra övergripande arbetsprocesser.

==== Leverantörsoberoende ====

Orbiq är inte bundet till specifika fabrikat, molnplattformar eller systemleverantörer.

==== Kontroll och självständighet ====

Organisationen kan själva administrera och vidareutveckla plattformen utan att vara beroende av extern leverantör i den dagliga driften.

==== Flexibel drift =====

Systemet kan driftsättas i olika miljöer, exempelvis iquest driftmiljö, kundens egen infrastruktur eller andra molnplattformar.
===== Orbiq och Miner =====

Orbiq används normalt tillsammans med komponenten [[miner:whitepaper:oppen-integrationsplattform|Miner]].

Miner fungerar som en integrations- och datainsamlingskomponent som hämtar data från olika tekniska system och publicerar denna till Orbiq.

En förenklad arkitektur kan beskrivas enligt följande:

  * tekniska system och datakällor
  * datainsamling via Miner
  * lagring, analys och visualisering i Orbiq

Miner ansvarar för kommunikation med olika system, protokoll och API:er, medan Orbiq fungerar som den operativa plattformen där data används för drift, analys och visualisering.

===== Centrala begrepp =====

I Orbiq används några centrala begrepp för att strukturera information i plattformen.

^ Begrepp ^ Beskrivning ^
| Objekt | Representerar en fysisk enhet, exempelvis en fastighet, byggnad eller annan del av fastighetsbeståndet |
| Resurs | Ett system eller en tjänst kopplad till ett objekt |
| Datapunkt | Ett mätvärde eller signal från ett tekniskt system |
| Larm | En händelse eller avvikelse från ett system |
| Miner | Komponent för datainsamling och integration |

Dessa begrepp används för att strukturera system, data och funktioner i plattformen.

===== Fastighetsstruktur och objekt =====

Orbiq innehåller en struktur för att organisera fastighetsbeståndet.

Objekt kan representera exempelvis:

  * områden
  * fastigheter
  * byggnader
  * tekniska installationer

Strukturen gör det möjligt att koppla samman tekniska system, larm, datapunkter och analys med rätt delar av fastighetsbeståndet.

Detta ger en tydlig och navigerbar modell över organisationens tekniska miljö.

===== Resurshantering =====

Orbiq erbjuder en central katalog över tekniska system och resurser.

En resurs kan representera:

  * ett styr- eller automationssystem
  * ett webbgränssnitt till ett tekniskt system
  * en serverbaserad applikation
  * en IoT-plattform eller extern tjänst
  * en datakälla eller integration
  * en enkel URL till ett relevant system eller dokument

Resurser kopplas till objekt i fastighetsstrukturen, exempelvis fastigheter eller byggnader.
<mermaid>
flowchart LR
  Obj["Objekt<br>(fastighet/byggnad)"] --> Res["Resurs<br>(system/URL/tjänst)"]
  Res --> Access["Åtkomst<br>(proxy / RDP / VNC / länk"]
  Access --> Use["Operativ användning<br>(larm, dokumentation, arbete)"]
  Res --> Meta["Metadata<br>klassificering/taggar"]
  Meta --> Search["Sökning & överblick"]
</mermaid>

Det gör det möjligt för användare att:

  * snabbt hitta rätt system för en specifik byggnad
  * navigera mellan relaterade system
  * få en samlad bild av vilka system som finns i beståndet

Systemet kan hantera mycket stora och heterogena systemlandskap där varje fastighet kan ha olika fabrikat och tekniska lösningar.

===== Säker åtkomst till tekniska system =====

Orbiq fungerar som en teknikportal för säker åtkomst till fastighetstekniska system.

Via plattformen kan användare nå underliggande system genom exempelvis:

  * webbaserade gränssnitt via reverse proxy
  * serverbaserade applikationer via webbaserad RDP- eller VNC-klient
  * direkta länkar till externa system och tjänster

Detta gör det möjligt att samla åtkomsten till ett stort antal system i ett gemensamt gränssnitt utan att användarna behöver installera eller administrera separata VPN-lösningar eller klientprogram.

Åtkomsten kan styras centralt via Orbiqs användarhantering och integration mot organisationens identitetssystem.

===== Orbiq Overlay =====

Orbiq Overlay är ett överliggande användargränssnitt som gör det möjligt att visa information och nå funktioner från Orbiq direkt ovanpå underliggande system.

När en användare öppnar ett system via Orbiqs proxyfunktion visas en flytande ikon ovanpå systemets användargränssnitt. Ikonen fungerar som en kontextuell ingång till funktioner i plattformen.

Overlayen kan exempelvis användas för att:

  * visa notifieringar och driftmeddelanden
  * skapa eller läsa driftanteckningar
  * hantera diskussioner kopplade till ett system
  * visa larm och avvikelser
  * navigera till relaterade resurser i Orbiq

Overlayen implementeras genom att ett script injiceras i proxade webbsidor via Orbiqs reverse proxy.

Ikonen är flytande och kan placeras ovanpå systemets användargränssnitt utan att påverka systemets funktion.

Overlayens utseende kan anpassas via Orbiqs temahantering så att färger och logotyp kan följa organisationens grafiska profil.

===== Central larmhantering =====

Orbiq erbjuder funktioner för central hantering av driftlarm och avvikelser.

Larm kan komma från olika typer av system och källor, exempelvis:

  * styr- och övervakningssystem
  * larm- och säkerhetssystem
  * IoT-plattformar
  * e-postbaserade larm
  * externa integrationer

Larmen kan tas emot via exempelvis:

  * API-integrationer
  * datainsamling via Miner
  * e-post via Orbiqs SMTP-server eller från externa servrar via IMAP, där larm tolkas och omvandlas till strukturerade händelser

Genom att samla larm från flera system i en gemensam plattform kan organisationen skapa en mer sammanhållen bild av driftläget och hantera avvikelser på ett strukturerat sätt.

===== Dataplattform =====

Orbiq innehåller en dataplattform för lagring och analys av data från fastighetstekniska system.

Data kan samlas in från ett stort antal olika källor via datainsamlingskomponenten Miner.

Miner kan exempelvis:

  * hämta mätdata från tekniska system
  * integrera mot olika protokoll och API:er
  * tolka och strukturera data från olika källor
  * publicera data till Orbiqs tidsseriedatabas

Metadata kan samtidigt publiceras till grafdatabaser vilket gör det möjligt att koppla samman tekniska objekt, byggnader och system i en gemensam informationsmodell.

Genom att kombinera metadata och tidsseriedata kan Orbiq:

  * stödja analys och visualisering
  * tillhandahålla data till andra applikationer via API
  * fungera som datakälla för energiuppföljning och optimering

===== Öppna API:er =====

Orbiq erbjuder API:er för att integrera plattformen med andra system och applikationer.

API:erna kan användas för att exempelvis:

  * läsa och skriva mätdata
  * hantera fastighetsstrukturer och objekt
  * administrera resurser och system
  * hämta och skapa larm
  * integrera externa analys- eller driftverktyg

Det gör det möjligt att använda Orbiq som en öppen integrationsplattform där data och funktionalitet kan delas mellan olika system.

===== Identitetshantering =====

Orbiq kan integreras med organisationens centrala identitetssystem för användarhantering och autentisering.

Plattformen har exempelvis stöd för SAML2, integration mot Microsoft Entra samt stöd för multifaktorautentisering (MFA) via vanligt förekommande lösningar såsom Microsoft Authenticator eller Google Authenticator.

Det gör det möjligt att använda Single Sign-On mellan Orbiq och underliggande system samtidigt som organisationen behåller central kontroll över behörigheter.

===== Administration =====

Orbiq innehåller ett administrativt gränssnitt där organisationen själv kan administrera plattformen.

Via administrationsgränssnittet kan användare exempelvis:

  * hantera fastighetsstruktur och objekt
  * registrera och konfigurera resurser
  * administrera användarkonton och roller
  * konfigurera proxyprofiler
  * hantera larmregler och notifieringar
  * anpassa systemets grafiska profil via temahantering

Det gör det möjligt för organisationen att själva vidareutveckla och anpassa plattformen utan att vara beroende av extern leverantör i den dagliga driften.