# derakings/bedrock-project architecture

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

- Interactive diagram: https://gitdiagram.com/derakings/bedrock-project
- Repository: https://github.com/derakings/bedrock-project

## Overview

This repository provisions InnovateMart’s AWS/Kubernetes hosting environment: an operator applies Terraform, then deploys the application to EKS and accesses its UI through an ALB. The documented platform includes VPC networking, EKS, IAM, managed databases, Kubernetes workloads, and deployment automation. The tree exposes Terraform and manifest files, but no source excerpts; links between specific Terraform resources are therefore omitted. CI automation is included because the README describes it as part of the deployment workflow.

Main entry points: [`eks-cluster.tf`](https://github.com/derakings/bedrock-project/blob/main/eks-cluster.tf) (EKS Cluster), [`kubernetes.yaml`](https://github.com/derakings/bedrock-project/blob/main/kubernetes.yaml) (Kubernetes Workloads), [`.github/workflows/workflow.yml`](https://github.com/derakings/bedrock-project/blob/main/.github/workflows/workflow.yml) (GitHub Actions), [`eks-vpc.tf`](https://github.com/derakings/bedrock-project/blob/main/eks-vpc.tf) (VPC Network)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_network["Network"]
  node_vpc["VPC Network<br/>[eks-vpc.tf]"]
end

subgraph group_aws["AWS Platform"]
  node_eks["EKS Cluster<br/>[eks-cluster.tf]"]
  node_iam_roles["IAM Roles<br/>[iam.tf]"]
  node_iam_policy["IAM Policy<br/>[iam-policy.json]"]
  node_trust_policy["Trust Policy<br/>[trust-policy.json]"]
  node_state_lock[("State Lock<br/>[s3-state-lock.tf]")]
  node_rds_mysql[("Catalog Database")]
  node_rds_postgres[("Orders Database")]
  node_dynamodb[("Cart Store")]
end

subgraph group_workloads["Application Deployment"]
  node_k8s["Kubernetes Workloads<br/>[kubernetes.yaml]"]
  node_alb["Application Load Balancer"]
  node_ui["UI Service<br/>[kubernetes.yaml]"]
end

subgraph group_automation["Deployment Automation"]
  node_github_actions["GitHub Actions<br/>[workflow.yml]"]
end

node_operator(("Operator"))
node_aws["AWS"]
node_browser_user(("Application User"))

node_operator -->|"provisions with Terraform"| node_vpc
node_operator -->|"provisions with Terraform"| node_eks
node_operator -->|"provisions with Terraform"| node_iam_roles
node_operator -->|"applies manifests"| node_k8s
node_github_actions -->|"deploys to"| node_eks
node_k8s -->|"deploys workloads"| node_eks
node_browser_user -->|"opens UI through"| node_alb
node_alb -->|"exposes"| node_ui
node_aws -->|"hosts catalog"| node_rds_mysql
node_aws -->|"hosts orders"| node_rds_postgres
node_aws -->|"hosts carts"| node_dynamodb

click node_vpc "https://github.com/derakings/bedrock-project/blob/main/eks-vpc.tf"
click node_eks "https://github.com/derakings/bedrock-project/blob/main/eks-cluster.tf"
click node_iam_roles "https://github.com/derakings/bedrock-project/blob/main/iam.tf"
click node_iam_policy "https://github.com/derakings/bedrock-project/blob/main/iam-policy.json"
click node_trust_policy "https://github.com/derakings/bedrock-project/blob/main/trust-policy.json"
click node_state_lock "https://github.com/derakings/bedrock-project/blob/main/s3-state-lock.tf"
click node_k8s "https://github.com/derakings/bedrock-project/blob/main/kubernetes.yaml"
click node_ui "https://github.com/derakings/bedrock-project/blob/main/kubernetes.yaml"
click node_github_actions "https://github.com/derakings/bedrock-project/blob/main/.github/workflows/workflow.yml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_vpc,node_browser_user toneBlue
class node_eks,node_iam_roles,node_iam_policy,node_trust_policy,node_state_lock,node_rds_mysql,node_rds_postgres,node_dynamodb toneAmber
class node_k8s,node_alb,node_ui toneMint
class node_github_actions toneRose
class node_operator,node_aws toneIndigo
```

## Components

### Network

- [VPC Network](https://github.com/derakings/bedrock-project/blob/main/eks-vpc.tf): `eks-vpc.tf`

### AWS Platform

- [EKS Cluster](https://github.com/derakings/bedrock-project/blob/main/eks-cluster.tf): `eks-cluster.tf`
- [IAM Roles](https://github.com/derakings/bedrock-project/blob/main/iam.tf): `iam.tf`
- [IAM Policy](https://github.com/derakings/bedrock-project/blob/main/iam-policy.json): `iam-policy.json`
- [Trust Policy](https://github.com/derakings/bedrock-project/blob/main/trust-policy.json): `trust-policy.json`
- [State Lock](https://github.com/derakings/bedrock-project/blob/main/s3-state-lock.tf): `s3-state-lock.tf`
- **Catalog Database**
- **Orders Database**
- **Cart Store**

### Application Deployment

- [Kubernetes Workloads](https://github.com/derakings/bedrock-project/blob/main/kubernetes.yaml): `kubernetes.yaml`
- **Application Load Balancer**
- [UI Service](https://github.com/derakings/bedrock-project/blob/main/kubernetes.yaml): `kubernetes.yaml`

### Deployment Automation

- [GitHub Actions](https://github.com/derakings/bedrock-project/blob/main/.github/workflows/workflow.yml): `.github/workflows/workflow.yml`

### Other components

- **Operator**
- **AWS**
- **Application User**

## Connections

- Operator → VPC Network: provisions with Terraform (evidence: `README.md`)
- Operator → EKS Cluster: provisions with Terraform (evidence: `README.md`)
- Operator → IAM Roles: provisions with Terraform (evidence: `README.md`)
- Operator → Kubernetes Workloads: applies manifests (evidence: `README.md`)
- GitHub Actions → EKS Cluster: deploys to (evidence: `README.md`)
- Kubernetes Workloads → EKS Cluster: deploys workloads (evidence: `README.md`)
- Application User → Application Load Balancer: opens UI through (evidence: `README.md`)
- Application Load Balancer → UI Service: exposes (evidence: `README.md`)
- AWS → Catalog Database: hosts catalog (evidence: `README.md`)
- AWS → Orders Database: hosts orders (evidence: `README.md`)
- AWS → Cart Store: hosts carts (evidence: `README.md`)
