# vfarcic/idp-full-demo architecture

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

- Interactive diagram: https://gitdiagram.com/vfarcic/idp-full-demo
- Repository: https://github.com/vfarcic/idp-full-demo

## Overview

##### Main Components

a. Infrastructure Layer:
- Kubernetes Clusters (indicated by kind.yaml and eksctl-config)
- Cloud Providers (AWS, Azure, Google Cloud - evident from crossplane directory)
- Database Services (shown in crossplane/*-sql.yaml files)

b. Platform Services:
- ArgoCD (deployment management)
- Crossplane (cloud resource provisioning)
- Backstage (developer portal)

c. Application Layer:
- Custom CLI Tool (indicated by main.go and root.go)
- Helm Charts (in charts directory)

**┌─────────────────────────────────────────────┐**
- Infrastructure Layer               │
- ┬─────────────┬────────────────────┤
- AWS SQL │ Azure SQL   │ Google Cloud SQL   │
- ┴─────────────┴────────────────────┘

**┌─────────────────────────────────────────────┐**
- Platform Layer                  │
- ┬─────────────┬────────────────────┤
- ArgoCD  │ Crossplane  │     Backstage      │
- ┴─────────────┴────────────────────┘

**┌─────────────────────────────────────────────┐**
- Application Layer                  │
- ┬─────────────┬────────────────────┤
- Helm     │ Kubernetes  │  Custom CLI Tool    │
- Charts   │ Resources   │                     │
- ┴─────────────┴────────────────────┘

##### Additional Elements

- GitHub Actions workflow (from .github/workflows)
- Configuration management (shown by various .yaml files)
- Script automation (from scripts directory)

##### Implementation Details

- Clear component boundaries
- Labels for each component and connection
- Version/environment indicators where applicable

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Infrastructure
        AWS["AWS Cloud"]:::cloud
        Azure["Azure Cloud"]:::cloud
        GCP["Google Cloud"]:::cloud
        
        AWSDB["AWS SQL DB"]:::database
        AzureDB["Azure SQL DB"]:::database
        GCPDB["Google Cloud SQL"]:::database
        
        AWS --> AWSDB
        Azure --> AzureDB
        GCP --> GCPDB
    end
    
    subgraph Platform
        ArgoCD["ArgoCD"]:::platform
        Crossplane["Crossplane"]:::platform
        Backstage["Backstage Developer Portal"]:::platform
        
        ArgoCD --> Crossplane
        ArgoCD --> Backstage
        Crossplane --> AWS
        Crossplane --> Azure
        Crossplane --> GCP
    end
    
    subgraph Application
        CLI["Custom CLI Tool"]:::app
        K8s["Kubernetes Resources"]:::app
        Helm["Helm Charts"]:::app
        
        CLI --> ArgoCD
        CLI --> K8s
        Helm --> K8s
    end
    
    subgraph Automation
        GHA["GitHub Actions"]:::automation
        Scripts["Automation Scripts"]:::automation
        
        GHA --> ArgoCD
        Scripts --> ArgoCD
        Scripts --> Backstage
        Scripts --> Crossplane
        Scripts --> K8s
    end

    %% Click Events
    click CLI "https://github.com/vfarcic/idp-full-demo/blob/main/main.go"
    click K8s "https://github.com/vfarcic/idp-full-demo/tree/main/kubernetes"
    click Helm "https://github.com/vfarcic/idp-full-demo/tree/main/charts"
    click ArgoCD "https://github.com/vfarcic/idp-full-demo/tree/main/argocd"
    click Crossplane "https://github.com/vfarcic/idp-full-demo/tree/main/crossplane"
    click Backstage "https://github.com/vfarcic/idp-full-demo/tree/main/charts/backstage"
    click Scripts "https://github.com/vfarcic/idp-full-demo/tree/main/scripts"
    click GHA "https://github.com/vfarcic/idp-full-demo/blob/main/.github/workflows/sync-control-plane-direct.yml"
    click AWSDB "https://github.com/vfarcic/idp-full-demo/blob/main/crossplane/aws-sql.yaml"
    click AzureDB "https://github.com/vfarcic/idp-full-demo/blob/main/crossplane/azure-sql.yaml"
    click GCPDB "https://github.com/vfarcic/idp-full-demo/blob/main/crossplane/google-sql.yaml"

    %% Styling
    classDef cloud fill:#add8e6,stroke:#333,stroke-width:2px
    classDef database fill:#f8cecc,stroke:#333,stroke-width:2px
    classDef platform fill:#d5e8d4,stroke:#333,stroke-width:2px
    classDef app fill:#ffe6cc,stroke:#333,stroke-width:2px
    classDef automation fill:#e1d5e7,stroke:#333,stroke-width:2px

    %% Legend
    subgraph Legend
        L1["Cloud Services"]:::cloud
        L2["Databases"]:::database
        L3["Platform Services"]:::platform
        L4["Applications"]:::app
        L5["Automation"]:::automation
    end
```
