@haiiro/docuflow 0.0.9 → 0.0.11

package/README.md

@@ -9,7 +9,7 @@
 
 | Где | Что |
 |---|---|
-| Сайдбар | пункт «Документооборот» с вкладками «Задания», «Процессы», «Документы» |
+| Сайдбар | папка «Документооборот» с пунктами «Задания», «Процессы», «Документы» — у каждого своя страница |
 | «Задания» | задачи раздела «Документооборот»; фильтры «Открытые / Мои / Просроченные / Выполненные / Архив» (архив — удалённые, со штатным «Восстановить»), поиск, создание задания с инструкцией и полями для заполнения |
 | Карточка задачи | вкладка «Задание»: инструкция, поля задания (собрать конструктором, заполнить), «Выполнить» |
 | Карточка процесса | кнопка «Параметры запуска» вверху (боковая панель): параметры запуска (конструктор полей) и, для шагов «Человеческий ввод» черновика, кто выполняет, срок в днях, обязательные поля; у каждого поля видна переменная, которой его читают следующие шаги |
@@ -32,19 +32,19 @@
 
 ## Установка
 
-На сервере, где запущен Twenty, из каталога с его `docker-compose.yml`; повторный запуск
-ставит новую версию:
+С любого компьютера с Node.js 20+, нужен только адрес CRM и ключ API администратора
+(«Настройки → API и вебхуки → Создать ключ»). Повторный запуск ставит новую версию:
 
 ```bash
-docker compose exec server npx -y @haiiro/install@latest docuflow
+npx -y @haiiro/docuflow install --url https://crm.example.ru --api-key <ключ>
 ```
 
-Ключи не нужны: установщик работает внутри контейнера сервера и вызывает его команды
-`marketplace:catalog-sync`, `application:install` и `application:upgrade`. Приложение ставится
-во все компании сервера. Конкретная версия: `docuflow@0.0.6`. Публикация из репозитория форка:
-`bash scripts/smb-publish.sh docflow`.
+Установщик загружает в CRM опубликованный архив этой версии пакета и устанавливает приложение
+(как `twenty app:install`), доступ к серверу и его настройки не нужны. Конкретная версия:
+`--version 0.0.8`.
 
-Из исходников (для разработки): `yarn install && yarn app remote:add --url … --api-key … --as prod && yarn app apply --remote prod`.
+Из исходников (для разработки): `node scripts/reinstall.mjs docuflow --local` в корне репозитория
+(нужны `CRM_URL` и `CRM_API_KEY` в `.env`).
 
 Затем в «Настройки → Приложения → Документооборот» заполнить переменные:
 
@@ -83,8 +83,13 @@ docker compose exec server npx -y @haiiro/install@latest docuflow
   из «Параметров запуска», без него — у запустившего. Поля задания — поля шага из редактора.
   «Выполнить» проверяет обязательные поля и продолжает процесс; значения дальше читаются
   переменными шага `{{<шаг>.<поле>}}`.
-- **Удаление.** В «Заданиях», «Процессах» и «Документах» у строки под курсором есть «Удалить»:
-  первый клик спрашивает «Удалить?», второй удаляет. Запись уходит в корзину Twenty и
+- **Списки.** Фильтры — в окне под полем поиска (значок фильтра горит, когда фильтр включён),
+  сортировка — кликом по заголовку колонки. Действия со строкой — в «⋯» в её конце: открыть,
+  переименовать, переместить в папку, удалить и т. п. «Процессы» показывают все процессы раздела,
+  опубликованные и черновики.
+- **Папки документов.** «+ Новая папка», у папки «⋯ → Переименовать и оформить»: название, цвет и
+  значок; удаление папки оставляет документы в «Все документы».
+- **Удаление.** «⋯ → Удалить» спрашивает ещё раз и удаляет. Запись уходит в корзину Twenty и
   восстанавливается: задания — в фильтре «Архив», документы — в фильтре «Удалённые», процессы — в
   штатном списке «Рабочие процессы → Удалённые»; в карточке удалённой записи есть «Восстановить».
   Для этого роль приложения может мягко удалять только документы, задачи и процессы.

package/bin/install.mjs

@@ -94,6 +94,12 @@ class CrmApiError extends Error {
     this.rawMessage = graphqlError?.message ?? '';
   }
 
