@haiiro/docuflow 0.0.0-stage → 0.0.2

package/src/logic-functions/save-task-form.logic-function.ts

@@ -0,0 +1,62 @@
+import { defineLogicFunction } from 'twenty-sdk/define';
+import { type RoutePayload } from 'twenty-sdk/logic-function';
+
+import { getFormFieldsError, parseFormFields, parseFormValues } from 'src/shared/form/form-fields.util';
+import { jsonResponse, readJsonBody } from 'src/server/http-response';
+import { getTask, updateTask } from 'src/server/records';
+import { isProcessTask } from 'src/server/task-completion';
+import { SAVE_TASK_FORM_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
+
+// The one-off fields of a task: their list is checked before it is saved,
+// and the fields of a process task belong to the process.
+const handler = async (event: RoutePayload) => {
+  const body = readJsonBody(event.body);
+
+  if (typeof body.taskId !== 'string') {
+    return jsonResponse(400, { message: 'Не указано задание' });
+  }
+
+  const task = await getTask('person', body.taskId);
+
+  if (task === undefined) {
+    return jsonResponse(404, { message: 'Задание не найдено' });
+  }
+
+  const data: Record<string, unknown> = {};
+
+  if (body.fields !== undefined) {
+    if (isProcessTask(task)) {
+      return jsonResponse(409, { message: 'Поля этого задания задаёт процесс' });
+    }
+
+    const fields = parseFormFields(body.fields);
+    const error = getFormFieldsError(fields);
+
+    if (error !== undefined) {
+      return jsonResponse(422, { message: error });
+    }
+
+    data.smbFormSchema = fields;
+  }
+
+  if (body.values !== undefined) {
+    data.smbFormValues = parseFormValues(body.values);
+  }
+
+  await updateTask('person', task.id, data);
+
+  return { status: 'SAVED' };
+};
+
+export default defineLogicFunction({
+  universalIdentifier: SAVE_TASK_FORM_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,
+  name: 'docflow-save-task-form',
+  description: 'Сохраняет поля задания и их значения',
+  timeoutSeconds: 15,
+  handler,
+  httpRouteTriggerSettings: {
+    path: '/docflow/tasks/form',
+    httpMethod: 'POST',
+    isAuthRequired: true,
+  },
+});

package/src/navigation-menu-items/docflow.navigation-menu-item.ts

@@ -0,0 +1,15 @@
+import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';
+
+import {
+  DOCFLOW_NAVIGATION_MENU_ITEM_UNIVERSAL_IDENTIFIER,
+  DOCFLOW_PAGE_LAYOUT_UNIVERSAL_IDENTIFIER,
+} from 'src/universal-identifiers';
+
+export default defineNavigationMenuItem({
+  universalIdentifier: DOCFLOW_NAVIGATION_MENU_ITEM_UNIVERSAL_IDENTIFIER,
+  name: 'Документооборот',
+  icon: 'IconFiles',
+  position: 0,
+  type: NavigationMenuItemType.PAGE_LAYOUT,
+  pageLayoutUniversalIdentifier: DOCFLOW_PAGE_LAYOUT_UNIVERSAL_IDENTIFIER,
+});

package/src/objects/document-folder.object.ts

@@ -0,0 +1,80 @@
+import { defineObject, FieldType } from 'twenty-sdk/define';
+
+import {
+  DOCUMENT_FOLDER_COLOR_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_FOLDER_NAME_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_FOLDER_OBJECT_UNIVERSAL_IDENTIFIER,
+} from 'src/universal-identifiers';
+
+export default defineObject({
+  universalIdentifier: DOCUMENT_FOLDER_OBJECT_UNIVERSAL_IDENTIFIER,
+  nameSingular: 'smbDocumentFolder',
+  namePlural: 'smbDocumentFolders',
+  labelSingular: 'Папка документов',
+  labelPlural: 'Папки документов',
+  description: 'Папка в дереве документов компании',
+  icon: 'IconFolder',
+  labelIdentifierFieldMetadataUniversalIdentifier:
+    DOCUMENT_FOLDER_NAME_UNIVERSAL_IDENTIFIER,
+  fields: [
+    {
+      universalIdentifier: DOCUMENT_FOLDER_NAME_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      label: 'Название',
+      icon: 'IconAbc',
+      name: 'name',
+    },
+    {
+      universalIdentifier: DOCUMENT_FOLDER_COLOR_UNIVERSAL_IDENTIFIER,
+      type: FieldType.SELECT,
+      label: 'Цвет',
+      icon: 'IconPalette',
+      name: 'color',
+      defaultValue: "'GRAY'",
+      options: [
+        {
+          id: 'cc211c98-25aa-4152-bf3a-683a94802991',
+          value: 'GRAY',
+          label: 'Серый',
+          position: 0,
+          color: 'gray',
+        },
+        {
+          id: '24d4e509-a5dd-4919-acaf-63b9eca5991b',
+          value: 'BLUE',
+          label: 'Синий',
+          position: 1,
+          color: 'blue',
+        },
+        {
+          id: 'e1a9b896-ded0-4153-ae31-275539e0f914',
+          value: 'GREEN',
+          label: 'Зелёный',
+          position: 2,
+          color: 'green',
+        },
+        {
+          id: '6932e1d5-8ad4-4a87-bb1e-b2f4f9a5bb37',
+          value: 'ORANGE',
+          label: 'Оранжевый',
+          position: 3,
+          color: 'orange',
+        },
+        {
+          id: '220fc4db-37fd-47ce-9754-133a6a7e3eeb',
+          value: 'RED',
+          label: 'Красный',
+          position: 4,
+          color: 'red',
+        },
+        {
+          id: '2516ec8c-9e1d-4eeb-993f-1791c908e35b',
+          value: 'PURPLE',
+          label: 'Фиолетовый',
+          position: 5,
+          color: 'purple',
+        },
+      ],
+    },
+  ],
+});

package/src/objects/document.object.ts

@@ -0,0 +1,312 @@
+import { defineObject, FieldType } from 'twenty-sdk/define';
+
+import {
+  DOCUMENT_DATE_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_DESCRIPTION_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_EDITOR_KIND_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_EDITOR_SNAPSHOT_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_FILE_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_NAME_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_NUMBER_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_OBJECT_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_ORIGIN_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_SOURCE_FILE_ID_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_SOURCE_OBJECT_NAME_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_SOURCE_RECORD_ID_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_SOURCE_RECORD_NAME_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_STATUS_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_TYPE_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_VALID_UNTIL_UNIVERSAL_IDENTIFIER,
+  DOCUMENT_WORKFLOW_RUN_ID_UNIVERSAL_IDENTIFIER,
+} from 'src/universal-identifiers';
+
+export default defineObject({
+  universalIdentifier: DOCUMENT_OBJECT_UNIVERSAL_IDENTIFIER,
+  nameSingular: 'smbDocument',
+  namePlural: 'smbDocuments',
+  labelSingular: 'Документ',
+  labelPlural: 'Документы',
+  description:
+    'Документ компании: файл, реквизиты, статус и откуда он пришёл в документы',
+  icon: 'IconFiles',
+  labelIdentifierFieldMetadataUniversalIdentifier:
+    DOCUMENT_NAME_UNIVERSAL_IDENTIFIER,
+  fields: [
+    {
+      universalIdentifier: DOCUMENT_NAME_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      label: 'Название',
+      icon: 'IconAbc',
+      name: 'name',
+    },
+    {
+      universalIdentifier: DOCUMENT_FILE_UNIVERSAL_IDENTIFIER,
+      type: FieldType.FILES,
+      label: 'Файл',
+      icon: 'IconPaperclip',
+      name: 'file',
+      universalSettings: { maxNumberOfValues: 1 },
+    },
+    {
+      universalIdentifier: DOCUMENT_STATUS_UNIVERSAL_IDENTIFIER,
+      type: FieldType.SELECT,
+      label: 'Статус',
+      icon: 'IconProgressCheck',
+      name: 'status',
+      defaultValue: "'DRAFT'",
+      options: [
+        {
+          id: 'a0e18a38-4cd3-417d-afb8-30ae5568adaf',
+          value: 'DRAFT',
+          label: 'Черновик',
+          position: 0,
+          color: 'gray',
+        },
+        {
+          id: '173d34b6-a325-4fe8-bf89-f3635efaf941',
+          value: 'IN_REVIEW',
+          label: 'На согласовании',
+          position: 1,
+          color: 'orange',
+        },
+        {
+          id: 'fe0a1f41-895c-4137-85c6-0315f9a375c6',
+          value: 'APPROVED',
+          label: 'Согласован',
+          position: 2,
+          color: 'green',
+        },
+        {
+          id: 'beb9ae41-787e-4dd8-82f6-2442f4a46209',
+          value: 'ARCHIVED',
+          label: 'В архиве',
+          position: 3,
+          color: 'blue',
+        },
+      ],
+    },
+    {
+      universalIdentifier: DOCUMENT_TYPE_UNIVERSAL_IDENTIFIER,
+      type: FieldType.SELECT,
+      label: 'Тип',
+      icon: 'IconTag',
+      name: 'documentType',
+      defaultValue: "'OTHER'",
+      options: [
+        {
+          id: '1c605c59-37d3-4acc-80ec-34fb2cc6251c',
+          value: 'CONTRACT',
+          label: 'Договор',
+          position: 0,
+          color: 'blue',
+        },
+        {
+          id: '9549a49f-8ef9-437c-a3d8-52776b68016f',
+          value: 'INVOICE',
+          label: 'Счёт',
+          position: 1,
+          color: 'green',
+        },
+        {
+          id: '67244616-4a2d-4db0-a48a-f891eccb7d2b',
+          value: 'ACT',
+          label: 'Акт',
+          position: 2,
+          color: 'turquoise',
+        },
+        {
+          id: '70fcc8e3-e779-4c63-b70d-1f035aed706e',
+          value: 'WAYBILL',
+          label: 'Накладная',
+          position: 3,
+          color: 'sky',
+        },
+        {
+          id: '85390ca1-6d61-4691-a347-4a4286bada77',
+          value: 'ORDER',
+          label: 'Приказ',
+          position: 4,
+          color: 'purple',
+        },
+        {
+          id: '499e28d6-52e5-47a0-9cb2-348b96192922',
+          value: 'LETTER',
+          label: 'Письмо',
+          position: 5,
+          color: 'orange',
+        },
+        {
+          id: '709b00c4-624e-4fac-9598-cdca9e92e9cd',
+          value: 'REPORT',
+          label: 'Отчёт',
+          position: 6,
+          color: 'pink',
+        },
+        {
+          id: '19aec623-2fea-42b5-ae02-9554bcda75fb',
+          value: 'OTHER',
+          label: 'Прочее',
+          position: 7,
+          color: 'gray',
+        },
+      ],
+    },
+    {
+      universalIdentifier: DOCUMENT_NUMBER_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      label: 'Номер',
+      icon: 'IconHash',
+      name: 'number',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: DOCUMENT_DATE_UNIVERSAL_IDENTIFIER,
+      type: FieldType.DATE,
+      label: 'Дата документа',
+      icon: 'IconCalendar',
+      name: 'documentDate',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: DOCUMENT_VALID_UNTIL_UNIVERSAL_IDENTIFIER,
+      type: FieldType.DATE,
+      label: 'Действует до',
+      icon: 'IconCalendarDue',
+      name: 'validUntil',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: DOCUMENT_DESCRIPTION_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      label: 'Описание',
+      icon: 'IconAlignLeft',
+      name: 'description',
+      isNullable: true,
+      defaultValue: null,
+    },
+    // Откуда документ пришёл (ADR-025 п.5): загружен в разделе или собран
+    // сервером из вложения записи либо задания процесса. Заполняет сервер.
+    {
+      universalIdentifier: DOCUMENT_ORIGIN_UNIVERSAL_IDENTIFIER,
+      type: FieldType.SELECT,
+      label: 'Источник',
+      icon: 'IconArrowFork',
+      name: 'origin',
+      defaultValue: "'UPLOAD'",
+      options: [
+        {
+          id: '589b6ce6-ed76-4572-8683-2ab62f89d0ad',
+          value: 'UPLOAD',
+          label: 'Загружен в документы',
+          position: 0,
+          color: 'gray',
+        },
+        {
+          id: '0c98e8c3-b61e-4bae-96fe-cb0083b74527',
+          value: 'RECORD',
+          label: 'Файл записи',
+          position: 1,
+          color: 'blue',
+        },
+        {
+          id: 'a33345ed-9a16-425e-bbee-0c43adaa3651',
+          value: 'PROCESS',
+          label: 'Процесс',
+          position: 2,
+          color: 'purple',
+        },
+      ],
+    },
+    {
+      universalIdentifier: DOCUMENT_SOURCE_OBJECT_NAME_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      label: 'Объект источника',
+      icon: 'IconBox',
+      name: 'sourceObjectName',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: DOCUMENT_SOURCE_RECORD_ID_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      label: 'Id записи источника',
+      icon: 'IconId',
+      name: 'sourceRecordId',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: DOCUMENT_SOURCE_RECORD_NAME_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      label: 'Где загружен',
+      icon: 'IconMapPin',
+      name: 'sourceRecordName',
+      isNullable: true,
+      defaultValue: null,
+    },
+    // Файл источника, из которого документ собран; по нему сбор не повторяется.
+    {
+      universalIdentifier: DOCUMENT_SOURCE_FILE_ID_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      label: 'Файл источника',
+      icon: 'IconFileSearch',
+      name: 'sourceFileId',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: DOCUMENT_WORKFLOW_RUN_ID_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      label: 'Запуск процесса',
+      icon: 'IconTopologyStar3',
+      name: 'workflowRunId',
+      isNullable: true,
+      defaultValue: null,
+    },
+    // Какой редактор открывает документ (ADR-016 п.8). Пока все значения
+    // показывает один просмотрщик файла, Univer добавится записью в реестр фронта.
+    {
+      universalIdentifier: DOCUMENT_EDITOR_KIND_UNIVERSAL_IDENTIFIER,
+      type: FieldType.SELECT,
+      label: 'Редактор',
+      icon: 'IconEdit',
+      name: 'editorKind',
+      defaultValue: "'NONE'",
+      options: [
+        {
+          id: '04188e00-de3f-4d7f-bfc9-a38703898f80',
+          value: 'NONE',
+          label: 'Файл',
+          position: 0,
+          color: 'gray',
+        },
+        {
+          id: '7120c842-3d38-4560-b434-7cdf48b5b799',
+          value: 'UNIVER_SHEET',
+          label: 'Таблица',
+          position: 1,
+          color: 'green',
+        },
+        {
+          id: 'ac29b1e1-b344-4b15-8701-27d537744ea4',
+          value: 'UNIVER_DOC',
+          label: 'Текст',
+          position: 2,
+          color: 'blue',
+        },
+      ],
+    },
+    {
+      universalIdentifier: DOCUMENT_EDITOR_SNAPSHOT_UNIVERSAL_IDENTIFIER,
+      type: FieldType.RAW_JSON,
+      label: 'Снимок редактора',
+      icon: 'IconBraces',
+      name: 'editorSnapshot',
+      isNullable: true,
+      defaultValue: null,
+    },
+  ],
+});

package/src/page-layouts/docflow.page-layout.ts

@@ -0,0 +1,86 @@
+import {
+  definePageLayout,
+  PageLayoutTabLayoutMode,
+  PageLayoutWidgetVerticalListHeightBehavior,
+} from 'twenty-sdk/define';
+
+import {
+  DOCFLOW_DOCUMENTS_TAB_UNIVERSAL_IDENTIFIER,
+  DOCFLOW_DOCUMENTS_WIDGET_UNIVERSAL_IDENTIFIER,
+  DOCFLOW_PAGE_LAYOUT_UNIVERSAL_IDENTIFIER,
+  DOCFLOW_PROCESSES_TAB_UNIVERSAL_IDENTIFIER,
+  DOCFLOW_PROCESSES_WIDGET_UNIVERSAL_IDENTIFIER,
+  DOCFLOW_TASKS_TAB_UNIVERSAL_IDENTIFIER,
+  DOCFLOW_TASKS_WIDGET_UNIVERSAL_IDENTIFIER,
+  DOCUMENTS_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+  PROCESSES_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+  TASKS_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+} from 'src/universal-identifiers';
+
+const buildTab = ({
+  universalIdentifier,
+  widgetUniversalIdentifier,
+  frontComponentUniversalIdentifier,
+  title,
+  icon,
+  position,
+}: {
+  universalIdentifier: string;
+  widgetUniversalIdentifier: string;
+  frontComponentUniversalIdentifier: string;
+  title: string;
+  icon: string;
+  position: number;
+}) => ({
+  universalIdentifier,
+  title,
+  position,
+  icon,
+  layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,
+  widgets: [
+    {
+      universalIdentifier: widgetUniversalIdentifier,
+      title: ' ',
+      type: 'FRONT_COMPONENT' as const,
+      heightBehavior: PageLayoutWidgetVerticalListHeightBehavior.TAB_VIEWPORT,
+      configuration: {
+        configurationType: 'FRONT_COMPONENT' as const,
+        frontComponentUniversalIdentifier,
+      },
+    },
+  ],
+});
+
+// The docflow page of the sidebar: the same three sections as the fork's
+// /docflow page, built from the app's front components.
+export default definePageLayout({
+  universalIdentifier: DOCFLOW_PAGE_LAYOUT_UNIVERSAL_IDENTIFIER,
+  name: 'Документооборот',
+  type: 'STANDALONE_PAGE',
+  tabs: [
+    buildTab({
+      universalIdentifier: DOCFLOW_TASKS_TAB_UNIVERSAL_IDENTIFIER,
+      widgetUniversalIdentifier: DOCFLOW_TASKS_WIDGET_UNIVERSAL_IDENTIFIER,
+      frontComponentUniversalIdentifier: TASKS_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+      title: 'Задания',
+      icon: 'IconChecklist',
+      position: 0,
+    }),
+    buildTab({
+      universalIdentifier: DOCFLOW_PROCESSES_TAB_UNIVERSAL_IDENTIFIER,
+      widgetUniversalIdentifier: DOCFLOW_PROCESSES_WIDGET_UNIVERSAL_IDENTIFIER,
+      frontComponentUniversalIdentifier: PROCESSES_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+      title: 'Процессы',
+      icon: 'IconTopologyStar3',
+      position: 1,
+    }),
+    buildTab({
+      universalIdentifier: DOCFLOW_DOCUMENTS_TAB_UNIVERSAL_IDENTIFIER,
+      widgetUniversalIdentifier: DOCFLOW_DOCUMENTS_WIDGET_UNIVERSAL_IDENTIFIER,
+      frontComponentUniversalIdentifier: DOCUMENTS_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+      title: 'Документы',
+      icon: 'IconFileText',
+      position: 2,
+    }),
+  ],
+});

package/src/page-layouts/task-docflow.page-layout-tab.ts

@@ -0,0 +1,36 @@
+import {
+  definePageLayoutTab,
+  PageLayoutTabLayoutMode,
+  PageLayoutWidgetVerticalListHeightBehavior,
+  STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+
+import {
+  TASK_FORM_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+  TASK_RECORD_DOCFLOW_TAB_UNIVERSAL_IDENTIFIER,
+  TASK_RECORD_DOCFLOW_WIDGET_UNIVERSAL_IDENTIFIER,
+} from 'src/universal-identifiers';
+
+// "Задание" tab on the standard task page: instruction, the task's own fields
+// and completing it, the same panel as on the docflow page.
+export default definePageLayoutTab({
+  universalIdentifier: TASK_RECORD_DOCFLOW_TAB_UNIVERSAL_IDENTIFIER,
+  pageLayoutUniversalIdentifier:
+    STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.taskRecordPage.universalIdentifier,
+  title: 'Задание',
+  position: 50,
+  icon: 'IconChecklist',
+  layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,
+  widgets: [
+    {
+      universalIdentifier: TASK_RECORD_DOCFLOW_WIDGET_UNIVERSAL_IDENTIFIER,
+      title: ' ',
+      type: 'FRONT_COMPONENT',
+      heightBehavior: PageLayoutWidgetVerticalListHeightBehavior.TAB_VIEWPORT,
+      configuration: {
+        configurationType: 'FRONT_COMPONENT',
+        frontComponentUniversalIdentifier: TASK_FORM_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+      },
+    },
+  ],
+});

package/src/page-layouts/workflow-steps.page-layout-tab.ts

@@ -0,0 +1,37 @@
+import {
+  definePageLayoutTab,
+  PageLayoutTabLayoutMode,
+  PageLayoutWidgetVerticalListHeightBehavior,
+  STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk/define';
+
+import {
+  PROCESS_STEPS_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+  WORKFLOW_RECORD_STEPS_TAB_UNIVERSAL_IDENTIFIER,
+  WORKFLOW_RECORD_STEPS_WIDGET_UNIVERSAL_IDENTIFIER,
+} from 'src/universal-identifiers';
+
+// "Запуск и задания" tab on the standard workflow page: the parameters asked
+// before the launch, and who fills each "Human input" step, by when, which
+// fields are required.
+export default definePageLayoutTab({
+  universalIdentifier: WORKFLOW_RECORD_STEPS_TAB_UNIVERSAL_IDENTIFIER,
+  pageLayoutUniversalIdentifier:
+    STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS.workflowRecordPage.universalIdentifier,
+  title: 'Запуск и задания',
+  position: 50,
+  icon: 'IconPlayerPlay',
+  layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,
+  widgets: [
+    {
+      universalIdentifier: WORKFLOW_RECORD_STEPS_WIDGET_UNIVERSAL_IDENTIFIER,
+      title: ' ',
+      type: 'FRONT_COMPONENT',
+      heightBehavior: PageLayoutWidgetVerticalListHeightBehavior.FIT_CONTENT,
+      configuration: {
+        configurationType: 'FRONT_COMPONENT',
+        frontComponentUniversalIdentifier: PROCESS_STEPS_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+      },
+    },
+  ],
+});

package/src/roles/default-role.ts

@@ -0,0 +1,21 @@
+import {
+  defineApplicationRole,
+  SystemPermissionFlag,
+} from 'twenty-sdk/define';
+
+// What the app's functions may do when nobody is behind a run (record
+// events, the Bitrix24 portal): hand out process tasks, collect documents.
+// A run a person triggered is further narrowed to that person's rights.
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+  '26b1dde8-4ed9-4f39-8516-e0dcb734ea5a';
+
+export default defineApplicationRole({
+  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  label: 'Документооборот: функции приложения',
+  description: 'Права серверных функций приложения «Документооборот»',
+  canReadAllObjectRecords: true,
+  canUpdateAllObjectRecords: true,
+  canSoftDeleteAllObjectRecords: false,
+  canDestroyAllObjectRecords: false,
+  permissionFlagUniversalIdentifiers: [SystemPermissionFlag.WORKFLOWS],
+});

package/src/roles/docflow-member.role.ts

@@ -0,0 +1,23 @@
+import { defineRole, SystemPermissionFlag } from 'twenty-sdk/define';
+
+import { DOCFLOW_MEMBER_ROLE_UNIVERSAL_IDENTIFIER } from 'src/universal-identifiers';
+
+// Twenty lets only a person with the "Workflows" permission answer a step of
+// a running process. Whoever fills process tasks or launches processes with
+// parameters on a plain Twenty needs this role (or the permission in their
+// own role). It also lets them edit processes: give it to those who own them.
+export default defineRole({
+  universalIdentifier: DOCFLOW_MEMBER_ROLE_UNIVERSAL_IDENTIFIER,
+  label: 'Документооборот: участник процессов',
+  description:
+    'Записи CRM и право «Рабочие процессы», без которого Twenty не даёт отвечать на шаги процессов',
+  canBeAssignedToUsers: true,
+  canBeAssignedToAgents: false,
+  canBeAssignedToApiKeys: false,
+  canReadAllObjectRecords: true,
+  canUpdateAllObjectRecords: true,
+  canSoftDeleteAllObjectRecords: true,
+  canDestroyAllObjectRecords: false,
+  canUpdateAllSettings: false,
+  permissionFlagUniversalIdentifiers: [SystemPermissionFlag.WORKFLOWS],
+});