High-level architecture

An end-to-end data stack under a phase banner, with cross-cutting bars.

1 high-level architecture example

Data stack overview

Sources, ingestion, storage, transformation and visualisation of a data platform on one canvas.

The chevron banner names the phases and every component sits under its phase. The scheduler bar spans the cluster and triggers what it runs, the identity and monitoring bars cut across everything, and the object store is the single focal node.

Open in the editor

What is a high-level architecture diagram?

A high-level architecture diagram gives an end-to-end view of a system or data stack on one page: the major building blocks, such as sources, ingestion, storage, transformation and consumption, without the detail of individual services.

Read it left to right as the path data or requests take. Phase banners across the top name the stages, and horizontal bars along the bottom show cross-cutting concerns such as governance, security and orchestration that apply everywhere.

When to use a high-level architecture diagram

  • Use it to present a data platform to executives or in a proposal, where the shape matters more than the detail.
  • Use it as the first page of architecture documentation, before more detailed diagrams.
  • If engineers need to implement from it, follow up with a detailed architecture or deployment diagram.

How to make a good high-level architecture diagram

  1. Limit it to five to seven stages so it fits on one slide.
  2. Name blocks by capability, and add product names only as secondary labels.
  3. Use cross-cutting bars for governance and security instead of repeating them in each block.
  4. Leave out arrows between every block; the left-to-right order already implies flow.