@haiiro/docuflow 0.0.5 → 0.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -10,10 +10,10 @@
10
10
  | Где | Что |
11
11
  |---|---|
12
12
  | Сайдбар | пункт «Документооборот» с вкладками «Задания», «Процессы», «Документы» |
13
- | «Задания» | задачи раздела «Документооборот»; фильтры «Открытые / Мои / Просроченные / Выполненные», поиск, создание задания с инструкцией и полями для заполнения |
13
+ | «Задания» | задачи раздела «Документооборот»; фильтры «Открытые / Мои / Просроченные / Выполненные / Архив» (архив — удалённые, со штатным «Восстановить»), поиск, создание задания с инструкцией и полями для заполнения |
14
14
  | Карточка задачи | вкладка «Задание»: инструкция, поля задания (собрать конструктором, заполнить), «Выполнить» |
15
- | Карточка процесса | вкладка «Запуск и задания»: параметры запуска (конструктор полей) и, для шагов «Человеческий ввод» черновика, кто выполняет, срок в днях, обязательные поля; у каждого поля видна переменная, которой его читают следующие шаги |
16
- | Редактор процесса | шаг «Запуск с параметрами» (из приложения): отдаёт следующим шагам параметры, заполненные перед запуском |
15
+ | Карточка процесса | кнопка «Параметры запуска» вверху (боковая панель): параметры запуска (конструктор полей) и, для шагов «Человеческий ввод» черновика, кто выполняет, срок в днях, обязательные поля; у каждого поля видна переменная, которой его читают следующие шаги |
16
+ | Редактор процесса | шаг «Параметры запуска» (ставится сам): отдаёт следующим шагам параметры, заполненные перед запуском |
17
17
  | «Процессы» | процессы с ручным запуском раздела «Документооборот»; форма параметров до запуска, «Запустить», «Создать», «Изменить процесс» |
18
18
  | «Документы» | папки, фильтры, поиск по названию и номеру, документ с реквизитами (тип, номер, дата, срок действия, контрагент, описание), файл в поле «Файл» карточки, карточка с источником |
19
19
  | Автоматически | шаг «Человеческий ввод» процесса становится задачей; её выполнение продолжает процесс; файл, приложенный к любой записи, копируется в документы с отметкой, кто, когда и куда его добавил |
@@ -32,17 +32,17 @@
32
32
 
33
33
  ## Установка
34
34
 
35
- Одна команда, на любой CRM; повторный запуск с новой версией пакета обновляет приложение:
35
+ На сервере, где запущен Twenty, из каталога с его `docker-compose.yml`; повторный запуск
36
+ ставит новую версию:
36
37
 
37
38
  ```bash
38
- npx @haiiro/docuflow install --url https://crm.example.ru --api-key '<ключ API>'
39
+ docker compose exec server npx -y @haiiro/install@latest docuflow
39
40
  ```
40
41
 
41
- Нужно: Node.js 20+ на машине, откуда запускается команда, и ключ API администратора
42
- («Настройки → API и вебхуки»). Команда скачивает эту версию пакета из npm, загружает её в CRM
43
- архивом приложения и устанавливает. Каталог приложений CRM для этого не нужен, поэтому
44
- результат одинаков на любом сервере, в том числе там, где «Документооборот» раньше ставили из исходников.
45
- Конкретная версия: `--version 0.0.4`. Ключ можно передать переменной `CRM_API_KEY`, адрес — `CRM_URL`.
42
+ Ключи не нужны: установщик работает внутри контейнера сервера и вызывает его команды
43
+ `marketplace:catalog-sync`, `application:install` и `application:upgrade`. Приложение ставится
44
+ во все компании сервера. Конкретная версия: `docuflow@0.0.6`. Публикация из репозитория форка:
45
+ `bash scripts/smb-publish.sh docflow`.
46
46
 
47
47
  Из исходников (для разработки): `yarn install && yarn app remote:add --url … --api-key … --as prod && yarn app apply --remote prod`.
