Документация Доски — whiteboard

Доски — совместные whiteboard’ы

Доски — это совместные whiteboard’ы с бесконечным холстом, встроенные в
Mockarty: набросайте архитектуру, спланируйте спринт, проведите ретро, нарисуйте
схему — вместе, в реальном времени, видя курсоры и изменения друг друга вживую.
Доски организованы в папки с тегами и фильтрами, поставляются с шаблонами и
хранят историю версий.

Открываются из бокового меню: Доски (/ui/whiteboards).

Организация досок

Левая панель — одно дерево, в том же стиле, что и дерево страниц вики: папки —
раскрывающиеся ветки, доски — их листья.

  • Папки — клик по папке раскрывает или сворачивает ветку; бейдж показывает,
    сколько досок в ней вместе с подпапками. Двойной клик (или F2) переименовывает
    папку на месте; правый клик (или ⋯ при наведении) открывает меню: новая
    доска здесь, новая подпапка, переименовать, переместить, свернуть, удалить.
    Удаление папки переносит её доски в родительскую, поэтому доска никогда не
    исчезает вместе с папкой.
  • Доски — клик открывает доску. Закладка отмечает избранную, маленький бейдж
    показывает число листов. Правый клик (или ⋯): открыть, в избранное,
    переименовать, папка и теги, скопировать ссылку, выбрать, удалить.
  • Перетаскивание — перетащите доску на папку, чтобы переместить её туда, или
    на пустое место панели, чтобы вынести из всех папок; папки так же
    перетаскиваются в другие папки.
  • Клавиатура — стрелки ходят по дереву, Enter открывает доску или
    раскрывает папку, Shift+F10 открывает меню строки.
  • Выбрать несколько — пункт «Выбрать» в меню доски: у каждой доски
    появляется флажок, а панель над деревом перемещает или удаляет всё выбранное.
  • Теги — у каждой доски могут быть теги; чипы тегов под деревом фильтруют его
    в один клик.
  • Поиск — фильтрует доски по названию или описанию по мере ввода; папки,
    ведущие к совпадению, остаются раскрытыми.
  • Новая доска — кнопка + открывает диалог создания с библиотекой
    шаблонов и выбором папки; из меню папки доска создаётся сразу в ней.
  • Корзина — удалённая доска попадает в Корзину, откуда
    её можно восстановить (вместе с историей версий), пока её не удалит политика
    хранения.

Шаблоны

При создании доски можно начать с шаблона вместо пустого холста:

  • Пустая — чистый холст.
  • ADR — макет Architecture Decision Record (контекст / решение /
    последствия / альтернативы).
  • Архитектура C4 — скелет диаграммы контейнеров C4.
  • Блок-схема — поток старт → действие → условие → финиш.
  • Ретро — колонки «хорошо» / «можно лучше» / «действия».

Рисование и совместная работа в реальном времени

Холст — полноценная поверхность для рисования: фигуры, стрелки, текст,
от-руки, изображения, фреймы, цвета, масштаб и палитра инструментов. Меню
«бургер» в левом верхнем углу холста собирает действия самой доски — импорт,
экспорт, историю версий, сохранение версии, полный экран, сетку вкл/выкл — рядом
с настройками холста (поиск, фон, тема, помощь, очистка).

Холст следует теме: белый в светлой, тёмная поверхность продукта в тёмной, с
едва заметной сеткой в стиле draw.io (каждая пятая линия чуть заметнее),
которая двигается и масштабируется вместе с рисунком и исчезает, когда клетки
становятся слишком мелкими. Отключается в меню «бургер» — выбор запоминается
в браузере. Цвет фона из настроек холста накрывает сетку; экспорт всегда идёт
на белом (или выбранном вами цвете).

  • Текст внутри фигуры — выделите фигуру и нажмите Enter или дважды
    кликните внутри неё и печатайте: текст остаётся по центру и переносится
    внутри фигуры; клик снаружи или Esc завершает ввод.

  • Откройте доску — и все, кто её открыл, в комнате вместе: вы видите
    курсоры друг друга и каждое изменение по мере его появления.

  • Режим следования — кликните аватар коллеги в панели присутствия, и ваш
    канвас повторит его перемещения и масштаб: идеально для демонстраций и
    ревью. Повторный клик выключает следование.

  • Обсуждения — иконка чата рядом с панелью присутствия открывает
    обсуждение этой доски в боковой панели; упомяните там @agent, чтобы AI
    изменил сцену с учётом контекста переписки.

  • Работа сохраняется автоматически; статус сохранения показан рядом с названием
    доски.

  • Соединяйте блоки стрелками, чтобы строить архитектурные схемы, ADR и потоки.

  • Точки соединения — наведите курсор на фигуру, и появятся восемь
    точек-якорей: четыре по серединам сторон и четыре по углам. Потяните от
    точки, чтобы сразу начать стрелку; Esc во время перетаскивания отменяет
    её. Стрелка привязывается к фигуре-источнику и к фигуре, на которой вы её
    отпустили, и остаётся прикреплённой при перемещении фигур. Переключатель
    типа стрелок на панели доски выбирает прямые, плавные или ломаные —
    ломаные включены по умолчанию и автоматически обходят другие элементы.

  • Паки элементов — кнопка паков на панели доски вставляет готовые группы в
    центр экрана: стикеры, набор блок-схемы (старт → процесс → развилка с
    ветками), набор архитектуры (пользователь → сервис → БД/очередь),
    SWOT-матрица, узлы C4, дорожки и статус-стикеры ✓/⚠/✗/?. Эти же наборы
    доступны в панели библиотеки канваса (иконка книги), а в диалоге паков есть
    кнопка, возвращающая их туда, если библиотеку очистили.

  • Карточки задач — привяжите задачи трекера к элементам, и их живые
    статус-бейджи отображаются прямо на канвасе; фрейм с задачами можно одним
    действием превратить в задачи трекера.

  • Экспорт — скачайте доску как картинку PNG, SVG или PDF, как файл
    диаграммы Mermaid (.mmd) или draw.io (.drawio), сохраняющий фигуры и
    связи редактируемыми в этих инструментах, либо как JSON-файл сцены.

  • Импорт — кнопка импорта открывает список форматов с поиском: выбираете,
    что именно вы приносите, и видите, что из этого получится. Встроенные
    форматы:

    • Mermaid — вставьте исходник или выберите файл .mmd. Flowchart,
      sequence и class становятся редактируемыми фигурами; остальные типы
      (например C4 или gantt) вставляются картинкой.
    • draw.io / diagrams.net — файл .drawio или .xml, включая сжатые:
      фигуры, текст и связи становятся редактируемыми.
    • Сцена доски (JSON) — файл, выгруженный экспортом доски: все фигуры
      возвращаются ровно такими, какими были.

    Если установлен плагин, добавляющий свой формат, он появляется в этом же
    списке с бейджем Плагин. Всё импортированное появляется в центре
    экрана обычными редактируемыми элементами, а один Ctrl+Z убирает
    вставленное целиком.

