> For the complete documentation index, see [llms.txt](https://docs.splexit.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.splexit.de/system/technische-architektur.md).

# Technische Architektur

Diese Seite richtet sich an IT-Verantwortliche, Schulträger und Entwickler:innen, die das technische Fundament von Splexit verstehen möchten. Für die Nutzerperspektive siehe die Systemübersicht.

### Tech Stack

| Schicht           | Technologie                            | Beschreibung                                                                                            |
| ----------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Companion App** | Flutter (Dart)                         | Plattformübergreifende App für iOS und Android. Enthält CMS, Editor, Presenter und integrierten Viewer. |
| **XR Viewer**     | Unity (C#)                             | XR-Client für Headsets. Nutzt XR Interaction Toolkit und AR Foundation für die räumliche Darstellung.   |
| **XR Runtime**    | OpenXR                                 | Plattformübergreifende API für VR/AR-Geräte — keine Abhängigkeit von einem einzelnen Hersteller.        |
| **Backend**       | Supabase                               | Postgres-Datenbank, Auth, Storage und Edge Functions. Gehostet oder self-hosted.                        |
| **Infrastruktur** | Docker-Container, Kubernetes Manifeste | Containerisierte Deployments für Self-Hosting und Skalierung.                                           |

### Client-Server-Architektur

Die Companion App betreibt während einer Präsentation einen **lokalen Host-Server**. Dieser Server übernimmt:

* **Session-Management** — Aufbau und Verwaltung der Multi-User-Session
* **Geräte-Discovery** — automatische Erkennung von Viewern im selben WLAN
* **Content-Synchronisation** — Verteilung der Projektdaten an alle verbundenen Endgeräte
* **Präsentations-Steuerung** — synchrone Auslieferung von Splex- und Mediaslide-Zuständen an alle Viewer

Die Kommunikation läuft lokal über WLAN — es wird kein externer Server benötigt. Bis zu 50 Endgeräte wurden bereits gleichzeitig auf einem handelsüblichen Router gesteuert. Rein technisch sind bis zu 255 Geräte möglich. Die tatsächliche Anzahl ist abhängig vom Netzwerk und dem Router.

{% hint style="info" %}
\
**Offene Control-API**\
Die lokale Steuer-API ist offen dokumentiert. Eigene Steuerelemente oder Integrationen können darüber angebunden werden.<br>
{% endhint %}

### Offene Standards

#### OpenXR

Splexit nutzt OpenXR als plattformübergreifende XR-Runtime im Unity-Client. Das bedeutet: Eine nahezu identische Codebase läuft auf Tablet, Quest, Pico und Vive.

#### glTF / GLB

Das primäre 3D-Format in Splexit. GLB-Dateien (binäres glTF) werden für Mediaslides und 3D-Modelle verwendet. Draco-Kompression wird für effiziente Netzwerkübertragung unterstützt.

#### WebXR

Über den WebXR-Modus der Headsets können externe browserbasierte XR-Plattformen zentral auf alle verbundenen Geräte ausgespielt werden — z. B. CoSpaces, Hubs, 360cities oder Arrival.Space. Die Companion App fungiert dabei als Launcher.

### Self-Hosting

Das gesamte Backend kann auf eigener Infrastruktur betrieben werden. Das gibt Schulträgern und Bildungseinrichtungen volle Datenhoheit.&#x20;

#### Deployment-Optionen

| Option               | Beschreibung                                                                   |
| -------------------- | ------------------------------------------------------------------------------ |
| **Docker Compose**   | Schneller lokaler Start — empfohlen für Einzelinstallationen und Tests         |
| **Kubernetes / k3s** | Produktionsumgebungen mit Skalierungsbedarf. Schlankes Setup über k3s möglich. |

Das CMS, die Authentifizierung und der Content-Storage laufen in diesem Setup vollständig lokal. Externe Dienste werden nur nach expliziter Einwilligung angebunden.

#### Managed Service

Die Architektur ist DSGVO-konform konzipiert:

* Optionales lokales Hosting mit voller Datenhoheit
* Keine externen Dienste ohne Einwilligung
* EU-Server bei gehosteter / gemanagter Nutzung der Splexit-Plattform garantiert. Keine Integration von U.S. Diensten

### Integrationen

Splexit ist als offenes, integrationsfähiges Ökosystem konzipiert. Externe Dienste werden über APIs angebunden und erweitern Splexit um Content-Quellen oder Funktionen.

#### Verfügbar

| Integration    | Typ     | Beschreibung                                                         |
| -------------- | ------- | -------------------------------------------------------------------- |
| **Sketchfab**  | Content | 3D-Modelle direkt ins Dashboard importieren und in Splexes verwenden |
| **Generio AI** | Content | KI-gestützte 3D-Modell-Generierung — von Text zu 3D-Asset            |

#### In Vorbereitung

| Integration      | Typ     | Beschreibung                                              |
| ---------------- | ------- | --------------------------------------------------------- |
| **Skybox AI**    | Content | 360°-Umgebungen per KI generieren                         |
| **OpenAI**       | Feature | KI-Assistenten und Content-Generierung im Bildungskontext |
| **Gemini AI**    | Feature | Multimodale KI-Features für Content-Erstellung            |
| **Meshy AI**     | Content | Image-to-3D und Text-to-3D Asset-Generierung              |
| **Stability AI** | Content | Bildgenerierung mit Stable Diffusion für Lerninhalte      |

#### Schulcloud- und LMS-Anbindung

Geplant ist die Anbindung an bestehende digitale Infrastrukturen im Bildungsbereich:

* **Moodle** — als Authentifizierungs-Provider (SSO, LTI 1.3)
* **Schulclouds** — Import von Inhalten und Nutzerverwaltung über Plugins

### Open Source

Der gesamte Splexit-Code wird öffentlich bereitgestellt. Alle Flutter Dart und Unity-C#-Komponenten sind Open Source. Das Ziel: Bildungseinrichtungen können die Software prüfen, anpassen und weiterentwickeln — ohne Abhängigkeit vom Hersteller.

* GitHub Repository (in Kürze verfügbar)
* Contribution Guide für Pull Requests
* Developer-Dokumentation mit Code-Beispielen

Weitere Details unter [splexit.de/technologie](https://splexit.de/technologie).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.splexit.de/system/technische-architektur.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.