48
48
 
@@ -62,23 +62,23 @@ npx @haiiro/docuflow install --url https://crm.example.ru --api-key '<ключ A
62
62
 
63
63
  ## Как пользоваться
64
64
 
65
- - **Процесс.** «Процессы → Создать» открывает карточку процесса с уже выставленным разделом.
66
- Существующий процесс переносится в документооборот полем «Раздел» в его карточке.
67
- - **Запуск с параметрами.** Вкладка процесса «Запуск и задания» → «Добавить поле»: название, тип
65
+ - **Процесс.** «Процессы → Создать» создаёт процесс с ручным запуском в разделе «Документооборот» и
66
+ открывает редактор. Существующий процесс переносится в документооборот полем «Раздел».
67
+ - **Параметры запуска.** Кнопка процесса «Параметры запуска» → «Добавить поле»: название, тип
68
68
  (текст, число, дата, сотрудник, компания, контакт, сделка), обязательность. «Сохранить параметры»
69
- ставит процессу ручной запуск, если запуска ещё нет, и первым шагом черновика — шаг «Запуск с
70
- параметрами». В следующих шагах параметры выбираются в списке переменных как поля этого шага:
69
+ ставит процессу ручной запуск, если запуска ещё нет, и сразу после него — шаг «Параметры
70
+ запуска». В следующих шагах параметры выбираются в списке переменных как поля этого шага:
71
71
  `{{<шаг>.<поле>}}`, точное имя показано рядом с полем. Опубликуйте процесс. Параметры
72
72
  заполняются в «Процессах» до запуска; обязательные проверяются и на странице, и на сервере, а
73
73
  значения хранятся в запуске (`trigger.smbDocflowParameters`).
74
74
  - **Задание шага.** Шаг «Человеческий ввод» становится задачей раздела процесса: у исполнителя
75
- из вкладки «Запуск и задания», без него — у запустившего. Поля задания — поля шага из редактора.
75
+ из «Параметров запуска», без него — у запустившего. Поля задания — поля шага из редактора.
76
76
  «Выполнить» проверяет обязательные поля и продолжает процесс; значения дальше читаются
77
77
  переменными шага `{{<шаг>.<поле>}}`.
78
78
  - **Своё задание.** «Задания → Создать»: название, исполнитель, срок, инструкция и поля для
79
79
  заполнения тем же конструктором. Поля меняются в панели задания («Изменить поля»).
80
- - **Документы.** «Документы → Добавить документ»: реквизиты, затем «Создать и прикрепить файл» —
81
- справа откроется карточка документа, файл кладётся в её поле «Файл». Так сделано потому, что
80
+ - **Документы.** «Документы → Создать» создаёт черновик в открытой папке и открывает его штатную
81
+ карточку: там реквизиты и поле «Файл»; строка списка открывает ту же карточку. Так сделано потому, что
82
82
  страница приложения в песочнице видит только имя и размер выбранного файла, не его содержимое.
83
83
  Файл, приложенный к любой записи (компания, сделка, задача, свой объект), появляется в
84
84
  документах сам: «Где загружен», автор, дата, для задачи процесса — ссылка на запуск. Документ
@@ -86,10 +86,13 @@ npx @haiiro/docuflow install --url https://crm.example.ru --api-key '<ключ A
86
86
 
87
87
  ## Ограничения
88
88
 
89
- - Рамку вокруг страницы раздела рисует платформа (страница из виджетов), приложение её не меняет.
89
+ - Рамки вокруг страницы раздела рисует платформа: карточку виджета и рамку вокруг компонента
90
+ приложения. Компоненты приложений работают в изолированном worker'е и убрать их не могут.
91
+ - Параметры видны в редакторе только как переменные шага «Параметры запуска»: у блока «Запуск
92
+ вручную» Twenty показывает лишь свои переменные, поэтому без шага их не выбрать.
90
93
  - Параметры запуска относятся к процессу, а не к версии: после правки полей опубликованная версия
