# Kommand API

> Платформа операционных процедур, обучения и документов для производства.
> REST API v2 — документы, папки, обсуждения, видеоинструкции.
> Авторизация: заголовок `Authorization: Bearer kmd_...` (ключ создаётся в настройках аккаунта).


## Машиночитаемое

- [OpenAPI 2.0](https://api.kommand.ru/docs/spec): полная спецификация REST v2, все операции, схемы и коды ошибок
- [Манифест системы](https://api.kommand.ru/api/v2/system/manifest): модули, справочники, контракты, точки расширения
- [Граф системы](https://api.kommand.ru/api/v2/system/graph): то же в форме `{nodes, edges}`
- [Документация для людей](https://api.kommand.ru/docs): Scalar UI, требует JavaScript

## Для агентов

MCP-сервер режима discovery: `POST https://api.kommand.ru/mcp`, JSON-RPC 2.0, ключ не нужен.
Инструменты: describe_system, list_modules, describe_module, list_references,
list_contracts, describe_contract, search, how_to_extend, get_graph.
Начинать с `describe_system` — он объясняет авторизацию и даёт адреса описаний.
Тенантных данных инструменты не касаются.


## Модули

- **Аналитика**: Матрицы компетенций и допусков, отчёты и сводные представления. Кросс-секущий модуль: данные берёт из справочников, обучения и процедур.
- **Документы**: Хранилище документов с папками, правами доступа, совместным редактированием и версиями. Основа для процедур, инструкций и регламентов.
- **Процедуры**: Чек-листы, SOP и наряды-допуски: конструктор шагов, исполнение с фиксацией ответов и доказательств, история прохождений.
- **Справочники**: Мастер-данные организации: сотрудники, структура, должности, навыки, допуски. На них опираются остальные модули.
- **Новости**: Лента публикаций организации: посты, обсуждение, вложения.
- **Задачи**: Поручения с ответственным и сроком. Связываются с документами, процедурами и обсуждениями.
- **Логистика**: Перевозки и электронные транспортные накладные (ЭТрН). Первый раздел — контрагенты: реквизиты, роли в перевозке, профили ЭДО; справочник может быть общим для аккаунтов организации.
- **Рабочий стол**: Личная стартовая страница: виджеты со задачами, обучением, процедурами и активностью. Состав виджетов настраивает сам пользователь.

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

- **Коннектор агент-платформы**: Источник инструментов для AI-ассистента. Отвалившийся коннектор не ломает диалог — его инструменты просто не предлагаются.
- **Объект обсуждения**: Тип записи, у которой бывают комментарии. Регистрация в реестре включает колонку обсуждения в общей detail-панели — вёрстку в разделе править не нужно.
- **Тип поля**: Тип значения для кастомных полей и вопросов процедур: как хранится, как валидируется, чем рисуется.
- **Вид «Входящих» из журнала**: Глагол журнала, по которому во «Входящие» приходит сообщение, и правило подтверждения. Незарегистрированный глагол сообщения не порождает.
- **Провайдер интеграции**: Внешний сервис с описанной схемой учётных данных и настроек. Схема разом задаёт форму в интерфейсе, серверную валидацию и проверку работоспособности.
- **Источник оси матрицы**: Из каких группировок собирается ось среза (по образцу AG5): узел структуры, должность, смена, категория требований или отдельная запись. Регистрация типа открывает его в меню «Добавить» вкладки оси и в резолвере состава среза.
- **Тип матрицы**: Срез в аналитике: что по строкам, что по столбцам, чем заполняется ячейка. Добавляется одним файлом в каталоге матриц.
- **Карточка записи**: Тип записи, который в списках, поиске и выборе связи показывается карточкой записи. Добавляется одним файлом-билдером в каталоге карточек; без билдера раздел остаётся на старой строке.
- **Вид требования**: Что может требоваться от человека: компетенция с уровнями, квалификационный документ с реквизитами, обучение или документ с внешним предметом. Регистрируется в инициализаторе единого каталога; вид объявляет свою структуру, каталог и журнал общие.
- **Носитель требований**: На кого распространяется норма: должность, участок, дальше — смена, операция, штатный профиль. Регистрация даёт носителю вкладку «Требования» и участие в выводе действующих требований.
- **Класс в конструкторе ролей**: Сущность, права на которую настраиваются в конструкторе ролей: набор действий и допустимые значения.
- **Объект публичного доступа**: Тип записи, на которую можно выдать доступ по ссылке: кто просматривает, какие права выдаются, что тянется вместе с ней.
- **Профиль системы**: Готовый состав модулей и справочников для нового аккаунта. Добавляется одним файлом в каталоге профилей; состав дальше меняется вручную.
- **Виджет рабочего стола**: Плитка на рабочем столе. Добавляется одним файлом в каталоге виджетов: ключ, источник данных, права, размер. Каталог собирается из файлов автоматически.