Reading diagrams / Topic 37 of 42

The context diagram: who calls, and what it reaches

The rule

The system map draws every route. The context diagram steps back to one screen: who calls the program, the program itself, and what it reaches. It borrows the system context diagram of Simon Brown's C4 model, which puts one system in the middle of the people and systems around it. Here, only what the source records is drawn.

On the left is each caller transport, such as http, with an arrow labelled with how many routes it carries. In the middle, the program's box says how many routes it has and how many pure programs, the green boxes of the system map. Inside it, routes are grouped by the exact set of resources each one reaches, and each group counts its routes. On the right is each resource, with one arrow from every group that reaches it, labelled with that group's count.

A route belongs to one group only. In Icetakes, a route that reaches the database and the model is counted under “Reach database + model”, not under “Reach database”, which holds the routes that reach the database and nothing else. So the arrows into a resource add up to every route that reaches it.

Two parts are not computed. The reading pins under the picture, headed “Agent-authored reading pins · unverified”, are an agent's suggestion of where to start, and so are the supplementary notes and the reason for the view each diagram opens in. Nothing checks them. The line above the picture says what the rest cannot know: “Static route reach · source files only. Users, vendors, deployment and traffic unknown.”

Press a group or an arrow to open the system map at its routes. The Overview and System map buttons switch between the two. review-desk opens on its system map, the view an agent chose for it, drawn with the marks the system map topics taught; press Overview to see its context diagram.

Icetakes, the community reading site from earlier topics.

Loading the context diagram.

review-desk, the small service with a pure program.

Loading the context diagram.

Loading the worked examples and practice.