91
94
  до публикации нового черновика получает новые поля, а переменные убранных полей в ней пусты.
92
- - Если после ручного запуска идут сразу несколько шагов, «Запуск с параметрами» встаёт перед
95
+ - Если после ручного запуска идут сразу несколько шагов, «Параметры запуска» встаёт перед
93
96
  первым из них; остальным ветвям переменные шага недоступны.
94
97
  - Документ без файла создаётся раньше файла: если закрыть карточку, не прикрепив файл, документ
95
98
  останется с пустым полем «Файл».
package/manifest.json CHANGED
@@ -47,9 +47,9 @@
47
47
  }
48
48
  },
49
49
  "defaultRoleUniversalIdentifier": "26b1dde8-4ed9-4f39-8516-e0dcb734ea5a",
50
- "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Одна команда, на любой CRM; повторный запуск с новой версией пакета обновляет приложение:\n\n```bash\nnpx @haiiro/docuflow install --url https://crm.example.ru --api-key '<ключ API>'\n```\n\nНужно: Node.js 20+ на машине, откуда запускается команда, и ключ API администратора\n(«Настройки → API и вебхуки»). Команда скачивает эту версию пакета из npm, загружает её в CRM\nархивом приложения и устанавливает. Каталог приложений CRM для этого не нужен, поэтому\nрезультат одинаков на любом сервере, в том числе там, где «Документооборот» раньше ставили из исходников.\nКонкретная версия: `--version 0.0.4`. Ключ можно передать переменной `CRM_API_KEY`, адрес — `CRM_URL`.\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 параметрами». В следующих шагах параметры выбираются в списке переменных как поля этого шага:\n `{{<шаг>.<поле>}}`, точное имя показано рядом с полем. Опубликуйте процесс. Параметры\n заполняются в «Процессах» до запуска; обязательные проверяются и на странице, и на сервере, а\n значения хранятся в запуске (`trigger.smbDocflowParameters`).\n- **Задание шага.** Шаг «Человеческий ввод» становится задачей раздела процесса: у исполнителя\n из вкладки «Запуск и задания», без него — у запустившего. Поля задания — поля шага из редактора.\n «Выполнить» проверяет обязательные поля и продолжает процесс; значения дальше читаются\n переменными шага `{{<шаг>.<поле>}}`.\n- **Своё задание.** «Задания → Создать»: название, исполнитель, срок, инструкция и поля для\n заполнения тем же конструктором. Поля меняются в панели задания («Изменить поля»).\n- **Документы.** «Документы → Добавить документ»: реквизиты, затем «Создать и прикрепить файл» —\n справа откроется карточка документа, файл кладётся в её поле «Файл». Так сделано потому, что\n страница приложения в песочнице видит только имя и размер выбранного файла, не его содержимое.\n Файл, приложенный к любой записи (компания, сделка, задача, свой объект), появляется в\n документах сам: «Где загружен», автор, дата, для задачи процесса — ссылка на запуск. Документ\n хранит копию файла.\n\n## Ограничения\n\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",
51
- "yarnLockChecksum": "0632f6795528cecac52b40852fa9da90",
52
- "packageJsonChecksum": "db63b70d70082dd84376b3616f0fd3c9",
50
+ "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 запуска». В следующих шагах параметры выбираются в списке переменных как поля этого шага:\n `{{<шаг>.<поле>}}`, точное имя показано рядом с полем. Опубликуйте процесс. Параметры\n заполняются в «Процессах» до запуска; обязательные проверяются и на странице, и на сервере, а\n значения хранятся в запуске (`trigger.smbDocflowParameters`).\n- **Задание шага.** Шаг «Человеческий ввод» становится задачей раздела процесса: у исполнителя\n из «Параметров запуска», без него — у запустившего. Поля задания — поля шага из редактора.\n «Выполнить» проверяет обязательные поля и продолжает процесс; значения дальше читаются\n переменными шага `{{<шаг>.<поле>}}`.\n- **Своё задание.** «Задания → Создать»: название, исполнитель, срок, инструкция и поля для\n заполнения тем же конструктором. Поля меняются в панели задания («Изменить поля»).\n- **Документы.** «Документы → Создать» создаёт черновик в открытой папке и открывает его штатную\n карточку: там реквизиты и поле «Файл»; строка списка открывает ту же карточку. Так сделано потому, что\n страница приложения в песочнице видит только имя и размер выбранного файла, не его содержимое.\n Файл, приложенный к любой записи (компания, сделка, задача, свой объект), появляется в\n документах сам: «Где загружен», автор, дата, для задачи процесса — ссылка на запуск. Документ\n хранит копию файла.\n\n## Ограничения\n\n- Рамки вокруг страницы раздела рисует платформа: карточку виджета и рамку вокруг компонента\n приложения. Компоненты приложений работают в изолированном worker'е и убрать их не могут.\n- Параметры видны в редакторе только как переменные шага «Параметры запуска»: у блока «Запуск\n вручную» Twenty показывает лишь свои переменные, поэтому без шага их не выбрать.\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",
51
+ "yarnLockChecksum": "42ac7e58e1f5be33be57956ccaa20fb3",
52
+ "packageJsonChecksum": "ac89a97e4fcc3287015b11fea59c0fe2",
53
53
  "requiredServerVersionRange": null,
