Свой драйвер трекера

Драйвер переводит API вашего трекера в общий формат задач GrigDesk. Он поставляется отдельным Git-пакетом и устанавливается через настройки доски.

Когда нужен отдельный пакет

Используйте его для новой системы задач или портала с нестандартной авторизацией, статусами, таймером и отчётами. Кейс собственного сервера Битрикс24 показывает, где заканчивается совместимость обычного драйвера.

Драйвер трекера и пользовательский плагин — разные типы пакетов. Драйвер подключает данные к общей доске; для собственной панели нужен плагин.

Устройство пакета

team-tracker/
  driver.json
  driver.ts
  src/
  types/

Пример манифеста для собственного пакета:

{
  "id": "team-tracker",
  "name": "Трекер команды",
  "version": "1.0.0",
  "contract": 1,
  "settings": {
    "baseUrl": {
      "type": "string",
      "required": true,
      "label": { "text": "Адрес трекера" }
    },
    "token": {
      "type": "string",
      "required": true,
      "secret": true,
      "label": { "text": "Токен доступа" }
    }
  }
}

driver.ts экспортирует по умолчанию фабрику TrackerFactory. Она получает TrackerHost и возвращает TaskTracker. Контракт установленной версии описан в server/src/lib/trackers/contract.ts и shared/trackers/contracts.ts. Штатные внешние драйверы хранят свой снимок типов и не импортируют код ядра при выполнении.

Что реализовать

Часть	Ответственность драйвера
Подключение	isConfigured, testAuth, accountIdentity; реквизиты доступны через host.credentials.
Чтение	listTasks, taskDetail, getDashboard, sourceUrl, probeTaskNumber.
Действия	Только реально поддерживаемые методы: например создание, комментарии, таймер или смена статуса.
Возможности	capabilities объявляет доступные действия; неподдерживаемые не включайте.
Представление	Статус и его смысл, данные карточки, числовые KPI и графики. Код и HTML виджетов в интерфейс не передаются.

Сессионную авторизацию и особенности API держите внутри пакета. Реквизиты хранит сервер GrigDesk; не добавляйте реальные токены в Git. Для чтений учитывайте отмену и очередь, предусмотренные контрактом.

Проверить и установить

Сначала проверьте драйвер на подготовленных ответах API: вход, списки, карточку, статусы, разрешённые действия, ошибки доступа и недоступность портала. Для доработанного Б24 отдельно проверьте собственные обработчики и поля.

Присвойте пакету уникальный id; own зарезервирован внутренним трекером. Версия в манифесте должна совпадать со стабильным тегом vX.Y.Z. Далее выполните обычную установку драйвера, настройте подключение и проверьте его на тестовом проекте портала.