+  // This version's archive was uploaded to the CRM before (also before an
+  // uninstall): the server keeps it and installs from that copy.
+  get isAlreadyDeployed() {
+    return /not higher than the currently deployed/i.test(`${this.message} ${this.rawMessage}`);
+  }
+
   // The app was installed from the marketplace on this CRM: the server keeps
   // it tied to npm and refuses an archive for it.
   get isSourceChannelMismatch() {
@@ -161,23 +167,39 @@ const install = async (options) => {
   try {
     await uploadArchive(connection, label, tarball);
   } catch (error) {
-    if (!(error instanceof CrmApiError) || !error.isSourceChannelMismatch) {
+    if (!(error instanceof CrmApiError) || !(error.isSourceChannelMismatch || error.isAlreadyDeployed)) {
       throw error;
     }
 
     // Installed from the marketplace before: the server fetches the same
-    // version from npm itself.
-    console.log('→ Приложение подключено из каталога npm, ставлю эту версию через каталог');
+    // version from npm itself. Or this version was uploaded before: the
+    // server has its copy.
+    console.log(
+      error.isAlreadyDeployed
+        ? `→ Версия ${options.version} уже загружена в CRM раньше, ставлю её`
+        : '→ Приложение подключено из каталога npm, ставлю эту версию через каталог',
+    );
   }
 
   console.log(`→ Устанавливаю «${manifest.application.displayName ?? packageJson.name}» ${options.version}`);
-  await callMetadataApi(
-    connection,
-    `mutation InstallApplication($universalIdentifier: String!, $version: String) {
-      installApplication(universalIdentifier: $universalIdentifier, version: $version) { id }
-    }`,
-    { universalIdentifier: manifest.application.universalIdentifier, version: options.version },
-  );
+
+  try {
+    await callMetadataApi(
+      connection,
+      `mutation InstallApplication($universalIdentifier: String!, $version: String) {
+        installApplication(universalIdentifier: $universalIdentifier, version: $version) { id }
+      }`,
+      { universalIdentifier: manifest.application.universalIdentifier, version: options.version },
+    );
+  } catch (error) {
+    if (!(error instanceof CrmApiError) || !/already installed/i.test(`${error.message} ${error.rawMessage}`)) {
+      throw error;
+    }
+
+    console.log(`\n✓ ${label} уже установлен в этой CRM.\n`);
+
+    return;
+  }
 
   console.log(`\n✓ ${label} установлен. Обновите страницу CRM.\n`);
 };

package/manifest.json

@@ -47,9 +47,9 @@
       }
     },
     "defaultRoleUniversalIdentifier": "26b1dde8-4ed9-4f39-8516-e0dcb734ea5a",
