DoskaДокументация
Документация / Начало работы

Быстрый старт

От регистрации до первой схемы в Doska за несколько минут: вход, код диаграммы, правки на доске и приглашение коллеги.

Это руководство проведёт вас от создания аккаунта до общей схемы, которую можно править вместе с коллегами. На всё уходит минут пять. Если хотите просто попробовать код диаграмм без аккаунта, откройте один из бесплатных редакторов.

1. Войдите

  1. Откройте getdoska.top и нажмите Начать бесплатно, чтобы войти через аккаунт Google.
  2. Чтобы зарегистрироваться по почте, откройте страницу регистрации, заполните поля Имя, Компания или команда, Email и Пароль (минимум 8 символов) и нажмите Создать аккаунт. Кнопка Продолжить с Google есть и на этой странице.

Doska создаст организацию с названием вашей компании или команды, а в ней проект Общие доски с доской Добро пожаловать. Вы станете владельцем и сможете позже пригласить коллег.

Заметка

Если ваша организация уже закрепила за собой домен рабочей почты, при входе через Google вы можете попасть в эту организацию вместо создания новой.

2. Выберите, с чего начать

Сразу после регистрации откроется экран С чего начнём?. Любой вариант заканчивается доской, на которой уже что-то есть:

ВариантЧто произойдёт
Вставить кодВставляете Mermaid, D2 или nwdiag — код превращается в фигуры, которые можно двигать.
Из вашей инфраструктурыОткроется новая доска с панелью инфраструктуры, куда можно добавить файлы Terraform, Kubernetes или docker-compose. См. Схемы из инфраструктуры.
Описать словамиОписываете систему или процесс, а ChatGPT или Claude пишет код схемы за вас.
РетроспективаДоска с колонками «что хорошо», «что улучшить» и «действия».
КанбанДоска с задачами по колонкам.
Пустая доскаЧистый холст для стикеров, фигур и стрелок.

Сначала покажите пример открывает доску «Добро пожаловать». Позже закрывает экран; доски можно создать с главной страницы или из проекта в любой момент.

Дальше разберём вариант Вставить код.

3. Вставьте код диаграммы

  1. Нажмите Вставить код.

  2. Вставьте код ниже или нажмите Взять пример — получится тот же код:

    mermaidОткрыть в бесплатном редакторе ↗
    flowchart LR
  user([Покупатель]) --> web[Сайт]
  web --> api[API]
  api --> pay{{Платежи}}
  api --> db[(База данных)]

  3. Doska проверяет код по мере ввода. Когда появится Всё в порядке, фигур: 5, нажмите Создать схему.

Откроется доска Моя первая схема: диаграмма на холсте, справа — панель Диаграммы из кода. Если в коде ошибка, под редактором появятся номер строки и сообщение, а кнопка останется недоступной.

Или опишите словами

Если писать код не хочется, выберите Описать словами:

  1. Опишите систему или процесс, например: «интернет-магазин: сайт, оплата, склад и доставка».
  2. Нажмите Спросить ChatGPT или Спросить Claude. Откроется новая вкладка с готовым запросом.
  3. Скопируйте ответ целиком и вставьте его обратно в Doska. Код схемы найдётся в ответе сам.
  4. Нажмите Создать схему.

4. Измените код и примените

В панели кода диаграмма редактируется как текст. Панель открывается и закрывается кнопкой Код в верхней панели или клавишами ⌘/Ctrl+E.

  1. Добавьте строку в конец кода:

    mermaidОткрыть в бесплатном редакторе ↗
    flowchart LR
  user([Покупатель]) --> web[Сайт]
  web --> api[API]
  api --> pay{{Платежи}}
  api --> db[(База данных)]
  api -->|заказ создан| queue[[Очередь заказов]]

  2. До применения доска показывает предпросмотр: новые элементы обведены зелёным, изменённые — жёлтым, удаляемые — красным. В панели видно, что изменится.

  3. Нажмите Применить или ⌘/Ctrl+Enter.

Новый узел и стрелка появятся рядом с соседями, всё остальное останется на своих местах. Чтобы откатить изменение, нажмите ⌘/Ctrl+Z: одна отмена возвращает и доску, и код.

Совет

Ошибка в коде никогда не ломает доску. Пока вы её не исправите, на доске остаётся последняя успешно применённая версия, а ошибка подсвечена в своей строке.

5. Подвигайте фигуры на доске

Код определяет, какие узлы и стрелки существуют. Холст — где они стоят.

  • Перетащите узел на новое место. Его стрелки перестроятся в обход других фигур. Позиции, размеры и цвета, заданные вручную, сохранятся при следующем применении кода.
  • Дважды кликните по узлу и введите новую подпись. Она поменяется и в коде.
  • Соедините два узла: выделите узел, потяните за одну из ручек + по его сторонам и отпустите на другом узле. Doska добавит связь в код.
  • Удалите узел клавишей Delete или Backspace. Из кода уйдут его строка и связи.

Если расстановка совсем разъехалась, нажмите Перераскладка в панели кода — все узлы будут расставлены заново.

6. Пригласите коллегу

  1. Нажмите Поделиться в правом верхнем углу доски.
  2. Выберите способ:
    • Добавить человека из организации: введите имя или почту, выберите Редактор или Наблюдатель и нажмите Добавить.
    • Пригласить нового человека: в блоке Ссылка-приглашение выберите роль, нажмите Создать, затем Копировать и отправьте ссылку. Она действует 7 дней. Человек не из организации войдёт гостем и увидит только эту доску.
    • Показать доску всем: рядом с Только у кого есть доступ нажмите Включить. Любой со ссылкой сможет смотреть доску без входа: только просмотр, изменения видны сразу.
  3. Чтобы открыть доступ ко всем доскам и документам проекта, нажмите Доступ ко всему проекту внизу окна.

Когда коллега откроет доску, вы увидите его курсор с именем, а в верхней панели — его аватар. Клик по аватару переносит вас туда, куда он смотрит.

Что дальше