Struct SystemBootstrap 

pub struct SystemBootstrap;

Staged system initialization with static stability.

Follows the AWS data plane / control plane separation pattern:

Stage 1: Initialize SystemMetadataStore from local storage
Stage 2: Replay _system/* streams → populate in-memory caches
Stage 3: If empty, run first-boot bootstrap (create default tenant)
Stage 4: Return SystemRepositories → start accepting traffic

Static Stability

After bootstrap, all metadata reads go through in-memory caches (DashMap). If a system stream write fails, the error is logged but does NOT block the data plane. User event ingestion and queries continue with cached metadata until the system store recovers.

Implementations

impl SystemBootstrap

pub async fn initialize( system_data_dir: PathBuf, bootstrap_tenant: Option<String>, ) -> Result<SystemRepositories>

Execute the staged initialization sequence.

Arguments

• system_data_dir — Path to the system metadata storage directory
• bootstrap_tenant — Optional default tenant name for first-boot

Returns

SystemRepositories with all event-sourced repos initialized and caches populated.

pub async fn try_initialize( system_data_dir: Option<PathBuf>, bootstrap_tenant: Option<String>, ) -> Option<SystemRepositories>

Try to initialize system repositories, falling back to None if the system data directory is not configured.

This implements the backward-compatibility path: if no system_data_dir is set, the system continues with in-memory repositories.