-    "aboutDescription": "# Документооборот (`@crm-nordiv/docuflow`)\n\nЗадания, процессы и документы компании в одном разделе. Ставится в CRM как приложение, без правок\nсервера.\n\n- universalIdentifier: `0b7d5d2e-8c4f-4a59-9a43-2f6f1c3e9d21`\n\n## Что получается после установки\n\n| Где | Что |\n|---|---|\n| Сайдбар | пункт «Документооборот» с вкладками «Задания», «Процессы», «Документы» |\n| «Задания» | задачи раздела «Документооборот»; фильтры «Открытые / Мои / Просроченные / Выполненные / Архив» (архив — удалённые, со штатным «Восстановить»), поиск, создание задания с инструкцией и полями для заполнения |\n| Карточка задачи | вкладка «Задание»: инструкция, поля задания (собрать конструктором, заполнить), «Выполнить» |\n| Карточка процесса | кнопка «Параметры запуска» вверху (боковая панель): параметры запуска (конструктор полей) и, для шагов «Человеческий ввод» черновика, кто выполняет, срок в днях, обязательные поля; у каждого поля видна переменная, которой его читают следующие шаги |\n| Редактор процесса | первый блок «Запуск с параметрами» (ставится сам): параметры, заполненные перед запуском, — его переменные |\n| «Процессы» | процессы с ручным запуском раздела «Документооборот»; форма параметров до запуска, «Запустить», «Создать», «Изменить процесс» |\n| «Документы» | папки, фильтры, поиск по названию и номеру, документ с реквизитами (тип, номер, дата, срок действия, контрагент, описание), файл в поле «Файл» карточки, карточка с источником |\n| Автоматически | шаг «Человеческий ввод» процесса становится задачей; её выполнение продолжает процесс; файл, приложенный к любой записи, копируется в документы с отметкой, кто, когда и куда его добавил |\n| Битрикс24 | страница приложения в портале со списком открытых заданий сотрудника и ссылками в CRM; уведомление исполнителю нового задания |\n\n## Данные\n\n| Объект | Поля |\n|---|---|\n| `smbDocument` (новый) | название, файл, тип, номер, дата, действует до, контрагент (компания), описание, статус, автор, ответственный, папка; источник: `origin`, `sourceObjectName`, `sourceRecordId`, `sourceRecordName`, `sourceFileId`, `workflowRunId` |\n| `smbDocumentFolder` (новый) | название, цвет, родительская папка |\n| `workflow` | `smbSection` «Раздел»: CRM / Документооборот; `smbLaunchFields` «Параметры запуска» — поля, которые заполняют перед запуском |\n| `task` | `smbSection`, `smbInstruction` «Инструкция»; `smbFormSchema`, `smbFormValues` — поля задания; `smbWorkflowRunId`, `smbWorkflowStepId`, `smbWorkflowThreadId` — связь с шагом процесса |\n| `company` | `smbDocuments` — документы контрагента |\n| роли | «Документооборот: функции приложения» (права функций), «Документооборот: участник процессов» (для людей, см. ниже) |\n\n## Установка\n\nНа сервере, где запущен Twenty, из каталога с его `docker-compose.yml`; повторный запуск\nставит новую версию:\n\n```bash\ndocker compose exec server npx -y @haiiro/install@latest docuflow\n```\n\nКлючи не нужны: установщик работает внутри контейнера сервера и вызывает его команды\n`marketplace:catalog-sync`, `application:install` и `application:upgrade`. Приложение ставится\nво все компании сервера. Конкретная версия: `docuflow@0.0.6`. Публикация из репозитория форка:\n`bash scripts/smb-publish.sh docflow`.\n\nИз исходников (для разработки): `yarn install && yarn app remote:add --url … --api-key … --as prod && yarn app apply --remote prod`.\n\nЗатем в «Настройки → Приложения → Документооборот» заполнить переменные:\n\n| Переменная | Что указать |\n|---|---|\n| `DOCFLOW_ENGINE` | `APP` |\n| `CRM_PUBLIC_URL` | адрес CRM компании, например `https://acme.example.ru`; по нему строятся ссылки из Битрикс24 |\n| `BITRIX_CLIENT_ID`, `BITRIX_CLIENT_SECRET` | из карточки локального приложения портала; без них Битрикс24 не подключается, остальное работает |\n\n**Права людей.** Отвечать на шаг запущенного процесса может только тот, у кого есть право\n«Рабочие процессы». Кто выполняет задания процессов или запускает процессы с параметрами,\nполучает роль «Документооборот: участник процессов» или это право в своей роли. Право также\nпозволяет менять процессы: давайте его тем, кому это допустимо. Обычные задания и документы\nправа «Рабочие процессы» не требуют.\n\n## Как пользоваться\n\n- **Процесс.** «Процессы → Создать» создаёт процесс с ручным запуском в разделе «Документооборот» и\n  открывает редактор. Существующий процесс переносится в документооборот полем «Раздел».\n- **Параметры запуска.** Кнопка процесса «Параметры запуска» → «Добавить поле»: название, тип\n  (текст, число, дата, сотрудник, компания, контакт, сделка), обязательность. «Сохранить\n  параметры» делает первым блоком черновика «Запуск с параметрами»: в следующих шагах параметры\n  выбираются как его переменные `{{trigger.<поле>}}` — например «Запуск с параметрами →\n  Сотрудник → Id» в поле «Исполнитель» задачи. Без параметров процесс начинается с обычного\n  «Запуск вручную». Опубликуйте процесс. Параметры заполняются в «Процессах» до запуска;\n  обязательные проверяются и на странице, и на сервере.\n\n  Устройство: своих типов триггеров у приложений Twenty нет, а у «Запуск вручную» редактор\n  показывает только свои переменные. Поэтому «Запуск с параметрами» — штатный триггер Webhook\n  (POST, только с ключом API), поля параметров — его тело. Документооборот запускает такую версию\n  сам; внешняя система (например, мост в Битрикс24) может запустить процесс POST-запросом на адрес\n  вебхука с ключом API и телом из этих полей — тогда проверку обязательных полей делает она.\n  Шаг «Параметры запуска» процессов из 0.0.6 и раньше при первом сохранении параметров убирается,\n  его переменные в следующих шагах переводятся на `trigger`.\n- **Задание шага.** Шаг «Человеческий ввод» становится задачей раздела процесса: у исполнителя\n  из «Параметров запуска», без него — у запустившего. Поля задания — поля шага из редактора.\n  «Выполнить» проверяет обязательные поля и продолжает процесс; значения дальше читаются\n  переменными шага `{{<шаг>.<поле>}}`.\n- **Удаление.** В «Заданиях», «Процессах» и «Документах» у строки под курсором есть «Удалить»:\n  первый клик спрашивает «Удалить?», второй удаляет. Запись уходит в корзину Twenty и\n  восстанавливается: задания — в фильтре «Архив», документы — в фильтре «Удалённые», процессы — в\n  штатном списке «Рабочие процессы → Удалённые»; в карточке удалённой записи есть «Восстановить».\n  Для этого роль приложения может мягко удалять только документы, задачи и процессы.\n- **Параметры в редакторе.** После «Сохранить параметры» редактор процесса открывается заново:\n  он держит загруженную версию и иначе показал бы новые переменные только после перезагрузки.\n- **Своё задание.** «Задания → Создать»: название, исполнитель, срок, инструкция и поля для\n  заполнения тем же конструктором. Поля меняются в панели задания («Изменить поля»).\n- **Документы.** «Документы → Создать» создаёт черновик в открытой папке и открывает его штатную\n  карточку: там реквизиты и поле «Файл»; строка списка открывает ту же карточку. Так сделано потому, что\n  страница приложения в песочнице видит только имя и размер выбранного файла, не его содержимое.\n  Файл, приложенный к любой записи (компания, сделка, задача, свой объект), появляется в\n  документах сам: «Где загружен», автор, дата, для задачи процесса — ссылка на запуск. Документ\n  хранит копию файла.\n\n## Ограничения\n\n- Рамки вокруг страницы раздела рисует платформа: карточку виджета и рамку вокруг компонента\n  приложения. Компоненты приложений работают в изолированном worker'е и убрать их не могут.\n- Блок «Запуск с параметрами» в редакторе открывает штатные настройки вебхука (адрес, тело,\n  авторизация): поля там те же, что в «Параметрах запуска», менять их удобнее кнопкой. Если\n  переименовать блок, Документооборот перестанет узнавать его как свой запуск.\n- Параметры запуска относятся к процессу, а не к версии: после правки полей опубликованная версия\n  до публикации нового черновика получает новые поля, а переменные убранных полей в ней пусты.\n- Документ без файла создаётся раньше файла: если закрыть карточку, не прикрепив файл, документ\n  останется с пустым полем «Файл».\n\n## Битрикс24\n\nПодключается локальным приложением портала (одна компания — один портал).\n\n1. В портале: «Разработчикам → Другое → Локальное приложение», тип «Серверное».\n2. Адреса — HTTP-маршруты приложения на адресе компании (точный адрес виден в «Настройки →\n   Приложения → Документооборот → функции»):\n   - путь обработчика: `https://<адрес компании>/s/bitrix/app`\n   - путь первоначальной установки: `https://<адрес компании>/s/bitrix/install`\n3. Права приложения: `user`, `im`.\n4. Сохранить, скопировать «Код приложения» и «Ключ приложения» в `BITRIX_CLIENT_ID` и\n   `BITRIX_CLIENT_SECRET`, затем открыть приложение в портале — установка завершится сама.\n\nКаждый запрос портала проверяется обменом refresh-токена на `oauth.bitrix.info` с ключом\nприложения; адрес портала берётся из ответа Битрикс24. Привязывается первый подтверждённый портал,\nдругой портал к той же компании не подключится. Токены портала хранятся в хранилище приложения, не\nв записях. Сотрудник находится по почте профиля Битрикс24.\n\n## Разработка\n\n```bash\nyarn app dev        # следит за src/ и синхронизирует с сервером\nyarn app dev:function:logs\nyarn test && yarn typecheck && yarn lint\n```\n\nУстройство `src/`: `shared/` — общий код (формы, процессы, фильтры REST, Битрикс24); `server/` —\nобращения к записям и движку процессов из функций; `logic-functions/`; `front/` и\n`front-components/` — интерфейс; `objects/`, `fields/`, `views/`, `roles/`, `page-layouts/`,\n`navigation-menu-items/` — данные и раскладка. Записи читаются и пишутся только через REST API\n(`server/records.ts`, `front/api.ts`), движок процессов — через две мутации GraphQL\n(`server/workflow-engine.ts`, `server/launch-step.ts`): при смене версии платформы сверять эти\nфайлы. Стили интерфейса только inline: теги `<style>` в странице приложения платформа отбрасывает.\n",
+    "aboutDescription": "# Документооборот (`@crm-nordiv/docuflow`)\n\nЗадания, процессы и документы компании в одном разделе. Ставится в CRM как приложение, без правок\nсервера.\n\n- universalIdentifier: `0b7d5d2e-8c4f-4a59-9a43-2f6f1c3e9d21`\n\n## Что получается после установки\n\n| Где | Что |\n|---|---|\n| Сайдбар | папка «Документооборот» с пунктами «Задания», «Процессы», «Документы» — у каждого своя страница |\n| «Задания» | задачи раздела «Документооборот»; фильтры «Открытые / Мои / Просроченные / Выполненные / Архив» (архив — удалённые, со штатным «Восстановить»), поиск, создание задания с инструкцией и полями для заполнения |\n| Карточка задачи | вкладка «Задание»: инструкция, поля задания (собрать конструктором, заполнить), «Выполнить» |\n| Карточка процесса | кнопка «Параметры запуска» вверху (боковая панель): параметры запуска (конструктор полей) и, для шагов «Человеческий ввод» черновика, кто выполняет, срок в днях, обязательные поля; у каждого поля видна переменная, которой его читают следующие шаги |\n| Редактор процесса | первый блок «Запуск с параметрами» (ставится сам): параметры, заполненные перед запуском, — его переменные |\n| «Процессы» | процессы с ручным запуском раздела «Документооборот»; форма параметров до запуска, «Запустить», «Создать», «Изменить процесс» |\n| «Документы» | папки, фильтры, поиск по названию и номеру, документ с реквизитами (тип, номер, дата, срок действия, контрагент, описание), файл в поле «Файл» карточки, карточка с источником |\n| Автоматически | шаг «Человеческий ввод» процесса становится задачей; её выполнение продолжает процесс; файл, приложенный к любой записи, копируется в документы с отметкой, кто, когда и куда его добавил |\n| Битрикс24 | страница приложения в портале со списком открытых заданий сотрудника и ссылками в CRM; уведомление исполнителю нового задания |\n\n## Данные\n\n| Объект | Поля |\n|---|---|\n| `smbDocument` (новый) | название, файл, тип, номер, дата, действует до, контрагент (компания), описание, статус, автор, ответственный, папка; источник: `origin`, `sourceObjectName`, `sourceRecordId`, `sourceRecordName`, `sourceFileId`, `workflowRunId` |\n| `smbDocumentFolder` (новый) | название, цвет, родительская папка |\n| `workflow` | `smbSection` «Раздел»: CRM / Документооборот; `smbLaunchFields` «Параметры запуска» — поля, которые заполняют перед запуском |\n| `task` | `smbSection`, `smbInstruction` «Инструкция»; `smbFormSchema`, `smbFormValues` — поля задания; `smbWorkflowRunId`, `smbWorkflowStepId`, `smbWorkflowThreadId` — связь с шагом процесса |\n| `company` | `smbDocuments` — документы контрагента |\n| роли | «Документооборот: функции приложения» (права функций), «Документооборот: участник процессов» (для людей, см. ниже) |\n\n## Установка\n\nС любого компьютера с Node.js 20+, нужен только адрес CRM и ключ API администратора\n(«Настройки → API и вебхуки → Создать ключ»). Повторный запуск ставит новую версию:\n\n```bash\nnpx -y @haiiro/docuflow install --url https://crm.example.ru --api-key <ключ>\n```\n\nУстановщик загружает в CRM опубликованный архив этой версии пакета и устанавливает приложение\n(как `twenty app:install`), доступ к серверу и его настройки не нужны. Конкретная версия:\n`--version 0.0.8`.\n\nИз исходников (для разработки): `node scripts/reinstall.mjs docuflow --local` в корне репозитория\n(нужны `CRM_URL` и `CRM_API_KEY` в `.env`).\n\nЗатем в «Настройки → Приложения → Документооборот» заполнить переменные:\n\n| Переменная | Что указать |\n|---|---|\n| `DOCFLOW_ENGINE` | `APP` |\n| `CRM_PUBLIC_URL` | адрес CRM компании, например `https://acme.example.ru`; по нему строятся ссылки из Битрикс24 |\n| `BITRIX_CLIENT_ID`, `BITRIX_CLIENT_SECRET` | из карточки локального приложения портала; без них Битрикс24 не подключается, остальное работает |\n\n**Права людей.** Отвечать на шаг запущенного процесса может только тот, у кого есть право\n«Рабочие процессы». Кто выполняет задания процессов или запускает процессы с параметрами,\nполучает роль «Документооборот: участник процессов» или это право в своей роли. Право также\nпозволяет менять процессы: давайте его тем, кому это допустимо. Обычные задания и документы\nправа «Рабочие процессы» не требуют.\n\n## Как пользоваться\n\n- **Процесс.** «Процессы → Создать» создаёт процесс с ручным запуском в разделе «Документооборот» и\n  открывает редактор. Существующий процесс переносится в документооборот полем «Раздел».\n- **Параметры запуска.** Кнопка процесса «Параметры запуска» → «Добавить поле»: название, тип\n  (текст, число, дата, сотрудник, компания, контакт, сделка), обязательность. «Сохранить\n  параметры» делает первым блоком черновика «Запуск с параметрами»: в следующих шагах параметры\n  выбираются как его переменные `{{trigger.<поле>}}` — например «Запуск с параметрами →\n  Сотрудник → Id» в поле «Исполнитель» задачи. Без параметров процесс начинается с обычного\n  «Запуск вручную». Опубликуйте процесс. Параметры заполняются в «Процессах» до запуска;\n  обязательные проверяются и на странице, и на сервере.\n\n  Устройство: своих типов триггеров у приложений Twenty нет, а у «Запуск вручную» редактор\n  показывает только свои переменные. Поэтому «Запуск с параметрами» — штатный триггер Webhook\n  (POST, только с ключом API), поля параметров — его тело. Документооборот запускает такую версию\n  сам; внешняя система (например, мост в Битрикс24) может запустить процесс POST-запросом на адрес\n  вебхука с ключом API и телом из этих полей — тогда проверку обязательных полей делает она.\n  Шаг «Параметры запуска» процессов из 0.0.6 и раньше при первом сохранении параметров убирается,\n  его переменные в следующих шагах переводятся на `trigger`.\n- **Задание шага.** Шаг «Человеческий ввод» становится задачей раздела процесса: у исполнителя\n  из «Параметров запуска», без него — у запустившего. Поля задания — поля шага из редактора.\n  «Выполнить» проверяет обязательные поля и продолжает процесс; значения дальше читаются\n  переменными шага `{{<шаг>.<поле>}}`.\n- **Списки.** Фильтры — в окне под полем поиска (значок фильтра горит, когда фильтр включён),\n  сортировка — кликом по заголовку колонки. Действия со строкой — в «⋯» в её конце: открыть,\n  переименовать, переместить в папку, удалить и т. п. «Процессы» показывают все процессы раздела,\n  опубликованные и черновики.\n- **Папки документов.** «+ Новая папка», у папки «⋯ → Переименовать и оформить»: название, цвет и\n  значок; удаление папки оставляет документы в «Все документы».\n- **Удаление.** «⋯ → Удалить» спрашивает ещё раз и удаляет. Запись уходит в корзину Twenty и\n  восстанавливается: задания — в фильтре «Архив», документы — в фильтре «Удалённые», процессы — в\n  штатном списке «Рабочие процессы → Удалённые»; в карточке удалённой записи есть «Восстановить».\n  Для этого роль приложения может мягко удалять только документы, задачи и процессы.\n- **Параметры в редакторе.** После «Сохранить параметры» редактор процесса открывается заново:\n  он держит загруженную версию и иначе показал бы новые переменные только после перезагрузки.\n- **Своё задание.** «Задания → Создать»: название, исполнитель, срок, инструкция и поля для\n  заполнения тем же конструктором. Поля меняются в панели задания («Изменить поля»).\n- **Документы.** «Документы → Создать» создаёт черновик в открытой папке и открывает его штатную\n  карточку: там реквизиты и поле «Файл»; строка списка открывает ту же карточку. Так сделано потому, что\n  страница приложения в песочнице видит только имя и размер выбранного файла, не его содержимое.\n  Файл, приложенный к любой записи (компания, сделка, задача, свой объект), появляется в\n  документах сам: «Где загружен», автор, дата, для задачи процесса — ссылка на запуск. Документ\n  хранит копию файла.\n\n## Ограничения\n\n- Рамки вокруг страницы раздела рисует платформа: карточку виджета и рамку вокруг компонента\n  приложения. Компоненты приложений работают в изолированном worker'е и убрать их не могут.\n- Блок «Запуск с параметрами» в редакторе открывает штатные настройки вебхука (адрес, тело,\n  авторизация): поля там те же, что в «Параметрах запуска», менять их удобнее кнопкой. Если\n  переименовать блок, Документооборот перестанет узнавать его как свой запуск.\n- Параметры запуска относятся к процессу, а не к версии: после правки полей опубликованная версия\n  до публикации нового черновика получает новые поля, а переменные убранных полей в ней пусты.\n- Документ без файла создаётся раньше файла: если закрыть карточку, не прикрепив файл, документ\n  останется с пустым полем «Файл».\n\n## Битрикс24\n\nПодключается локальным приложением портала (одна компания — один портал).\n\n1. В портале: «Разработчикам → Другое → Локальное приложение», тип «Серверное».\n2. Адреса — HTTP-маршруты приложения на адресе компании (точный адрес виден в «Настройки →\n   Приложения → Документооборот → функции»):\n   - путь обработчика: `https://<адрес компании>/s/bitrix/app`\n   - путь первоначальной установки: `https://<адрес компании>/s/bitrix/install`\n3. Права приложения: `user`, `im`.\n4. Сохранить, скопировать «Код приложения» и «Ключ приложения» в `BITRIX_CLIENT_ID` и\n   `BITRIX_CLIENT_SECRET`, затем открыть приложение в портале — установка завершится сама.\n\nКаждый запрос портала проверяется обменом refresh-токена на `oauth.bitrix.info` с ключом\nприложения; адрес портала берётся из ответа Битрикс24. Привязывается первый подтверждённый портал,\nдругой портал к той же компании не подключится. Токены портала хранятся в хранилище приложения, не\nв записях. Сотрудник находится по почте профиля Битрикс24.\n\n## Разработка\n\n```bash\nyarn app dev        # следит за src/ и синхронизирует с сервером\nyarn app dev:function:logs\nyarn test && yarn typecheck && yarn lint\n```\n\nУстройство `src/`: `shared/` — общий код (формы, процессы, фильтры REST, Битрикс24); `server/` —\nобращения к записям и движку процессов из функций; `logic-functions/`; `front/` и\n`front-components/` — интерфейс; `objects/`, `fields/`, `views/`, `roles/`, `page-layouts/`,\n`navigation-menu-items/` — данные и раскладка. Записи читаются и пишутся только через REST API\n(`server/records.ts`, `front/api.ts`), движок процессов — через две мутации GraphQL\n(`server/workflow-engine.ts`, `server/launch-step.ts`): при смене версии платформы сверять эти\nфайлы. Стили интерфейса только inline: теги `<style>` в странице приложения платформа отбрасывает.\n",
     "yarnLockChecksum": "42ac7e58e1f5be33be57956ccaa20fb3",
