7.0. Diagram Implementation Families

English | Русский

English

Diagram Implementation Families

ORBIT diagram types remain user-facing, domain-specific concepts. Internally, they should reuse a smaller set of implementation families based on semantic shape, grammar patterns, layout, routing, and renderer primitives.

Domain AST
    ↓
Validated Domain Model
    ↓
Family Render Model
    ↓
Family Layout and Routing
    ↓
Positioned Renderer Primitives
    ↓
Representation

Implementation families are internal architecture, not ORBIT syntax. They do not replace domain grammars or user-facing groups.

Families

• Graph — typed nodes, compartments, containment, and general edges.
• Flow — directed steps, branches, lanes, transitions, and ordered flow.
• Timeline — time axes, tracks, intervals, milestones, and messages.
• Matrix — row/column grids and cells.
• Canvas — named regions containing structured text or cards.
• Board/List — ordered lanes, columns, groups, cards, and list items.

Families may define specialized subtypes. Likely Graph subtypes include Generic Graph, Topology Graph, Hierarchy Graph, and Mapping Graph.

Proposed Classification

Diagram Type	User Group	Family	Grammar Similarity	Layout Similarity	Routing Similarity	Shared Primitives
Database Schema	Engineering	Graph	entities, fields, references	compartment nodes	port-to-port edges	boxes, rows, badges, edges
ER Diagram	Engineering	Graph	entities, attributes, relations	entity graph	cardinality edges	boxes, rows, edge labels
Domain Model	Engineering	Graph	entities, values, associations	typed graph	association edges	boxes, compartments, edges
Class Diagram	Engineering	Graph	classes, members, inheritance	compartment graph	typed edges	boxes, rows, arrows
Component Diagram	Engineering	Graph	components, ports, dependencies	clustered graph	dependency edges	groups, boxes, ports, edges
Architecture Diagram	Engineering	Graph	systems, services, dependencies	clustered graph	dependency edges	groups, boxes, icons, edges
C4 Diagram	Engineering	Graph	hierarchical elements, relations	nested graph	relationship edges	groups, boxes, labels, edges
Deployment Diagram	Engineering	Graph	nodes, artifacts, deployments	nested topology	topology edges	groups, boxes, badges, edges
Network Diagram	Engineering	Graph	devices, networks, links	topology graph	link routing	nodes, icons, labels, edges
Sequence Diagram	Engineering	Timeline	participants, messages	horizontal actors, vertical time	message arrows	lifelines, messages, activations
State Machine Diagram	Engineering	Flow	states, transitions, guards	directed state graph	transition routing	state nodes, edges, labels
Flowchart	Process	Flow	steps, decisions, transitions	layered graph	flow routing	process nodes, decisions, arrows
Activity Diagram	Process	Flow	activities, branches, lanes	layered lanes	control-flow routing	lanes, nodes, forks, arrows
BPMN	Process	Flow	events, tasks, gateways, pools	pools and lanes	sequence/message routing	events, tasks, gateways, lanes
Pipeline	Process	Flow	stages, jobs, dependencies	layered stages	dependency routing	stages, nodes, badges, arrows
Data Flow	Process	Flow	processes, stores, actors	directed flow graph	labeled flow routing	nodes, stores, labels, arrows
User Flow	Process	Flow	screens, actions, decisions	directed journey graph	transition routing	cards, decisions, arrows
Event Storming	Process	Flow	events, commands, actors	ordered lanes/clusters	causal links	cards, lanes, groups, edges
Gantt	Planning	Timeline	tasks, durations, dependencies	time grid and tracks	dependency connectors	axis, bars, milestones, links
Roadmap	Planning	Timeline	periods, initiatives, milestones	time bands/tracks	limited links	axis, bands, cards, milestones
Timeline	Planning	Timeline	dated events and intervals	one or more time axes	callout connectors	axis, events, intervals, labels
Calendar	Planning	Timeline	dates, events, recurrence	calendar grid	usually none	grid, cells, event cards
Checklist	Planning	Board/List	groups, ordered items	grouped vertical lists	none	groups, rows, check markers
Kanban	Planning	Board/List	columns, cards, ordering	board columns	optional links	lanes, cards, badges
Dependency Map	Planning	Graph	items, dependencies	dependency graph	directed edges	boxes, groups, arrows
User Story Map	Product	Board/List	activities, tasks, releases	hierarchical rows/columns	usually none	lanes, cards, release bands
Impact Map	Product	Graph	goals, actors, impacts	radial/tree hierarchy	parent-child edges	hierarchy nodes, groups, edges
Opportunity Solution Tree	Product	Graph	opportunities, solutions, experiments	hierarchical tree	parent-child edges	hierarchy nodes, cards, edges
Customer Journey Map	Product	Timeline	stages, actions, emotions	stage columns and tracks	stage flow	lanes, headers, curves, cards
Stakeholder Map	Product	Graph	stakeholders, groups, influence	radial/clustered graph	influence edges	nodes, groups, labels, edges
Feature Map	Product	Board/List	feature groups, hierarchy	grouped cards/tree rows	optional links	groups, cards, badges
Business Model Canvas	Business	Canvas	fixed sections and entries	fixed region template	none	regions, headings, cards
SWOT	Business	Matrix	four named categories	fixed 2x2 matrix	none	matrix cells, headings, lists
SMART Goals	Business	Canvas	goal and five criteria	fixed named regions	none	regions, headings, text
Value Proposition Canvas	Business	Canvas	customer and value sections	paired-region template	semantic pairing	regions, cards, headings
RACI Matrix	Business	Matrix	activities, roles, assignments	row/column grid	none	headers, cells, badges
Risk Matrix	Business	Matrix	likelihood, impact, risks	scored matrix grid	none	axes, cells, markers, legend
Decision Matrix	Business	Matrix	options, criteria, scores	row/column grid	none	headers, cells, score badges
Data Lineage	Data	Graph	datasets, fields, transforms, lineage	layered mapping graph	field-level port routing	dataset boxes, rows, ports, directed edges
ETL Mapping	Data	Graph	sources, targets, transformations, field mappings	paired/layered mapping graph	dense field-level routing	tables, rows, ports, transform nodes, mapping edges