Листы — несколько схем на одной доске

Доска — это рабочая книга: в ней может быть несколько листов, между
которыми переключаются вкладки под холстом, как в электронной таблице.
Контекстная схема, контейнеры, последовательность и ретро одной системы живут
вместе, а не раскиданы по отдельным доскам.

  • Добавить лист — кнопка + слева в полосе вкладок (или правый клик по
    пустому месту полосы). Новая вкладка сразу открывается на переименование:
    введите название и нажмите Enter.
  • Переименовать — двойной клик по вкладке или F2 на выбранной.
  • Правый клик по вкладке (или Shift+F10) открывает меню: переименовать,
    дублировать, сдвинуть влево / вправо, скопировать ссылку на лист, удалить.
  • Переставить — перетащите вкладку вдоль полосы.
  • Дублировать копирует рисунок листа в новую вкладку — быстрый способ
    нарисовать варианты «до / после».
  • У каждого листа свой короткий ключ (WB-12), своя история версий и своя
    комната совместной работы: ссылка на лист открывает доску сразу на нём, а
    коллеги на разных листах не мешают друг другу.
  • Удалить отправляет лист в Корзину вместе с его
    историей; удаление доски забирает все её листы, а восстановление доски
    возвращает их все. Первый лист — это сама доска, отдельно его не удалить.
  • Листы — вкладки доски, а не отдельные доски: в списке досок одна карточка на
    доску с числом листов.

Агенты делают то же самое через MCP: whiteboard_get возвращает полосу вкладок
в sheets; whiteboard_sheet_create, whiteboard_sheet_update,
whiteboard_sheets_reorder и whiteboard_sheet_delete управляют ею; рисование
на листе — whiteboard_save_scene с id листа.

История версий

Кнопка с часами открывает историю снимков доски (у каждого листа она своя).

  • Снимки делаются автоматически по мере рисования — не чаще одного на автора в
    пять минут, чтобы непрерывное рисование не переполняло историю, — плюс каждый
    раз, когда вы нажимаете закладку (Сохранить версию) и добавляете заметку.
    Доска, созданная из шаблона, начинает историю с шаблона как v1.
  • Именованные контрольные точки помечены акцентным бейджем, автосохранения
    приглушены — вехи видны сразу.
  • Клик по снимку открывает сравнение: выбранная версия показана рядом с
    предыдущей — добавленные элементы зелёным, удалённые красным, изменённые
    жёлтым, со сводкой +/−/~. Любую сторону можно переключить — на другую версию,
    на Начало (пустая доска) или на Текущую доску: так в один клик видно,
    что изменилось с последнего снимка. Первый снимок сравнивается с пустой
    доской, а не сам с собой.
  • Восстановить эту версию возвращает снимок как текущую сцену. История
    только дополняется — восстановление само является новым снимком, и все
    открытые холсты сразу перечитывают восстановленную сцену.

Вставка доски в Wiki

Любую доску можно вставить в wiki-страницу через !board:<id-доски> — страница
покажет живое превью со ссылкой Открыть доску и кнопкой Рисовать здесь,
открывающей канвас прямо в странице. Так архитектурная документация остаётся
синхронной со схемой.

Включение Досок

Доски поставляются внутри модуля TCM — включаются тем же переключением на уровне
пространства, что и остальные фичи этого семейства.