-    "packageJsonChecksum": "7096a203802f32e5eb67fbee10db5857",
+    "packageJsonChecksum": "5f6c8154ff516638f8521ec7e7aa4312",
     "requiredServerVersionRange": null,
     "healthCheckLogicFunction": {
       "universalIdentifier": "84360081-db5a-4f1c-9644-d975ccad9b2c"
@@ -371,6 +371,16 @@
           "icon": "IconAbc",
           "name": "name"
         },
+        {
+          "universalIdentifier": "ba5dc9b0-5592-48c8-b0a5-13c9ea91c548",
+          "type": "TEXT",
+          "label": "Значок",
+          "icon": "IconIcons",
+          "name": "icon",
+          "description": "Значок папки в документах, имя иконки Tabler (IconFolder, IconBriefcase…)",
+          "isNullable": true,
+          "defaultValue": null
+        },
         {
           "universalIdentifier": "bd9ffd70-819f-4e09-bba1-d76002fb7b6b",
           "type": "SELECT",
@@ -733,6 +743,14 @@
           "canDestroyObjectRecords": false,
           "universalIdentifier": "f82e6bc7-751b-5ff2-8c5b-0aa4d05bcd3a"
         },
+        {
+          "objectUniversalIdentifier": "dfbf9c6a-8ee5-4598-9bc3-f767d3636e17",
+          "canReadObjectRecords": true,
+          "canUpdateObjectRecords": true,
+          "canSoftDeleteObjectRecords": true,
+          "canDestroyObjectRecords": false,
+          "universalIdentifier": "3bc9c33d-cf6a-52bc-9155-3029fc5d51f9"
+        },
         {
           "objectUniversalIdentifier": "20202020-1ba1-48ba-bc83-ef7e5990ed10",
           "canReadObjectRecords": true,
@@ -995,7 +1013,7 @@
       "componentName": "TaskForm",
       "sourceComponentPath": "src/front-components/task-form.front-component.tsx",
       "builtComponentPath": "src/front-components/task-form.front-component.mjs",
-      "builtComponentChecksum": "d7fab9dddddda34b40ef5fd41273882db1755672061ae1d631b1a1b52af32e85",
+      "builtComponentChecksum": "33fa54e8c3bd27830f85195a4aa1e489262371b137b48a131d95484e34a49812",
       "isHeadless": false,
       "usesSdkClient": true
     },
