# jaydenmichaels7/azure-client-baseline architecture

> Architecture diagram of the GitHub repository jaydenmichaels7/azure-client-baseline, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jaydenmichaels7/azure-client-baseline
- Repository: https://github.com/jaydenmichaels7/azure-client-baseline

## Overview

This repository provisions an isolated Azure client environment with Terraform and provides two operational utilities: an Azure drift audit and a client-environment folder generator. The main workflow is to bootstrap shared state and GitHub identity once, configure a client environment, then deploy its network, security, and optional compute resources. The README documents these capabilities and relationships; Terraform implementation details were not sampled, so the graph uses only supported paths and documented connections.

Main entry points: [`environments/dev/main.tf`](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/environments/dev/main.tf) (Client environment), [`bootstrap/main.tf`](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/bootstrap/main.tf) (Bootstrap setup), [`modules/networking/main.tf`](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/modules/networking/main.tf) (Network segmentation), [`modules/security/main.tf`](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/modules/security/main.tf) (Identity and vault)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provision["Provisioning"]
  node_bootstrap["Bootstrap setup<br/>[main.tf]"]
  node_client_env["Client environment<br/>[main.tf]"]
  node_backend[("Remote state<br/>[backend.tf]")]
  node_dev_template["Dev environment template"]
end

subgraph group_azure["Azure baseline"]
  node_network["Network segmentation<br/>[main.tf]"]
  node_security["Identity and vault<br/>[main.tf]"]
  node_compute["Optional VM<br/>[main.tf]"]
  node_azure_resources["Azure resources"]
end

subgraph group_tools["Operations tools"]
  node_audit["Drift audit<br/>[msp_audit.py]"]
  node_client_generator["Client generator<br/>[new_client.py]"]
end

node_engineer(("Engineer"))

node_engineer -->|"bootstraps once"| node_bootstrap
node_engineer -->|"configures environment"| node_client_env
node_bootstrap -->|"creates state storage"| node_backend
node_client_env -->|"stores state"| node_backend
node_client_env -->|"configures networking"| node_network
node_client_env -->|"configures security"| node_security
node_client_env -->|"optionally enables"| node_compute
node_network -->|"provisions VNet and NSGs"| node_azure_resources
node_security -->|"provisions vault and identities"| node_azure_resources
node_compute -->|"provisions VM"| node_azure_resources
node_engineer -->|"runs audit"| node_audit
node_audit -->|"reads resources, rules, secrets"| node_azure_resources
node_engineer -->|"generates client folder"| node_client_generator
node_client_generator -->|"copies template"| node_dev_template

click node_bootstrap "https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/bootstrap/main.tf"
click node_client_env "https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/environments/dev/main.tf"
click node_backend "https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/environments/dev/backend.tf"
click node_network "https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/modules/networking/main.tf"
click node_security "https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/modules/security/main.tf"
click node_compute "https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/modules/compute/main.tf"
click node_audit "https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/scripts/msp_audit.py"
click node_client_generator "https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/scripts/new_client.py"
click node_dev_template "https://github.com/jaydenmichaels7/azure-client-baseline/tree/main/environments/dev"

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_bootstrap,node_client_env,node_backend,node_dev_template toneBlue
class node_network,node_security,node_compute,node_azure_resources toneAmber
class node_audit,node_client_generator toneMint
class node_engineer toneIndigo
```

## Components

### Provisioning

- [Bootstrap setup](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/bootstrap/main.tf): `bootstrap/main.tf`
- [Client environment](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/environments/dev/main.tf): `environments/dev/main.tf`
- [Remote state](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/environments/dev/backend.tf): `environments/dev/backend.tf`
- [Dev environment template](https://github.com/jaydenmichaels7/azure-client-baseline/tree/main/environments/dev): `environments/dev`

### Azure baseline

- [Network segmentation](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/modules/networking/main.tf): `modules/networking/main.tf`
- [Identity and vault](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/modules/security/main.tf): `modules/security/main.tf`
- [Optional VM](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/modules/compute/main.tf): `modules/compute/main.tf`
- **Azure resources**

### Operations tools

- [Drift audit](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/scripts/msp_audit.py): `scripts/msp_audit.py`
- [Client generator](https://github.com/jaydenmichaels7/azure-client-baseline/blob/main/scripts/new_client.py): `scripts/new_client.py`

### Other components

- **Engineer**

## Connections

- Engineer → Bootstrap setup: bootstraps once (evidence: `README.md`)
- Engineer → Client environment: configures environment (evidence: `README.md`)
- Bootstrap setup → Remote state: creates state storage (evidence: `README.md`)
- Client environment → Remote state: stores state (evidence: `README.md`)
- Client environment → Network segmentation: configures networking (evidence: `README.md`)
- Client environment → Identity and vault: configures security (evidence: `README.md`)
- Client environment → Optional VM: optionally enables (evidence: `README.md`)
- Network segmentation → Azure resources: provisions VNet and NSGs (evidence: `README.md`)
- Identity and vault → Azure resources: provisions vault and identities (evidence: `README.md`)
- Optional VM → Azure resources: provisions VM (evidence: `README.md`)
- Engineer → Drift audit: runs audit (evidence: `scripts/msp_audit.py`)
- Drift audit → Azure resources: reads resources, rules, secrets (evidence: `scripts/msp_audit.py`)
- Engineer → Client generator: generates client folder (evidence: `scripts/new_client.py`)
- Client generator → Dev environment template: copies template (evidence: `scripts/new_client.py`)
