Глоссарий

Короткие определения терминов дизайн-систем: расхождение, дизайн-токены, режимы, конвейер токенов и другие.

А

Автоматический pull request: Автоматический pull request инструмент открывает или обновляет сам, когда меняется источник: изменение дизайна приходит как pull request, и запускать доставку никому не нужно.

Время исправления: Время исправления — сколько находка по дизайн-системе остаётся открытой: от дня, когда её впервые заметили, до дня, когда её закрыли.

Дизайн-токен: Дизайн-токен — одно дизайн-решение, например цвет, шаг отступа или размер шрифта, с именем, общим для дизайна и кода.

Здоровье дизайн-системы: Здоровье дизайн-системы показывает, совпадает ли с ней продукт, который её использует: расхождения, их охват, обходы и время исправления.
Здоровье компонента: Здоровье компонента — оценка одного компонента: насколько он следует макету и токенам и в каком порядке его API и доступность. В FISYCO она от 0 до 100.

Индекс кода: Индекс кода — структурированная запись фактов о репозитории, например имён компонентов, пропсов и применений, которая хранится вместо самого кода.

Класс изменения: Класс изменения говорит, насколько правка дизайна может задеть код, который уже использует компонент: ломающее, расширяющее или косметика.
Конвейер токенов: Конвейер токенов — автоматический путь, по которому дизайн-токены попадают из источника, например Figma, в код в виде изменения, прошедшего ревью.
Контроль дизайн-системы: Контроль дизайн-системы — практика, которая в любой момент доказывает, что продакшен по-прежнему совпадает с дизайн-системой, утверждённой командой.

Обход системы: Обход системы — код, который идёт мимо дизайн-системы там, где есть токен или компонент, например зашитый цвет или заново собранная кнопка.
Охват: Охват — часть продукта, которую затрагивает токен, компонент или расхождение: число мест в коде, которые их используют или от них зависят.

Патч дизайн-системы: Патч дизайн-системы — правка кода, которая возвращает его к дизайн-системе: её доказывают до выпуска и присылают как pull request.
Примитивные и смысловые токены: Примитивный токен называет сырое значение, например blue 500. Смысловой — назначение значения, например акцентный фон, и ссылается на примитив.
Продуктовый репозиторий: Продуктовый репозиторий — репозиторий продукта, который подключает ui-kit дизайн-системы как зависимость, а не содержит его.

Расхождение дизайн-системы: Расхождение дизайн-системы — разрыв между дизайном, который утвердила команда, и кодом, который получают клиенты.
Режим: Режим — один набор значений для тех же токенов, например светлая или тёмная тема.

Сопоставление вариантов: Сопоставление вариантов связывает каждое свойство вариантов Figma и его значения с пропсами кода и значениями, которые рисуют то же самое.

DTCG: DTCG (Design Tokens Community Group) — группа сообщества W3C, которая разрабатывает Design Tokens Format Module, и привычное короткое имя самого формата: JSON с типизированными токенами и ссылками.

MCP-сервер дизайн-системы: MCP-сервер дизайн-системы даёт ИИ-агентам дизайн-систему в виде инструментов: компоненты, токены, правила команды и проверку кода, который они пишут.

SVG-спрайт иконок: SVG-спрайт иконок — один SVG-файл, где каждая иконка лежит символом. Страница рисует иконку по ссылке, а не грузит её отдельным файлом.