Документ собирается из блоков — 38 типов контента в четырёх группах: текстовые, утилиты, данные и графики. Каждый блок занимает в сетке документа от 1 до 24 колонок и перетаскивается мышью.
Текстовые
- MarkdownContent — форматированный текст: пояснения, выводы, ссылки;
- NotebookContent — полноценный Jupyter Notebook как блок отчёта (подробнее — Jupyter Notebooks).
Утилиты
- BookmarksContent — закладки-карточки со ссылками на другие отчёты и страницы;
- SectionContent — заголовок раздела: группирует блоки в длинных отчётах;
- DetailsContent — список свойств сущности: компактная карточка «ключ — значение».
Данные
- TableContent — интерактивная таблица: закреплённые шапка и первые колонки при прокрутке, постраничная выдача, сортировка, итоговая строка, мини-график в ячейке, цветные значки по правилам (например, только топ-10% — красным) и ссылки из ячеек;
- MetricContent — одиночная метрика/KPI крупным числом — с подписью, планом, изменением за период, состоянием и мини-графиком динамики;
- GaugeContent — спидометр-гейдж с зонами значений;
- BarGaugeContent — линейка-гейдж: ранжированный ряд значений, цвет каждого по порогам — удобно для рейтингов и нормативов;
- AlertsContent — живой список сработавших оповещений: состояния и фильтры по меткам, обновляется в реальном времени.
Графики
- LineChartContent — линейный график: как величина меняется во времени;
- BarChartContent — столбчатая диаграмма: сравнение категорий между собой;
- ComboChartContent — комбинированная диаграмма: столбцы одного показателя и линия другого на двух осях;
- ScatterChartContent — точечная диаграмма: связь двух числовых колонок и выбросы;
- DumbbellChartContent — гантельная диаграмма: два значения одной сущности и разрыв между ними (план и факт);
- SlopeChartContent — наклонная диаграмма: как изменились значения или рейтинг между двумя периодами;
- BulletChartContent — пулевая диаграмма: значение против нормы с коридорами допуска;
- ParetoChartContent — диаграмма Парето: рейтинг категорий с линией накопленной доли;
- DoughnutChartContent — кольцевая диаграмма: доли целого;
- TreemapChartContent — дерево: площади прямоугольников вместо долей и вложенность категорий;
- WaterfallChartContent — диаграмма-водопад: из чего сложился итог — от начальной суммы к конечной;
- SankeyChartContent — диаграмма потоков: куда перетекают деньги или товары, ширина ленты — объём;
- HistogramChartContent — гистограмма распределения значений;
- BoxPlotChartContent — диаграмма размаха с квартилями и выбросами;
- ViolinChartContent — диаграмма-скрипка: полная форма распределения по каждой группе;
- HeatmapContent — тепловая карта: плотность значений по двум колонкам;
- CalendarHeatmapContent — календарная тепловая карта: значение каждого дня в сетке года;
- FunnelChartContent — воронка: сколько людей доходит до каждого этапа и где отваливаются;
- GanttChartContent — диаграмма Ганта: что когда начинается и заканчивается, с отметкой сегодняшнего дня;
- TornadoChartContent — торнадо: какой фактор сильнее всего двигает результат;
- RadarChartContent — лепестковая диаграмма: профиль объекта по нескольким критериям сразу;
- ParallelCoordinatesChartContent — параллельные координаты: профили многих объектов по нескольким показателям;
- VennChartContent — диаграмма Венна: пересечение двух или трёх групп;
- MapChartContent — карта регионов: значение каждого региона России или страны мира цветом;
- NodeGraphChartContent — граф связей: узлы и рёбра по списку связей, кого-с-кем;
- StateTimelineChartContent — таймлайн состояний: цветные интервалы состояний по каждой метке;
- StatusHistoryChartContent — сетка состояний по времени: дискретные ячейки-периоды для каждой метки;
- CandlestickChartContent — свечи OHLC с объёмом торгов: финансовые ряды.
Что показывает каждый график и когда его ставить — в разделе Графики.
Сетка документа
- ширина блока — от 1 до 24 колонок; ширина вне диапазона ловится валидатором (
INVALID_BLOCK_WIDTH); - блоки перетаскиваются мышью (drag & drop);
- у каждого блока уникальный ID вида
block_{timestamp}_{random}; - конфигурация блока — словарь параметров: заголовок, размеры, тип контента, данные, запросы, переопределения оформления.
Notebook-блок
Ноутбук хранится двумя способами: как встроенный JSON прямо в блоке или как ссылка на внешний файл .ipynb. У блока отображаются счётчик ячеек и время последнего сохранения.