Architecture Consequences

• Domain packages own grammar, AST, validation, and semantic models.
• Family packages own reusable render-model contracts and layout strategies.
• Routing operates on positioned ports and obstacles, not domain AST nodes.
• Renderers consume positioned primitives rather than domain models directly.
• Diagram types may specialize a family without creating a separate renderer.
• Specialized Graph layouts may support topology, hierarchy, and mapping-style diagrams without creating separate top-level families.
• Hybrid diagrams compose family strategies and primitives.

Open Questions

• How Graph family subtypes should share layout and routing primitives while supporting specialized styles such as topology, hierarchy, and mapping graphs.
• Whether Timeline and Board/List share a track/lane abstraction.
• How render models preserve accessibility and documentation metadata.
• How future layout preferences select strategies without becoming model semantics.

Русский

Семейства реализации диаграмм

Типы диаграмм ORBIT остаются пользовательскими предметно-ориентированными понятиями. Внутренняя реализация должна повторно использовать меньшее число семейств, выделенных по семантической форме, грамматике, компоновке, маршрутизации и графическим примитивам.

Предметный AST
    ↓
Проверенная предметная модель
    ↓
Модель визуализации семейства
    ↓
Компоновка и маршрутизация семейства
    ↓
Позиционированные графические примитивы
    ↓
Представление

Семейства реализации являются внутренней архитектурой, а не синтаксисом ORBIT. Они не заменяют предметные грамматики или пользовательские группы.

Семейства

• Graph — типизированные узлы, секции, вложенность и общие связи.
• Flow — направленные шаги, ветвления, дорожки и переходы.
• Timeline — временные оси, треки, интервалы, вехи и сообщения.
• Matrix — сетки строк, столбцов и ячеек.
• Canvas — именованные области со структурированным текстом или карточками.
• Board/List — упорядоченные дорожки, столбцы, группы, карточки и пункты.

Семейства могут иметь специализированные подтипы. Возможные подтипы Graph: Generic Graph, Topology Graph, Hierarchy Graph и Mapping Graph.

Предлагаемая классификация

