Report mail and KPI blocks follow header names, so the inserted columns do not shift the wrong fields. Co-authored-by: Cursor <cursoragent@cursor.com> |
||
|---|---|---|
| config | ||
| src | ||
| tests | ||
| tools | ||
| .clasp.example.json | ||
| .gitignore | ||
| README.md | ||
| appsscript.json | ||
| departments.json | ||
| package-lock.json | ||
| package.json | ||
| tsconfig.json | ||
| tsconfig.tests.json | ||
| vitest.config.ts | ||
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 в его scriptId.
Перед первым push: npx clasp login.
Структура
src/core— общее ядро (конфиг, листы, почта, Bitrix, даты, коды задач)src/reports/<id>— отчёт-плагин: меню, обработчики, свои ключи Configsrc/departments/<id>/profile.ts— состав поставки отделаsrc/departments/<id>/entry.ts— точка сборкиtests— Vitest, без SpreadsheetAppdist/<id>— собранный проект для clasp (в git не кладётся)departments.json—scriptIdцелевого Apps Script
Лист Config и Script Properties по-прежнему runtime-настройки конкретной таблицы. Профиль отдела задаёт какой код в неё попадает.
Как добавить отдел
- Скопируйте
src/departments/universal/вsrc/departments/<id>/. - В профиле оставьте только нужные плагины. Чтобы подменить логику отчёта, импортируйте свою реализацию с тем же
idи теми же именамиhandlers. - Добавьте
scriptIdвdepartments.json. npm run deploy -- <id>.
Уникальный отчёт кладите в src/reports/<newId>/ и подключайте только в профилях, которым он нужен.
Как добавить отчёт
- Папка
src/reports/<id>/сindex.ts, где экспортируетсяReportPlugin. - В плагине:
menuTitle,menuItems,handlers, при необходимостиrequiredConfigKeys/requiredScriptProperties. - Чистую логику (строки → строки отчёта) выносите в отдельный файл и покрывайте тестом, как
src/reports/bigSmall/builder.ts. - Подключите плагин в профиле отдела.
Имена глобальных функций из меню текущего эталона (universal) не меняйте — на них могут висеть привычка и триггеры.
Выкат в таблицу
Сборка кладёт в dist/<id>/ файлы Code.js, appsscript.json, HTML и .clasp.json. Push идёт только из этой папки, а не из корня репозитория.
Секреты (HMAC, webhook Bitrix) задаются в Script Properties целевого проекта. Что писать на лист Config — в config/README.md.