# energy-dsi/dpn-integration-playbook architecture

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

- Interactive diagram: https://gitdiagram.com/energy-dsi/dpn-integration-playbook
- Repository: https://github.com/energy-dsi/dpn-integration-playbook

## Overview

This repository is an implementation playbook, not the DPN runtime: it guides organisations through prerequisites, configuration, deployment, and operation across Azure and AWS. Its central workflow is infrastructure setup followed by application installation, with separate Azure automated and AWS manual application paths. The README also documents onboarding, certificate trust, producer/consumer exchange, and user-interface operations. No source excerpts were provided, so relationships below are limited to sequences and capabilities explicitly described in the README; paths for less-detailed capabilities use their existing documentation directories.

Main entry points: [`Docs/03-dpn-application-deployment/aws-manual-beta`](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta) (AWS application deploy), [`Docs/02-dpn-infrastructure-deployment`](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment) (Infrastructure configuration), [`Docs/02-dpn-infrastructure-deployment/azure`](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment/azure) (Azure infrastructure), [`Docs/02-dpn-infrastructure-deployment/aws`](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment/aws) (AWS infrastructure)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_infra["Infrastructure deployment"]
  node_infra_pre["Infrastructure prerequisites"]
  node_infra_config["Infrastructure configuration"]
  node_infra_azure["Azure infrastructure"]
  node_infra_aws["AWS infrastructure"]
end

subgraph group_app["Application deployment"]
  node_app_pre["Application prerequisites"]
  node_app_config["Application configuration"]
  node_app_azure["Azure application deploy"]
  node_app_aws["AWS application deploy"]
  node_vault_cert["Vault and certificates"]
  node_health["Health monitoring"]
  node_pipeline["Data pipelines"]
  node_gateway["Federator gateway"]
  node_file_scan["File scan service"]
end

subgraph group_exchange["Federated exchange"]
  node_producer["Producer process<br/>[README.md]"]
  node_consumer["Consumer process<br/>[README.md]"]
  node_kafka["Kafka topics"]
  node_storage[("Organisation storage")]
end

subgraph group_ops["Operations and onboarding"]
  node_onboarding["Partner onboarding<br/>[README.md]"]
  node_user_guides["Service UI guides"]
  node_rollback["Rollback and decommission"]
end

node_org(("Organisation"))

node_org -->|"checks prerequisites"| node_infra_pre
node_infra_pre -->|"then configures"| node_infra_config
node_infra_config -->|"provisions Azure"| node_infra_azure
node_infra_config -->|"provisions AWS"| node_infra_aws
node_infra_azure -->|"precedes app setup"| node_app_pre
node_infra_aws -->|"precedes app setup"| node_app_pre
node_app_pre -->|"then configures"| node_app_config
node_app_config -->|"guides Azure install"| node_app_azure
node_app_config -->|"guides AWS install"| node_app_aws
node_app_aws -->|"installs first"| node_vault_cert
node_app_aws -->|"installs second"| node_health
node_app_aws -->|"installs third"| node_pipeline
node_app_aws -->|"installs fourth"| node_gateway
node_app_azure -->|"includes component"| node_file_scan
node_producer -->|"publishes data"| node_kafka
node_consumer -->|"publishes stream data"| node_kafka
node_consumer -->|"moves file data"| node_storage
node_org -->|"completes onboarding"| node_onboarding
node_org -->|"operates services"| node_user_guides
node_infra_azure -->|"documents rollback"| node_rollback
node_infra_aws -->|"documents rollback"| node_rollback

