Description
Knowledge Graph View is the interactive visual workflow for exploring how entities connect inside a Dotabase. It begins with a cluster overview, drills into cluster members, and then opens a focused ego neighborhood around a selected entity. Breadcrumbs, edge-family explanations, cluster-key selection, DIIICE filtering, focus depth, show-more controls, keyboard navigation, and row peeks let users move from visual structure to inspectable knowledge.
The server supplies bounded cluster, member, and neighborhood reads; the browser composes deterministic scenes for the active level. URL parameters preserve cluster, focus, and depth state so a graph destination can be revisited or shared. The renderer includes a screen-reader node list and direct selection semantics rather than treating the canvas as decorative imagery.
Selling Points
- Reveals clusters and bridges that remain difficult to see in tables or keyword search.
- Moves from overview to a concrete focused neighborhood, keeping visual exploration tied to inspectable entities.
- Preserves drill state in the URL, making graph discoveries reproducible instead of transient canvas moments.
- Supports edge-family and DIIICE filters, helping users ask meaningful structural questions without editing graph queries.
- Provides keyboard and screen-reader alternatives for a workflow that is often inaccessible in other graph products.
User Story
A researcher opens a Dotabase’s Graph view, selects a domain cluster, drills into its members, and focuses on one decision row. They increase neighborhood depth, filter to relevant edge families, open a connected row in a peek, and copy the URL so a teammate can return to the same graph state.
Extension Surface
The user experience is configurable through cluster keys, filters, focus, depth, and edge-family selection. apps/web/src/modules/dotabases/views/DotabaseGraphView.tsx owns those controls and URL state, while packages/parts/src/graph/GraphDrillView.tsx accepts typed scene data and callbacks. The shared renderer is separately extensible in-repo, but this end-user view has no external layout plugin contract.
Capabilities & Limits
- Drills through cluster, member, and ego-neighborhood levels.
- Supports URL restoration, filters, edge explanations, keyboard movement, focus depth, and row peeks.
- Keeps scene composition bounded and deterministic in the browser.
- Limit: full-corpus grouping and layout are not performed on the render thread; the view depends on server-provided bounded graph reads.
Implementation Map
apps/web/src/modules/dotabases/views/DotabaseGraphView.tsxpackages/parts/src/graph/GraphDrillView.tsxpackages/parts/src/graph/ConstellationMap.tsxpackages/parts/src/graph/FocusDepthControl.tsx