# dddwa/dddperth architecture

> Architecture diagram of the GitHub repository dddwa/dddperth, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dddwa/dddperth
- Repository: https://github.com/dddwa/dddperth

## Overview

##### Main Components

a. Frontend Layer:
- Next.js/Remix Application (main website)
- UI Components (ParkUI framework)
- MDX Content Processing
- Client-side State Management

b. Backend Services:
- Server-side Rendering (SSR) Components
- API Integrations:
- EventsAir Integration
- Sessionize Integration
- Tito Integration (ticketing)
- GitHub Integration

c. Infrastructure:
- Azure Infrastructure (based on .bicep files)
- Container Registry
- Key Vault
- Monitoring Services
- Dashboard

d. Observability:
- OpenTelemetry Integration
- Jaeger Tracing

**[Client Layer] → [Application Layer] → [Infrastructure Layer]**

##### Specific Component Relationships

- Content Flow: website-content → MDX Compilation → Frontend Routes
- API Integrations: Show external service connections
- Monitoring Flow: Application → OpenTelemetry → Jaeger
- Infrastructure Dependencies: Show Azure resources relationships

##### Important Details

a. Frontend Architecture:
- Component hierarchy (header, footer, hero, UI components)
- Static content flow (blog, pages)
- Client-side entry points

b. Backend Services:
- Server-side functions
- API integration points
- Authentication/authorization flows

c. Infrastructure Components:
- Container deployment
- Key Vault secrets management
- Monitoring setup
- Static content delivery

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        FE[Frontend Application]
        UI[UI Components Framework]
        CS[Client State]
        Header[Header Component]
        Footer[Footer Component]
        Hero[Hero Section]
    end

    subgraph Processing
        MDX[MDX Processing]
        CMDX[MDX Compilation]
    end

    subgraph "External APIs"
        EA[EventsAir API]
        SZ[Sessionize API]
        TT[Tito API]
        GH[GitHub API]
    end

    subgraph Infrastructure
        KV[Key Vault]
        CR[Container Registry]
        MON[Monitoring]
        DASH[Dashboard]
        MAIN[Main Infrastructure]
    end

    subgraph Content
        BLOG[Blog Content]
        WCONT[Website Content]
    end

    subgraph Observability
        OT[OpenTelemetry]
        JG[Jaeger Tracing]
    end

    subgraph "State Management"
        CSTATE[Conference State]
        CACT[Conference Actions]
    end

    subgraph Deployment
        CI[CI Pipeline]
        DOCK[Docker Config]
    end

    %% Relationships
    FE --> UI
    FE --> CS
    UI --> Header
    UI --> Footer
    UI --> Hero
    WCONT --> MDX
    BLOG --> MDX
    MDX --> CMDX
    CMDX --> FE
    FE --> EA
    FE --> SZ
    FE --> TT
    FE --> GH
    FE --> OT
    OT --> JG
    MAIN --> KV
    MAIN --> CR
    MAIN --> MON
    MAIN --> DASH
    CS --> CSTATE
    CS --> CACT

    %% Styles
    classDef frontend fill:#3498db
    classDef infrastructure fill:#e67e22
    classDef external fill:#2ecc71
    classDef monitoring fill:#9b59b6
    classDef content fill:#f1c40f

    class FE,UI,CS,Header,Footer,Hero frontend
    class KV,CR,MON,DASH,MAIN infrastructure
    class EA,SZ,TT,GH external
    class OT,JG monitoring
    class BLOG,WCONT,MDX,CMDX content

    %% Click Events
    click FE "https://github.com/dddwa/dddperth/tree/main/website/app"
    click UI "https://github.com/dddwa/dddperth/tree/main/website/app/components/ui"
    click MDX "https://github.com/dddwa/dddperth/blob/main/website/app/lib/mdx.server.ts"
    click CMDX "https://github.com/dddwa/dddperth/blob/main/website/app/lib/compile-mdx.server.ts"
    click EA "https://github.com/dddwa/dddperth/blob/main/website/app/lib/events-air.server.ts"
    click SZ "https://github.com/dddwa/dddperth/blob/main/website/app/lib/sessionize.server.ts"
    click TT "https://github.com/dddwa/dddperth/blob/main/website/app/lib/tito.server.ts"
    click GH "https://github.com/dddwa/dddperth/blob/main/website/app/lib/github.server.ts"
    click MAIN "https://github.com/dddwa/dddperth/blob/main/infra/main.bicep"
    click KV "https://github.com/dddwa/dddperth/blob/main/infra/shared/keyvault.bicep"
    click MON "https://github.com/dddwa/dddperth/blob/main/infra/shared/monitoring.bicep"
    click CR "https://github.com/dddwa/dddperth/blob/main/infra/shared/registry.bicep"
    click DASH "https://github.com/dddwa/dddperth/blob/main/infra/shared/dashboard-web.bicep"
    click BLOG "https://github.com/dddwa/dddperth/tree/main/blog/posts"
    click WCONT "https://github.com/dddwa/dddperth/tree/main/website-content/pages"
    click Header "https://github.com/dddwa/dddperth/blob/main/website/app/components/header/header.tsx"
    click Footer "https://github.com/dddwa/dddperth/blob/main/website/app/components/footer/footer.tsx"
    click Hero "https://github.com/dddwa/dddperth/blob/main/website/app/components/hero/hero.tsx"
    click OT "https://github.com/dddwa/dddperth/blob/main/website/app/lib/setupOpenTelemetry.tsx"
    click CSTATE "https://github.com/dddwa/dddperth/blob/main/website/app/lib/conference-state.ts"
    click CACT "https://github.com/dddwa/dddperth/blob/main/website/app/lib/conference-actions.ts"
    click CI "https://github.com/dddwa/dddperth/blob/main/.github/workflows/ci.yml"
    click DOCK "https://github.com/dddwa/dddperth/tree/main/Dockerfile"
```
