@haiiro/docuflow 0.0.1 → 0.0.3

package/{.twenty/output/manifest.json → manifest.json}

@@ -48,8 +48,8 @@
     },
     "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Нужно: Node.js 24.5+, `corepack enable` (Yarn 4), доступ администратора к CRM.\n\n```bash\nyarn install\nyarn app dev:build   # сборка без сервера, проверяет манифест и типы\nyarn app remote:add --url https://crm.example.ru --api-key <ключ API администратора> --as prod\nyarn app remote:use prod\nyarn app plan        # что изменится, без применения\nyarn app apply       # установка; повторный запуск обновляет\n```\n\nКлюч API создаётся в «Настройки → API и вебхуки».\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",
-    "yarnLockChecksum": "a9126e57b6896d6c873ec888793d08f0",
-    "packageJsonChecksum": "5ce2b7630ea756c0827875e436a00669",
+    "yarnLockChecksum": "42ac7e58e1f5be33be57956ccaa20fb3",
+    "packageJsonChecksum": "b5aea934332d3340b579f6718c61f1ae",
     "requiredServerVersionRange": null,
     "healthCheckLogicFunction": {
       "universalIdentifier": "84360081-db5a-4f1c-9644-d975ccad9b2c"
@@ -892,7 +892,7 @@
       "handlerName": "default.config.handler",
       "sourceHandlerPath": "src/logic-functions/save-launch-fields.logic-function.ts",
       "builtHandlerPath": "src/logic-functions/save-launch-fields.logic-function.mjs",
-      "builtHandlerChecksum": "5772939812d8adf14c81d4cbe2a6dc94"
+      "builtHandlerChecksum": "a605be396d01944f6cd2d2b9621ac0ca"
     },
     {
       "universalIdentifier": "d94c98c9-4f19-4fdd-9da2-89b3dfc6e43c",
@@ -922,7 +922,7 @@
       "handlerName": "default.config.handler",
       "sourceHandlerPath": "src/logic-functions/launch-process.logic-function.ts",
       "builtHandlerPath": "src/logic-functions/launch-process.logic-function.mjs",
-      "builtHandlerChecksum": "7ab1e4cbde49a4a0c719418446c2860c"
+      "builtHandlerChecksum": "805635a4b94da6daba317b0c20004f8f"
     },
     {
       "universalIdentifier": "f27cfbdc-8e87-4e1a-ab37-fc2a8093946c",
@@ -989,7 +989,7 @@
       "componentName": "TaskForm",
       "sourceComponentPath": "src/front-components/task-form.front-component.tsx",
       "builtComponentPath": "src/front-components/task-form.front-component.mjs",
-      "builtComponentChecksum": "add7d0f5be09461d3461a1651bcdf16dc36d41a60bdc0b3c21abb6d537fd1f2e",
+      "builtComponentChecksum": "75a12dac0cfc98127c317381a56ac2405d3fb2543b7ae8d78bf87e0c4ac6df84",
       "isHeadless": false,
       "usesSdkClient": true
     },
@@ -1000,7 +1000,7 @@
       "componentName": "ProcessSteps",
       "sourceComponentPath": "src/front-components/process-steps.front-component.tsx",
       "builtComponentPath": "src/front-components/process-steps.front-component.mjs",
-      "builtComponentChecksum": "b42e549eaabf1544b41a169a75f49973e367912978aae65200be39e060ad0ab5",
+      "builtComponentChecksum": "5f9f310c29f892e2bdc40bb4cb2ad00c1230e01d0b9e62ab5ca7965ab30a9bea",
       "isHeadless": false,
       "usesSdkClient": true
     },
@@ -1011,7 +1011,7 @@
       "componentName": "DocflowTasks",
       "sourceComponentPath": "src/front-components/docflow-tasks.front-component.tsx",
       "builtComponentPath": "src/front-components/docflow-tasks.front-component.mjs",
-      "builtComponentChecksum": "fa073f9138b3a682c1694ffbda830bc7cf7a315cd3d6fc0ecd638a97c7e607d8",
+      "builtComponentChecksum": "e7435238851ed24c6b254f10f1a9449d3088cb23cc13cb25e1c690b2b7b2a1c7",
       "isHeadless": false,
       "usesSdkClient": true
     },
@@ -1022,7 +1022,7 @@
       "componentName": "DocflowDocuments",
       "sourceComponentPath": "src/front-components/docflow-documents.front-component.tsx",
       "builtComponentPath": "src/front-components/docflow-documents.front-component.mjs",
-      "builtComponentChecksum": "de6f3b6ce5f4a34b6d1d7f72ba9564df5206c66611e86362f90c0506c0721427",
+      "builtComponentChecksum": "0e27dea613cd6524d27e4a16cea280fecfd7528dbd5362d8143523421810c78c",
       "isHeadless": false,
       "usesSdkClient": true
     },
@@ -1033,7 +1033,7 @@
       "componentName": "DocflowProcesses",
       "sourceComponentPath": "src/front-components/docflow-processes.front-component.tsx",
       "builtComponentPath": "src/front-components/docflow-processes.front-component.mjs",
-      "builtComponentChecksum": "943f8bd1483e8f5042bdbf29cb4d73248dd1eb7b8eaf621cd96e6582878e120f",
+      "builtComponentChecksum": "e98516994b425be61d9e0e59124fae05cb262799212e7e1e08c3080800e5d6cc",
       "isHeadless": false,
       "usesSdkClient": true
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haiiro/docuflow",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "NorDiv Документооборот: задания с полями, процессы с запуском по параметрам, документы со всех записей, приложение Битрикс24",
   "license": "AGPL-3.0-only",
   "publishConfig": {
@@ -8,8 +8,20 @@
     "registry": "https://registry.npmjs.org/"
   },
   "files": [
-    "**/*",
-    "!**/*.map"
+    "manifest.json",
+    "front-component-shared-dependencies.mjs",
+    "yarn.lock",
+    "src/**/*",
+    "public/**/*",
+    "README.md",
+    "tsconfig.json",
+    "tsconfig.spec.json",
+    "vitest.unit.config.ts",
+    ".oxlintrc.json",
+    ".nvmrc",
+    ".yarnrc.yml",
+    "!**/*.map",
+    "!**/__tests__/**"
   ],
   "engines": {
     "node": "^24.5.0",