From d00ee99ab162656f984684f93c3a7d114f7a62ab Mon Sep 17 00:00:00 2001 From: romanskijdev Date: Mon, 22 Jun 2026 22:42:04 +0300 Subject: [PATCH] Added flow nodes page && tree guide page --- .env | 2 +- src/App.tsx | 4 + src/api/flowNodes.ts | 72 + src/api/topics.ts | 7 + src/features/flowNodes/hooks/useFlowNodes.ts | 158 +++ .../components/CategoryEditModal.tsx | 6 +- src/pages/flowNodes/FlowTreeGuidePage.tsx | 1198 +++++++++++++++++ src/pages/flowNodes/FlowTreePage.tsx | 402 ++++++ .../components/DataFlowExplainer.tsx | 463 +++++++ .../components/FlowNodeEditModal.tsx | 517 +++++++ .../flowNodes/components/FlowTreeNode.tsx | 227 ++++ .../components/HierarchyEditModal.tsx | 2 +- .../topics/components/TopicEditModal.tsx | 8 + src/types/api.ts | 24 + 14 files changed, 3085 insertions(+), 5 deletions(-) create mode 100644 src/api/flowNodes.ts create mode 100644 src/features/flowNodes/hooks/useFlowNodes.ts create mode 100644 src/pages/flowNodes/FlowTreeGuidePage.tsx create mode 100644 src/pages/flowNodes/FlowTreePage.tsx create mode 100644 src/pages/flowNodes/components/DataFlowExplainer.tsx create mode 100644 src/pages/flowNodes/components/FlowNodeEditModal.tsx create mode 100644 src/pages/flowNodes/components/FlowTreeNode.tsx diff --git a/.env b/.env index 66c28ec..9047958 100644 --- a/.env +++ b/.env @@ -1,5 +1,5 @@ # API Configuration -#VITE_API_BASE_URL=http://localhost:1726/api +VITE_API_BASE_URL=http://localhost:1726/api VITE_API_KEY=test VITE_API_PUBLIC_KEY=ruspet_public_key_2026 VITE_API_PRIVATE_KEY=ruspet_private_key_SUPER_SECRET_2026 diff --git a/src/App.tsx b/src/App.tsx index 0f95736..b3e8d4e 100644 --- a/src/App.tsx +++ b/src/App.tsx @@ -17,6 +17,8 @@ import TopicsPage from "@/pages/topics/TopicsPage.tsx"; import SettingsPage from './pages/settings/SettingsPage' import AdminsPage from './pages/admins/AdminsPage' import ApprovalTasksPage from './pages/approvalTasks/ApprovalTasksPage' +import FlowTreePage from "@/pages/flowNodes/FlowTreePage.tsx"; +import FlowTreeGuidePage from './pages/flowNodes/FlowTreeGuidePage' const Placeholder = ({ title }: { title: string }) => (
@@ -52,6 +54,7 @@ function App() { } /> } /> } /> + } /> } /> } /> } /> @@ -64,6 +67,7 @@ function App() { } /> } /> } /> + } /> ) diff --git a/src/api/flowNodes.ts b/src/api/flowNodes.ts new file mode 100644 index 0000000..a5151fd --- /dev/null +++ b/src/api/flowNodes.ts @@ -0,0 +1,72 @@ +import apiClient from './client' +import type { ApprovalFlowNode, ApiResponse } from '@/types/api' + +export interface CreateFlowNodeRequest { + topic_id: number + parent_id?: number | null + key: string + label: string + data_key?: string | null + data_value?: string | null + is_input?: boolean + input_key?: string | null + input_hint?: string | null + is_multi_select?: boolean + multi_select_key?: string | null + multi_select_value?: string | null + topic_code?: string | null + sort_order?: number +} + +export interface UpdateFlowNodeRequest { + id: number + topic_id?: number + parent_id?: number | null + key?: string + label?: string + data_key?: string | null + data_value?: string | null + is_input?: boolean + input_key?: string | null + input_hint?: string | null + is_multi_select?: boolean + multi_select_key?: string | null + multi_select_value?: string | null + topic_code?: string | null + sort_order?: number +} + +export interface MoveFlowNodeRequest { + new_parent_id?: number | null + new_sort_order?: number +} + +export interface SaveTreeRequest { + nodes: ApprovalFlowNode[] +} + +export const flowNodesApi = { + getTree: (topicId: number) => + apiClient.get>(`/flow-nodes/topic/${topicId}`), + + getById: (id: number) => + apiClient.get(`/flow-nodes/${id}`), + + create: (data: CreateFlowNodeRequest) => + apiClient.post('/flow-nodes/', data), + + update: (data: UpdateFlowNodeRequest) => + apiClient.put('/flow-nodes/', data), + + delete: (id: number) => + apiClient.delete('/flow-nodes/', { data: { id } }), + + saveTree: (topicId: number, data: SaveTreeRequest) => + apiClient.post(`/flow-nodes/topic/${topicId}/tree`, data), + + move: (id: number, data: MoveFlowNodeRequest) => + apiClient.post(`/flow-nodes/${id}/move`, data), + + duplicate: (id: number) => + apiClient.post(`/flow-nodes/${id}/duplicate`, {}), +} \ No newline at end of file diff --git a/src/api/topics.ts b/src/api/topics.ts index 333cb6c..b309b6a 100644 --- a/src/api/topics.ts +++ b/src/api/topics.ts @@ -8,6 +8,7 @@ export interface TopicsListParams { is_active?: boolean name?: string code?: string + is_tree_root?: boolean } export interface CreateTopicRequest { @@ -16,6 +17,7 @@ export interface CreateTopicRequest { code: string duration_type?: string time_type?: string + is_tree_root?: boolean payment_type?: string template?: string | null allows_file?: boolean @@ -28,6 +30,8 @@ export interface CreateTopicRequest { requires_file?: boolean require_observer_selection?: boolean instructions?: string | null + message_template?: string | null + code_template?: string | null } export interface UpdateTopicRequest { @@ -38,6 +42,7 @@ export interface UpdateTopicRequest { duration_type?: string time_type?: string payment_type?: string + is_tree_root?: boolean template?: string | null allows_file?: boolean is_active?: boolean @@ -49,6 +54,8 @@ export interface UpdateTopicRequest { requires_file?: boolean require_observer_selection?: boolean instructions?: string | null + message_template?: string | null + code_template?: string | null } export const topicsApi = { diff --git a/src/features/flowNodes/hooks/useFlowNodes.ts b/src/features/flowNodes/hooks/useFlowNodes.ts new file mode 100644 index 0000000..4c6c0e9 --- /dev/null +++ b/src/features/flowNodes/hooks/useFlowNodes.ts @@ -0,0 +1,158 @@ +import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query' +import { + flowNodesApi, + type CreateFlowNodeRequest, + type UpdateFlowNodeRequest, + type MoveFlowNodeRequest, + type SaveTreeRequest, +} from '@/api/flowNodes' +import { notifications } from '@mantine/notifications' + +export const FLOW_NODES_QUERY_KEY = 'flowNodes' + +export function useFlowNodesTree(topicId: number | null) { + return useQuery({ + queryKey: [FLOW_NODES_QUERY_KEY, topicId], + queryFn: async () => { + if (!topicId) return null + const response = await flowNodesApi.getTree(topicId) + return response.data + }, + enabled: !!topicId, + }) +} + +export function useCreateFlowNode() { + const queryClient = useQueryClient() + + return useMutation({ + mutationFn: (data: CreateFlowNodeRequest) => flowNodesApi.create(data), + onSuccess: () => { + queryClient.invalidateQueries({ queryKey: [FLOW_NODES_QUERY_KEY] }) + notifications.show({ + title: 'Успешно', + message: 'Узел создан', + color: 'green', + }) + }, + onError: (error: any) => { + notifications.show({ + title: 'Ошибка', + message: error.response?.data?.error_description || 'Не удалось создать узел', + color: 'red', + }) + }, + }) +} + +export function useUpdateFlowNode() { + const queryClient = useQueryClient() + + return useMutation({ + mutationFn: (data: UpdateFlowNodeRequest) => flowNodesApi.update(data), + onSuccess: () => { + queryClient.invalidateQueries({ queryKey: [FLOW_NODES_QUERY_KEY] }) + notifications.show({ + title: 'Успешно', + message: 'Узел обновлён', + color: 'green', + }) + }, + onError: (error: any) => { + notifications.show({ + title: 'Ошибка', + message: error.response?.data?.error_description || 'Не удалось обновить узел', + color: 'red', + }) + }, + }) +} + +export function useDeleteFlowNode() { + const queryClient = useQueryClient() + + return useMutation({ + mutationFn: (id: number) => flowNodesApi.delete(id), + onSuccess: () => { + queryClient.invalidateQueries({ queryKey: [FLOW_NODES_QUERY_KEY] }) + notifications.show({ + title: 'Успешно', + message: 'Узел удалён', + color: 'green', + }) + }, + onError: (error: any) => { + notifications.show({ + title: 'Ошибка', + message: error.response?.data?.error_description || 'Не удалось удалить узел', + color: 'red', + }) + }, + }) +} + +export function useSaveFlowTree() { + const queryClient = useQueryClient() + + return useMutation({ + mutationFn: ({ topicId, data }: { topicId: number; data: SaveTreeRequest }) => + flowNodesApi.saveTree(topicId, data), + onSuccess: () => { + queryClient.invalidateQueries({ queryKey: [FLOW_NODES_QUERY_KEY] }) + notifications.show({ + title: 'Успешно', + message: 'Дерево сохранено', + color: 'green', + }) + }, + onError: (error: any) => { + notifications.show({ + title: 'Ошибка', + message: error.response?.data?.error_description || 'Не удалось сохранить дерево', + color: 'red', + }) + }, + }) +} + +export function useMoveFlowNode() { + const queryClient = useQueryClient() + + return useMutation({ + mutationFn: ({ id, data }: { id: number; data: MoveFlowNodeRequest }) => + flowNodesApi.move(id, data), + onSuccess: () => { + queryClient.invalidateQueries({ queryKey: [FLOW_NODES_QUERY_KEY] }) + }, + onError: (error: any) => { + notifications.show({ + title: 'Ошибка', + message: error.response?.data?.error_description || 'Не удалось переместить узел', + color: 'red', + }) + }, + }) +} + +export function useDuplicateFlowNode() { + const queryClient = useQueryClient() + + return useMutation({ + mutationFn: (id: number) => flowNodesApi.duplicate(id), + onSuccess: () => { + queryClient.invalidateQueries({ queryKey: [FLOW_NODES_QUERY_KEY] }) + notifications.show({ + title: 'Успешно', + message: 'Узел дублирован', + color: 'green', + }) + }, + onError: (error: any) => { + notifications.show({ + title: 'Ошибка', + message: error.response?.data?.error_description || 'Не удалось дублировать узел', + color: 'red', + }) + }, + }) +} \ No newline at end of file diff --git a/src/pages/categories/components/CategoryEditModal.tsx b/src/pages/categories/components/CategoryEditModal.tsx index 8290373..21b77b5 100644 --- a/src/pages/categories/components/CategoryEditModal.tsx +++ b/src/pages/categories/components/CategoryEditModal.tsx @@ -45,10 +45,10 @@ export default function CategoryEditModal({ is_active: true, }, validate: { - name: (value) => (value.length < 2 ? 'Название должно содержать минимум 2 символа' : null), - code: (value) => { + name: (value: string | any[]) => (value.length < 2 ? 'Название должно содержать минимум 2 символа' : null), + code: (value: string | any[]) => { if (value.length < 2) return 'Код должен содержать минимум 2 символа' - if (!/^[a-z0-9_]+$/.test(value)) return 'Код должен содержать только lowercase буквы, цифры и подчеркивания' + if (!/^[a-z0-9_]+$/.test(value as string)) return 'Код должен содержать только lowercase буквы, цифры и подчеркивания' return null }, }, diff --git a/src/pages/flowNodes/FlowTreeGuidePage.tsx b/src/pages/flowNodes/FlowTreeGuidePage.tsx new file mode 100644 index 0000000..6fd1596 --- /dev/null +++ b/src/pages/flowNodes/FlowTreeGuidePage.tsx @@ -0,0 +1,1198 @@ +import { useState, useEffect } from 'react' +import { + Stack, + Text, + Code, + Paper, + Group, + Box, + Title, + Table, + Divider, + Anchor, + ActionIcon, + Tooltip, + CopyButton, + ScrollArea, + Badge, + Alert, + UnstyledButton, +} from '@mantine/core' +import { + IconArrowLeft, + IconCopy, + IconCheck, + IconChevronRight, +} from '@tabler/icons-react' +import { useNavigate } from 'react-router-dom' + +// ================================================================ +// Структура документации +// ================================================================ + +interface DocSection { + id: string + title: string + level: number +} + +const SECTIONS: DocSection[] = [ + { id: 'overview', title: 'Обзор', level: 1 }, + { id: 'architecture', title: 'Архитектура', level: 1 }, + { id: 'data-model', title: 'Модель данных', level: 1 }, + { id: 'node-types', title: 'Типы узлов', level: 1 }, + { id: 'node-button', title: ' Кнопка', level: 2 }, + { id: 'node-input', title: ' Текстовый ввод', level: 2 }, + { id: 'node-multiselect', title: ' Мультиселект', level: 2 }, + { id: 'data-flow', title: 'Поток данных', level: 1 }, + { id: 'collected', title: 'Структура collected', level: 1 }, + { id: 'templates', title: 'Шаблонизация', level: 1 }, + { id: 'message-template', title: ' message_template', level: 2 }, + { id: 'code-template', title: ' code_template', level: 2 }, + { id: 'syntax', title: 'Синтаксис шаблонов', level: 1 }, + { id: 'variables', title: 'Справочник переменных', level: 1 }, + { id: 'examples', title: 'Примеры конфигураций', level: 1 }, + { id: 'constraints', title: 'Ограничения и валидация', level: 1 }, + { id: 'troubleshooting', title: 'Диагностика ошибок', level: 1 }, +] + +export default function FlowTreeGuidePage() { + const navigate = useNavigate() + const [activeSection, setActiveSection] = useState('overview') + + // Отслеживание активной секции при скролле + useEffect(() => { + const handleScroll = () => { + const scrollPosition = window.scrollY + 100 + for (const section of [...SECTIONS].reverse()) { + const element = document.getElementById(section.id) + if (element && element.offsetTop <= scrollPosition) { + setActiveSection(section.id) + break + } + } + } + window.addEventListener('scroll', handleScroll) + return () => window.removeEventListener('scroll', handleScroll) + }, []) + + const scrollTo = (id: string) => { + document.getElementById(id)?.scrollIntoView({ behavior: 'smooth', block: 'start' }) + setActiveSection(id) + } + + return ( + + {/* ============================================================ */} + {/* Sidebar с навигацией */} + {/* ============================================================ */} + + + + + Документация + + navigate('/nodes')} + > + + + + + + + {SECTIONS.map((section) => ( + scrollTo(section.id)} + px={section.level === 2 ? 20 : 12} + py={6} + style={{ + borderRadius: 4, + backgroundColor: + activeSection === section.id + ? 'var(--mantine-color-blue-0)' + : 'transparent', + borderLeft: + activeSection === section.id + ? '2px solid var(--mantine-color-blue-6)' + : '2px solid transparent', + }} + > + + {section.title} + + + ))} + + + + + + {/* ============================================================ */} + {/* Основной контент */} + {/* ============================================================ */} + + + {/* Заголовок документа */} + + + v1.0 + Обновлено: 22 июня 2026 + + Конструктор деревьев навигации + + Техническая документация по настройке деревьев навигации для системы + согласования заявок. Описывает архитектуру, модель данных, синтаксис + шаблонов и примеры конфигураций. + + + + + + {/* ============================================================ */} + {/* 1. ОБЗОР */} + {/* ============================================================ */} + + + + Дерево навигации — иерархическая структура узлов, определяющая последовательность + шагов, которые проходит пользователь при создании заявки в Telegram-боте. Каждый + узел дерева представляет собой либо кнопку выбора значения, либо поле ввода + произвольного текста. + + + + Система предназначена для конфигурирования произвольных бизнес-процессов + согласования без изменения исходного кода сервиса. Администратор создаёт дерево + через веб-интерфейс, а бот динамически строит интерфейс на основе этой + конфигурации. + + + + Деревья используются для тем согласования: отпуска, внебюджетные расходы, + возвраты, изменения клиентов и прочие бизнес-процессы, требующие сбора + структурированных данных от пользователя перед отправкой на согласование. + + + {/* ============================================================ */} + {/* 2. АРХИТЕКТУРА */} + {/* ============================================================ */} + + + + Система состоит из трёх уровней сущностей: + + + + + + Уровень + Сущность + Назначение + + + + + + approval_topic_categories + + Категория + + Группировка тем. Отображается как кнопка первого уровня в меню бота. + + + + + approval_topics + + Тема + + Конкретный тип согласования. Содержит настройки, шаблоны сообщений + и код для идентификации. + + + + + approval_flow_nodes + + Узел дерева + + Отдельный шаг навигации: кнопка, поле ввода или мультиселект. + Связан с темой через topic_id. + + + +
+ + + Узлы образуют древовидную структуру через поле parent_id. Корневой + узел имеет parent_id = NULL. Порядок отображения узлов одного + уровня определяется полем sort_order. + + + + + {/* ============================================================ */} + {/* 3. МОДЕЛЬ ДАННЫХ */} + {/* ============================================================ */} + + + + Структура таблицы approval_flow_nodes: + + + + + + Поле + Тип + Описание + + + + + id + BIGINT PK + Уникальный идентификатор узла + + + topic_id + BIGINT FK + Ссылка на тему согласования + + + parent_id + BIGINT FK NULL + Ссылка на родительский узел. NULL для корня + + + key + TEXT NOT NULL + + Уникальный в рамках темы идентификатор узла. Используется + системой для навигации + + + + label + TEXT NOT NULL + Текст, отображаемый пользователю + + + data_key + TEXT NULL + + Имя переменной, в которую сохраняется data_value при + выборе узла + + + + data_value + TEXT NULL + Значение, сохраняемое в data_key + + + is_input + BOOLEAN + Признак узла текстового ввода + + + input_key + TEXT NULL + Ключ для сохранения введённого текста (обычно content) + + + input_hint + TEXT NULL + Подсказка-шаблон для пользователя + + + is_multi_select + BOOLEAN + Признак узла мультиселекта + + + multi_select_key + TEXT NULL + Ключ для сохранения выбранных значений + + + multi_select_value + TEXT NULL + Значение данного варианта мультиселекта + + + topic_code + TEXT NULL + + Код темы для проверки прав доступа. Если задан — узел отображается + только пользователям с правом create на указанную тему + + + + sort_order + INTEGER + Порядок сортировки среди узлов одного родителя + + +
+ + + На таблицу наложен уникальный индекс UNIQUE(topic_id, key). Это + гарантирует, что в рамках одной темы не существует двух узлов с одинаковым + key. Нарушение этого условия приведёт к ошибке + SQLSTATE 23505 при сохранении. + + + {/* ============================================================ */} + {/* 4. ТИПЫ УЗЛОВ */} + {/* ============================================================ */} + + + + Система поддерживает три типа узлов, определяемых комбинацией булевых полей + is_input и is_multi_select. + + + + + + Тип + is_input + is_multi_select + Назначение + + + + + Кнопка + false + false + Выбор значения и переход к следующему шагу + + + Текстовый ввод + true + false + Ввод произвольного текста пользователем + + + Мультиселект + false + true + Выбор нескольких значений из списка + + +
+ + + + + Базовый тип узла. При выборе кнопки система записывает в контекст пользователя + пару data_key = data_value и переходит к дочерним узлам. + + + Обязательные поля: + + + + Поле + Требования + Пример + + + + + key + Уникальный в теме, snake_case + crimea + + + label + Непустая строка + Крым + + + data_key + snake_case, осмысленное имя + region + + + data_value + snake_case, уникальное в рамках data_key + crimea + + +
+ + + Все дочерние узлы одного родителя должны иметь одинаковое значение{' '} + data_key, но различные data_value. Это необходимо + для корректной работы шаблонизации: система ожидает, что по ключу{' '} + region будет получено ровно одно значение. + + + + + + Терминальный узел, запрашивающий у пользователя произвольный текст. Введённый + текст сохраняется в контекст по ключу input_key. + + + Обязательные поля: + + + + Поле + Требования + Пример + + + + + input_key + Обычно content + content + + + input_hint + Конкретный пример заполнения + Опишите изменения: текущие → новые + + +
+ + + Каждый путь от корня до листа дерева должен заканчиваться узлом типа «Текстовый + ввод». Отсутствие такого узла приведёт к невозможности завершения создания + заявки. + + + + + + Специализированный узел, позволяющий пользователю выбрать несколько значений + одновременно. Все выбранные значения сохраняются через запятую в ключ + multi_select_key. + + + Обязательные поля: + + + + Поле + Требования + Пример + + + + + multi_select_key + Одинаковый для всех дочерних узлов + systems + + + multi_select_value + Уникальный для каждого дочернего узла + okb, 1c + + +
+ + + При выборе нескольких значений формируется строка вида{' '} + systems = "okb,1c". Автоматически создаётся производная + переменная systems_label, содержащая человекочитаемые названия + через запятую: "ОКБ, 1С". + + + {/* ============================================================ */} + {/* 5. ПОТОК ДАННЫХ */} + {/* ============================================================ */} + + + + При прохождении пользователем дерева навигации формируется контекст + collected — ассоциативный массив, аккумулирующий все выбранные + значения. Процесс состоит из следующих этапов: + + + + + + + + + + + + + {/* ============================================================ */} + {/* 6. СТРУКТУРА COLLECTED */} + {/* ============================================================ */} + + + + Контекст collected — это map[string]string, содержащий + все данные, собранные в процессе прохождения дерева. Структура формируется + детерминированно на основе конфигурации узлов. + + + + + + Переменные с суффиксом _label формируются автоматически и не + требуют явного указания в дереве. Их значения соответствуют полю{' '} + label узла, в котором был задан соответствующий{' '} + data_key. + + + + Ключ content зарезервирован для текста заявки, вводимого + пользователем. Ключ instructions заполняется автоматически из + поля instructions темы, если оно задано. + + + {/* ============================================================ */} + {/* 7. ШАБЛОНИЗАЦИЯ */} + {/* ============================================================ */} + + + + Шаблоны используют синтаксис text/template стандартной библиотеки + Go. Шаблоны хранятся в таблице approval_topics в полях + message_template и code_template. + + + + + + Определяет формат сообщения, отправляемого согласующему в Telegram. Поддерживает + HTML-разметку (<b>, <i>,{' '} + <code>). + + + Менеджерские расходы — {{.region_label}} + +{{.initiator_name}}: +{{.content}}`} + /> + + + + + Определяет алгоритм формирования кода темы на основе collected. + Полученный код используется для поиска записи в таблице{' '} + approval_topics. Если шаблон не задан, код формируется + автоматически конкатенацией всех значений collected через + символ подчёркивания. + + + + + + Результат применения code_template должен точно соответствовать + значению поля code существующей записи в{' '} + approval_topics. В противном случае система вернёт ошибку + approval topic not found. + + + {/* ============================================================ */} + {/* 8. СИНТАКСИС */} + {/* ============================================================ */} + + + + Доступные конструкции языка шаблонов: + + + + + + Конструкция + Семантика + + + + + {`{{.key}}`} + Вывод значения переменной + + + {`{{if .key}}...{{end}}`} + Условный вывод (проверяется непустота) + + + + {`{{if eq .key "val"}}A{{else}}B{{end}}`} + + Ветвление по значению + + + + {`{{if ...}}...{{else if ...}}...{{else}}...{{end}}`} + + Множественное ветвление + + + {`{{trimPrefix .key "prefix"}}`} + Удаление префикса из значения + + + {`{{trimSuffix .key "suffix"}}`} + Удаление суффикса из значения + + + {`{{toUpper .key}}`} + Приведение к верхнему регистру + + + {`{{toLower .key}}`} + Приведение к нижнему регистру + + + {`{{contains .key "substr"}}`} + Проверка вхождения подстроки + + +
+ + + При обращении к несуществующему ключу шаблонизатор выводит строку{' '} + <no value>. Это признак ошибки конфигурации: либо в дереве + отсутствует узел с соответствующим data_key, либо пользователь + не прошёл необходимый шаг. + + + {/* ============================================================ */} + {/* 9. СПРАВОЧНИК ПЕРЕМЕННЫХ */} + {/* ============================================================ */} + + + + Переменные, доступные в шаблонах, делятся на две категории: встроенные + (предоставляются системой) и пользовательские (формируются из дерева). + + + Встроенные переменные + + + + Переменная + Источник + Описание + + + + + initiator_name + Таблица users + ФИО пользователя, создавшего заявку + + + topic_name + Таблица approval_topics + Название темы + + + content + Текстовый ввод пользователя + Основной текст заявки + + + instructions + Поле instructions темы + Инструкция для согласующего + + +
+ + Пользовательские переменные + + Формируются на основе data_key узлов дерева. Для каждого + data_key автоматически создаётся производная переменная с суффиксом + _label. + + + + + + Переменная + Типичное значение + Описание + + + + + region + crimea, krasnodar + Идентификатор региона + + + region_label + Крым, Краснодар + Человекочитаемое название региона + + + branch + f1, f2 + Идентификатор филиала + + + payment_type + own_expense + Тип оплаты + + + systems + okb,1c + Выбранные системы (мультиселект) + + + systems_label + ОКБ, 1С + Названия выбранных систем + + +
+ + {/* ============================================================ */} + {/* 10. ПРИМЕРЫ */} + {/* ============================================================ */} + + + + Ниже приведены типовые конфигурации для различных сценариев. Шаблоны могут + быть скопированы и адаптированы под конкретные требования. + + + {/* Пример 1 */} + 10.1. Простая тема с выбором региона + + Сценарий: пользователь выбирает регион, затем вводит текст заявки. + + + + + Менеджерские расходы — {{.region_label}} + +{{.initiator_name}}: +{{.content}}`} + /> + + + + {/* Пример 2 */} + 10.2. Многоуровневая тема с условной логикой + + Сценарий: филиал → тип расхода → признак ПП → ввод. Формат кода темы + зависит от наличия признака ПП. + + + + + Внебюджетные расходы — {{.branch_label}} ({{.expense_type_label}}) +{{if .pp_required}}💳 ПП: {{.pp_required_label}}{{end}} + +{{.initiator_name}}: +{{.content}}`} + /> + + + + {/* Пример 3 */} + 10.3. Тема с мультиселектом + + Сценарий: пользователь выбирает несколько систем одновременно. + + + + + Изменение клиентов: {{.change_type_label}} +🖥 Системы: {{.systems_label}} +📍 Регион: {{.region_label}} + +{{.initiator_name}}: +{{.content}}`} + /> + + + + {/* Пример 4 */} + 10.4. Составная тема с множественными сценариями + + Сценарий: единая тема объединяет несколько подтипов (отпуск, отгул, + больничный) с различным форматированием сообщений. + + + Тип: Отгул + +{{.initiator_name}}: прошу согласовать отгул +{{.content}} +{{.payment_type_label}} +{{else if eq .absence_type "vacation"}}📋 Тип: Отпуск + +{{.initiator_name}}: прошу согласовать отпуск +{{.content}} +{{.payment_type_label}} +{{else if eq .absence_type "sickleave"}}📋 Тип: Официальный больничный + +{{.initiator_name}}: прошу согласовать больничный +{{if .open_date}}Дата открытия: {{.open_date}}. +{{end}}{{.content}} +{{.payment_type_label}} +{{end}}`} + /> + + + + {/* ============================================================ */} + {/* 11. ОГРАНИЧЕНИЯ */} + {/* ============================================================ */} + + + + При конфигурации деревьев необходимо соблюдать следующие ограничения: + + + + + + № + Ограничение + Обоснование + + + + + 1 + Уникальность key в рамках темы + + Обеспечивается уникальным индексом (topic_id, key). + Нарушение приводит к ошибке SQLSTATE 23505. + + + + 2 + + Единообразие data_key на одном уровне + + + Все дочерние узлы одного родителя должны иметь одинаковый{' '} + data_key. В противном случае в collected{' '} + появятся конфликтующие значения. + + + + 3 + + Уникальность data_value среди братьев + + + Система не сможет различить узлы с одинаковыми data_key{' '} + и data_value. + + + + 4 + Терминальность путей + + Каждый путь от корня до листа должен заканчиваться узлом типа + «Текстовый ввод». + + + + 5 + Отсутствие циклов + + parent_id не может указывать на собственный узел или + его потомка. Проверяется при операциях перемещения. + + + + 6 + Формат key, data_key, data_value + + Только строчные латинские буквы, цифры и символ подчёркивания + (snake_case). + + + + 7 + Согласованность code_template с БД + + Результат применения шаблона должен соответствовать существующей + записи в approval_topics. + + + +
+ + {/* ============================================================ */} + {/* 12. ДИАГНОСТИКА */} + {/* ============================================================ */} + + + + Типовые ошибки и методы их устранения: + + + + + + + + + + + + + + + Конец документации. По вопросам конфигурации обращаться к разработчикам системы. + +
+
+
+ ) +} + +// ================================================================ +// Вспомогательные компоненты +// ================================================================ + +function DocSection({ id, title, level = 1 }: { id: string; title: string; level?: number }) { + return ( + + {level === 1 ? ( + {title} + ) : ( + {title} + )} + + ) +} + +function CodeBlock({ title, code }: { title: string; code: string }) { + return ( + + + {title} + + {({ copied, copy }) => ( + + + {copied ? : } + + + )} + + + + + {code} + + + + ) +} + +function Callout({ title, children, mt = 'md' }: { title: string; children: React.ReactNode; mt?: string }) { + return ( + + {children} + + ) +} + +function FlowStep({ step, title, description }: { step: number; title: string; description: string }) { + return ( + + + {step} + + + {title} + {description} + + + ) +} + +function ErrorEntry({ code, description, resolution }: { code: string; description: string; resolution: string }) { + return ( + + {code} + {description} + + Решение: + {resolution} + + + ) +} \ No newline at end of file diff --git a/src/pages/flowNodes/FlowTreePage.tsx b/src/pages/flowNodes/FlowTreePage.tsx new file mode 100644 index 0000000..fcb28e8 --- /dev/null +++ b/src/pages/flowNodes/FlowTreePage.tsx @@ -0,0 +1,402 @@ +import { useState, useMemo } from 'react' +import { + Paper, + Group, + Button, + Text, + Select, + Loader, + Center, + Stack, + Box, + Badge, + Textarea, + Code, + Divider, + Alert, + Collapse, + ActionIcon, + Tooltip, +} from '@mantine/core' +import { + IconPlus, + IconDeviceFloppy, + IconRefresh, + IconChevronDown, + IconChevronRight, + IconInfoCircle, IconBook, +} from '@tabler/icons-react' +import { modals } from '@mantine/modals' +import { useTopics } from '@/features/topics/hooks/useTopics' +import { + useFlowNodesTree, + useDeleteFlowNode, + useSaveFlowTree, + useMoveFlowNode, + useDuplicateFlowNode, +} from '@/features/flowNodes/hooks/useFlowNodes' +import { useUpdateTopic } from '@/features/topics/hooks/useTopics' +import FlowTreeNode from './components/FlowTreeNode' +import FlowNodeEditModal from './components/FlowNodeEditModal' +import type { ApprovalFlowNode, ApprovalTopic } from '@/types/api' +import { useNavigate } from 'react-router-dom' + +export default function FlowTreePage() { + const [selectedTopicId, setSelectedTopicId] = useState(null) + const [showTemplates, setShowTemplates] = useState(false) + + // Модалка редактирования узла + const [editModal, setEditModal] = useState<{ + opened: boolean + parentNode: ApprovalFlowNode | null + editNode: ApprovalFlowNode | null + }>({ + opened: false, + parentNode: null, + editNode: null, + }) + + // Загружаем все темы + const { data: topicsData } = useTopics({ + limit: 1000, + is_tree_root: true + }) + const topics = topicsData?.data || [] + + // Загружаем дерево для выбранной темы + const { data: treeData, isLoading: treeLoading } = useFlowNodesTree(selectedTopicId) + const tree = treeData?.data || [] + + const deleteFlowNode = useDeleteFlowNode() + const saveTree = useSaveFlowTree() + const moveFlowNode = useMoveFlowNode() + const duplicateFlowNode = useDuplicateFlowNode() + const updateTopic = useUpdateTopic() + + const navigate = useNavigate() + + // Выбранная тема + const selectedTopic = useMemo(() => { + return topics.find((t) => t.id === selectedTopicId) || null + }, [topics, selectedTopicId]) + + const topicOptions = topics.map((t) => ({ + value: String(t.id), + label: `${t.name} (${t.code})`, + })) + + // Подсчёт узлов + const countNodes = (nodes: ApprovalFlowNode[]): number => { + let count = nodes.length + for (const n of nodes) { + if (n.children) count += countNodes(n.children) + } + return count + } + const totalNodes = countNodes(tree) + + // Обработчики + const handleEdit = (node: ApprovalFlowNode) => { + // Находим родителя + const parent = findParent(tree, node.id!) + setEditModal({ + opened: true, + parentNode: parent, + editNode: node, + }) + } + + const handleAddChild = (parent: ApprovalFlowNode) => { + setEditModal({ + opened: true, + parentNode: parent, + editNode: null, + }) + } + + const handleAddRoot = () => { + setEditModal({ + opened: true, + parentNode: null, + editNode: null, + }) + } + + const handleDelete = (node: ApprovalFlowNode) => { + modals.openConfirmModal({ + title: 'Удалить узел?', + children: ( + + Удалить узел {node.label}? Все дочерние узлы также будут удалены. + + ), + labels: { confirm: 'Удалить', cancel: 'Отмена' }, + confirmProps: { color: 'red' }, + onConfirm: () => deleteFlowNode.mutate(node.id!), + }) + } + + const handleDuplicate = (node: ApprovalFlowNode) => { + duplicateFlowNode.mutate(node.id!) + } + + const handleMoveUp = (node: ApprovalFlowNode) => { + const parent = findParent(tree, node.id!) + const siblings = parent ? parent.children! : tree + const index = siblings.findIndex((n) => n.id === node.id) + if (index > 0) { + moveFlowNode.mutate({ + id: node.id!, + data: { new_sort_order: index - 1 }, + }) + } + } + + const handleMoveDown = (node: ApprovalFlowNode) => { + const parent = findParent(tree, node.id!) + const siblings = parent ? parent.children! : tree + const index = siblings.findIndex((n) => n.id === node.id) + if (index < siblings.length - 1) { + moveFlowNode.mutate({ + id: node.id!, + data: { new_sort_order: index + 1 }, + }) + } + } + + // Сохранение шаблонов темы + const handleSaveTemplates = () => { + if (!selectedTopic) return + updateTopic.mutate({ + id: selectedTopic.id!, + message_template: selectedTopic.message_template, + code_template: selectedTopic.code_template, + }) + } + + return ( + + + Конструктор деревьев + + {selectedTopic && ( + {totalNodes} узлов + )} + + + + + {/* Выбор темы */} + + +