Skip to content

Architecture

Architectural diagrams and design documentation for the Forge platform.

📋 Architecture Documentation

Document Description
Golden Path Standardized patterns and best practices for Forge apps

📊 Diagrams

Diagram Description Format
System Design High-level overview of the Forge platform architecture .drawio
Azure Infrastructure Azure resource topology and service dependencies .drawio
Eventing Event-driven architecture patterns and message flows .drawio
Front Door Azure Front Door configuration and routing patterns .drawio

System Design

The system design diagram provides a high-level overview of how Forge applications are structured and deployed.

Source: system-design.drawio

Key Components:

  • Application hosting with Azure App Service
  • API Management for gateway and policy enforcement
  • Identity integration with Entra ID and Okta
  • Infrastructure provisioning with Terraform

Azure Infrastructure

The Azure infrastructure diagram shows the resource topology for a typical Forge application deployment.

Source: azure.drawio

Key Components:

  • Resource group organization by environment
  • Networking with VNets and Private Endpoints
  • Managed identities for secure service-to-service communication
  • Key Vault for secrets management

Eventing

The eventing diagram illustrates event-driven architecture patterns used in Forge applications.

Source: eventing.drawio

Key Components:

  • Azure Service Bus for message queuing
  • Event subscriptions and topic routing
  • Cosmos DB change feed integration
  • Saga patterns for distributed transactions

Front Door

The Front Door diagram shows how Azure Front Door is configured for global load balancing and routing.

Source: front-door.drawio

Key Components:

  • Origin groups and health probes
  • Routing rules and caching policies
  • WAF integration for security
  • Custom domain configuration

🔧 Viewing Diagrams

These diagrams are in Draw.io format (.drawio). To view or edit:

  1. VS Code: Install the Draw.io Integration extension
  2. Online: Upload to app.diagrams.net
  3. Desktop: Use Draw.io Desktop