Витрина для разработчиков

Kommand, описанный своим кодом

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

дайджест описания 8df264505050381a

Модуль: 8
Справочник: 4
Сущность: 5
Контракт: 184
Точка расширения: 14
Возможность: 110

Разделы

Граф системы

/portal/graph

Разделы, справочники и контракты со связями между ними. Клик по узлу показывает, что к нему относится.

Справочник API

/docs

OpenAPI по REST v2: операции, схемы запросов и ответов, коды ошибок.

MCP-сервер

/mcp

Девять инструментов discovery для агентов: разделы, контракты, точки расширения. Ключ не нужен.

Манифест

/api/v2/system/manifest

То же описание в JSON — для интеграции, генерации клиентов и агентов.

Первый вызов

01
Создайте ключ

В настройках аккаунта Kommand. Ключ привязан к одному аккаунту и передаётся заголовком.
```
Authorization: Bearer kmd_...
```
02
Узнайте account_id

Он подставляется в пути почти всех операций, поэтому это всегда второй шаг.
```
curl -H "Authorization: Bearer kmd_..." https://api.kommand.ru/api/v2/me
```
03
Сделайте содержательный запрос

Список документов аккаунта. Дальше — по справочнику API.
```
curl -H "Authorization: Bearer kmd_..." \
  https://api.kommand.ru/api/v2/accounts/{account_id}/documents
```

Для агентов

Дальше читает не человек. Описание системы отдаётся в машинном виде — без ключа и без разбора вёрстки.

POST /mcp

JSON-RPC 2.0. Начинать с describe_system: он объясняет авторизацию и даёт адреса остальных описаний.

GET /llms.txt

Карта платформы в тексте: разделы, точки расширения и адреса машиночитаемых представлений.

Точки расширения

Места, куда добавляют новое, не трогая остальное.

Коннектор агент-платформы

Источник инструментов для AI-ассистента. Отвалившийся коннектор не ломает диалог — его инструменты просто не предлагаются.

Объект обсуждения

Тип записи, у которой бывают комментарии. Регистрация в реестре включает колонку обсуждения в общей detail-панели — вёрстку в разделе править не нужно.

Тип поля

Тип значения для кастомных полей и вопросов процедур: как хранится, как валидируется, чем рисуется.

Вид «Входящих» из журнала

Глагол журнала, по которому во «Входящие» приходит сообщение, и правило подтверждения. Незарегистрированный глагол сообщения не порождает.

Провайдер интеграции

Внешний сервис с описанной схемой учётных данных и настроек. Схема разом задаёт форму в интерфейсе, серверную валидацию и проверку работоспособности.

Источник оси матрицы

Из каких группировок собирается ось среза (по образцу AG5): узел структуры, должность, смена, категория требований или отдельная запись. Регистрация типа открывает его в меню «Добавить» вкладки оси и в резолвере состава среза.

Тип матрицы

Срез в аналитике: что по строкам, что по столбцам, чем заполняется ячейка. Добавляется одним файлом в каталоге матриц.

Карточка записи

Тип записи, который в списках, поиске и выборе связи показывается карточкой записи. Добавляется одним файлом-билдером в каталоге карточек; без билдера раздел остаётся на старой строке.

Вид требования

Что может требоваться от человека: компетенция с уровнями, квалификационный документ с реквизитами, обучение или документ с внешним предметом. Регистрируется в инициализаторе единого каталога; вид объявляет свою структуру, каталог и журнал общие.

Носитель требований

На кого распространяется норма: должность, участок, дальше — смена, операция, штатный профиль. Регистрация даёт носителю вкладку «Требования» и участие в выводе действующих требований.

Класс в конструкторе ролей

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

Объект публичного доступа

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

Профиль системы

Готовый состав модулей и справочников для нового аккаунта. Добавляется одним файлом в каталоге профилей; состав дальше меняется вручную.

Виджет рабочего стола

Плитка на рабочем столе. Добавляется одним файлом в каталоге виджетов: ключ, источник данных, права, размер. Каталог собирается из файлов автоматически.