@haiiro/docuflow 0.0.1 → 0.0.3

package/{.twenty/output/src → src}/logic-functions/launch-process.logic-function.mjs

@@ -119468,6 +119468,18 @@ var runWorkflowVersion = async ({
   return data.runWorkflowVersion.workflowRunId;
 };
 
+// src/shared/log.util.ts
+var PREFIX = "[docflow]";
+var describeError = (error) => {
+  if (error instanceof Error) {
+    const { status, body } = error;
+    return { name: error.name, message: error.message, status, body };
+  }
+  return error;
+};
+var logDocflow = (event, details) => console.info(PREFIX, event, details ?? "");
+var logDocflowError = (event, error, details) => console.error(PREFIX, event, describeError(error), details ?? "");
+
 // src/universal-identifiers.ts
 var LAUNCH_PROCESS_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER = "de04e9c8-7ebe-4ac2-b4b3-4ca256eb94db";
 
@@ -119507,10 +119519,12 @@ var handler = async (event, context) => {
       payload: fields.length > 0 ? buildLaunchPayload(parameters) : {}
     });
   } catch (error) {
+    logDocflowError("launch: run failed", error, { workflowVersionId });
     return jsonResponse(403, {
       message: error instanceof CoreGraphqlError && error.userMessage !== void 0 ? error.userMessage : "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u0437\u0430\u043F\u0443\u0441\u0442\u0438\u0442\u044C \u043F\u0440\u043E\u0446\u0435\u0441\u0441"
     });
   }
