Saltar al contenido principal

Orbit

The pluggable admin product for the Nucleus framework.

Orbit is a self-contained admin panel — Data Studio, a live request/SQL feed, a session viewer, RBAC management, and system metrics — that mounts in-process into any Nucleus application through the framework's extension/module API.

It is a separate Go module with its own release cadence, extracted from the framework core (nucleus ADR-019) so the core stays lean and the admin evolves as its own product. You add one dependency and one Mount(...) call; Orbit reads everything it needs from the running app's Runtime and serves its embedded React SPA — no separate asset deployment, no out-of-process sidecar, and no database of its own.

What you get

ModuleWhat it does
Data StudioBrowse, create, edit, and delete records for every model in the app's registry — tenant-aware, with import/export.
Live runtime inspectorReal-time feed of incoming HTTP requests and executed SQL across the whole app, with optional cross-node aggregation.
Session viewerList and revoke active server-side sessions.
Access control (RBAC)Inspect and manage the Casbin policies and roles backing the app's authorizer.
System metricsRuntime and resource consumption — CPU, memory, goroutines, database pool.
Audit logAn in-memory ring of admin actions.
Overview & HealthDashboard and health at a glance.

The UI ships embedded in the binary (go:embed), version-pinned to the Orbit module: a consumer who mounts Orbit gets the full admin offline, in a single binary.

Requirements

  • Go 1.26+
  • A Nucleus application to mount into.
  • (Optional) Redis — only for the cross-node live-telemetry relay (see Cluster observability).

Status

The first tagged release is v0.1.0. Pre-1.0: the API may still change before v1.0.

Next: Quick start.