Focused Context Diagrams are simplified, domain-driven visualizations that highlight a single bounded context and show only its direct relationships with other domains.
They are used to keep wiki pages for individual domains clean, readable, and context-aware without showing the entire system graph.
# Purpose - Show a **zoomed-in view** of a specific domain (e.g. Pinning Services) - Illustrate how that domain **interfaces with others** - Avoid visual overload from unrelated parts of the system - Reinforce **bounded context boundaries** from Domain-Driven Design
# Diagram Style A focused context diagram follows these conventions: - The **primary domain** is rendered as a full `subgraph cluster`, with all of its internal nodes and a tooltip label - **Directly linked domains** are represented as **single, colored nodes** matching the color used in the Federated Social Pinning Service full system graph - Unrelated or indirectly connected domains are **not shown** - Cross-domain links are drawn with labeled edges to make boundaries explicit
# Example The page for Pinning Services includes a focused context diagram that: - Renders "Pinning Services" as a green subgraph with its three internal nodes - Shows "Metadata and Naming" as a yellow standalone node - Shows "Social Layer" as a blue standalone node - Omits "Verification Mesh" and "Consumers", which are not directly connected
digraph PinningServicesContext { node [shape=box, style=filled, fillcolor=lightgray]; // Pinning Services Domain (full detail) subgraph cluster_pinning { tooltip = "Pinning Services"; label = "Pinning Services"; style = filled; color = lightgreen; "Pinning Service"; "Homelab Node"; "Institutional Node"; } // Linked domains as colored label nodes "Metadata and Naming" [fillcolor=lightyellow, style=filled, tooltip="Metadata and Naming"]; "Social Layer" [fillcolor=lightblue, style=filled, tooltip="Social Layer"]; // Cross-domain links "Pinning Service" -> "Metadata and Naming" [label="uses CID"]; "Homelab Node" -> "Social Layer" [label="pinned by allies"]; "Institutional Node" -> "Social Layer" [label="mirrored by institutions"]; }
# Advantages - Easier to interpret for non-technical users - Promotes modular design thinking - Makes inter-domain responsibilities and handoffs explicit - Can evolve independently as each domain changes
# Related Concepts - Bounded Context - Domain Design - Federated Social Pinning Service - Subgraph Styling - IPFS Trust Edges These diagrams help each page stay locally focused while remaining part of a larger federated design.