# hemzaz/tf-atmos architecture

> Architecture diagram of the GitHub repository hemzaz/tf-atmos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hemzaz/tf-atmos
- Repository: https://github.com/hemzaz/tf-atmos

## Overview

This repository is an Atmos-composed AWS infrastructure platform: operators select an environment stack, then run bootstrap or layered deployment workflows that plan and apply Terraform components. Stack configuration supplies shared defaults and component inputs; Terraform provisions networking, security, compute, and application services in AWS. Separate components cover monitoring, disaster recovery, and cost management. The README documents these capabilities and the deployment flow; sampled source excerpts were limited to cost-optimization functions and dependency/plan-sweep utilities, so component-to-component links are shown only where documented.

Main entry points: [`components/terraform`](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform) (Terraform components), [`workflows`](https://github.com/hemzaz/tf-atmos/tree/master/workflows) (Deploy workflows), [`stacks/orgs/fnx`](https://github.com/hemzaz/tf-atmos/tree/master/stacks/orgs/fnx) (Environment stacks), [`atmos.yaml`](https://github.com/hemzaz/tf-atmos/blob/master/atmos.yaml) (Atmos CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deploy["Deployment composition"]
  node_atmos["Atmos CLI<br/>[atmos.yaml]"]
  node_workflows["Deploy workflows"]
  node_stacks["Environment stacks"]
  node_catalog["Component catalog"]
  node_mixins["Stack mixins"]
  node_terraform["Terraform components"]
  node_shared["Shared modules"]
end

subgraph group_foundation["Cloud foundation"]
  node_backend[("Terraform backend")]
  node_network["Network &amp; VPC"]
  node_identity["IAM &amp; security"]
end

subgraph group_platform["Platform services"]
  node_compute["Compute platforms"]
  node_addons["EKS add-ons"]
  node_application["Application services"]
  node_data["Data services"]
end

subgraph group_operations["Operations"]
  node_monitoring["Monitoring"]
  node_recovery["Backup &amp; recovery"]
  node_cost["Cost management"]
end

node_operator(("Operator"))
node_aws["AWS services"]

node_operator -->|"runs"| node_atmos
node_atmos -->|"starts"| node_workflows
node_workflows -->|"selects"| node_stacks
node_stacks -->|"composes"| node_catalog
node_stacks -->|"imports"| node_mixins
node_workflows -->|"plans and applies"| node_terraform
node_terraform -->|"uses"| node_shared
node_terraform -->|"configures state"| node_backend
node_terraform -->|"provisions"| node_aws
node_network -->|"provisions"| node_aws
node_identity -->|"provisions"| node_aws
node_compute -->|"provisions"| node_aws
node_addons -->|"provisions"| node_aws
node_application -->|"provisions"| node_aws
node_data -->|"provisions"| node_aws
node_monitoring -->|"provisions"| node_aws
node_recovery -->|"provisions"| node_aws
node_cost -->|"analyzes and manages"| node_aws

click node_atmos "https://github.com/hemzaz/tf-atmos/blob/master/atmos.yaml"
click node_workflows "https://github.com/hemzaz/tf-atmos/tree/master/workflows"
click node_stacks "https://github.com/hemzaz/tf-atmos/tree/master/stacks/orgs/fnx"
click node_catalog "https://github.com/hemzaz/tf-atmos/tree/master/stacks/catalog"
click node_mixins "https://github.com/hemzaz/tf-atmos/tree/master/stacks/mixins"
click node_terraform "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform"
click node_shared "https://github.com/hemzaz/tf-atmos/tree/master/modules/terraform"
click node_backend "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/backend"
click node_network "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/vpc"
click node_identity "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/iam"
click node_compute "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/eks"
click node_addons "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/eks-addons"
click node_application "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/ecs"
click node_data "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/rds"
click node_monitoring "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/monitoring"
click node_recovery "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/backup"
click node_cost "https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/cost-optimization"

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_atmos,node_workflows,node_stacks,node_catalog,node_mixins,node_terraform,node_shared toneBlue
class node_backend,node_network,node_identity toneAmber
class node_compute,node_addons,node_application,node_data toneMint
class node_monitoring,node_recovery,node_cost toneRose
class node_operator,node_aws toneIndigo
```

## Components

### Deployment composition

- [Atmos CLI](https://github.com/hemzaz/tf-atmos/blob/master/atmos.yaml): `atmos.yaml`
- [Deploy workflows](https://github.com/hemzaz/tf-atmos/tree/master/workflows): `workflows`
- [Environment stacks](https://github.com/hemzaz/tf-atmos/tree/master/stacks/orgs/fnx): `stacks/orgs/fnx`
- [Component catalog](https://github.com/hemzaz/tf-atmos/tree/master/stacks/catalog): `stacks/catalog`
- [Stack mixins](https://github.com/hemzaz/tf-atmos/tree/master/stacks/mixins): `stacks/mixins`
- [Terraform components](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform): `components/terraform`
- [Shared modules](https://github.com/hemzaz/tf-atmos/tree/master/modules/terraform): `modules/terraform`

### Cloud foundation

- [Terraform backend](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/backend): `components/terraform/backend`
- [Network & VPC](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/vpc): `components/terraform/vpc`
- [IAM & security](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/iam): `components/terraform/iam`

### Platform services

- [Compute platforms](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/eks): `components/terraform/eks`
- [EKS add-ons](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/eks-addons): `components/terraform/eks-addons`
- [Application services](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/ecs): `components/terraform/ecs`
- [Data services](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/rds): `components/terraform/rds`

### Operations

- [Monitoring](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/monitoring): `components/terraform/monitoring`
- [Backup & recovery](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/backup): `components/terraform/backup`
- [Cost management](https://github.com/hemzaz/tf-atmos/tree/master/components/terraform/cost-optimization): `components/terraform/cost-optimization`

### Other components

- **Operator**
- **AWS services**

## Connections

- Operator → Atmos CLI: runs
- Atmos CLI → Deploy workflows: starts
- Deploy workflows → Environment stacks: selects
- Environment stacks → Component catalog: composes
- Environment stacks → Stack mixins: imports
- Deploy workflows → Terraform components: plans and applies
- Terraform components → Shared modules: uses
- Terraform components → Terraform backend: configures state
- Terraform components → AWS services: provisions
- Network & VPC → AWS services: provisions
- IAM & security → AWS services: provisions
- Compute platforms → AWS services: provisions
- EKS add-ons → AWS services: provisions
- Application services → AWS services: provisions
- Data services → AWS services: provisions
- Monitoring → AWS services: provisions
- Backup & recovery → AWS services: provisions
- Cost management → AWS services: analyzes and manages