54
54
  "healthCheckLogicFunction": {
55
55
  "universalIdentifier": "84360081-db5a-4f1c-9644-d975ccad9b2c"
@@ -725,7 +725,9 @@
725
725
  "canSoftDeleteAllObjectRecords": false,
726
726
  "canDestroyAllObjectRecords": false,
727
727
  "permissionFlagUniversalIdentifiers": [
728
- "6189e7bd-4051-5752-b6b1-5f31358fbaf1"
728
+ "6189e7bd-4051-5752-b6b1-5f31358fbaf1",
729
+ "dc6931a9-44bd-5164-a983-3db5db837f54",
730
+ "6edf252f-228e-5e2f-9706-7bab7a796fd3"
729
731
  ],
730
732
  "objectPermissions": [],
731
733
  "fieldPermissions": [],
@@ -882,7 +884,7 @@
882
884
  {
883
885
  "universalIdentifier": "d2cce9f2-6ba4-415c-aa3d-5d9aba6ae89c",
884
886
  "name": "docflow-save-launch-fields",
885
- "description": "Сохраняет параметры запуска процесса и ставит шаг «Запуск с параметрами»",
887
+ "description": "Сохраняет параметры запуска процесса и ставит шаг «Параметры запуска»",
886
888
  "timeoutSeconds": 30,
887
889
  "httpRouteTriggerSettings": {
888
890
  "path": "/docflow/processes/launch-fields",
@@ -892,7 +894,7 @@
892
894
  "handlerName": "default.config.handler",
893
895
  "sourceHandlerPath": "src/logic-functions/save-launch-fields.logic-function.ts",
894
896
  "builtHandlerPath": "src/logic-functions/save-launch-fields.logic-function.mjs",
895
- "builtHandlerChecksum": "a605be396d01944f6cd2d2b9621ac0ca"
897
+ "builtHandlerChecksum": "622be5f06efbc7bc4a157c7c706044b8"
896
898
  },
897
899
  {
898
900
  "universalIdentifier": "d94c98c9-4f19-4fdd-9da2-89b3dfc6e43c",
@@ -922,7 +924,7 @@
922
924
  "handlerName": "default.config.handler",
923
925
  "sourceHandlerPath": "src/logic-functions/launch-process.logic-function.ts",
924
926
  "builtHandlerPath": "src/logic-functions/launch-process.logic-function.mjs",
925
- "builtHandlerChecksum": "805635a4b94da6daba317b0c20004f8f"
927
+ "builtHandlerChecksum": "bc6d9f5f7dd0a6b665040b44991bdef1"
926
928
  },
927
929
  {
928
930
  "universalIdentifier": "f27cfbdc-8e87-4e1a-ab37-fc2a8093946c",
@@ -947,7 +949,7 @@
947
949
  "handlerName": "default.config.handler",
948
950
  "sourceHandlerPath": "src/logic-functions/capture-file.logic-function.ts",
949
951
  "builtHandlerPath": "src/logic-functions/capture-file.logic-function.mjs",
950
- "builtHandlerChecksum": "889aaa79cad38a7230a05dd50aa8e2d6"
952
+ "builtHandlerChecksum": "bc75be09cf7a967ea95d3b9f7876f402"
951
953
  },
952
954
  {
953
955
  "universalIdentifier": "f7559a62-213e-4b1f-a142-603b463a585a",
@@ -955,7 +957,7 @@
955
957
  "description": "Отдаёт следующим шагам параметры, заполненные перед запуском процесса",
956
958
  "timeoutSeconds": 10,
957
959
  "workflowActionTriggerSettings": {
958
- "label": "Запуск с параметрами",
960
+ "label": "Параметры запуска",
959
961
  "icon": "IconPlayerPlay",
960
962
  "inputSchema": [
961
963
  {
@@ -978,7 +980,7 @@
978
980
  "handlerName": "default.config.handler",
979
981
  "sourceHandlerPath": "src/logic-functions/launch-parameters-step.logic-function.ts",
980
982
  "builtHandlerPath": "src/logic-functions/launch-parameters-step.logic-function.mjs",
981
- "builtHandlerChecksum": "9a76a3a09e039240309ce6f4f70903cb"
983
+ "builtHandlerChecksum": "380658563801f106208578d34c7d2a49"
982
984
  }
983
985
  ],
984
986
  "frontComponents": [
@@ -989,7 +991,7 @@
989
991
  "componentName": "TaskForm",
990
992
  "sourceComponentPath": "src/front-components/task-form.front-component.tsx",
991
993
  "builtComponentPath": "src/front-components/task-form.front-component.mjs",
992
- "builtComponentChecksum": "75a12dac0cfc98127c317381a56ac2405d3fb2543b7ae8d78bf87e0c4ac6df84",
994
+ "builtComponentChecksum": "d7fab9dddddda34b40ef5fd41273882db1755672061ae1d631b1a1b52af32e85",
993
995
  "isHeadless": false,
994
996
  "usesSdkClient": true
995
997
  },
@@ -1000,7 +1002,7 @@
1000
1002
  "componentName": "ProcessSteps",
1001
1003
  "sourceComponentPath": "src/front-components/process-steps.front-component.tsx",
1002
1004
  "builtComponentPath": "src/front-components/process-steps.front-component.mjs",
1003
- "builtComponentChecksum": "5f9f310c29f892e2bdc40bb4cb2ad00c1230e01d0b9e62ab5ca7965ab30a9bea",
1005
+ "builtComponentChecksum": "7470005cdb1982814bf29810cd65460e0a5dbc50ec23b434cc84190bd2aa350c",
1004
1006
  "isHeadless": false,
1005
1007
  "usesSdkClient": true
1006
1008
  },
@@ -1011,7 +1013,7 @@
1011
1013
  "componentName": "DocflowTasks",
1012
1014
  "sourceComponentPath": "src/front-components/docflow-tasks.front-component.tsx",
1013
1015
  "builtComponentPath": "src/front-components/docflow-tasks.front-component.mjs",
1014
- "builtComponentChecksum": "e7435238851ed24c6b254f10f1a9449d3088cb23cc13cb25e1c690b2b7b2a1c7",
1016
+ "builtComponentChecksum": "dbee351241924f3b5395f0da610433d53a54613acdbb2d12b54e56eb692d7592",
1015
1017
  "isHeadless": false,
1016
1018
  "usesSdkClient": true
1017
1019
  },
@@ -1022,9 +1024,9 @@
1022
1024
  "componentName": "DocflowDocuments",
1023
1025
  "sourceComponentPath": "src/front-components/docflow-documents.front-component.tsx",
1024
1026
  "builtComponentPath": "src/front-components/docflow-documents.front-component.mjs",
1025
- "builtComponentChecksum": "0e27dea613cd6524d27e4a16cea280fecfd7528dbd5362d8143523421810c78c",
1027
+ "builtComponentChecksum": "f3c446b3ed107e2131132b30f612448b4cabd2467758cef01488304097935234",
1026
1028
  "isHeadless": false,
1027
- "usesSdkClient": true
1029
+ "usesSdkClient": false
1028
1030
  },
1029
1031
  {
1030
1032
  "universalIdentifier": "ee4f4169-9ef7-44e6-bbd4-aa60384a9f46",
@@ -1033,7 +1035,7 @@
1033
1035
  "componentName": "DocflowProcesses",
1034
1036
  "sourceComponentPath": "src/front-components/docflow-processes.front-component.tsx",
1035
1037
  "builtComponentPath": "src/front-components/docflow-processes.front-component.mjs",
1036
- "builtComponentChecksum": "e98516994b425be61d9e0e59124fae05cb262799212e7e1e08c3080800e5d6cc",
1038
+ "builtComponentChecksum": "12d65821f6160d833a369ac7d3549be14b913b71601ec5cee5576c28a44dd915",
1037
1039
  "isHeadless": false,
1038
1040
  "usesSdkClient": true
1039
1041
  }
@@ -1306,30 +1308,22 @@
1306
1308
  }