@@ -1006,7 +1024,7 @@
       "componentName": "ProcessSteps",
       "sourceComponentPath": "src/front-components/process-steps.front-component.tsx",
       "builtComponentPath": "src/front-components/process-steps.front-component.mjs",
-      "builtComponentChecksum": "aeaa21a9c4bd6f746f41aff1602586ad3ecc28d1c190c86003bb0572342c337a",
+      "builtComponentChecksum": "45fcaea1fa2f65a7d6a3bee5aa99f413eb351465147fc2f439e01a9cf1066de4",
       "isHeadless": false,
       "usesSdkClient": true
     },
@@ -1017,7 +1035,7 @@
       "componentName": "DocflowTasks",
       "sourceComponentPath": "src/front-components/docflow-tasks.front-component.tsx",
       "builtComponentPath": "src/front-components/docflow-tasks.front-component.mjs",
-      "builtComponentChecksum": "6b88814173d9430ab66445537cae0e255221ab2c57a710d54e70b7205fba9257",
+      "builtComponentChecksum": "9a7cf922b19dc40d860e3162594e42cdf306bdbadfb9f5f10909e0c816c760a9",
       "isHeadless": false,
       "usesSdkClient": true
     },
@@ -1028,7 +1046,7 @@
       "componentName": "DocflowDocuments",
       "sourceComponentPath": "src/front-components/docflow-documents.front-component.tsx",
       "builtComponentPath": "src/front-components/docflow-documents.front-component.mjs",
