Visual Assets Index

Complete catalog of 53 Python-generated SVG diagrams organized by learning level, with descriptions and regeneration instructions.

Overview

All visual assets in Brain Trek are generated from Python scripts using matplotlib, enabling consistent styling and easy updates. Each SVG follows the Microsoft Azure color palette for brand consistency.

Azure Color Palette

Color	Hex	Usage
Azure Blue	`#0078D4`	Primary elements, headers
Azure Dark Blue	`#004578`	Borders, strokes
Azure Green	`#107C10`	Success, on-premises
Azure Orange	`#FF8C00`	Warnings, cautions
Azure Red	`#D13438`	Errors, critical items
Azure Light Blue	`#50E6FF`	Highlights, accents
Azure Gray	`#6B6B6B`	Secondary text

Regeneration Instructions

Prerequisites

# Ensure Python dependencies are installed
pip install -r requirements.txt

Regenerate All Diagrams

npm run diagrams

Regenerate by Level

npm run diagrams:level50
npm run diagrams:level100
npm run diagrams:level200
npm run diagrams:level300

Regenerate Single Diagram

python scripts/regenerate-diagrams.py --level 100 --name azure-local-architecture

Level 50 — Foundational (21 diagrams)

Cloud Computing Concepts

Diagram	Description	Used In
cloud-computing-mindmap.svg	Cloud computing essential characteristics mindmap	`cloud-computing-primer.md`
traditional-vs-cloud.svg	Traditional IT vs cloud infrastructure comparison	`cloud-computing-primer.md`
cloud-tco-comparison.svg	CapEx vs OpEx total cost of ownership	`cloud-computing-primer.md`
cloud-scalability-patterns.svg	Horizontal vs vertical scaling patterns	`cloud-computing-primer.md`

Service & Deployment Models

Diagram	Description	Used In
shared-responsibility-matrix.svg	IaaS/PaaS/SaaS responsibility matrix	`cloud-service-models.md`
shared-responsibility-shift.svg	Responsibility shift across service models	`cloud-service-models.md`
cloud-deployment-models.svg	Public/private/hybrid deployment comparison	`cloud-deployment-models.md`
cloud-deployment-models-overview.svg	Deployment model decision tree	`cloud-deployment-models.md`
hypervisor-types.svg	Type 1 vs Type 2 hypervisors	`cloud-computing-primer.md`

Security & Compliance

Diagram	Description	Used In
cia-triad.svg	Confidentiality, Integrity, Availability triangle	`security-compliance-basics.md`
defense-in-depth.svg	Multi-layer security model	`security-compliance-basics.md`
authentication-authorization-flow.svg	AuthN vs AuthZ flow comparison	`security-compliance-basics.md`
data-classification-pyramid.svg	Data sensitivity classification levels	`security-compliance-basics.md`
compliance-frameworks-comparison.svg	GDPR, HIPAA, FedRAMP comparison	`compliance-frameworks.md`

Azure Fundamentals

Diagram	Description	Used In
azure-infrastructure-hierarchy.svg	Regions, zones, datacenters hierarchy	`azure-global-infrastructure.md`
azure-service-categories.svg	Azure service taxonomy	`azure-service-categories.md`
azure-compute-options.svg	VMs, containers, serverless comparison	`azure-service-categories.md`
azure-storage-tiers.svg	Hot, cool, archive storage tiers	`azure-service-categories.md`
azure-networking-fundamentals.svg	VNet, subnet, NSG basics	`azure-service-categories.md`

Level 100 — Foundational Sovereignty (9 diagrams)

Sovereignty Concepts

Diagram	Description	Used In
azure-regions-map.svg	Global Azure region distribution	`azure-global-infrastructure.md`
regulatory-timeline.svg	Key regulatory framework timeline	`compliance-frameworks.md`
eu-data-boundary.svg	EU Data Boundary scope	`european-commitments.md`
sovereign-cloud-models-comparison.svg	Sovereign cloud model comparison matrix	`sovereign-cloud-models.md`
data-classification-pyramid.svg	Sovereignty-focused data classification	`data-residency-concepts.md`

Azure Local

Diagram	Description	Used In
azure-local-architecture.svg	Azure Local cluster architecture overview	`azure-local-overview.md`
capex-opex-comparison.svg	Azure Local economics comparison	`cloud-computing-primer.md`