+  logDocflow("launch: started", { workflowVersionId, workflowRunId, parameters });
   return { workflowRunId };
 };
 var launch_process_logic_function_default = defineLogicFunction({

package/src/logic-functions/launch-process.logic-function.ts

@@ -15,6 +15,7 @@ import {
 import { readJsonBody, jsonResponse } from 'src/server/http-response';
 import { getWorkflow, getWorkflowVersion } from 'src/server/records';
 import { runWorkflowVersion } from 'src/server/workflow-engine';
+import { logDocflow, logDocflowError } from 'src/shared/log.util';
 import { LAUNCH_PROCESS_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
 
 // Launch with parameters: they are checked here and ride in the run payload,
@@ -71,6 +72,8 @@ const handler = async (
       payload: fields.length > 0 ? buildLaunchPayload(parameters) : {},
     });
   } catch (error) {
+    logDocflowError('launch: run failed', error, { workflowVersionId });
+
     return jsonResponse(403, {
       message:
         error instanceof CoreGraphqlError && error.userMessage !== undefined
@@ -79,6 +82,8 @@ const handler = async (
     });
   }
 
+  logDocflow('launch: started', { workflowVersionId, workflowRunId, parameters });
+
   return { workflowRunId };
 };
 

package/{.twenty/output/src → src}/logic-functions/save-launch-fields.logic-function.mjs

@@ -119607,6 +119607,18 @@ var jsonResponse = (status, body) => new AL(JSON.stringify(body), {
 });
 var readJsonBody = (body) => typeof body === "object" && body !== null && !Array.isArray(body) ? body : {};
 
+// src/shared/log.util.ts
+var PREFIX = "[docflow]";
+var describeError = (error) => {
+  if (error instanceof Error) {
+    const { status, body } = error;
+    return { name: error.name, message: error.message, status, body };
+  }
+  return error;
+};
+var logDocflow = (event, details) => console.info(PREFIX, event, details ?? "");
+var logDocflowError = (event, error, details) => console.error(PREFIX, event, describeError(error), details ?? "");
+
 // src/logic-functions/save-launch-fields.logic-function.ts
 var handler = async (event) => {
   const body = readJsonBody(event.body);
@@ -119629,6 +119641,7 @@ var handler = async (event) => {
   }
   try {
     const result = await syncLaunchStep({ workflowId, fields });
+    logDocflow("launch fields: draft synced", { workflowId, result });
     if (result?.status === "NOT_MANUAL") {
       return jsonResponse(409, {
         message: "\u041F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B \u0441\u043E\u0445\u0440\u0430\u043D\u0435\u043D\u044B, \u043D\u043E \u0448\u0430\u0433 \u043D\u0435 \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D: \u0443 \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u0430 \u043D\u0435 \u0440\u0443\u0447\u043D\u043E\u0439 \u0437\u0430\u043F\u0443\u0441\u043A"
@@ -119636,6 +119649,7 @@ var handler = async (event) => {
     }
     return { status: "SAVED", stepId: result?.status === "SAVED" ? result.stepId : null };
   } catch (error) {
+    logDocflowError("launch fields: draft not synced", error, { workflowId });
     return jsonResponse(502, {
       message: error instanceof CoreGraphqlError && error.userMessage !== void 0 ? `\u041F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B \u0441\u043E\u0445\u0440\u0430\u043D\u0435\u043D\u044B, \u0448\u0430\u0433 \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u0430 \u043D\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u0451\u043D: ${error.userMessage}` : `\u041F\u0430\u0440\u0430\u043C\u0435\u0442\u0440\u044B \u0441\u043E\u0445\u0440\u0430\u043D\u0435\u043D\u044B, \u0448\u0430\u0433 \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u0430 \u043D\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u0451\u043D: ${error instanceof Error ? error.message : "\u043E\u0448\u0438\u0431\u043A\u0430 \u0440\u0435\u0434\u0430\u043A\u0442\u043E\u0440\u0430 \u043F\u0440\u043E\u0446\u0435\u0441\u0441\u043E\u0432"}`
     });

package/src/logic-functions/save-launch-fields.logic-function.ts

@@ -8,6 +8,7 @@ import { parseLaunchFields } from 'src/shared/workflow/launch-step.util';
 import { syncLaunchStep } from 'src/server/launch-step';
 import { jsonResponse, readJsonBody } from 'src/server/http-response';
 import { restClient } from 'src/server/records';
+import { logDocflow, logDocflowError } from 'src/shared/log.util';
 import { SAVE_LAUNCH_FIELDS_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
 
 // Saves the parameters of a process and keeps its draft in step: the
@@ -42,6 +43,8 @@ const handler = async (event: RoutePayload) => {
   try {
     const result = await syncLaunchStep({ workflowId, fields });
 
+    logDocflow('launch fields: draft synced', { workflowId, result });
+
     if (result?.status === 'NOT_MANUAL') {
       return jsonResponse(409, {
         message: 'Параметры сохранены, но шаг не добавлен: у процесса не ручной запуск',
@@ -50,6 +53,8 @@ const handler = async (event: RoutePayload) => {
 
     return { status: 'SAVED', stepId: result?.status === 'SAVED' ? result.stepId : null };
   } catch (error) {
+    logDocflowError('launch fields: draft not synced', error, { workflowId });
+
     return jsonResponse(502, {
       message:
         error instanceof CoreGraphqlError && error.userMessage !== undefined

package/.gitignore

@@ -1,43 +0,0 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.*
-.yarn/*
-!.yarn/patches
-!.yarn/plugins
-!.yarn/releases
-!.yarn/sdks
-!.yarn/versions
-
-# codegen
-generated
-
-# testing
-/coverage
-
-# dev
-/dist/
-
-.twenty
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-
-# env files (can opt-in for committing if needed)
-.env*
-
-# typescript
-*.tsbuildinfo
-*.d.ts

package/.nvmrc

@@ -1 +0,0 @@
-24.5.0

package/.oxlintrc.json

@@ -1,37 +0,0 @@
-{
-  "$schema": "./node_modules/oxlint/configuration_schema.json",
-  "plugins": ["typescript"],
-  "categories": {
-    "correctness": "off"
-  },
-  "ignorePatterns": ["node_modules", "dist"],
-  "rules": {
-    "no-unused-vars": "off",
-
-    "typescript/no-unused-vars": [
-      "warn",
-      {
-        "argsIgnorePattern": "^_"
-      }
-    ],
-    "typescript/no-explicit-any": "off"
-  },
-  "overrides": [
-    {
-      "files": ["**/*.logic-function.ts", "**/logic-functions/**/*.ts"],
-      "rules": {
-        "no-restricted-imports": [
-          "error",
-          {
-            "patterns": [
-              {
-                "group": ["twenty-shared", "twenty-shared/*"],
-                "message": "Logic functions must not import from twenty-shared directly. Import runtime types and helpers from `twenty-sdk/logic-function` instead so the logic-function bundle stays minimal."
-              }
-            ]
-          }
-        ]
-      }
-    }
-  ]
-}

package/.twenty/output/README.md

@@ -1,128 +0,0 @@
-# Документооборот (`@crm-nordiv/docuflow`)
-
-Задания, процессы и документы компании в одном разделе. Ставится в CRM как приложение, без правок
-сервера.
-
-- universalIdentifier: `0b7d5d2e-8c4f-4a59-9a43-2f6f1c3e9d21`
-
-## Что получается после установки
-
-| Где | Что |
-|---|---|
-| Сайдбар | пункт «Документооборот» с вкладками «Задания», «Процессы», «Документы» |
-| «Задания» | задачи раздела «Документооборот»; фильтры «Открытые / Мои / Просроченные / Выполненные», поиск, создание задания с инструкцией и полями для заполнения |
-| Карточка задачи | вкладка «Задание»: инструкция, поля задания (собрать конструктором, заполнить), «Выполнить» |
-| Карточка процесса | вкладка «Запуск и задания»: параметры запуска (конструктор полей) и, для шагов «Человеческий ввод» черновика, кто выполняет, срок в днях, обязательные поля; у каждого поля видна переменная, которой его читают следующие шаги |
-| Редактор процесса | шаг «Запуск с параметрами» (из приложения): отдаёт следующим шагам параметры, заполненные перед запуском |
-| «Процессы» | процессы с ручным запуском раздела «Документооборот»; форма параметров до запуска, «Запустить», «Создать», «Изменить процесс» |
-| «Документы» | папки, фильтры, поиск по названию и номеру, документ с реквизитами (тип, номер, дата, срок действия, контрагент, описание), файл в поле «Файл» карточки, карточка с источником |
-| Автоматически | шаг «Человеческий ввод» процесса становится задачей; её выполнение продолжает процесс; файл, приложенный к любой записи, копируется в документы с отметкой, кто, когда и куда его добавил |
-| Битрикс24 | страница приложения в портале со списком открытых заданий сотрудника и ссылками в CRM; уведомление исполнителю нового задания |
-
-## Данные
-
-| Объект | Поля |
-|---|---|
-| `smbDocument` (новый) | название, файл, тип, номер, дата, действует до, контрагент (компания), описание, статус, автор, ответственный, папка; источник: `origin`, `sourceObjectName`, `sourceRecordId`, `sourceRecordName`, `sourceFileId`, `workflowRunId` |
-| `smbDocumentFolder` (новый) | название, цвет, родительская папка |
-| `workflow` | `smbSection` «Раздел»: CRM / Документооборот; `smbLaunchFields` «Параметры запуска» — поля, которые заполняют перед запуском |
-| `task` | `smbSection`, `smbInstruction` «Инструкция»; `smbFormSchema`, `smbFormValues` — поля задания; `smbWorkflowRunId`, `smbWorkflowStepId`, `smbWorkflowThreadId` — связь с шагом процесса |
-| `company` | `smbDocuments` — документы контрагента |
-| роли | «Документооборот: функции приложения» (права функций), «Документооборот: участник процессов» (для людей, см. ниже) |
-
-## Установка
-
-Нужно: Node.js 24.5+, `corepack enable` (Yarn 4), доступ администратора к CRM.
-
-```bash
-yarn install
-yarn app dev:build   # сборка без сервера, проверяет манифест и типы
-yarn app remote:add --url https://crm.example.ru --api-key <ключ API администратора> --as prod
-yarn app remote:use prod
-yarn app plan        # что изменится, без применения
-yarn app apply       # установка; повторный запуск обновляет
-```
-
-Ключ API создаётся в «Настройки → API и вебхуки».
-
-Затем в «Настройки → Приложения → Документооборот» заполнить переменные:
-
-| Переменная | Что указать |
-|---|---|
-| `DOCFLOW_ENGINE` | `APP` |
-| `CRM_PUBLIC_URL` | адрес CRM компании, например `https://acme.example.ru`; по нему строятся ссылки из Битрикс24 |
-| `BITRIX_CLIENT_ID`, `BITRIX_CLIENT_SECRET` | из карточки локального приложения портала; без них Битрикс24 не подключается, остальное работает |
-
-**Права людей.** Отвечать на шаг запущенного процесса может только тот, у кого есть право
-«Рабочие процессы». Кто выполняет задания процессов или запускает процессы с параметрами,
-получает роль «Документооборот: участник процессов» или это право в своей роли. Право также
-позволяет менять процессы: давайте его тем, кому это допустимо. Обычные задания и документы
-права «Рабочие процессы» не требуют.
-
-## Как пользоваться
-
-- **Процесс.** «Процессы → Создать» открывает карточку процесса с уже выставленным разделом.
-  Существующий процесс переносится в документооборот полем «Раздел» в его карточке.
-- **Запуск с параметрами.** Вкладка процесса «Запуск и задания» → «Добавить поле»: название, тип
-  (текст, число, дата, сотрудник, компания, контакт, сделка), обязательность. «Сохранить параметры»
-  ставит процессу ручной запуск, если запуска ещё нет, и первым шагом черновика — шаг «Запуск с
-  параметрами». В следующих шагах параметры выбираются в списке переменных как поля этого шага:
-  `{{<шаг>.<поле>}}`, точное имя показано рядом с полем. Опубликуйте процесс. Параметры
-  заполняются в «Процессах» до запуска; обязательные проверяются и на странице, и на сервере, а
-  значения хранятся в запуске (`trigger.smbDocflowParameters`).
-- **Задание шага.** Шаг «Человеческий ввод» становится задачей раздела процесса: у исполнителя
-  из вкладки «Запуск и задания», без него — у запустившего. Поля задания — поля шага из редактора.
-  «Выполнить» проверяет обязательные поля и продолжает процесс; значения дальше читаются
-  переменными шага `{{<шаг>.<поле>}}`.
-- **Своё задание.** «Задания → Создать»: название, исполнитель, срок, инструкция и поля для
-  заполнения тем же конструктором. Поля меняются в панели задания («Изменить поля»).
-- **Документы.** «Документы → Добавить документ»: реквизиты, затем «Создать и прикрепить файл» —
-  справа откроется карточка документа, файл кладётся в её поле «Файл». Так сделано потому, что
-  страница приложения в песочнице видит только имя и размер выбранного файла, не его содержимое.
-  Файл, приложенный к любой записи (компания, сделка, задача, свой объект), появляется в
-  документах сам: «Где загружен», автор, дата, для задачи процесса — ссылка на запуск. Документ
-  хранит копию файла.
-
-## Ограничения
-
-- Рамку вокруг страницы раздела рисует платформа (страница из виджетов), приложение её не меняет.
-- Параметры запуска относятся к процессу, а не к версии: после правки полей опубликованная версия
-  до публикации нового черновика получает новые поля, а переменные убранных полей в ней пусты.
-- Если после ручного запуска идут сразу несколько шагов, «Запуск с параметрами» встаёт перед
-  первым из них; остальным ветвям переменные шага недоступны.
-- Документ без файла создаётся раньше файла: если закрыть карточку, не прикрепив файл, документ
-  останется с пустым полем «Файл».
-
-## Битрикс24
-
-Подключается локальным приложением портала (одна компания — один портал).
-
-1. В портале: «Разработчикам → Другое → Локальное приложение», тип «Серверное».
-2. Адреса — HTTP-маршруты приложения на адресе компании (точный адрес виден в «Настройки →
-   Приложения → Документооборот → функции»):
-   - путь обработчика: `https://<адрес компании>/s/bitrix/app`
-   - путь первоначальной установки: `https://<адрес компании>/s/bitrix/install`
-3. Права приложения: `user`, `im`.
-4. Сохранить, скопировать «Код приложения» и «Ключ приложения» в `BITRIX_CLIENT_ID` и
-   `BITRIX_CLIENT_SECRET`, затем открыть приложение в портале — установка завершится сама.
-
-Каждый запрос портала проверяется обменом refresh-токена на `oauth.bitrix.info` с ключом
-приложения; адрес портала берётся из ответа Битрикс24. Привязывается первый подтверждённый портал,
-другой портал к той же компании не подключится. Токены портала хранятся в хранилище приложения, не
-в записях. Сотрудник находится по почте профиля Битрикс24.
-
-## Разработка
-
-```bash
-yarn app dev        # следит за src/ и синхронизирует с сервером
-yarn app dev:function:logs
-yarn test && yarn typecheck && yarn lint
-```
-
-Устройство `src/`: `shared/` — общий код (формы, процессы, фильтры REST, Битрикс24); `server/` —
-обращения к записям и движку процессов из функций; `logic-functions/`; `front/` и
-`front-components/` — интерфейс; `objects/`, `fields/`, `views/`, `roles/`, `page-layouts/`,
-`navigation-menu-items/` — данные и раскладка. Записи читаются и пишутся только через REST API
-(`server/records.ts`, `front/api.ts`), движок процессов — через две мутации GraphQL
-(`server/workflow-engine.ts`, `server/launch-step.ts`): при смене версии платформы сверять эти
-файлы. Стили интерфейса только inline: теги `<style>` в странице приложения платформа отбрасывает.

package/.twenty/output/package.json

@@ -1,49 +0,0 @@
-{
-  "name": "@crm-nordiv/docuflow",
-  "version": "1.1.0",
-  "description": "NorDiv Документооборот: задания с полями, процессы с запуском по параметрам, документы со всех записей, приложение Битрикс24",
-  "license": "AGPL-3.0-only",
-  "files": [
-    "**/*",
-    "!**/*.map"
-  ],
-  "engines": {
-    "node": "^24.5.0",
-    "npm": "please-use-yarn",
-    "yarn": ">=4.0.2"
-  },
-  "keywords": [
-    "twenty-app"
-  ],
-  "packageManager": "yarn@4.13.0",
-  "scripts": {
-    "twenty": "twenty",
-    "app": "twenty",
-    "build": "twenty dev:build",
-    "lint": "oxlint -c .oxlintrc.json .",
-    "lint:fix": "oxlint --fix -c .oxlintrc.json .",
-    "typecheck": "tsc --noEmit -p tsconfig.spec.json",
-    "test": "vitest run --config vitest.unit.config.ts"
-  },
-  "devDependencies": {
-    "@types/node": "^24.7.2",
-    "@types/react": "^19.0.0",
-    "oxlint": "^0.16.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "twenty-client-sdk": "2.45.0",
-    "twenty-sdk": "2.45.0",
-    "twenty-ui": "2.45.0",
-    "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^4.2.1",
-    "vitest": "^4.0.0"
-  },
-  "frontComponentSharedDependencies": [
-    "react",
-    "react-dom/client",
-    "twenty-ui/primitives/input",
-    "twenty-ui/primitives/data-display",
-    "twenty-ui/theme",
-    "twenty-ui/icon"
-  ]
-}

package/.twenty/output/public/cover.svg

@@ -1,15 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1400 860" width="1400" height="860">
-  <rect width="1400" height="860" fill="#F4F4F2"/>
-  <g transform="translate(620 250) scale(2)">
-  <rect width="80" height="80" rx="16" fill="#141414"/>
-  <g transform="translate(16 16) scale(0.5581)" fill="#FAFAFA">
-    <path d="M4 0 H36 A4 4 0 0 1 40 4 V16 A24 24 0 0 1 16 40 H4 A4 4 0 0 1 0 36 V4 A4 4 0 0 1 4 0 Z" fill-opacity="1"/>
-    <path d="M50 0 H50 A36 36 0 0 1 86 36 V36 A4 4 0 0 1 82 40 H70 A24 24 0 0 1 46 16 V4 A4 4 0 0 1 50 0 Z" fill-opacity="0.8"/>
-    <path d="M4 46 H16 A24 24 0 0 1 40 70 V82 A4 4 0 0 1 36 86 H4 A4 4 0 0 1 0 82 V50 A4 4 0 0 1 4 46 Z" fill-opacity="0.86"/>
-    <path d="M70 46 H82 A4 4 0 0 1 86 50 V50 A36 36 0 0 1 50 86 H50 A4 4 0 0 1 46 82 V70 A24 24 0 0 1 70 46 Z" fill-opacity="0.68"/>
-  </g>
-  </g>
-  <text x="700" y="520" text-anchor="middle" font-family="Inter, Arial, sans-serif" font-size="56" font-weight="600" fill="#141414">Документооборот</text>
-  <text x="700" y="580" text-anchor="middle" font-family="Inter, Arial, sans-serif" font-size="28" fill="#6B6B6B">Задания · Процессы · Документы</text>
-  <text x="700" y="800" text-anchor="middle" font-family="Inter, Arial, sans-serif" font-size="24" font-weight="600" letter-spacing="4" fill="#9A9A9A">NORDIV</text>
-</svg>

package/.twenty/output/public/logo.svg

@@ -1,9 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80" fill="none">
-  <rect width="80" height="80" rx="16" fill="#141414"/>
-  <g transform="translate(16 16) scale(0.5581)" fill="#FAFAFA">
-    <path d="M4 0 H36 A4 4 0 0 1 40 4 V16 A24 24 0 0 1 16 40 H4 A4 4 0 0 1 0 36 V4 A4 4 0 0 1 4 0 Z" fill-opacity="1"/>
-    <path d="M50 0 H50 A36 36 0 0 1 86 36 V36 A4 4 0 0 1 82 40 H70 A24 24 0 0 1 46 16 V4 A4 4 0 0 1 50 0 Z" fill-opacity="0.8"/>
-    <path d="M4 46 H16 A24 24 0 0 1 40 70 V82 A4 4 0 0 1 36 86 H4 A4 4 0 0 1 0 82 V50 A4 4 0 0 1 4 46 Z" fill-opacity="0.86"/>
-    <path d="M70 46 H82 A4 4 0 0 1 86 50 V50 A36 36 0 0 1 50 86 H50 A4 4 0 0 1 46 82 V70 A24 24 0 0 1 70 46 Z" fill-opacity="0.68"/>
-  </g>
-</svg>