-      "builtComponentChecksum": "1abe5a4a28e5c54b02fbab87a86530a50b7d065d36710a43d4db362031d526bb",
+      "builtComponentChecksum": "960bba09e135069123bb0ddb2522e2da482c89c54c8bb36a8624aa5e1b246393",
       "isHeadless": false,
       "usesSdkClient": false
     },
@@ -1039,7 +1057,7 @@
       "componentName": "DocflowProcesses",
       "sourceComponentPath": "src/front-components/docflow-processes.front-component.tsx",
       "builtComponentPath": "src/front-components/docflow-processes.front-component.mjs",
-      "builtComponentChecksum": "f84b86d2015f5a1d35474f868243afe057ddc8a8a419838f921ada50326a172f",
+      "builtComponentChecksum": "e1cf8f66264e75ac353360519f3f219764c30299a8719de5a7236e00ec17c238",
       "isHeadless": false,
       "usesSdkClient": true
     }
@@ -1217,19 +1235,45 @@
   ],
   "viewFields": [],
   "navigationMenuItems": [
+    {
+      "universalIdentifier": "5355f1b8-c9aa-408f-a6a1-4fba20783f50",
+      "name": "Процессы",
+      "icon": "IconTopologyStar3",
+      "position": 1,
+      "type": "PAGE_LAYOUT",
+      "pageLayoutUniversalIdentifier": "9e32175c-8751-47c7-8310-79592798d0ba",
+      "folderUniversalIdentifier": "ad0bb840-6369-4d61-a4c8-eadd887c3653"
+    },
+    {
+      "universalIdentifier": "5cb9f473-2f5b-4b9d-bdad-2bd33c15084f",
+      "name": "Документы",
+      "icon": "IconFileText",
+      "position": 2,
+      "type": "PAGE_LAYOUT",
+      "pageLayoutUniversalIdentifier": "59b1060b-6892-40ef-b32d-01174b16296b",
+      "folderUniversalIdentifier": "ad0bb840-6369-4d61-a4c8-eadd887c3653"
+    },
     {
       "universalIdentifier": "684b284a-5539-4576-8ff3-bebc42b6b040",
+      "name": "Задания",
+      "icon": "IconChecklist",
+      "position": 0,
+      "type": "PAGE_LAYOUT",
+      "pageLayoutUniversalIdentifier": "2afc1ee1-4931-45c9-a656-284703432ae9",
+      "folderUniversalIdentifier": "ad0bb840-6369-4d61-a4c8-eadd887c3653"
+    },
+    {
+      "universalIdentifier": "ad0bb840-6369-4d61-a4c8-eadd887c3653",
       "name": "Документооборот",
       "icon": "IconFiles",
       "position": 0,
-      "type": "PAGE_LAYOUT",
-      "pageLayoutUniversalIdentifier": "2afc1ee1-4931-45c9-a656-284703432ae9"
+      "type": "FOLDER"
     }
   ],
   "pageLayouts": [
     {
       "universalIdentifier": "2afc1ee1-4931-45c9-a656-284703432ae9",
-      "name": "Документооборот",
+      "name": "Задания",
       "type": "STANDALONE_PAGE",
       "tabs": [
         {
@@ -1250,41 +1294,55 @@
               }
             }
           ]
-        },
+        }
+      ]
+    },
+    {
+      "universalIdentifier": "59b1060b-6892-40ef-b32d-01174b16296b",
+      "name": "Документы",
+      "type": "STANDALONE_PAGE",
+      "tabs": [
         {
-          "universalIdentifier": "ec744df7-e0b7-432c-9a6a-0744ce8ce181",
-          "title": "Процессы",
-          "position": 1,
-          "icon": "IconTopologyStar3",
+          "universalIdentifier": "6812be11-2eba-4a84-9fa6-415a20a8c41b",
+          "title": "Документы",
+          "position": 0,
+          "icon": "IconFileText",
           "layoutMode": "VERTICAL_LIST",
           "widgets": [
             {
-              "universalIdentifier": "3d008534-4079-465b-a102-597a8d9e1b91",
+              "universalIdentifier": "0186ba32-7eed-4882-ac28-55309fb6aad5",
               "title": " ",
               "type": "FRONT_COMPONENT",
               "heightBehavior": "TAB_VIEWPORT",
               "configuration": {
                 "configurationType": "FRONT_COMPONENT",
-                "frontComponentUniversalIdentifier": "ee4f4169-9ef7-44e6-bbd4-aa60384a9f46"
+                "frontComponentUniversalIdentifier": "ea04342b-c22e-4aa6-aa70-368899394750"
               }
             }
           ]
-        },
+        }
+      ]
+    },
+    {
+      "universalIdentifier": "9e32175c-8751-47c7-8310-79592798d0ba",
+      "name": "Процессы",
+      "type": "STANDALONE_PAGE",
+      "tabs": [
         {
-          "universalIdentifier": "f840d53e-5060-4513-9a32-cd7a79255cc3",
-          "title": "Документы",
-          "position": 2,
-          "icon": "IconFileText",
+          "universalIdentifier": "2a39e80b-5ffd-4b36-ad55-31858985faf5",
+          "title": "Процессы",
+          "position": 0,
+          "icon": "IconTopologyStar3",
           "layoutMode": "VERTICAL_LIST",
           "widgets": [
             {
-              "universalIdentifier": "0e20c04b-f01d-438f-b3cd-0cac0dc25bc0",
+              "universalIdentifier": "a81078bf-e8cd-497a-a557-89fe3d428842",
               "title": " ",
               "type": "FRONT_COMPONENT",
               "heightBehavior": "TAB_VIEWPORT",
               "configuration": {
                 "configurationType": "FRONT_COMPONENT",
-                "frontComponentUniversalIdentifier": "ea04342b-c22e-4aa6-aa70-368899394750"
+                "frontComponentUniversalIdentifier": "ee4f4169-9ef7-44e6-bbd4-aa60384a9f46"
               }
             }
           ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haiiro/docuflow",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "NorDiv Документооборот: задания с полями, процессы с запуском по параметрам, документы со всех записей, приложение Битрикс24",
   "license": "AGPL-3.0-only",
   "publishConfig": {