# jojoooo1/cloud-diplomats-terraform-commons architecture

> Architecture diagram of the GitHub repository jojoooo1/cloud-diplomats-terraform-commons, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jojoooo1/cloud-diplomats-terraform-commons
- Repository: https://github.com/jojoooo1/cloud-diplomats-terraform-commons

## Overview

##### Project type and purpose
- This is a Terraform–based Infrastructure-as-Code (IaC) project whose goal is to automate the setup of a Google Cloud Platform (GCP) Organization’s folder hierarchy, organization-level policies, and GCP projects (split by “commons”, “development”, and “production” scopes).
- Key indicators: directories named “folders-and-policies” and “projects,” each containing Terraform files (common.tf, main.tf, variables.tf, outputs.tf, tf.example), plus README links to blog posts on “Terraforming GCP folders” and “Terraforming GCP projects.”

##### File structure
- Top-level modules:
- folders-and-policies/ → creates GCP Organization folders and applies org policies
- projects/ → contains subdirectories for different project types
- Under projects/:
- commons/ → reusable common-service modules (dns, oauth, workload-identity-federation)
- development/ → environment-specific projects (services, shared)
- production/ → environment-specific projects (services)
- Each module folder has: .pre-commit-config.yaml (linting), common.tf (shared definitions), main.tf (resource definitions), variables.tf (inputs), outputs.tf (outputs), tf.example (usage example).

##### README for additional insights
- The README simply points to Medium articles explaining how the Terraform code structures GCP organization, folders, org policies, and projects.

##### Elements
- Clear, consistent labels for each Terraform module/folder (e.g., “folders-and-policies”, “projects/commons/dns”, etc.)
- From CI/CD to Terraform modules
- Between modules (folder outputs → project inputs)
- From Terraform modules to GCP entities (Organization, Folders, Projects, APIs)
- Blue rectangles for Terraform modules

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Top CI/CD layer
    CICD["Terraform Orchestration (CI/CD & CLI)"]:::terraform

    %% Organization & Policies layer
    subgraph "Organization & Policies"
        FAP["folders-and-policies Module"]:::terraform
        ORG["GCP Organization"]:::gcp
        FOLDER["GCP Folders"]:::gcp
    end

    %% Projects layer
    subgraph "Projects Modules"
        subgraph "Commons Modules"
            DNS["DNS Service Module"]:::service
            OAUTH["OAuth Service Module"]:::service
            WIF["Workload Identity Federation Module"]:::service
        end
        subgraph "Development Environment"
            DEV_SERVICES["Development Services Module"]:::terraform
            DEV_SHARED["Development Shared Module"]:::terraform
        end
        subgraph "Production Environment"
            PROD_SERVICES["Production Services Module"]:::terraform
        end
    end

    %% GCP Projects resource
    PROJECTS["GCP Projects"]:::gcp

    %% Flows
    CICD -->|"initiate Terraform plan/apply"| FAP
    FAP -->|"creates org folders"| ORG
    ORG -->|"folders created"| FOLDER
    FAP -->|"folder_id"| DEV_SERVICES
    FAP -->|"folder_id"| DEV_SHARED
    FAP -->|"folder_id"| PROD_SERVICES

    DEV_SERVICES -->|"project_id"| PROJECTS
    DEV_SHARED -->|"project_id"| PROJECTS
    PROD_SERVICES -->|"project_id"| PROJECTS

    PROJECTS -->|"provisions via modules"| DNS
    PROJECTS -->|"provisions via modules"| OAUTH
    PROJECTS -->|"provisions via modules"| WIF

    %% Click events
    click CICD "https://github.com/jojoooo1/cloud-diplomats-terraform-commons/blob/main/README.md"
    click FAP "https://github.com/jojoooo1/cloud-diplomats-terraform-commons/tree/main/folders-and-policies/"
    click DNS "https://github.com/jojoooo1/cloud-diplomats-terraform-commons/tree/main/projects/commons/dns/"
    click OAUTH "https://github.com/jojoooo1/cloud-diplomats-terraform-commons/tree/main/projects/commons/oauth/"
    click WIF "https://github.com/jojoooo1/cloud-diplomats-terraform-commons/tree/main/projects/commons/workload-identity-federation/"
    click DEV_SERVICES "https://github.com/jojoooo1/cloud-diplomats-terraform-commons/tree/main/projects/development/services/"
    click DEV_SHARED "https://github.com/jojoooo1/cloud-diplomats-terraform-commons/tree/main/projects/development/shared/"
    click PROD_SERVICES "https://github.com/jojoooo1/cloud-diplomats-terraform-commons/tree/main/projects/production/services/"

    %% Styles
    classDef terraform fill:#1E90FF,stroke:#000,color:#fff
    classDef gcp fill:#FFA500,stroke:#000,color:#000
    classDef service fill:#32CD32,stroke:#000,color:#fff
```
