bitrix_task_control/config
Dmitriy_Kravchenko a0f673c2e8 Refactor department configuration to support multiple script IDs, updating related documentation and functions for improved project management. Introduce new utility functions for loading and validating script IDs, enhancing the deployment process across multiple Apps Script projects. 2026-10-09 12:02:45 +03:00
..
README.md Refactor department configuration to support multiple script IDs, updating related documentation and functions for improved project management. Introduce new utility functions for loading and validating script IDs, enhancing the deployment process across multiple Apps Script projects. 2026-10-09 12:02:45 +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 в каждый id из scriptIds в 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.