Focused Context Diagrams

**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 # 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.