- 6 minutes to read

C4 Diagram Sets Administration Overview

This section helps administrators and super users operate C4 Diagram Sets with clear governance, consistent quality, and repeatable curation workflows.

A C4 Diagram Set is the container that groups the related C4 Diagrams for one software system in the Repository Model. Architects and business users work with the sets day to day (see C4 Diagrams Getting Started); administrators decide who may create, open, and change them, and keep their content healthy.

In the Nodinite Web Client, you find C4 Diagram Sets under Repository → Diagram Sets. The C4 Diagram Sets link on the Mapify card in the Administration Overview opens the same list. They aren't on the Customize card or menu.

C4 Diagram Sets administration from the Mapify card to the Edit Diagram Set dialog, animated walkthrough (7.12)
Animated walkthrough: Administration → Mapify card → C4 Diagram Sets, filter on Orders and EDI, open the Diagram Set Orders and EDI - BizTalk (docs) and its Coverage matrix, one row per System, then Edit. It ends on the Edit Diagram Set dialog: Name, Description, Web Site, Tags, Set Mode, and a Roles card where each Role shows its Access and Modify icons for this set, and Edit picks the Roles.

Diagram Sets list with Include deleted ticked, Available and Deleted badges, and the Name, Tags, Description, Mode, Active Diagrams, and Draft Diagrams columns (7.12)
The Diagram Sets list: filter by text, Tag, or Mode (Free Draw or Layered), tick Include deleted to also show deleted sets New 7.12, and open each set's Action menu. The counters show how many Active and Draft diagrams each set holds.

From the list, Add Diagram Set creates a new set (its arrow opens more ways to add one), and the Action menu on each row opens the set's options; see Add or manage C4 Diagram Set. Each row's Mode shows whether the set uses Layered Mode or Free Draw (Diagram Set Fundamentals).

Understanding C4 Diagram Set Administration

graph LR Role["fa:fa-user-shield Role"] -->|"Global: Access, Create, Modify, Logging"| Sets["fa:fa-layer-group C4 Diagram Sets"] Role -->|"Per set: Access, Modify"| Sets Param["fa:fa-sliders DefaultRolesInViews"] -.->|"pre-selects Roles on new sets"| Sets Sets --> Assist["fa:fa-list-check Diagram Assistance
Suggestions and Coverage"] Sets --> Inbox["fa:fa-inbox Impact Inbox
drift review"] AIParam["fa:fa-robot AI System Parameter
EnableDiagramAiAssistance"] -.->|"optional"| Assist style Role fill:#2678BD,color:#fff style Param fill:#9E59BB,color:#fff style AIParam fill:#9E59BB,color:#fff style Sets fill:#3F827B,color:#fff style Assist fill:#93d16d,color:#000 style Inbox fill:#FFD525,color:#000

Roles (blue) grant access to the sets (teal); System Parameters (purple) set defaults and switch on AI. Diagram Assistance (green) proposes safe additions, while the Impact Inbox (yellow) collects changes to review.

Administrative scope

Administrators handle the operational quality of set content, while architects and business users consume or collaborate based on assigned roles.

Admin responsibility Why it matters Where
Keep Diagram Sets current Prevent architecture drift Import, Generate from Integration Landscape, C4 Dynamic on the BPM page, Diagram Lifecycle. New 7.12 Navigation between the diagrams is inferred, so there is nothing to sync (Navigation Between C4 Diagrams)
Review suggestions continuously Improve set completeness over time Diagram Assistance
Use optional AI Assistance responsibly Speed up curation while preserving quality controls AI System Parameter
Enforce role-based access Keep architecture governance secure Permission Set for C4 Diagram Sets
Remove obsolete sets deliberately Delete can be restored; Permanently Delete can't, and refuses a set that still holds diagrams Add or manage C4 Diagram Set

Suggestions and guidance workflow

Diagram Assistance exposes built-in suggestions for set curation. Built-in Suggestions work without AI.

Assistance and Coverage panel with the AI Diagram Assistant and a Coverage matrix: a Landscape row that covers the Systems BizTalk EDI Application and G22 Harmonised Orders, then one row per System, with Draft, Optional, or – per C4 level (7.12)
The Coverage matrix has one column per level (System Landscape, Context, Container, Component, Dynamic, Deployment) and one row per scope: a Landscape row that covers the set's Systems, then one row per System. Each cell reads Draft, Active, Optional, or –. Only Active and Draft diagrams count; archived revisions are excluded.

New 7.12 A cell with more than one diagram shows the count and opens the cell browser, where Component cells list each diagram's Subject (the Service or Contract it shows). The counts follow the sets and diagrams the user may open.

The Coverage matrix needs scoped diagrams. When no diagram in the set has an architectural scope, the panel shows Coverage matrix unavailable instead; set the scope in a diagram's Edit Properties or in the Designer to unlock it.

Assistance and Coverage panel on the Diagram Set page Order-to-Cash: ERP planning (draft) with the Static Recommendation Add an L3 component diagram for a Service, the AI Diagram Assistant, and the warning Coverage matrix unavailable because no diagram in the set has an architectural scope yet (7.12)
Static Recommendations are deterministic: L1 Context, L2 Container, and L3 Component are must-have, while L0 System Landscape, Dynamic, and Deployment are nice-to-have. The AI Diagram Assistant answers set-focused questions only when you ask, with What Should I Create Next? and Which Diagrams Look Stale?. No diagram in this Draft set has an Architectural Scope yet, so the panel shows Coverage matrix unavailable instead of the matrix.

In environments where the Impact Inbox is enabled, it appears directly beneath this guidance area and highlights potential drift across diagram levels. It is collapsed by default; its header shows the number of open items, and a click on the header opens it.

Impact Inbox with the Why you are seeing this help panel, the New, High impact, Stale, Dismissed, and Applied filters, and Bound entity diverged items (7.12)
A Why you are seeing this help panel sits on top. Each item names the bound entity in its title (Bound entity diverged: …) and the diagram, with a Why line and How to mitigate steps. Open the diagram, mark the item reviewed, or dismiss it; the review and dismiss buttons have menus. Filters separate new, high-impact, stale, dismissed, and applied items.

This is especially useful when teams work in Free Draw mode and content starts to diverge between related levels such as System Landscape, Context, Container, and Component (see Diagram Set Fundamentals for Layered Mode and Free Draw, and Review Impacts for the review states).

When AI guidance is enabled with EnableDiagramAiAssistance in the AI System Parameter, users can ask for set-level help directly in the workflow.

Ask AI What Needs Attention button
The button opens the AI Assistant with the current Diagram Set as context.

Access and governance

C4 Diagram Set governance depends on role permissions and administration settings.

Next Steps