z-dev.app logoDocs
Anmelden
Einführung
Was ist Z-UCP? Das SaaS-Konzept Erste Schritte
Konzepte
Architektur & Konzepte
Spieler Bereich
Spieler Leitfaden Z-Property & Housing
Admin Bereich
Audit Logs & Sicherheit Admin Übersicht Berechtigungen im Detail Rollen & Rechte (RBAC) CMS & Whitelabeling
Module & Integrationen
CMS Block-Referenz Database Best Practices Database Module
Technik & Sicherheit
Bridge Fehlerbehebung FiveM Bridge Setup Datenschutz & DSGVO API Referenz
© 2026 z-dev.app. Alle Rechte vorbehalten.

Architektur & Konzepte

Verstehe die technische Basis und das Mandanten-Modell von Z-UCP.

Architektur & Konzepte

Z-UCP ist nicht nur ein einfaches Web-Panel, sondern eine skalierbare Multi-Tenant SaaS Plattform. Das bedeutet, dass eine einzige Instanz der Software hunderte von verschiedenen FiveM-Servern gleichzeitig bedienen kann, während alle Daten strikt voneinander isoliert bleiben.

Das Mandanten-Modell (Multi-Tenancy)

Jeder Server-Betreiber wird in unserem System als Tenant (Mandant) geführt.

  • Daten-Isolation: Jeder Tenant hat seine eigenen Datenbank-Verbindungen, CMS-Inhalte, Medien-Assets und Benutzerrollen. Es gibt keine Vermischung von Daten zwischen verschiedenen Projekten.
  • Routing: Die Identifizierung eines Mandanten erfolgt über den Hostnamen (Subdomain oder Custom Domain). Unsere Middleware extrahiert den tenantSlug und stellt sicher, dass nur die relevanten Daten geladen werden.

Die Bridge-Technologie

Die Kommunikation mit deinem FiveM-Server erfolgt über eine bidirektionale Bridge:

  1. Pull-Modell (Web -> Server): Wenn du im Panel eine Aktion ausführst (z.B. einen Spieler kickst), sendet das Panel einen verschlüsselten Request an das Bridge-Plugin auf deinem Server.
  2. Push-Modell (Server -> Web): Dein Server sendet regelmäßig Heartbeats, Spielerstatistiken und Log-Events an unsere API.

Framework-Agnostik

Eines der mächtigsten Features von Z-UCP ist die Query Engine. Sie ist so konzipiert, dass sie mit fast jedem Framework funktioniert (ESX, QB-Core, Custom):

  • Schema Mapping: Du definierst in den Einstellungen, in welcher Tabelle und Spalte welche Daten liegen (z.B. users vs players).
  • Dynamic Parsing: Die Engine erkennt automatisch, ob Inventare als JSON-Strings, separate Tabellen-Einträge oder spezialisierte Systeme (wie ox_inventory) gespeichert sind.

Diese Flexibilität erlaubt es dir, Z-UCP auch dann zu nutzen, wenn du ein stark modifiziertes Framework verwendest.

VorherigeErste SchritteNächste Spieler Leitfaden