Введение
Что такое Doska: общая доска, где диаграммы — это код, с живыми документами, импортом инфраструктуры и Claude через MCP.
Doska — доска для совместной работы инженерных команд. Здесь можно рисовать вместе в реальном времени, описывать архитектуру кодом на Mermaid или D2, вести runbook'и и проектные документы рядом с досками и превращать файлы Terraform, Kubernetes и docker-compose в схемы. На этой странице — основные идеи и ссылки на остальные разделы документации.
Doska бесплатна и работает в браузере по адресу getdoska.top.
Как устроено рабочее пространство
Всё в Doska укладывается в простую иерархию:
| Уровень | Что это |
|---|---|
| Организация | Ваша компания или команда. Участники, приглашения и токены доступа относятся к организации. |
| Проект | Набор досок и документов со своими участниками и ролями (Владелец, Редактор, Наблюдатель). Проект можно открыть для всей организации. |
| Папка | Необязательная вложенность внутри проекта, чтобы держать доски и документы в порядке. |
| Доска | Бесконечный холст: стикеры, фигуры, стрелки, фреймы, картинки и диаграммы из кода. |
| Документ | Страница с форматированным текстом, как в Confluence, в которой могут жить диаграммы с досок. |
При регистрации Doska создаёт для вас организацию, в ней проект Общие доски и доску Добро пожаловать. Отдельной доской или документом можно поделиться, не открывая весь проект.
Диаграммы — это код
За диаграммой на доске стоит код: Mermaid (flowchart, sequenceDiagram, architecture-beta), D2 или nwdiag. Вставьте код, и Doska превратит его в настоящие фигуры, стрелки и фреймы. Их можно двигать, перекрашивать и соединять с чем угодно на доске.
flowchart LR
user([Клиент]) --> web[Сайт]
web --> api[API]
api --> pay{{Платежи}}
api --> db[(База данных)]Синхронизация работает в обе стороны:
- Правите код и нажимаете Применить — диаграмма обновляется на месте. Неизменившиеся фигуры остаются там, куда вы их поставили.
- Правите на холсте — переименовываете узел, проводите стрелку между узлами, удаляете или группируете узлы, а Doska переписывает в коде только затронутые строки.
- Сначала рисуете, потом превращаете в код — выделите нарисованные вручную фигуры и стрелки и нажмите В диаграмму.
Раз диаграмма — это текст, её можно хранить в git, ревьюить и обновлять из CI через REST API. Подробности — в разделе Диаграммы из кода.
Документы с живыми диаграммами
Документы — это страницы для runbook'ов, ADR, RFC, постмортемов и заметок со встреч. В них есть заголовки, списки, чек-листы, выноски, таблицы, блоки кода и комментарии к любой фразе. Вставьте диаграмму с доски, и документ всегда покажет её актуальное состояние: поменяли доску — обновились все страницы, где она есть. См. Документы.
Инфраструктура в схему
Загрузите вывод terraform show -json, манифесты Kubernetes или docker-compose.yml, и Doska нарисует архитектуру: регионы, VPC, подсети, сервисы и связи между ними. Результат — обычный код D2, который можно править. Повторный импорт того же источника обновляет схему на месте и показывает, где доска разошлась с файлами. См. Схемы из инфраструктуры.
Claude на ваших досках
В Doska встроен MCP-сервер. Подключите Claude Code (или другой MCP-клиент) по личному токену доступа, и он сможет читать доски, писать и исправлять диаграммы, добавлять стикеры и отвечать на комментарии — с правами не больше ваших. См. Claude и MCP.
Бесплатные редакторы без регистрации
Часть инструментов работает без аккаунта: редакторы Mermaid, D2 и nwdiag и Terraform в схему. Код и файлы читаются прямо в браузере. Когда захотите сохранить результат, сохраните его на доску. См. Бесплатные инструменты.
Совместная работа
Все, кто открыл доску, видят курсоры и правки друг друга сразу. К любой фигуре или узлу диаграммы можно оставить комментарий с @упоминанием, из истории версий — вернуть прежнее состояние, а доской — поделиться с коллегой, гостем не из организации или с кем угодно по ссылке только для просмотра. См. Доски и Доступ и совместная работа.
Что читать дальше
- Быстрый старт — от регистрации до первой схемы за несколько минут.
- Доски — инструменты, выделение, выравнивание, комментарии, история и экспорт.
- Горячие клавиши — полный справочник.
- Диаграммы из кода — синтаксис Mermaid, D2 и nwdiag и как работает синхронизация.
- Схемы из инфраструктуры — Terraform, Kubernetes и docker-compose.
- Документы — страницы с живыми диаграммами.
- Бесплатные инструменты — редакторы без аккаунта.
- Доступ и совместная работа — роли, приглашения и публичные ссылки.
- Claude и MCP — как подключить Claude к доскам.
- REST API — обновление диаграмм из скриптов и CI.
- Конфиденциальность и безопасность — как обращаемся с вашими данными.