Тип диаграммы	Пользовательская группа	Семейство	Сходство грамматики	Сходство компоновки	Сходство маршрутизации	Общие примитивы
Database Schema	Engineering	Graph	сущности, поля, ссылки	узлы с секциями	связи между портами	блоки, строки, метки, связи
ER Diagram	Engineering	Graph	сущности, атрибуты, отношения	граф сущностей	связи с кардинальностью	блоки, строки, подписи связей
Domain Model	Engineering	Graph	сущности, значения, ассоциации	типизированный граф	ассоциации	блоки, секции, связи
Class Diagram	Engineering	Graph	классы, члены, наследование	граф с секциями	типизированные связи	блоки, строки, стрелки
Component Diagram	Engineering	Graph	компоненты, порты, зависимости	кластерный граф	зависимости	группы, блоки, порты, связи
Architecture Diagram	Engineering	Graph	системы, сервисы, зависимости	кластерный граф	зависимости	группы, блоки, иконки, связи
C4 Diagram	Engineering	Graph	иерархические элементы и связи	вложенный граф	отношения	группы, блоки, подписи, связи
Deployment Diagram	Engineering	Graph	узлы, артефакты, развёртывание	вложенная топология	топологические связи	группы, блоки, метки, связи
Network Diagram	Engineering	Graph	устройства, сети, соединения	топологический граф	маршрутизация соединений	узлы, иконки, подписи, связи
Sequence Diagram	Engineering	Timeline	участники, сообщения	участники по горизонтали, время по вертикали	стрелки сообщений	линии жизни, сообщения, активации
State Machine Diagram	Engineering	Flow	состояния, переходы, условия	направленный граф состояний	маршрутизация переходов	состояния, связи, подписи
Flowchart	Process	Flow	шаги, решения, переходы	слоистый граф	маршрутизация потока	процессы, решения, стрелки
Activity Diagram	Process	Flow	действия, ветвления, дорожки	слоистые дорожки	поток управления	дорожки, узлы, развилки, стрелки
BPMN	Process	Flow	события, задачи, шлюзы, пулы	пулы и дорожки	последовательности и сообщения	события, задачи, шлюзы, дорожки
Pipeline	Process	Flow	этапы, задания, зависимости	слоистые этапы	зависимости	этапы, узлы, метки, стрелки
Data Flow	Process	Flow	процессы, хранилища, участники	направленный граф потока	подписанные потоки	узлы, хранилища, подписи, стрелки
User Flow	Process	Flow	экраны, действия, решения	направленный граф пути	переходы	карточки, решения, стрелки
Event Storming	Process	Flow	события, команды, участники	упорядоченные дорожки и кластеры	причинные связи	карточки, дорожки, группы, связи
Gantt	Planning	Timeline	задачи, длительности, зависимости	временная сетка и треки	связи зависимостей	ось, полосы, вехи, связи
Roadmap	Planning	Timeline	периоды, инициативы, вехи	временные полосы и треки	ограниченные связи	ось, полосы, карточки, вехи
Timeline	Planning	Timeline	датированные события и интервалы	одна или несколько осей	выносные соединители	ось, события, интервалы, подписи
Calendar	Planning	Timeline	даты, события, повторения	календарная сетка	обычно отсутствует	сетка, ячейки, карточки событий
Checklist	Planning	Board/List	группы, упорядоченные пункты	сгруппированные списки	отсутствует	группы, строки, отметки
Kanban	Planning	Board/List	столбцы, карточки, порядок	столбцы доски	необязательные связи	дорожки, карточки, метки
Dependency Map	Planning	Graph	элементы, зависимости	граф зависимостей	направленные связи	блоки, группы, стрелки
User Story Map	Product	Board/List	активности, задачи, релизы	иерархические строки и столбцы	обычно отсутствует	дорожки, карточки, полосы релизов
Impact Map	Product	Graph	цели, участники, влияния	радиальная или древовидная иерархия	связи родитель-потомок	иерархические узлы, группы, связи
Opportunity Solution Tree	Product	Graph	возможности, решения, эксперименты	иерархическое дерево	связи родитель-потомок	узлы, карточки, связи
Customer Journey Map	Product	Timeline	этапы, действия, эмоции	столбцы этапов и треки	поток между этапами	дорожки, заголовки, кривые, карточки
Stakeholder Map	Product	Graph	участники, группы, влияние	радиальный или кластерный граф	связи влияния	узлы, группы, подписи, связи
Feature Map	Product	Board/List	группы функций, иерархия	группы карточек и строки дерева	необязательные связи	группы, карточки, метки
Business Model Canvas	Business	Canvas	фиксированные разделы и записи	шаблон фиксированных областей	отсутствует	области, заголовки, карточки
SWOT	Business	Matrix	четыре именованные категории	фиксированная матрица 2x2	отсутствует	ячейки, заголовки, списки
SMART Goals	Business	Canvas	цель и пять критериев	фиксированные именованные области	отсутствует	области, заголовки, текст
Value Proposition Canvas	Business	Canvas	разделы клиента и ценности	парный шаблон областей	смысловое соответствие	области, карточки, заголовки
RACI Matrix	Business	Matrix	действия, роли, назначения	сетка строк и столбцов	отсутствует	заголовки, ячейки, метки
Risk Matrix	Business	Matrix	вероятность, влияние, риски	оценочная матрица	отсутствует	оси, ячейки, маркеры, легенда
Decision Matrix	Business	Matrix	варианты, критерии, оценки	сетка строк и столбцов	отсутствует	заголовки, ячейки, оценки
Data Lineage	Data	Graph	наборы данных, поля, преобразования, происхождение	слоистый граф отображения	маршрутизация на уровне портов полей	блоки наборов данных, строки, порты, направленные связи
ETL Mapping	Data	Graph	источники, цели, преобразования, отображения полей	парный или слоистый граф отображения	плотная маршрутизация на уровне полей	таблицы, строки, порты, узлы преобразований, связи отображения

Архитектурные следствия

• Предметные пакеты владеют грамматикой, AST, валидацией и семантическими моделями.
• Пакеты семейств владеют общими моделями визуализации и стратегиями компоновки.
• Маршрутизация работает с позиционированными портами и препятствиями, а не с AST.
• Рендереры получают позиционированные примитивы, а не предметные модели напрямую.
• Тип диаграммы может специализировать семейство без отдельного рендерера.
• Специализированные компоновки Graph могут поддерживать топологические, иерархические диаграммы и графы отображения без создания отдельных семейств.
• Гибридные диаграммы комбинируют стратегии и примитивы семейств.

Открытые вопросы

• Как подтипы семейства Graph должны совместно использовать примитивы компоновки и маршрутизации, поддерживая специализированные стили топологических, иерархических графов и графов отображения.
• Нужна ли Timeline и Board/List общая абстракция треков и дорожек.
• Как модели визуализации сохраняют accessibility-метаданные и документацию.
• Как будущие предпочтения компоновки выбирают стратегию, не становясь семантикой модели.