Docs / Getting Started / Understanding Activity Center and Progress States

Understanding Activity Center and Progress States

Published · Last updated: May 2026 · 2 min read

Architecture Overview

Unlike legacy tools where you trigger an action and are forced to watch a spinning loader, CloudAIPilot embraces an asynchronous, "fire-and-forget" orchestration model via the Activity Center.

Whenever you initiate a long-running infrastructure task—such as server provisioning, container deployments, cloud uploads, or database restorations—the operation is immediately handed off to the backend control plane. You can close the modal, navigate away, or completely shut down your browser without interrupting the task.

The Global Operations Matrix

The Activity Center provides a unified, real-time view of every active operation in your organization. It tracks:

  • Server Lifecycle: Provisioning, Migrations, and Post-Quantum (PQC) Activation.
  • Application Workloads: Git Deployments, Docker App Deployments, SFTP configuration, and Site/SSL Setup.
  • Data Operations: System Backups, Restores, Database Provisioning, and Cloud Storage transfers (Uploads/Downloads).

How It Works Under the Hood

The Activity Center relies on a highly resilient, fault-tolerant state engine:

  1. WebSocket Streaming: As background workers execute tasks on your infrastructure, they stream granular, step-by-step telemetry directly to your browser via secure WebSockets.
  2. Auto-Reconnection: If your network drops, the Activity Center automatically attempts to reconnect to the live stream.
  3. Persistent Local State: Your active processes are cached locally. If you refresh the page, the Activity Center instantly restores your view without losing context.
  4. Reconciliation Engine: If you close your browser completely and return hours later, the frontend automatically reconciles all "stale" tasks with the backend APIs to determine if they successfully completed or failed while you were away.

Progress States and Step Tracking

Every major operation is broken down into precise steps, providing total transparency into the control plane's actions.

Global Process Statuses

  • Pending: The task is queued on the control plane.
  • Running: Active execution is occurring.
  • Completed: All steps finished successfully.
  • Failed: A critical error occurred during execution.

Granular Step Statuses

Within a running process, individual steps are visually tracked:

  • Active: The specific script or API call currently executing.
  • Skipped: Steps that were bypassed (e.g., skipping SSL setup if it was not requested).
  • Failed / Rolled Back: If a step fails (such as insufficient disk space during a database restore), CloudAIPilot will often trigger an autonomous rollback sequence to return your server to its previous safe state. The Activity Center will visually indicate both the exact point of failure and the subsequent rollback execution.

Accessing the Activity Center

You can open the Activity Center at any time by clicking the Activity tab in the collapsible "More" section of the left sidebar. If there are active tasks, a counter badge will appear indicating the number of concurrent operations currently running.

Related Articles