click node_infra_pre "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment"
click node_infra_config "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment"
click node_infra_azure "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment/azure"
click node_infra_aws "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment/aws"
click node_app_pre "https://github.com/energy-dsi/dpn-integration-playbook/blob/release/1.0.0/Docs/03-dpn-application-deployment/azure-ado-beta/01-prerequisites/01-dpn-prerequisites.md"
click node_app_config "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/azure-ado-beta/02-configuration"
click node_app_azure "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/azure-ado-beta/03-installation"
click node_app_aws "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta"
click node_vault_cert "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/01-vault-certificate-manager"
click node_health "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/02-health-monitor"
click node_pipeline "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/03-data-pipeline"
click node_gateway "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/04-federator-gateway"
click node_file_scan "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/azure-ado-beta"
click node_producer "https://github.com/energy-dsi/dpn-integration-playbook/blob/release/1.0.0/README.md"
click node_consumer "https://github.com/energy-dsi/dpn-integration-playbook/blob/release/1.0.0/README.md"
click node_kafka "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/04-federator-gateway"
click node_storage "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/04-federator-gateway"
click node_onboarding "https://github.com/energy-dsi/dpn-integration-playbook/blob/release/1.0.0/README.md"
click node_user_guides "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/05-dpn-user-interfaces"
click node_rollback "https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment"

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_infra_pre,node_infra_config,node_infra_azure,node_infra_aws toneBlue
class node_app_pre,node_app_config,node_app_azure,node_app_aws,node_vault_cert,node_health,node_pipeline,node_gateway,node_file_scan toneAmber
class node_producer,node_consumer,node_kafka,node_storage toneMint
class node_onboarding,node_user_guides,node_rollback toneRose
class node_org toneIndigo
```

## Components

### Infrastructure deployment

- [Infrastructure prerequisites](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment): `Docs/02-dpn-infrastructure-deployment`
- [Infrastructure configuration](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment): `Docs/02-dpn-infrastructure-deployment`
- [Azure infrastructure](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment/azure): `Docs/02-dpn-infrastructure-deployment/azure`
- [AWS infrastructure](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment/aws): `Docs/02-dpn-infrastructure-deployment/aws`

### Application deployment

- [Application prerequisites](https://github.com/energy-dsi/dpn-integration-playbook/blob/release/1.0.0/Docs/03-dpn-application-deployment/azure-ado-beta/01-prerequisites/01-dpn-prerequisites.md): `Docs/03-dpn-application-deployment/azure-ado-beta/01-prerequisites/01-dpn-prerequisites.md`
- [Application configuration](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/azure-ado-beta/02-configuration): `Docs/03-dpn-application-deployment/azure-ado-beta/02-configuration`
- [Azure application deploy](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/azure-ado-beta/03-installation): `Docs/03-dpn-application-deployment/azure-ado-beta/03-installation`
- [AWS application deploy](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta): `Docs/03-dpn-application-deployment/aws-manual-beta`
- [Vault and certificates](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/01-vault-certificate-manager): `Docs/03-dpn-application-deployment/aws-manual-beta/01-vault-certificate-manager`
- [Health monitoring](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/02-health-monitor): `Docs/03-dpn-application-deployment/aws-manual-beta/02-health-monitor`
- [Data pipelines](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/03-data-pipeline): `Docs/03-dpn-application-deployment/aws-manual-beta/03-data-pipeline`
- [Federator gateway](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/04-federator-gateway): `Docs/03-dpn-application-deployment/aws-manual-beta/04-federator-gateway`
- [File scan service](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/azure-ado-beta): `Docs/03-dpn-application-deployment/azure-ado-beta`

### Federated exchange

- [Producer process](https://github.com/energy-dsi/dpn-integration-playbook/blob/release/1.0.0/README.md): `README.md`
- [Consumer process](https://github.com/energy-dsi/dpn-integration-playbook/blob/release/1.0.0/README.md): `README.md`
- [Kafka topics](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/04-federator-gateway): `Docs/03-dpn-application-deployment/aws-manual-beta/04-federator-gateway`
- [Organisation storage](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/03-dpn-application-deployment/aws-manual-beta/04-federator-gateway): `Docs/03-dpn-application-deployment/aws-manual-beta/04-federator-gateway`

### Operations and onboarding

- [Partner onboarding](https://github.com/energy-dsi/dpn-integration-playbook/blob/release/1.0.0/README.md): `README.md`
- [Service UI guides](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/05-dpn-user-interfaces): `Docs/05-dpn-user-interfaces`
- [Rollback and decommission](https://github.com/energy-dsi/dpn-integration-playbook/tree/release/1.0.0/Docs/02-dpn-infrastructure-deployment): `Docs/02-dpn-infrastructure-deployment`

### Other components

- **Organisation**

## Connections

- Organisation → Infrastructure prerequisites: checks prerequisites (evidence: `README.md`)
- Infrastructure prerequisites → Infrastructure configuration: then configures (evidence: `README.md`)
- Infrastructure configuration → Azure infrastructure: provisions Azure (evidence: `README.md`)
- Infrastructure configuration → AWS infrastructure: provisions AWS (evidence: `README.md`)
- Azure infrastructure → Application prerequisites: precedes app setup (evidence: `README.md`)
- AWS infrastructure → Application prerequisites: precedes app setup (evidence: `README.md`)
- Application prerequisites → Application configuration: then configures (evidence: `README.md`)
- Application configuration → Azure application deploy: guides Azure install (evidence: `README.md`)
- Application configuration → AWS application deploy: guides AWS install (evidence: `README.md`)
- AWS application deploy → Vault and certificates: installs first (evidence: `README.md`)
- AWS application deploy → Health monitoring: installs second (evidence: `README.md`)
- AWS application deploy → Data pipelines: installs third (evidence: `README.md`)
- AWS application deploy → Federator gateway: installs fourth (evidence: `README.md`)
- Azure application deploy → File scan service: includes component (evidence: `README.md`)
- Producer process → Kafka topics: publishes data (evidence: `README.md`)
- Consumer process → Kafka topics: publishes stream data (evidence: `README.md`)
- Consumer process → Organisation storage: moves file data (evidence: `README.md`)
- Organisation → Partner onboarding: completes onboarding (evidence: `README.md`)
- Organisation → Service UI guides: operates services (evidence: `README.md`)
- Azure infrastructure → Rollback and decommission: documents rollback (evidence: `README.md`)
- AWS infrastructure → Rollback and decommission: documents rollback (evidence: `README.md`)
