The Root Board serves as the central workspace for the Cloud Observatory platform. It provides a high-level view of the platform, its users, infrastructure, applications, and development tools. It acts as the primary navigation hub where stakeholders can understand how different systems interact.

---

Purpose

The Root Board enables users to:

• View the overall platform architecture.
• Understand relationships between applications and infrastructure.
• Navigate between major workboards.
• Visualize user roles and system interactions.
• Document architecture using markdown notes.

---

Major Components

🟦 Platform

Purpose

The Platform is responsible for architecting, analysing, publishing, and managing workboards.

Responsibilities

• Architect application workboards
• AI-powered architecture analysis
• Publishing workboards
• Mirror platform contracts

---

🟩 Customer Portal

Purpose

Represents the customer-facing applications.

Capabilities

• Marketing Website
• Customer Portal
• Identity Management
• Billing
• Entitlements
• Single Sign-On (SSO)

The customer portal interacts closely with the Platform and consumes analysis generated by it.

---

🟨 Cloud Infrastructure

Purpose

Provides the cloud infrastructure used by the platform.

Technology

• AWS CDK

Responsibilities

• Provision cloud resources
• Host cloud infrastructure
• Deploy platform services

---

🟪 CDX Local Codebase Analyser

A local developer plugin used for analysing application source code.

Purpose

• Analyse local codebases
• Push analysis into the Platform
• Assist developers during development

---

User Personas

Architect / End User

Uses the Platform to:

• Design workboards
• Explore architecture
• Consume documentation
• View system relationships

---

DevOps Engineer

Responsible for:

• Deploying CDX
• Provisioning infrastructure
• Managing cloud environments

Works closely with the Cloud Infrastructure board.

---

Developer

Uses the CDX Local Codebase Analyser plugin to:

• Analyse source code
• Push architectural insights
• Keep documentation up to date

---

Key Relationships

Platform ↔ Customer Portal

• Platform analysis is consumed by the Customer Portal.
• Platform contracts are mirrored.

---

Platform ↔ Cloud Infrastructure

Cloud Infrastructure:

• Provisions resources
• Hosts platform services

---

Developer ↔ Codebase Analyser

Developers execute the local analyser which sends architecture information back to the Platform.

---

DevOps ↔ Cloud Infrastructure

DevOps engineers deploy and manage infrastructure using AWS CDK.

---

Authentication & Platform Flow

The note on the board describes the authentication and onboarding flow:

1. Browser performs an SSO relay during onboarding.
2. The Entitlements service verifies JWTs using the organization's JWKS endpoint.
3. Platform contracts are mirrored across systems.

---

Workboard Information

---

Overall Architecture

Architect / End User
        │
        ▼
    Platform
   /    |    \
  /     |     \
Customer |  Cloud Infrastructure
 Portal  |        ▲
          \       |
           \      |
      Codebase Analyser
             ▲
        Developer

DevOps Engineer
        │
        ▼
Cloud Infrastructure

---

Summary

The Root Board is the entry point into the Cloud Observatory ecosystem. It connects platform services, customer-facing applications, cloud infrastructure, developer tooling, and user personas into a single visual workspace. This allows architects, developers, and DevOps engineers to understand the overall system architecture and navigate seamlessly between related workboards.