# tungcbh/first-cloud-journey-workshop architecture

> Architecture diagram of the GitHub repository tungcbh/first-cloud-journey-workshop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tungcbh/first-cloud-journey-workshop
- Repository: https://github.com/tungcbh/first-cloud-journey-workshop

## Overview

##### Project type and purpose
- This is not a traditional full-stack app but an Infrastructure-as-Code (IaC) “workshop” repository built with Terraform modules.
- Its goal is to teach or demonstrate AWS service provisioning for cost management and IAM access control.

##### File structure
- Top-level:
- README.md – high-level workshop title (“first-cloud-journey-workshop”).
- explore_aws_services/ – contains one directory per exercise (2-manage-usage-cost, 4-iam-access-control).
- Each exercise directory follows the same pattern:
- main.tf – resource definitions
- variables.tf – input variables
- terraform.tf (or terraform.tfvars) – backend or environment-specific settings
- .terraform.lock.hcl – dependency lockfile
- README.md – exercise-specific instructions and context

##### README.md
- The root README is minimal; it simply names the workshop.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Actor
    DevCI["Developer / CI Pipeline"]:::external
    click DevCI "https://github.com/tungcbh/first-cloud-journey-workshop/blob/main/README.md"

    %% Terraform Core
    TerraformCore["Terraform Core\n(orchestration layer)"]:::terraform
    click TerraformCore "https://github.com/tungcbh/first-cloud-journey-workshop/tree/main/./"

    %% State Backend
    StateBackend["Terraform State Backend\n(S3 + DynamoDB)"]:::state

    %% Modules
    subgraph "Modules" 
        style Modules fill:none,stroke:none
        ManageCost["Module: manage-usage-cost"]:::module
        click ManageCost "https://github.com/tungcbh/first-cloud-journey-workshop/blob/main/explore_aws_services/2-manage-usage-cost/main.tf"
        IAMAccess["Module: iam-access-control"]:::module
        click IAMAccess "https://github.com/tungcbh/first-cloud-journey-workshop/blob/main/explore_aws_services/4-iam-access-control/main.tf"
    end

    %% AWS Services
    subgraph "AWS Services"
        style AWS_Services fill:none,stroke:none
        CostUsage["AWS Cost & Usage\n(Cost Explorer, Budgets)"]:::aws
        IAMService["AWS IAM\n(Users, Roles, Policies)"]:::aws
    end

    %% Relationships
    DevCI -->|"runs init/plan/apply"| TerraformCore
    TerraformCore -->|"invokes modules"| ManageCost
    TerraformCore -->|"invokes modules"| IAMAccess
    TerraformCore -->|"reads/writes state"| StateBackend
    ManageCost -->|"API calls"| CostUsage
    IAMAccess -->|"API calls"| IAMService

    %% Styles
    classDef external fill:#fdf,stroke:#333,stroke-width:1px
    classDef terraform fill:#bbf,stroke:#333,stroke-width:1px
    classDef module fill:#bfb,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
    classDef aws fill:#ffb,stroke:#333,stroke-width:1px
    classDef state fill:#fbf,stroke:#333,stroke-width:1px,stroke-dasharray: 2 2
```
