Architecture & Concepts

Z-UCP is not just a simple web panel, but a scalable multi-tenant SaaS platform. This means that a single instance of the software can serve hundreds of different FiveM servers simultaneously while all data remains strictly isolated from each other.

The Multi-Tenant Model (Multi-Tenancy)

Every server operator is managed in our system as a tenant.

• Data Isolation: Every tenant has their own database connections, CMS content, media assets, and user roles. There is no mixing of data between different projects.
• Routing: A tenant is identified via the hostname (subdomain or custom domain). Our middleware extracts the tenantSlug and ensures that only the relevant data is loaded.

Bridge Technology

Communication with your FiveM server takes place via a bidirectional bridge:

1. Pull Model (Web -> Server): When you perform an action in the panel (e.g., kick a player), the panel sends an encrypted request to the bridge plugin on your server.
2. Push Model (Server -> Web): Your server regularly sends heartbeats, player statistics, and log events to our API.

Framework Agnosticism

One of the most powerful features of Z-UCP is the Query Engine. It is designed to work with almost any framework (ESX, QB-Core, Custom):

• Schema Mapping: In the settings, you define which table and column each data point is located in (e.g., users vs. players).
• Dynamic Parsing: The engine automatically detects whether inventories are stored as JSON strings, separate table entries, or specialized systems (such as ox_inventory).