Go to file
Dmitriy_Kravchenko c603146566 Fix email extraction logic in getUserEmailMap function by updating the index used to retrieve email addresses from the data array. 2026-10-12 11:01:30 +03:00
config 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
src Fix email extraction logic in getUserEmailMap function by updating the index used to retrieve email addresses from the data array. 2026-10-12 11:01:30 +03:00
tests Add deleteOldReports plugin to main menu and implement functionality to delete hidden report sheets. Enhance report lifecycle management with new utility functions for identifying and removing hidden sheets based on prefixes. 2026-10-09 14:02:51 +03:00
tools 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
.clasp.example.json initial commit 2026-09-21 09:43:53 +03:00
.gitignore Add mcp.json to .gitignore to prevent tracking of configuration files 2026-10-09 12:02:22 +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
appsscript.json initial commit 2026-09-21 09:43:53 +03:00
departments.json 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
package-lock.json initial commit 2026-09-21 09:43:53 +03:00
package.json initial commit 2026-09-21 09:43:53 +03:00
tsconfig.json initial commit 2026-09-21 09:43:53 +03:00
tsconfig.tests.json initial commit 2026-09-21 09:43:53 +03:00
vitest.config.ts initial commit 2026-09-21 09:43:53 +03:00

README.md

Система отчётов Google Sheets

Исходник правды — git. Редактор Apps Script только для запуска: следующий clasp push затрёт ручные правки.

Сборка даёт IIFE (const __gas = (...)()). Меню и onOpen Apps Script находит только по объявлениям function onOpen() на верхнем уровне файла, поэтому после бандла tools/build.mjs дописывает такие обёртки.

Команды

npm install
npm test
npm run build -- universal
npm run push -- universal
npm run deploy -- universal

deploy гоняет тесты, собирает бандл отдела и делает clasp push в каждый проект из его scriptIds.

Перед первым push: npx clasp login.

Структура

  • src/core — общее ядро (конфиг, листы, почта, Bitrix, даты, коды задач)
  • src/reports/<id> — отчёт-плагин: меню, обработчики, свои ключи Config
  • src/departments/<id>/profile.ts — состав поставки отдела
  • src/departments/<id>/entry.ts — точка сборки
  • tests — Vitest, без SpreadsheetApp
  • dist/<id> — собранный проект для clasp (в git не кладётся)
  • departments.json — scriptIds целевых проектов Apps Script

Лист Config и Script Properties по-прежнему runtime-настройки конкретной таблицы. Профиль отдела задаёт какой код в неё попадает.

Как добавить отдел

  1. Скопируйте src/departments/universal/ в src/departments/<id>/.
  2. В профиле оставьте только нужные плагины. Чтобы подменить логику отчёта, импортируйте свою реализацию с тем же id и теми же именами handlers.
  3. Добавьте scriptIds в departments.json. Один профиль можно отправить в несколько проектов: перечислите их id в массиве. Поле scriptId со строкой по-прежнему означает один проект.
"salesOriginal": {
  "scriptIds": ["SCRIPT_ID_TABLE_1", "SCRIPT_ID_TABLE_2"],
  "htmlFiles": ["DateRangeDialog.html"]
}
  1. npm run deploy -- <id>.

Уникальный отчёт кладите в src/reports/<newId>/ и подключайте только в профилях, которым он нужен.

Как добавить отчёт

  1. Папка src/reports/<id>/ с index.ts, где экспортируется ReportPlugin.
  2. В плагине: menuTitle, menuItems, handlers, при необходимости requiredConfigKeys / requiredScriptProperties.
  3. Чистую логику (строки → строки отчёта) выносите в отдельный файл и покрывайте тестом, как src/reports/bigSmall/builder.ts.
  4. Подключите плагин в профиле отдела.

Имена глобальных функций из меню текущего эталона (universal) не меняйте — на них могут висеть привычка и триггеры.

Выкат в таблицу

Сборка кладёт в dist/<id>/ файлы Code.js, appsscript.json, HTML и .clasp.json. Push идёт только из этой папки, а не из корня репозитория. Если в профиле несколько scriptIds, один и тот же бандл отправляется в каждый проект по очереди.

Секреты (HMAC, webhook Bitrix) задаются в Script Properties целевого проекта. Что писать на лист Config — в config/README.md.