# kebaldwi/net-automate architecture

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

- Interactive diagram: https://gitdiagram.com/kebaldwi/net-automate
- Repository: https://github.com/kebaldwi/net-automate

## Overview

NET-AUTOMATE is a collection of enterprise networking automation examples, chiefly for Cisco Catalyst Center. Its principal workflow takes configuration and site intent, builds hierarchy and network settings, discovers and assigns devices, then applies profiles, provisions devices, and deploys templates. Template authoring and GitHub synchronization are additional branches. The tree and excerpts mainly substantiate Catalyst Center examples; Dashboard and Cisco Workflows are documented as expanding focus areas but have no implementation paths in the supplied tree. Several lab variants are duplicates, so they are grouped by directory where appropriate.

Main entry points: [`CODE/PYTHON/CLONE/GITOPS/common/helpers.py`](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/common/helpers.py) (API Helpers), [`CODE/PYTHON/CLONE/GITOPS/1.0-Cisco-Catalyst-Center-Site-Hierarchy/site_hierarchy.py`](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/1.0-Cisco-Catalyst-Center-Site-Hierarchy/site_hierarchy.py) (Site Hierarchy), [`CODE/PYTHON/CLONE/GITOPS/4.0-Cisco-Catalyst-Center-Device-Discovery/device_discovery.py`](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/4.0-Cisco-Catalyst-Center-Device-Discovery/device_discovery.py) (Device Discovery), [`CODE/PYTHON/CLONE/GITOPS/9.0-Cisco-Catalyst-Center-Provision-Deploy-Composite/deploy_composite.py`](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/9.0-Cisco-Catalyst-Center-Provision-Deploy-Composite/deploy_composite.py) (Template Deployment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["Site Design"]
  node_settings_data["Project Settings"]
  node_hierarchy["Site Hierarchy<br/>[site_hierarchy.py]"]
  node_network_settings["Network Settings"]
end

subgraph group_operations["Device Operations"]
  node_discovery["Device Discovery"]
  node_assignment["Site Assignment<br/>[assign_to_site.py]"]
  node_profiles["Network Profiles<br/>[network_profile.py]"]
  node_provision["Device Provisioning"]
  node_catc[("Catalyst Center")]
end

subgraph group_templates["Template Automation"]
  node_project["Template Project<br/>[create_project.py]"]
  node_member["Member Template"]
  node_composite["Composite Template"]
  node_deployment["Template Deployment"]
  node_template_examples["Template Examples"]
end

subgraph group_shared["Shared Utilities"]
  node_authentication["API Authentication<br/>[authenticate.py]"]
  node_helpers["API Helpers<br/>[helpers.py]"]
end

subgraph group_legacy["Python Lab Examples"]
  node_lab_automation["Lab Automation"]
  node_api_knowledge["API Knowledge Base<br/>[dnac_api_kb.py]"]
  node_inventory["Device Inventory"]
  node_template_sync["GitHub Template Sync<br/>[template_sync.py]"]
  node_poe["PoE Sustainability"]
end

node_engineer(("Network Engineer"))

node_engineer -->|"runs"| node_hierarchy
node_engineer -->|"runs"| node_network_settings
node_engineer -->|"runs"| node_discovery
node_engineer -->|"runs"| node_deployment
node_settings_data -->|"configures"| node_hierarchy
node_settings_data -->|"configures"| node_network_settings
node_settings_data -->|"configures"| node_profiles
node_hierarchy -->|"calls"| node_helpers
node_network_settings -->|"calls"| node_helpers
node_discovery -->|"calls"| node_helpers
node_assignment -->|"calls"| node_helpers
node_profiles -->|"calls"| node_helpers
node_provision -->|"calls"| node_helpers
node_authentication -->|"requests token"| node_helpers
node_project -.->|"calls"| node_helpers
node_member -->|"creates and commits"| node_helpers
node_composite -->|"creates and commits"| node_helpers
node_deployment -->|"submits and polls"| node_helpers
node_hierarchy -->|"creates sites"| node_catc
node_discovery -->|"starts discovery"| node_catc
node_provision -->|"provisions devices"| node_catc
node_deployment -->|"deploys composite"| node_catc
node_lab_automation -->|"uses sync"| node_template_sync
node_lab_automation -->|"uses API calls"| node_api_knowledge
node_template_examples -->|"uses sync"| node_template_sync

click node_hierarchy "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/1.0-Cisco-Catalyst-Center-Site-Hierarchy/site_hierarchy.py"
click node_network_settings "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/2.0-Cisco-Catalyst-Center-Settings/network_settings.py"
click node_discovery "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/4.0-Cisco-Catalyst-Center-Device-Discovery/device_discovery.py"
click node_assignment "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/5.0-Cisco-Catalyst-Center-Assign-To-Site/assign_to_site.py"
click node_profiles "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/7.0-Cisco-Catalyst-Center-Network-Profile/network_profile.py"
click node_provision "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/8.0-Cisco-Catalyst-Center-Provision-Devices/provision_devices.py"
click node_authentication "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/6.1-Cisco-Catalyst-Center-Templates-Authenticate/authenticate.py"
click node_helpers "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/common/helpers.py"
click node_project "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/6.2-Cisco-Catalyst-Center-Templates-Create-Project/create_project.py"
click node_member "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/6.3-Cisco-Catalyst-Center-Templates-Create-Member-Template/create_member_template.py"
click node_composite "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/6.4-Cisco-Catalyst-Center-Templates-Create-Composite-Template/create_composite_template.py"
click node_deployment "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/9.0-Cisco-Catalyst-Center-Provision-Deploy-Composite/deploy_composite.py"
click node_lab_automation "https://github.com/kebaldwi/net-automate/tree/master/CODE/PYTHON/CLONE/CICD-LAB"
click node_api_knowledge "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/dnac_api_kb.py"
click node_inventory "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/device_inventory.py"
click node_template_sync "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/template_sync.py"
click node_template_examples "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/deploy_templates.py"
click node_poe "https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/poe_sustainability.py"

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_settings_data,node_hierarchy,node_network_settings toneBlue
class node_discovery,node_assignment,node_profiles,node_provision,node_catc toneAmber
class node_project,node_member,node_composite,node_deployment,node_template_examples toneMint
class node_authentication,node_helpers toneRose
class node_lab_automation,node_api_knowledge,node_inventory,node_template_sync,node_poe,node_engineer toneIndigo
```

## Components

### Site Design

- **Project Settings**
- [Site Hierarchy](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/1.0-Cisco-Catalyst-Center-Site-Hierarchy/site_hierarchy.py): `CODE/PYTHON/CLONE/GITOPS/1.0-Cisco-Catalyst-Center-Site-Hierarchy/site_hierarchy.py`
- [Network Settings](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/2.0-Cisco-Catalyst-Center-Settings/network_settings.py): `CODE/PYTHON/CLONE/GITOPS/2.0-Cisco-Catalyst-Center-Settings/network_settings.py`

### Device Operations

- [Device Discovery](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/4.0-Cisco-Catalyst-Center-Device-Discovery/device_discovery.py): `CODE/PYTHON/CLONE/GITOPS/4.0-Cisco-Catalyst-Center-Device-Discovery/device_discovery.py`
- [Site Assignment](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/5.0-Cisco-Catalyst-Center-Assign-To-Site/assign_to_site.py): `CODE/PYTHON/CLONE/GITOPS/5.0-Cisco-Catalyst-Center-Assign-To-Site/assign_to_site.py`
- [Network Profiles](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/7.0-Cisco-Catalyst-Center-Network-Profile/network_profile.py): `CODE/PYTHON/CLONE/GITOPS/7.0-Cisco-Catalyst-Center-Network-Profile/network_profile.py`
- [Device Provisioning](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/8.0-Cisco-Catalyst-Center-Provision-Devices/provision_devices.py): `CODE/PYTHON/CLONE/GITOPS/8.0-Cisco-Catalyst-Center-Provision-Devices/provision_devices.py`
- **Catalyst Center**

### Template Automation

- [Template Project](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/6.2-Cisco-Catalyst-Center-Templates-Create-Project/create_project.py): `CODE/PYTHON/CLONE/GITOPS/6.2-Cisco-Catalyst-Center-Templates-Create-Project/create_project.py`
- [Member Template](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/6.3-Cisco-Catalyst-Center-Templates-Create-Member-Template/create_member_template.py): `CODE/PYTHON/CLONE/GITOPS/6.3-Cisco-Catalyst-Center-Templates-Create-Member-Template/create_member_template.py`
- [Composite Template](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/6.4-Cisco-Catalyst-Center-Templates-Create-Composite-Template/create_composite_template.py): `CODE/PYTHON/CLONE/GITOPS/6.4-Cisco-Catalyst-Center-Templates-Create-Composite-Template/create_composite_template.py`
- [Template Deployment](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/9.0-Cisco-Catalyst-Center-Provision-Deploy-Composite/deploy_composite.py): `CODE/PYTHON/CLONE/GITOPS/9.0-Cisco-Catalyst-Center-Provision-Deploy-Composite/deploy_composite.py`
- [Template Examples](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/deploy_templates.py): `CODE/PYTHON/deploy_templates.py`

### Shared Utilities

- [API Authentication](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/6.1-Cisco-Catalyst-Center-Templates-Authenticate/authenticate.py): `CODE/PYTHON/CLONE/GITOPS/6.1-Cisco-Catalyst-Center-Templates-Authenticate/authenticate.py`
- [API Helpers](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/CLONE/GITOPS/common/helpers.py): `CODE/PYTHON/CLONE/GITOPS/common/helpers.py`

### Python Lab Examples

- [Lab Automation](https://github.com/kebaldwi/net-automate/tree/master/CODE/PYTHON/CLONE/CICD-LAB): `CODE/PYTHON/CLONE/CICD-LAB`
- [API Knowledge Base](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/dnac_api_kb.py): `CODE/PYTHON/dnac_api_kb.py`
- [Device Inventory](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/device_inventory.py): `CODE/PYTHON/device_inventory.py`
- [GitHub Template Sync](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/template_sync.py): `CODE/PYTHON/template_sync.py`
- [PoE Sustainability](https://github.com/kebaldwi/net-automate/blob/master/CODE/PYTHON/poe_sustainability.py): `CODE/PYTHON/poe_sustainability.py`

### Other components

- **Network Engineer**

## Connections

- Network Engineer → Site Hierarchy: runs (evidence: `CODE/PYTHON/CLONE/GITOPS/1.0-Cisco-Catalyst-Center-Site-Hierarchy/site_hierarchy.py`)
- Network Engineer → Network Settings: runs (evidence: `CODE/PYTHON/CLONE/GITOPS/2.0-Cisco-Catalyst-Center-Settings/network_settings.py`)
- Network Engineer → Device Discovery: runs (evidence: `CODE/PYTHON/CLONE/GITOPS/4.0-Cisco-Catalyst-Center-Device-Discovery/device_discovery.py`)
- Network Engineer → Template Deployment: runs (evidence: `CODE/PYTHON/CLONE/GITOPS/9.0-Cisco-Catalyst-Center-Provision-Deploy-Composite/deploy_composite.py`)
- Project Settings → Site Hierarchy: configures (evidence: `CODE/PYTHON/CLONE/GITOPS/1.0-Cisco-Catalyst-Center-Site-Hierarchy/site_hierarchy.py`)
- Project Settings → Network Settings: configures (evidence: `CODE/PYTHON/CLONE/GITOPS/2.0-Cisco-Catalyst-Center-Settings/network_settings.py`)
- Project Settings → Network Profiles: configures (evidence: `CODE/PYTHON/CLONE/GITOPS/7.0-Cisco-Catalyst-Center-Network-Profile/network_profile.py`)
- Site Hierarchy → API Helpers: calls (evidence: `CODE/PYTHON/CLONE/GITOPS/1.0-Cisco-Catalyst-Center-Site-Hierarchy/site_hierarchy.py`)
- Network Settings → API Helpers: calls (evidence: `CODE/PYTHON/CLONE/GITOPS/2.0-Cisco-Catalyst-Center-Settings/network_settings.py`)
- Device Discovery → API Helpers: calls (evidence: `CODE/PYTHON/CLONE/GITOPS/4.0-Cisco-Catalyst-Center-Device-Discovery/device_discovery.py`)
- Site Assignment → API Helpers: calls (evidence: `CODE/PYTHON/CLONE/GITOPS/5.0-Cisco-Catalyst-Center-Assign-To-Site/assign_to_site.py`)
- Network Profiles → API Helpers: calls (evidence: `CODE/PYTHON/CLONE/GITOPS/7.0-Cisco-Catalyst-Center-Network-Profile/network_profile.py`)
- Device Provisioning → API Helpers: calls (evidence: `CODE/PYTHON/CLONE/GITOPS/8.0-Cisco-Catalyst-Center-Provision-Devices/provision_devices.py`)
- API Authentication → API Helpers: requests token (evidence: `CODE/PYTHON/CLONE/GITOPS/6.1-Cisco-Catalyst-Center-Templates-Authenticate/authenticate.py`)
- Template Project → API Helpers: calls (evidence: `CODE/PYTHON/CLONE/GITOPS/6.2-Cisco-Catalyst-Center-Templates-Create-Project/create_project.py`)
- Member Template → API Helpers: creates and commits (evidence: `CODE/PYTHON/CLONE/GITOPS/6.3-Cisco-Catalyst-Center-Templates-Create-Member-Template/create_member_template.py`)
- Composite Template → API Helpers: creates and commits (evidence: `CODE/PYTHON/CLONE/GITOPS/6.4-Cisco-Catalyst-Center-Templates-Create-Composite-Template/create_composite_template.py`)
- Template Deployment → API Helpers: submits and polls (evidence: `CODE/PYTHON/CLONE/GITOPS/9.0-Cisco-Catalyst-Center-Provision-Deploy-Composite/deploy_composite.py`)
- Site Hierarchy → Catalyst Center: creates sites (evidence: `CODE/PYTHON/CLONE/GITOPS/1.0-Cisco-Catalyst-Center-Site-Hierarchy/site_hierarchy.py`)
- Device Discovery → Catalyst Center: starts discovery
- Device Provisioning → Catalyst Center: provisions devices (evidence: `CODE/PYTHON/CLONE/GITOPS/8.0-Cisco-Catalyst-Center-Provision-Devices/provision_devices.py`)
- Template Deployment → Catalyst Center: deploys composite (evidence: `CODE/PYTHON/CLONE/GITOPS/9.0-Cisco-Catalyst-Center-Provision-Deploy-Composite/deploy_composite.py`)
- Lab Automation → GitHub Template Sync: uses sync (evidence: `CODE/PYTHON/CLONE/CICD-LAB/deploy_templates.py`)
- Lab Automation → API Knowledge Base: uses API calls (evidence: `CODE/PYTHON/CLONE/CICD-LAB/device_discovery.py`)
- Template Examples → GitHub Template Sync: uses sync (evidence: `CODE/PYTHON/deploy_templates.py`)