Edge AI

Diagram	Description	Used In
vector-embedding-process.svg	RAG vector embedding workflow	`rag-fundamentals.md`
nist-cloud-characteristics.svg	NIST cloud characteristics	`cloud-computing-primer.md`

Level 200 — Intermediate (7 diagrams)

Azure Local Deep Dive

Diagram	Description	Used In
storage-spaces-direct.svg	S2D architecture and data flow	`azure-local-architecture-deep-dive.md`
sdn-architecture.svg	Software-defined networking stack	`azure-local-advanced-networking.md`

Azure Arc

Diagram	Description	Used In
enterprise-arc-topology.svg	Enterprise Arc deployment patterns	`arc-enterprise-patterns.md`

Edge RAG

Diagram	Description	Used In
edge-rag-implementation.svg	RAG implementation architecture	`edge-rag-implementation.md`

Compliance & Security

Diagram	Description	Used In
security-patterns-matrix.svg	Security pattern decision matrix	`compliance-security-patterns.md`
encryption-key-hierarchy.svg	Key management hierarchy	`encryption-key-management.md`
fedramp-control-families.svg	FedRAMP control family overview	`fedramp-compliance.md`

Level 300 — Advanced (16 diagrams)

Zero Trust

Diagram	Description	Used In
zero-trust-architecture.svg	Complete Zero Trust implementation	`zero-trust.md`
security-monitoring-flow.svg	Security monitoring and alerting	`zero-trust-monitoring.md`
hybrid-identity.svg	Hybrid identity architecture	`zero-trust.md`

Azure Local at Scale

Diagram	Description	Used In
azure-local-multisite.svg	Multi-site deployment topology	`azure-local-multi-site.md`
air-gapped-architecture.svg	Air-gapped environment design	`azure-local-air-gapped.md`
disaster-recovery-topology.svg	DR site configuration	`disaster-recovery.md`
multi-region-sovereign.svg	Multi-region sovereign architecture	`sovereign-landing-zone.md`

Production Edge RAG

Diagram	Description	Used In
edge-rag-production.svg	Production RAG deployment	`edge-rag-production.md`
mlops-pipeline.svg	MLOps continuous improvement	`edge-rag-mlops.md`

Industry Verticals

Diagram	Description	Used In
healthcare-sovereign.svg	Healthcare sovereignty patterns	`healthcare-sovereign.md`
financial-services.svg	Financial services architecture	`financial-services.md`
government-cloud.svg	Government cloud design	`government-cloud.md`
critical-infrastructure.svg	Critical infrastructure patterns	`critical-infrastructure.md`

Architecture Patterns

Diagram	Description	Used In
sovereign-landing-zone.svg	Sovereign Landing Zone structure	`sovereign-landing-zone.md`
api-gateway-patterns.svg	API gateway architectures	`api-gateway-patterns.md`
event-driven-architecture.svg	Event-driven patterns	`event-driven-architecture.md`
data-mesh-sovereignty.svg	Data mesh with sovereignty	`data-mesh-sovereignty.md`
observability-stack.svg	Observability architecture	`observability-stack.md`

Python Source Scripts

All diagram sources are located in docs/assets/diagrams/src/:

docs/assets/diagrams/src/
├── level-50/     (21 scripts)
├── level-100/    (9 scripts)
├── level-200/    (7 scripts)
└── level-300/    (16 scripts)

Script Naming Convention

Script: {diagram-name}.py
Output: docs/assets/images/level-{N}/{diagram-name}.svg

Common Script Structure

import matplotlib.pyplot as plt

# Azure color palette
AZURE_BLUE = '#0078D4'
AZURE_DARK = '#004578'
AZURE_GREEN = '#107C10'

def create_diagram():
    fig, ax = plt.subplots(figsize=(12, 8))
    # ... diagram logic ...
    plt.savefig('output.svg', format='svg', bbox_inches='tight')

if __name__ == '__main__':
    create_diagram()

Adding New Diagrams

Create Python script in appropriate src/level-{N}/ folder
Follow existing naming and color conventions
Run regeneration: npm run diagrams:level{N}
Embed in target Markdown file
Update this index

Last Updated: January 2025