Information Architecture

Entity Hierarchy

Organization
├── Dashboard
├── Workspaces
│   └── Workspace
│       ├── Projects
│       │   └── Project
│       │       ├── Folders
│       │       └── Files (BPMN, DMN, JSON, Markdown)
│       ├── Catalog (workspace-scoped)
│       └── Settings
├── Clusters
│   └── Cluster
│       ├── Operate
│       │   ├── Dashboard
│       │   ├── Processes
│       │   ├── Decisions
│       │   └── Operations
│       ├── Tasklist
│       │   ├── Tasks
│       │   ├── Processes
│       │   └── Settings
│       └── Admin
│           ├── TBD
├── Catalog (organization-scoped)
├── Members
│   ├── Users
│   ├── Groups
│   └── Roles
└── Settings
    ├── Overview
    ├── Usage
    ├── Administration API
    └── General

Scope Model

The Hub operates across three scopes that determine what the user sees and can do:

Scope	Description	Sidebar Content	Breadcrumb
Organization (hub)	Top-level view of the entire organization	Dashboard, Workspaces, Clusters, Catalog, Members, Settings + Clusters list	[Org Name]
Workspace (workspace)	Scoped to a single workspace	Projects, Catalog, Settings + Assigned Clusters list	Org Name / [Workspace Name]
Cluster Component (cluster)	Immersive view of a cluster runtime component	Component-specific navigation (e.g., Operate sub-pages)	Entity / Cluster Name / [Component Name]

Cross-Cutting Concepts

Clusters are visible at both Organization and Workspace levels:

• At the organization level, all Clusters belonging to the Organization are listed (see Clusters section).
• At the workspace level, only Clusters assigned to that Workspace are shown.
• This dual visibility allows the Center of Excellence (CoE) to manage all infrastructure centrally while Delivery Teams see only their allocated resources.

Catalog exists at two levels:

• Organization Catalog — the master catalog of all reusable Catalog Assets, managed by Center of Excellence (CoE).
• Workspace Catalog — the catalog with assets available to a Workspace, where Developers discover and install them for their Projects.

---

Navigation

The navigation pattern combines a breadcrumb-driven top bar for entity context switching with a contextual sidebar for scope-specific actions.

Top Navigation Bar (Header)

The header is a fixed horizontal bar with three area:

• Camunda logo
• Dynamic breadcrumb chain (entity switchers)
• Options panel on the right side:
  • Search
  • Notifications
  • Help & Tutorials
  • User Profile
  • AI Copilot

Breadcrumb Navigation

The breadcrumb is the primary wayfinding element. It builds from left to right based on the user’s current depth in the hierarchy. Each segment is a two-part control:

1. Clickable label — navigates to that entity’s home page
2. Chevron dropdown — opens a switcher to change the selected entity

Breadcrumb States

Context	Breadcrumb Display
Organization level	[Org Name ▼]
Workspace level	Org Name ▼ / [Workspace Name ▼]
Project selected	Org Name ▼ / Workspace Name ▼ / [Project Name ▼]
Cluster detail	Entity ▼ / [Cluster Name] [Plan Tag] ▼
Cluster component	Entity ▼ / Cluster Name [Plan Tag] ▼ / [Component ▼]

Switcher Dropdowns

Dropdown	Header	Items Listed
Organization Switcher	”Switch Organization”	All available organizations
Workspace Switcher	”Switch Workspace”	All workspaces in current organization
Project Switcher	”Switch Project”	All projects in current workspace
Cluster Switcher	”Switch Cluster”	Clusters relevant to current context
Component Switcher	”Switch Component”	Operate, Tasklist, Admin

Back Navigation Behavior

• Clicking the org breadcrumb from workspace level → navigates to the Organization Home.
• Clicking the workspace breadcrumb when a project is selected → navigates to the list of all workspace projects.
• Clicking the entity breadcrumb from cluster view → returns to the level from which the cluster was accessed (org or workspace), preserving context.
• Clicking the cluster name from component view → navigates to the cluster detail page.

Sidebar Navigation

The sidebar is a collapsible panel (expandable to ~16rem, collapsible to ~3rem with icon-only mode) positioned below the header. Its content is entirely contextual — it changes based on the current scope.

Organization-Level Sidebar

Organization menu:

• Home
• Workspaces
• Clusters
• Catalog
• Members
• Settings

Below it, a Clusters section lists all organization clusters as expandable items. Each cluster expands to show sub-items: Operate, Tasklist, Admin.

Workspace-Level Sidebar

Workspace menu:

• Projects
• Catalog
• Settings

Below it, a Clusters section lists only the clusters assigned to the current workspace, each expandable with Operate, Tasklist, Admin sub-items.

Cluster Component Sidebar

When the user enters a cluster component (Operate, Tasklist, or Admin), the sidebar switches to that component’s internal navigation. The organization/workspace menu items are replaced.

Operate Sidebar:

Operate menu:

• Dashboard
• Processes
• Decisions
• Operations
  • Batch operations
  • Operations log

Tasklist Sidebar:

Tasklist menu:

• Tasks
• Processes
• Settings

Admin Sidebar:

Admin menu:

• TBD

---

Data Model

Entity Relationships

Organization (1)
 ├── has many ──→ OrganizationMember (N)
 ├── has many ──→ Workspace (N)
 │                 ├── has many ──→ WorkspaceMember (N)
 │                 ├── has ──→ WorkspaceSettings (1)
 │                 ├── has many ──→ ProjectFile (N, hierarchical)
 │                 └── assigned ──→ Cluster (N, subset of org clusters)
 ├── has many ──→ Cluster (N)
 │                 ├── has many ──→ Tenant (N)
 └── has ──→ CatalogItem (N, global catalog)