bitrix_task_control/config
Dmitriy_Kravchenko 450209ba10 Add completed source sheet configuration and enhance completed tasks report with parent task details 2026-09-25 10:23:36 +03:00
..
README.md Add completed source sheet configuration and enhance completed tasks report with parent task details 2026-09-25 10:23:36 +03:00
config.sheet.example.md Add completed source sheet configuration and enhance completed tasks report with parent task details 2026-09-25 10:23:36 +03:00

README.md

Конфигурация филиала

Код собирается по профилю отдела (src/departments/<id>). Набор отчётов и их реализации задаёт профиль. Различия данных между таблицами — лист Config и Script Properties.

Развёртывание

Из корня репозитория:

npm test
npm run deploy -- universal

Это тесты, сборка dist/universal и clasp push в scriptId из departments.json. Редактор Apps Script не используйте как место правок исходников.

Для новой таблицы:

  1. Создайте профиль отдела и запись в departments.json.
  2. Создайте в таблице лист Config по образцу config/config.sheet.example.md.
  3. Project Settings → Script properties — секреты из списка ниже.
  4. npm run deploy -- <id>.

Обязательные ключи Config зависят от включённых в профиль отчётов. Если ключ нужен включённому отчёту и не заполнен, запуск останавливается с явной ошибкой.

Лист Config

Имя листа строго Config. Первая строка может быть заголовком key | value. Дальше пары ключ–значение.

Ключ Смысл
SOURCE_SHEET_ID gid листа выгрузки задач
COMPLETED_SOURCE_SHEET_ID gid листа выгрузки завершенных задач
EMAILS_SHEET_ID gid листа email сотрудников
ROLES_SHEET_ID gid листа ролей (ячейки B1–B6: РОП, зам. РОПа, рукфил, зам. рукфила, директор, контролёр)
BACKUP_EMAILS_SPREADSHEET_ID таблица с запасными email (листы РП и АП)
MANAGER_TABLES_CONFIG_ID JSON на Drive: исполнитель → персональная таблица
ORG_STRUCTURE_FILE_ID JSON оргструктуры на Drive
DEPARTMENT_ID ID отдела в оргструктуре
TEMPLATE_SCAN_DEPARTMENT_ID отдел для сканера шаблонов
BITRIX_PORTAL https://example.bitrix24.ru без слэша на конце
BALANCER_URL URL балансировщика Bitrix REST
TEMPLATE_SCANNER_URL URL сервиса latest template id
DEFAULT_FILIAL_HEAD_NAME ФИО рукфила по умолчанию

Необязательные:

Ключ По умолчанию
METRICS_SHEET_NAME Data
TASK_INDEX_SHEET_NAME taskIndex

Script Properties (не хранить в git)

Ключ Смысл
BALANCER_PUBLIC публичный ключ HMAC балансировщика
BALANCER_SECRET секрет HMAC
BITRIX_WEBHOOK_TASKS базовый webhook URL для tasks.task.* (со слэшем на конце)
BITRIX_WEBHOOK_USERS webhook для user.get
BITRIX_WEBHOOK_TEMPLATES webhook для tasks.template.get

Константы самих отчётов (префиксы листов, словари кодов, индекс вставки листа) лежат в src/core/constants.ts.