1307
1309
  }
1308
1310
  ]
1309
- },
1311
+ }
1312
+ ],
1313
+ "pageLayoutWidgets": [],
1314
+ "commandMenuItems": [
1310
1315
  {
1311
- "universalIdentifier": "6b031481-d834-4af2-a1ef-a10717b5289b",
1312
- "pageLayoutUniversalIdentifier": "d5b24215-4902-517d-a8c8-88ff5c0ba88e",
1313
- "title": "Запуск и задания",
1314
- "position": 50,
1316
+ "universalIdentifier": "c3f5a2d4-7e1b-4c9a-8f36-2b5d0e7a91c4",
1317
+ "label": "Параметры запуска",
1318
+ "shortLabel": "Параметры запуска",
1315
1319
  "icon": "IconPlayerPlay",
1316
- "layoutMode": "VERTICAL_LIST",
1317
- "widgets": [
1318
- {
1319
- "universalIdentifier": "e7d95558-abb4-46af-aae9-20dade718fc5",
1320
- "title": " ",
1321
- "type": "FRONT_COMPONENT",
1322
- "heightBehavior": "FIT_CONTENT",
1323
- "configuration": {
1324
- "configurationType": "FRONT_COMPONENT",
1325
- "frontComponentUniversalIdentifier": "839b8f10-d269-4005-a13a-0838610747b9"
1326
- }
1327
- }
1328
- ]
1320
+ "isPinned": true,
1321
+ "availabilityType": "RECORD_SELECTION",
1322
+ "availabilityObjectUniversalIdentifier": "20202020-62be-406c-b9ca-8caa50d51392",
1323
+ "frontComponentUniversalIdentifier": "839b8f10-d269-4005-a13a-0838610747b9",
1324
+ "conditionalAvailabilityExpression": "numberOfSelectedRecords == 1"
1329
1325
  }
1330
1326
  ],
1331
- "pageLayoutWidgets": [],
1332
- "commandMenuItems": [],
1333
1327
  "timelineActivityTypes": [],
1334
1328
  "settingsMenuItems": []
1335
1329
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@haiiro/docuflow",
3
- "version": "0.0.5",
3
+ "version": "0.0.7",
4
4
  "description": "NorDiv Документооборот: задания с полями, процессы с запуском по параметрам, документы со всех записей, приложение Битрикс24",
5
5
  "license": "AGPL-3.0-only",
6
6
  "publishConfig": {