diff --git a/src/api/flowNodes.ts b/src/api/flowNodes.ts index ae24cfc..930ff62 100644 --- a/src/api/flowNodes.ts +++ b/src/api/flowNodes.ts @@ -49,6 +49,23 @@ export interface SaveTreeRequest { nodes: ApprovalFlowNode[] } +// Живой предпросмотр: код темы + текст сообщения согласующему для +// конкретного набора ответов (collected: data_key -> data_value), +// посчитанные тем же движком, что использует боевой бот. +export interface PreviewFlowRequest { + collected: Record + initiator_name?: string +} + +export interface PreviewFlowResponse { + code: string + message: string + incomplete: boolean + topic_exists: boolean + topic_id?: number + topic_name?: string +} + export const flowNodesApi = { getTree: (categoryId: number) => apiClient.get>(`/flow-nodes/category/${categoryId}`), @@ -73,4 +90,8 @@ export const flowNodesApi = { duplicate: (id: number) => apiClient.post(`/flow-nodes/${id}/duplicate`, {}), + + // НОВОЕ + preview: (categoryId: number, data: PreviewFlowRequest) => + apiClient.post(`/flow-nodes/category/${categoryId}/preview`, data), } \ No newline at end of file diff --git a/src/features/flowNodes/hooks/useFlowNodes.ts b/src/features/flowNodes/hooks/useFlowNodes.ts index 5b99826..ed993db 100644 --- a/src/features/flowNodes/hooks/useFlowNodes.ts +++ b/src/features/flowNodes/hooks/useFlowNodes.ts @@ -4,7 +4,7 @@ import { type CreateFlowNodeRequest, type UpdateFlowNodeRequest, type MoveFlowNodeRequest, - type SaveTreeRequest, + type PreviewFlowRequest, } from '@/api/flowNodes' import { notifications } from '@mantine/notifications' @@ -24,21 +24,16 @@ export function useFlowNodesTree(categoryId: number | null) { 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', - }) + notifications.show({ title: 'Готово', message: 'Кнопка/шаг добавлены', color: 'green' }) }, onError: (error: any) => { notifications.show({ - title: 'Ошибка', - message: error.response?.data?.error_description || 'Не удалось создать узел', + title: 'Не получилось', + message: error.response?.data?.error_description || 'Не удалось сохранить', color: 'red', }) }, @@ -47,21 +42,16 @@ export function useCreateFlowNode() { 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', - }) + notifications.show({ title: 'Готово', message: 'Изменения сохранены', color: 'green' }) }, onError: (error: any) => { notifications.show({ - title: 'Ошибка', - message: error.response?.data?.error_description || 'Не удалось обновить узел', + title: 'Не получилось', + message: error.response?.data?.error_description || 'Не удалось сохранить изменения', color: 'red', }) }, @@ -70,64 +60,35 @@ export function useUpdateFlowNode() { 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', - }) + 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: ({ categoryId, data }: { categoryId: number; data: SaveTreeRequest }) => - flowNodesApi.saveTree(categoryId, 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 || 'Не удалось сохранить дерево', + title: 'Не получилось', + message: error.response?.data?.error_description || 'Не удалось удалить', color: 'red', }) }, }) } +// Перемещение узла — используется и для ↑/↓ среди соседей, и для +// "поднять/опустить уровень" (там просто другой new_parent_id). export function useMoveFlowNode() { const queryClient = useQueryClient() - return useMutation({ - mutationFn: ({ id, data }: { id: number; data: MoveFlowNodeRequest }) => - flowNodesApi.move(id, data), + 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 || 'Не удалось переместить узел', + title: 'Не получилось', + message: error.response?.data?.error_description || 'Не удалось переместить', color: 'red', }) }, @@ -136,23 +97,32 @@ export function useMoveFlowNode() { 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', - }) + notifications.show({ title: 'Готово', message: 'Шаг скопирован', color: 'green' }) }, onError: (error: any) => { notifications.show({ - title: 'Ошибка', - message: error.response?.data?.error_description || 'Не удалось дублировать узел', + title: 'Не получилось', + message: error.response?.data?.error_description || 'Не удалось скопировать', color: 'red', }) }, }) +} + +// НОВОЕ: живой предпросмотр — код темы + текст сообщения согласующему +// для конкретного набора выборов. Не мутирует данные, поэтому это +// useMutation, вызываемый вручную (а не useQuery), чтобы не дёргать +// сервер на каждое нажатие клавиши, а только по явному запросу/дебаунсу. +export function usePreviewFlow(categoryId: number | null) { + return useMutation({ + mutationFn: async (data: PreviewFlowRequest) => { + if (!categoryId) throw new Error('categoryId is required') + const response = await flowNodesApi.preview(categoryId, data) + return response.data // разворачиваем AxiosResponse -> PreviewFlowResponse + }, + }) } \ No newline at end of file diff --git a/src/features/flowNodes/utils/treeWalk.ts b/src/features/flowNodes/utils/treeWalk.ts new file mode 100644 index 0000000..fff9960 --- /dev/null +++ b/src/features/flowNodes/utils/treeWalk.ts @@ -0,0 +1,166 @@ +import type { ApprovalFlowNode } from '@/types/api' + +export function findParent( + nodes: ApprovalFlowNode[], + targetId: number, + parent: ApprovalFlowNode | null = null +): ApprovalFlowNode | null { + for (const node of nodes) { + if (node.id === targetId) return parent + if (node.children) { + const found = findParent(node.children, targetId, node) + if (found) return found + } + } + return null +} + +export function findNodeById(nodes: ApprovalFlowNode[], targetId: number): ApprovalFlowNode | null { + for (const node of nodes) { + if (node.id === targetId) return node + if (node.children) { + const found = findNodeById(node.children, targetId) + if (found) return found + } + } + return null +} + +// Путь от корня дерева категории до узла (включительно). Нужен, чтобы +// посчитать, какие data_key/data_value уже "накопились" на этом пути — +// именно так реальный бот собирает `collected` при прохождении сценария. +export function getPathToNode(tree: ApprovalFlowNode[], targetId: number): ApprovalFlowNode[] { + const path: ApprovalFlowNode[] = [] + const walk = (nodes: ApprovalFlowNode[]): boolean => { + for (const n of nodes) { + path.push(n) + if (n.id === targetId) return true + if (n.children && walk(n.children)) return true + path.pop() + } + return false + } + walk(tree) + return path +} + +// Собирает collected (data_key -> data_value) по цепочке узлов пути. +// Мультиселект-узлы на одном пути объединяются через запятую — это +// приближение (реальный пользователь может выбрать несколько узлов +// мультиселекта одновременно), для целей предпросмотра/проверки этого +// достаточно. +export function collectFromPath(path: ApprovalFlowNode[]): Record { + const collected: Record = {} + for (const n of path) { + if (n.data_key && n.data_value) { + collected[n.data_key] = n.data_value + } + if (n.multi_select_key && n.multi_select_value) { + collected[n.multi_select_key] = collected[n.multi_select_key] + ? `${collected[n.multi_select_key]},${n.multi_select_value}` + : n.multi_select_value + } + } + return collected +} + +// Все пути от корня до "концов" дерева (узел без детей ИЛИ узел +// текстового ввода — именно на нём сценарий завершается и определяется +// тема заявки). +export function collectLeafPaths(tree: ApprovalFlowNode[]): ApprovalFlowNode[][] { + const leaves: ApprovalFlowNode[][] = [] + const walk = (nodes: ApprovalFlowNode[], path: ApprovalFlowNode[]) => { + for (const n of nodes) { + const nextPath = [...path, n] + if (n.is_input || !n.children || n.children.length === 0) { + leaves.push(nextPath) + } else { + walk(n.children, nextPath) + } + } + } + walk(tree, []) + return leaves +} + +export function pathLabel(path: ApprovalFlowNode[]): string { + return path.map((n) => n.label).join(' → ') +} + +// ============================================================ +// Перемещение по уровням ("поднять/опустить уровень") +// ============================================================ + +export interface MoveTarget { + new_parent_id: number | null + new_sort_order: number +} + +// "Поднять уровень": узел становится соседом своего текущего родителя +// (переходит на уровень выше), а не остаётся его ребёнком. +export function getPromoteMove(tree: ApprovalFlowNode[], node: ApprovalFlowNode): MoveTarget | null { + if (!node.id) return null + const parent = findParent(tree, node.id) + if (!parent || !parent.id) return null // узел уже на самом верхнем уровне + + const grandParent = findParent(tree, parent.id) + const grandSiblings = grandParent ? grandParent.children || [] : tree + const parentIndex = grandSiblings.findIndex((n) => n.id === parent.id) + + return { + new_parent_id: grandParent?.id ?? null, + new_sort_order: parentIndex + 1, + } +} + +// "Опустить уровень": узел становится последним ребёнком своего +// предыдущего соседа (вкладывается на уровень ниже). +export function getDemoteMove(tree: ApprovalFlowNode[], node: ApprovalFlowNode): MoveTarget | null { + if (!node.id) return null + const parent = findParent(tree, node.id) + const siblings = parent ? parent.children || [] : tree + const index = siblings.findIndex((n) => n.id === node.id) + if (index <= 0) return null // нет предыдущего соседа, чтобы вложиться в него + + const newParent = siblings[index - 1] + if (!newParent.id) return null + + return { + new_parent_id: newParent.id, + new_sort_order: newParent.children?.length ?? 0, + } +} + +// ============================================================ +// Черновик шаблона сообщения +// ============================================================ + +// Генерирует ЧЕРНОВИК Go-шаблона сообщения согласующему на основе первого +// уровня развилок в дереве категории. Это стартовая точка, а не готовое +// решение — админ должен проверить результат через живой предпросмотр +// и доработать при необходимости (например, добавить ещё один уровень +// условий, если сообщение должно отличаться глубже одного уровня). +export function generateDraftMessageTemplate(root: ApprovalFlowNode): string { + const children = root.children || [] + const withDataKey = children.filter((c) => c.data_key && c.data_value) + + if (withDataKey.length === 0) { + return `📋 ${root.label}\n\n{{.initiator_name}}:\n{{.content}}` + } + + const dataKey = withDataKey[0].data_key + const uniform = withDataKey.every((c) => c.data_key === dataKey) + + if (!uniform) { + return `📋 ${root.label}\n\n{{.initiator_name}}:\n{{.content}}` + } + + let chain = '' + withDataKey.forEach((c, i) => { + const cond = `eq .${dataKey} "${c.data_value}"` + chain += i === 0 ? `{{if ${cond}}}${c.label}` : `{{else if ${cond}}}${c.label}` + }) + chain += `{{else}}${root.label}{{end}}` + + return `📋 ${chain}\n\n{{.initiator_name}}:\n{{.content}}` +} \ No newline at end of file diff --git a/src/pages/flowNodes/FlowTreeGuidePage.tsx b/src/pages/flowNodes/FlowTreeGuidePage.tsx index 6ecd9b7..4d8cacc 100644 --- a/src/pages/flowNodes/FlowTreeGuidePage.tsx +++ b/src/pages/flowNodes/FlowTreeGuidePage.tsx @@ -7,31 +7,15 @@ import { Group, Box, Title, - Table, Divider, ActionIcon, - Tooltip, - CopyButton, ScrollArea, - Badge, Alert, UnstyledButton, - Timeline, - ThemeIcon, } from '@mantine/core' -import { - IconArrowLeft, - IconCopy, - IconCheck, - IconBulb, - IconAlertTriangle, -} from '@tabler/icons-react' +import { IconArrowLeft, IconBulb, IconAlertTriangle } from '@tabler/icons-react' import { useNavigate } from 'react-router-dom' -// ================================================================ -// Структура документации -// ================================================================ - interface DocSection { id: string title: string @@ -40,19 +24,11 @@ interface DocSection { const SECTIONS: DocSection[] = [ { id: 'overview', title: 'Что это такое', level: 1 }, - { id: 'terms', title: 'Три простых понятия', level: 1 }, - { id: 'howto', title: 'Как создать дерево — по шагам', level: 1 }, - { id: 'step-1', title: ' 1. Выбрать категорию', level: 2 }, - { id: 'step-2', title: ' 2. Создать первый узел', level: 2 }, - { id: 'step-3', title: ' 3. Добавить варианты (ветки)', level: 2 }, - { id: 'step-4', title: ' 4. Завершить ветку вводом текста', level: 2 }, - { id: 'step-5', title: ' 5. Настроить сообщение согласующему', level: 2 }, - { id: 'step-6', title: ' 6. Проверить результат', level: 2 }, - { id: 'node-types', title: 'Три типа узлов', level: 1 }, - { id: 'example-1', title: 'Пример: «Отпуска»', level: 1 }, - { id: 'example-2', title: 'Пример: выбор из нескольких списков', level: 1 }, - { id: 'template-basics', title: 'Как писать сообщение согласующему', level: 1 }, - { id: 'tips', title: 'Советы и правила', level: 1 }, + { id: 'principle-1', title: '1. Чтобы кнопка появилась в боте', level: 1 }, + { id: 'principle-2', title: '2. Как создать новую тему', level: 1 }, + { id: 'principle-3', title: '3. Как изменить существующую тему', level: 1 }, + { id: 'templates', title: 'Сообщение согласующему — важное правило', level: 1 }, + { id: 'check', title: 'Как проверить, что всё работает', level: 1 }, { id: 'troubleshooting', title: 'Если что-то не работает', level: 1 }, ] @@ -82,43 +58,28 @@ export default function FlowTreeGuidePage() { return ( - + Руководство - navigate('/nodes')} - > + navigate('/nodes')}> - {SECTIONS.map((section) => ( scrollTo(section.id)} - px={section.level === 2 ? 20 : 12} + px={12} py={6} style={{ borderRadius: 4, backgroundColor: - activeSection === section.id - ? 'var(--mantine-color-blue-0)' - : 'transparent', + activeSection === section.id ? 'var(--mantine-color-blue-0)' : 'transparent', borderLeft: activeSection === section.id ? '2px solid var(--mantine-color-blue-6)' @@ -126,7 +87,7 @@ export default function FlowTreeGuidePage() { }} > @@ -139,531 +100,164 @@ export default function FlowTreeGuidePage() { - {/* ============================================================ */} - {/* Основной контент */} - {/* ============================================================ */} - {/* Заголовок */} - Как настроить дерево согласования + Как настроить дерево заявок - Это руководство для тех, кто настраивает бота — без программирования. - Здесь пошагово показано, как собрать «дерево» вопросов, которые бот задаёт - сотруднику, когда тот создаёт заявку: например, «Какой регион?» → - «Какая причина?» → «Опишите заявку». + Когда сотрудник создаёт заявку в боте, тот задаёт вопросы по очереди и предлагает + варианты ответа кнопками: «Какой регион?» → «Какая причина?» → «Опишите заявку». Эта + цепочка вопросов и есть дерево, и вы его собираете здесь — без программирования. - {/* ============================================================ */} - {/* ОБЗОР */} - {/* ============================================================ */} - - Когда сотрудник создаёт заявку в Telegram-боте, бот задаёт ему вопросы по - очереди и предлагает варианты ответов кнопками. Например: «Выберите - регион» → «Крым» или «Краснодар» → «Опишите заявку текстом». Эта - последовательность вопросов и есть дерево. + Каждый раздел заявок («Отпуска», «Возвраты» и т.д.) — это отдельное дерево вопросов. + Каждый вопрос или кнопка внутри дерева — это шаг. Путь, который сотрудник проходит от + первого вопроса до текстового поля, в конце превращается в конкретную тему заявки со своими + согласующими. - - - Вы настраиваете это дерево в разделе «Конструктор деревьев» — без единой - строчки кода. Каждый вопрос и каждая кнопка — это отдельный «узел», который - вы добавляете через простую форму. - - - - Так настраиваются любые сценарии: отпуска, больничные, внебюджетные - расходы, возвраты и любые другие заявки. Если появится новый вид заявки — - не нужно ничего программировать, достаточно собрать новое дерево здесь. + + 🔘 Кнопка — сотрудник выбирает один из вариантов. 📝 Текстовый ввод — сотрудник + пишет заявку своими словами (этим всегда заканчивается путь). ☑️{' '} + Несколько вариантов сразу — как кнопка, но можно отметить сразу несколько пунктов. - {/* ============================================================ */} - {/* ТРИ ПОНЯТИЯ */} - {/* ============================================================ */} - - - - Прежде чем начать, важно понимать всего три вещи: - - - - - - Понятие - Что это простыми словами - - - - - Категория - - Раздел заявок, который вы выбираете вверху страницы («Отпуска», - «Внебюджетные расходы» и т.д.). Одно дерево всегда строится - внутри одной категории. - - - - Узел - - Один шаг в дереве: кнопка с вариантом ответа, поле ввода текста - или список для множественного выбора. Узлы соединяются друг с - другом — у каждого может быть несколько «детей» (следующих - шагов). - - - - Тема заявки - - То, во что в итоге превращается пройденный сотрудником путь по - дереву. Например, путь «Крым → За свой счёт» превращается в - конкретную тему заявки со своими согласующими. - - - -
- - - Дерево — это как схема метро: от начальной станции (первого вопроса) до - конечной (поля ввода текста) должен существовать путь через любые - промежуточные станции (кнопки-варианты). Ваша задача — построить эти пути. + + Три условия, все должны выполняться одновременно: + + + а) Раздел, в котором лежит дерево, должен быть создан и активен — если раздела + ещё нет, нажмите «Новый раздел» прямо на странице конструктора. + + + б) От первого вопроса до этой кнопки должен существовать полный путь без обрывов + — то есть у каждого шага на пути есть родитель, а сама кнопка либо ведёт дальше, либо + заканчивается текстовым вводом. + + + в) Сотруднику должно быть выдано право видеть этот раздел. Это отдельная + настройка прав доступа — она делается ПОСЛЕ того, как дерево готово, в другом разделе + системы, не здесь. + + + + Сначала проверьте (а) и (б) — они настраиваются прямо в конструкторе. Если с деревом всё в + порядке — дело в правах доступа (в), обратитесь к тому, кто их настраивает. - {/* ============================================================ */} - {/* ПОРЯДОК СОЗДАНИЯ */} - {/* ============================================================ */} - - - - Ниже — точный порядок действий от пустой категории до готового, - работающего дерева. - - - - - - Откройте страницу «Конструктор деревьев» и в выпадающем списке «Категория» - выберите нужный раздел. Если подходящей категории ещё нет — обратитесь к - администратору, чтобы её создали (это отдельная настройка, не относится к - дереву). - - - - Если дерево для этой категории уже существует, вы увидите его сразу после - выбора. Можно смело редактировать — все изменения сохраняются - автоматически, ничего не потеряется. - - - - - - Нажмите кнопку «Добавить корневой узел». Это будет самый первый вопрос, - который увидит сотрудник. Откроется окно с тремя полями: - - - - - - Поле - Что писать - - - - - Тип узла - Оставьте «Кнопка» — для первого шага почти всегда нужна кнопка - - - Название - То, что увидит сотрудник, например «Отпуска» - - - Ключ - - Не трогайте — заполняется автоматически из названия - - - -
- - - Нажмите «Создать». Узел появится в дереве — с него всё и начинается. - - - - - - Наведите на созданный узел — рядом появятся кнопки. Нажмите «+», чтобы - добавить к нему дочерний узел — следующий шаг вопроса. Повторяйте это для - каждого варианта ответа. - - - - Например, если первый узел — «Тип отпуска», добавьте к нему детей: - «Отпуск», «Отгул», «Больничный». Каждый из них — отдельная кнопка, которую - увидит сотрудник после выбора первого шага. - - - - Для узлов-кнопок в форме есть два поля: DataKey — название того, что - мы запоминаем (например «тип отпуска»), и DataValue — конкретное - значение этой кнопки (например «отпуск»). У всех кнопок-веток одного и того - же вопроса DataKey должен быть одинаковым, а DataValue — у каждой свой. - Смотрите готовый пример ниже — там всё видно на конкретных значениях. - - - - - - Каждая ветка дерева обязательно должна заканчиваться узлом «Текстовый - ввод» — это последний шаг, где сотрудник пишет саму заявку своими словами. - Добавьте такой узел к каждому «листу» дерева (к узлу, у которого больше нет - вариантов выбора). - - - - В форме выберите тип узла «Текстовый ввод» и заполните поле «Подсказка» — - это пример того, что должен написать сотрудник, чтобы ему было понятнее. - - - - Пройдите мысленно (или на бумаге) каждый путь от первого узла до конца. - Если какой-то путь обрывается на кнопке, не доходя до текстового ввода — - сотрудник не сможет завершить заявку. Добавьте туда узел ввода. - - - - - - На узле, где заявка «превращается» в конкретную тему (обычно это последний - узел-кнопка перед вводом текста), можно раскрыть блок «Шаблоны сообщения и - кода темы» и задать, как будет выглядеть уведомление у согласующего в - Telegram. Подробно про это — в разделе{' '} - «Как писать сообщение согласующему»{' '} - ниже. Если ничего не менять — сработает оформление по умолчанию. - - - - - - Дерево сохраняется автоматически после каждого действия — отдельной кнопки - «Сохранить всё» нажимать не нужно. Лучший способ проверить готовое дерево — - попросить коллегу создать тестовую заявку через бота и убедиться, что все - вопросы задаются в правильном порядке, а итоговое сообщение согласующему - выглядит понятно. - - - {/* ============================================================ */} - {/* ТИПЫ УЗЛОВ */} - {/* ============================================================ */} - - - - При создании или редактировании узла вы выбираете один из трёх типов: - - - - - - 🔘 - Кнопка - - - Сотрудник нажимает и переходит к следующему шагу. Используется для - любого выбора из вариантов: регион, тип заявки, филиал и т.д. - Требует заполнения DataKey и DataValue. - - - - - 📝 - Текстовый ввод - - - Сотрудник печатает текст. Всегда завершает ветку дерева — после - него бот создаёт заявку. Требует заполнения «Подсказки» — - примера того, что нужно написать. - - - - - ☑️ - Мультивыбор - - - Сотрудник может отметить сразу несколько вариантов (например, - несколько систем: «ОКБ» и «1С»). Все отмеченные варианты - сохранятся вместе, через запятую. - - + + Порядок действий с нуля: + + + Шаг 1. На странице конструктора нажмите «Новый раздел», если подходящего ещё + нет — впишите название, технический код заполнится сам. + + + Шаг 2. Нажмите «Добавить первый вопрос» — это то, что сотрудник увидит первым. + + + Шаг 3. Наведите на созданный шаг, нажмите «+» и добавьте варианты ответа. У всех + кнопок одного вопроса поле «что запомнить» должно совпадать — конструктор подставляет + его сам, начиная со второй кнопки. + + + Шаг 4. Каждую ветку обязательно завершите шагом «Текстовый ввод» — без него + сотрудник не сможет закончить заявку. + + + Шаг 5. В окне редактирования любого шага есть кнопка «Проверить» — она покажет, + появилась ли для этого пути настроенная тема в системе. Если её ещё нет — рядом + появится кнопка «Создать тему», нажмите её, ничего искать в других разделах не нужно. + + + Шаг 6. На самом первом (корневом) шаге дерева настройте текст сообщения + согласующему — см. следующий раздел, это важно. + - {/* ============================================================ */} - {/* ПРИМЕР 1 */} - {/* ============================================================ */} - - + - Разберём готовый пример целиком — от первого узла до отправки заявки. - Сценарий: сотрудник выбирает тип отсутствия, затем способ оплаты, затем - пишет причину. + Найдите нужный раздел в выпадающем списке, разверните дерево и нажмите ✏️ на шаге, который + хотите поменять. Можно переименовать шаг, поменять подсказку для текстового ввода, добавить + новые варианты ответа или переставить шаги местами кнопками ↑ ↓ (среди соседних) и стрелками + с отступом (поднять/опустить на другой уровень вложенности). Все изменения сохраняются + сразу, отдельной кнопки «Сохранить» нет. + + Удаление шага удаляет и все шаги, которые находятся под ним. Система переспросит перед + удалением. + - - - - Название: Тип отсутствия. Тип узла: Кнопка. Это - «заголовок» дерева — сам по себе кнопкой сотруднику не показывается, - но от него отходят первые варианты. - - - - - Добавляем к корню три узла: Отпуск, Отгул,{' '} - Больничный. У всех трёх DataKey одинаковый —{' '} - absence_type, а DataValue разный: vacation,{' '} - timeoff, sickleave. - - - - - К узлу «Отпуск» добавляем два дочерних узла: За свой счёт{' '} - и В счёт отпуска. DataKey у обоих —{' '} - payment_type, DataValue — own_expense и{' '} - vacation_account соответственно. Аналогично поступаем с - ветками «Отгул» и «Больничный». - - - - - К каждому из узлов способа оплаты добавляем узел «Текстовый ввод» с - подсказкой: Укажите даты отпуска, например: 22.02.2026 — 25.02.2026. - - - - - На узле способа оплаты (там, где заявка уже точно определена) - открываем «Шаблоны сообщения и кода темы» и вписываем текст — см. - пример ниже. - - - - - - + + } color="orange" variant="light"> + + Текст сообщения и код темы настраиваются ОДИН РАЗ — на самом первом (корневом) шаге + дерева, а не на каждой отдельной ветке. + + - Что увидит сотрудник в боте: сначала кнопки «Отпуск / Отгул / - Больничный», затем — «За свой счёт / В счёт отпуска», затем поле для - ввода дат. Три нажатия и один текст — заявка готова. + Если раньше вы пытались настроить отдельное сообщение на каком-то шаге в середине дерева и + оно «не сохранялось» или не действовало — вот почему: система всегда смотрит только на + самый первый шаг. Чтобы сообщение отличалось в зависимости от выбора сотрудника, в тексте + используются условия — но настраивается это тоже на первом шаге, одним общим текстом. - Тип: {{.absence_type_label}} - -{{.initiator_name}} просит согласовать: {{.payment_type_label}} -{{.content}}`} - /> - - - Всё, что в фигурных скобках — подставится автоматически: название узла, - который выбрал сотрудник, его имя и текст, который он написал. Про этот - синтаксис подробнее — в разделе ниже. - - - {/* ============================================================ */} - {/* ПРИМЕР 2 */} - {/* ============================================================ */} - - - - Более сложный, но частый случай: нужно спросить у сотрудника два - независимых параметра подряд — например, филиал и тип расхода. - - - - - - Обратите внимание: узел «ТМЦ» повторяется дважды — под «Филиал 1» и под - «Филиал 2». Это нормально: узлы с одинаковым названием на разных ветках - дерева — это разные, независимые узлы, у каждого свой ключ (система - добавляет к ключу префикс родителя автоматически). - - - Внебюджетные расходы — {{.branch_label}} ({{.expense_type_label}}) + title="Пример: сообщение, которое меняется в зависимости от выбора" + code={`📋 {{if eq .branch "f1"}}Филиал 1{{else}}Филиал 2{{end}} {{.initiator_name}}: {{.content}}`} /> - - {/* ============================================================ */} - {/* ШАБЛОНЫ */} - {/* ============================================================ */} - - - - В блоке «Шаблоны сообщения и кода темы» вы пишете обычный текст с - HTML-разметкой (<b>жирный</b>,{' '} - <i>курсив</i>) — так, как хотите видеть уведомление - у согласующего. В нужных местах вставляете «плейсхолдеры» в фигурных - скобках — они подставляются автоматически. + + Не нужно запоминать этот синтаксис — на первом шаге дерева есть кнопка «Сформировать + черновик», которая сама подставит условия на основе первого вопроса дерева. Дальше можно + поправить текст руками и сразу посмотреть, как он будет выглядеть, через «Проверить готовую + ветку» в том же окне. - - - - - Что написать - Что подставится - - - - - {`{{.initiator_name}}`} - Имя сотрудника, который создал заявку - - - {`{{.content}}`} - Текст, который сотрудник ввёл на последнем шаге - - - {`{{.название_кнопки_label}}`} - - Название выбранной сотрудником кнопки. Например, если DataKey - кнопки — region, пишите{' '} - {`{{.region_label}}`}, и туда подставится «Крым» или - «Краснодар» — смотря что выбрал сотрудник - - - -
- - - Не нужно запоминать синтаксис. Откройте похожий уже настроенный узел (в - этой же или другой категории), скопируйте оттуда шаблон и замените - плейсхолдеры на DataKey ваших узлов. - - - - Дополнительно доступны несколько простых условий — пригодятся, если - сообщение должно немного отличаться в зависимости от выбора: - - - - - - - Поле «Шаблон кода темы» обычно можно не трогать — если оставить пустым, - система сама соберёт код заявки из всех выборов сотрудника. Заполняйте его - только если вам явно сказали, что для этой темы нужен особый код - (например, если это уже настроенная в системе тема с заранее заданным - названием). + Поле «Код темы» почти всегда можно оставить пустым — тогда код соберётся сам из всех + выборов сотрудника. - {/* ============================================================ */} - {/* СОВЕТЫ */} - {/* ============================================================ */} - - - - - - - - - - - - {/* ============================================================ */} - {/* ДИАГНОСТИКА */} - {/* ============================================================ */} - - + - Частые ситуации и что с ними делать: + Под деревом есть блок «Проверка дерева» с кнопкой «Проверить все ветки» — он пройдёт по + каждому возможному пути и покажет, для всех ли есть настроенная тема. Это быстрее, чем + вручную проходить весь сценарий в Telegram, и находит проблему до того, как её найдёт + сотрудник. + - - - Остались вопросы — обратитесь к администратору системы согласований. + Остались вопросы — обратитесь к тому, кто настраивал вам эту систему.
@@ -671,18 +265,10 @@ export default function FlowTreeGuidePage() { ) } -// ================================================================ -// Вспомогательные компоненты -// ================================================================ - -function DocSection({ id, title, level = 1 }: { id: string; title: string; level?: number }) { +function DocSection({ id, title }: { id: string; title: string }) { return ( - {level === 1 ? ( - {title} - ) : ( - {title} - )} + {title} ) } @@ -690,23 +276,11 @@ function DocSection({ id, title, level = 1 }: { id: string; title: string; level function CodeBlock({ title, code }: { title: string; code: string }) { return ( - - {title} - - {({ copied, copy }) => ( - - - {copied ? : } - - - )} - - + + + {title} + + {code} @@ -716,51 +290,33 @@ function CodeBlock({ title, code }: { title: string; code: string }) { ) } -function Callout({ title, children, mt = 'md' }: { title: string; children: React.ReactNode; mt?: string }) { +function Callout({ title, children }: { title: string; children: React.ReactNode }) { return ( - } - title={title} - mt={mt} - styles={{ - title: { fontSize: 13, fontWeight: 600 }, - message: { fontSize: 13 }, - }} - > + } title={title} mt="md"> {children} ) } -function TipEntry({ title, text }: { title: string; text: string }) { - return ( - - - - - - {title} - {text} - - - ) -} - function ErrorEntry({ title, description, resolution }: { title: string; description: string; resolution: string }) { return ( - - - - {title} + + + {title} + - {description} + + {description} + - Что делать: - {resolution} + + Что делать:{' '} + + + {resolution} + ) diff --git a/src/pages/flowNodes/FlowTreePage.tsx b/src/pages/flowNodes/FlowTreePage.tsx index 716236f..26bf9ef 100644 --- a/src/pages/flowNodes/FlowTreePage.tsx +++ b/src/pages/flowNodes/FlowTreePage.tsx @@ -13,116 +13,78 @@ import { ActionIcon, Tooltip, } from '@mantine/core' -import { - IconPlus, - IconRefresh, - IconInfoCircle, - IconBook, -} from '@tabler/icons-react' +import { IconPlus, IconInfoCircle, IconBook, IconFolderPlus } from '@tabler/icons-react' import { modals } from '@mantine/modals' import { useCategories } from '@/features/categories/hooks/useCategories' import { useFlowNodesTree, useDeleteFlowNode, - useSaveFlowTree, useMoveFlowNode, useDuplicateFlowNode, } from '@/features/flowNodes/hooks/useFlowNodes' -import FlowTreeNode from './components/FlowTreeNode' -import FlowNodeEditModal from './components/FlowNodeEditModal' +import { findParent, getPromoteMove, getDemoteMove } from '@/features/flowNodes/utils/treeWalk' import type { ApprovalFlowNode, ApprovalTopicCategory } from '@/types/api' import { useNavigate } from 'react-router-dom' +import FlowTreeNode from "@/pages/flowNodes/components/FlowTreeNode.tsx"; +import TreeHealthPanel from "@/pages/flowNodes/components/TreeHealthPanel.tsx"; +import FlowNodeEditModal from "@/pages/flowNodes/components/FlowNodeEditModal.tsx"; +import CategoryCreateModal from "@/pages/flowNodes/components/CategoryCreateModal.tsx"; export default function FlowTreePage() { const [selectedCategoryId, setSelectedCategoryId] = useState(null) + const [categoryModalOpened, setCategoryModalOpened] = useState(false) - // Модалка редактирования узла. - // Шаблоны сообщения/кода для темы (message_template / code_template) - // редактируются здесь же, как поля узла — в БД они хранятся на - // ApprovalFlowNode (обычно на терминальном узле, где также заполнен - // topic_code), а не на ApprovalTopic. const [editModal, setEditModal] = useState<{ opened: boolean parentNode: ApprovalFlowNode | null editNode: ApprovalFlowNode | null - }>({ - opened: false, - parentNode: null, - editNode: null, - }) + }>({ opened: false, parentNode: null, editNode: null }) - // Загружаем все активные категории — именно категория является - // единицей дерева навигации (Registry строит Topic-интерфейс на - // основе категории + узлов дерева, привязанных к category_id) - const { data: categoriesData } = useCategories({ - limit: 1000, - is_active: true, - }) + const { data: categoriesData } = useCategories({ limit: 1000, is_active: true }) const categories = categoriesData?.data || [] - // Загружаем дерево для выбранной категории const { data: treeData, isLoading: treeLoading } = useFlowNodesTree(selectedCategoryId) const tree = treeData?.data || [] const deleteFlowNode = useDeleteFlowNode() - const saveTree = useSaveFlowTree() const moveFlowNode = useMoveFlowNode() const duplicateFlowNode = useDuplicateFlowNode() const navigate = useNavigate() - // Выбранная категория - const selectedCategory = useMemo(() => { - return categories.find((c) => c.id === selectedCategoryId) || null - }, [categories, selectedCategoryId]) + const selectedCategory = useMemo( + () => categories.find((c) => c.id === selectedCategoryId) || null, + [categories, selectedCategoryId] + ) - const categoryOptions = categories.map((c) => ({ - value: String(c.id), - label: `${c.name} (${c.code})`, - })) + const categoryOptions = categories.map((c) => ({ value: String(c.id), label: `${c.name} (${c.code})` })) - // Подсчёт узлов const countNodes = (nodes: ApprovalFlowNode[]): number => { let count = nodes.length - for (const n of nodes) { - if (n.children) count += countNodes(n.children) - } + 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, - }) + setEditModal({ opened: true, parentNode: parent, editNode: node }) } const handleAddChild = (parent: ApprovalFlowNode) => { - setEditModal({ - opened: true, - parentNode: parent, - editNode: null, - }) + setEditModal({ opened: true, parentNode: parent, editNode: null }) } const handleAddRoot = () => { - setEditModal({ - opened: true, - parentNode: null, - editNode: null, - }) + setEditModal({ opened: true, parentNode: null, editNode: null }) } const handleDelete = (node: ApprovalFlowNode) => { modals.openConfirmModal({ - title: 'Удалить узел?', + title: 'Удалить этот шаг?', children: ( - Удалить узел {node.label}? Все дочерние узлы также будут удалены. + Удалить шаг {node.label}? Все шаги, которые идут после него, тоже удалятся. ), labels: { confirm: 'Удалить', cancel: 'Отмена' }, @@ -131,103 +93,87 @@ export default function FlowTreePage() { }) } - const handleDuplicate = (node: ApprovalFlowNode) => { - duplicateFlowNode.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 }, - }) - } + 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 }, - }) - } + if (index < siblings.length - 1) moveFlowNode.mutate({ id: node.id!, data: { new_sort_order: index + 1 } }) + } + + const handlePromote = (node: ApprovalFlowNode) => { + const target = getPromoteMove(tree, node) + if (target) moveFlowNode.mutate({ id: node.id!, data: target }) + } + + const handleDemote = (node: ApprovalFlowNode) => { + const target = getDemoteMove(tree, node) + if (target) moveFlowNode.mutate({ id: node.id!, data: target }) } return ( - Конструктор деревьев + + Конструктор дерева заявок + - {selectedCategory && ( - {totalNodes} узлов - )} - - {/* Выбор категории */} - setSelectedCategoryId(v ? Number(v) : null)} + searchable + style={{ flex: 1 }} + /> + + + + - {/* Дерево */} {selectedCategoryId && ( - Дерево навигации + Дерево вопросов {treeLoading && } - - - { - if (selectedCategoryId) { - window.location.reload() - } - }} - > - - - - - + } color="blue" variant="light"> - Совет: Используйте кнопки ↑ ↓ для изменения порядка,{' '} - + для добавления дочернего узла, 📋 для дублирования. - Все изменения сохраняются автоматически. Шаблоны сообщения и кода - темы (Go template) задаются в редакторе узла — обычно на том узле, - где также указан topic_code. + Значки справа от каждого шага: ↑ ↓ — переставить среди соседних кнопок; стрелки с + отступом — поднять/опустить на другой уровень вложенности; + — добавить следующий + шаг; ✏️ — изменить; 📋 — сделать копию; 🗑 — удалить. Всё сохраняется сразу. @@ -238,12 +184,9 @@ export default function FlowTreePage() { ) : tree.length === 0 ? (
- Дерево пустое -
@@ -255,13 +198,15 @@ export default function FlowTreePage() { node={node} depth={0} siblings={tree} + index={idx} onEdit={handleEdit} onAddChild={handleAddChild} onDelete={handleDelete} onDuplicate={handleDuplicate} onMoveUp={handleMoveUp} onMoveDown={handleMoveDown} - index={idx} + onPromote={handlePromote} + onDemote={handleDemote} /> ))}
@@ -270,36 +215,24 @@ export default function FlowTreePage() {
)} - {/* Модалка редактирования узла. - Помимо key/label/data_key и т.д. должна включать поля - message_template и code_template (Go template) — они - хранятся на самом узле. saveTree/create/update передают - category_id вместо topic_id. */} + {selectedCategoryId && tree.length > 0 && } + {selectedCategoryId && ( setEditModal({ opened: false, parentNode: null, editNode: null })} /> )} + + setCategoryModalOpened(false)} + onCreated={(newId) => setSelectedCategoryId(newId)} + />
) -} - -// Вспомогательная функция: найти родителя узла по ID -function findParent( - nodes: ApprovalFlowNode[], - targetId: number, - parent: ApprovalFlowNode | null = null -): ApprovalFlowNode | null { - for (const node of nodes) { - if (node.id === targetId) return parent - if (node.children) { - const found = findParent(node.children, targetId, node) - if (found) return found - } - } - return null } \ No newline at end of file diff --git a/src/pages/flowNodes/components/CategoryCreateModal.tsx b/src/pages/flowNodes/components/CategoryCreateModal.tsx new file mode 100644 index 0000000..137ca33 --- /dev/null +++ b/src/pages/flowNodes/components/CategoryCreateModal.tsx @@ -0,0 +1,117 @@ +import { useEffect } from 'react' +import { Modal, Stack, TextInput, Textarea, Group, Button, Text, Alert } from '@mantine/core' +import { useForm } from '@mantine/form' +import { IconInfoCircle } from '@tabler/icons-react' +import { useCreateCategory } from '@/features/categories/hooks/useCategories' +import type { CreateCategoryRequest } from '@/api/categories' + +interface CategoryCreateModalProps { + opened: boolean + onClose: () => void + onCreated: (categoryId: number) => void +} + +const translitMap: Record = { + а: 'a', б: 'b', в: 'v', г: 'g', д: 'd', е: 'e', ё: 'yo', ж: 'zh', з: 'z', и: 'i', й: 'y', + к: 'k', л: 'l', м: 'm', н: 'n', о: 'o', п: 'p', р: 'r', с: 's', т: 't', у: 'u', ф: 'f', + х: 'h', ц: 'ts', ч: 'ch', ш: 'sh', щ: 'sch', ъ: '', ы: 'y', ь: '', э: 'e', ю: 'yu', я: 'ya', +} + +function slugify(text: string): string { + return text + .toLowerCase() + .split('') + .map((ch) => translitMap[ch] ?? ch) + .join('') + .replace(/[\s-]+/g, '_') + .replace(/[^a-z0-9_]/g, '') + .replace(/_+/g, '_') + .replace(/^_+|_+$/g, '') + .substring(0, 50) +} + +// Создание новой категории (раздела заявок) прямо из конструктора дерева — +// требование "полной автономности": админ не должен переходить в другой +// раздел, чтобы завести новый вид заявки. +export default function CategoryCreateModal({ opened, onClose, onCreated }: CategoryCreateModalProps) { + const createCategory = useCreateCategory() + + const form = useForm({ + initialValues: { name: '', code: '', description: '' }, + validate: { + name: (v) => (!v || v.length < 2 ? 'Введите название раздела' : null), + code: (v) => (!v || v.length < 2 ? 'Технический код должен быть заполнен' : null), + }, + }) + + useEffect(() => { + if (opened) form.reset() + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [opened]) + + useEffect(() => { + form.setFieldValue('code', slugify(form.values.name)) + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [form.values.name]) + + const handleSubmit = async (values: typeof form.values) => { + const payload: CreateCategoryRequest = { + name: values.name, + code: values.code, + description: values.description || undefined, + is_active: true, + } + const result = await createCategory.mutateAsync(payload) + // categoriesApi.create возвращает ApprovalTopicCategory без обёртки + // (apiClient.post), axios кладёт его в response.data. + const newId = result?.data?.id + if (newId) onCreated(newId) + onClose() + } + + return ( + Новый раздел заявок}> +
+ + } color="blue" variant="light"> + + Раздел — это то, что сотрудник увидит в главном меню бота (например, «Отпуска» или + «Возвраты»). Внутри одного раздела вы потом соберёте дерево вопросов. + + + + + + + +