Upodate flow nodes constructor
Deploy Frontend / build-and-deploy (push) Successful in 27s Details

This commit is contained in:
romanskijdev 2026-07-16 15:16:16 +03:00
parent 98481e4f8a
commit 805bbdbd4a
9 changed files with 1200 additions and 1268 deletions

View File

@ -49,6 +49,23 @@ export interface SaveTreeRequest {
nodes: ApprovalFlowNode[]
}
// Живой предпросмотр: код темы + текст сообщения согласующему для
// конкретного набора ответов (collected: data_key -> data_value),
// посчитанные тем же движком, что использует боевой бот.
export interface PreviewFlowRequest {
collected: Record<string, string>
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<ApiResponse<ApprovalFlowNode[]>>(`/flow-nodes/category/${categoryId}`),
@ -73,4 +90,8 @@ export const flowNodesApi = {
duplicate: (id: number) =>
apiClient.post<ApprovalFlowNode>(`/flow-nodes/${id}/duplicate`, {}),
// НОВОЕ
preview: (categoryId: number, data: PreviewFlowRequest) =>
apiClient.post<PreviewFlowResponse>(`/flow-nodes/category/${categoryId}/preview`, data),
}

View File

@ -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
},
})
}

View File

@ -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<string, string> {
const collected: Record<string, string> = {}
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 `📋 <b>${root.label}</b>\n\n<b>{{.initiator_name}}</b>:\n{{.content}}`
}
const dataKey = withDataKey[0].data_key
const uniform = withDataKey.every((c) => c.data_key === dataKey)
if (!uniform) {
return `📋 <b>${root.label}</b>\n\n<b>{{.initiator_name}}</b>:\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 `📋 <b>${chain}</b>\n\n<b>{{.initiator_name}}</b>:\n{{.content}}`
}

View File

@ -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 (
<Box style={{ display: 'flex', gap: 32, alignItems: 'flex-start' }}>
<Box
style={{
width: 260,
flexShrink: 0,
position: 'sticky',
top: 20,
maxHeight: 'calc(100vh - 40px)',
}}
>
<Box style={{ width: 260, flexShrink: 0, position: 'sticky', top: 20, maxHeight: 'calc(100vh - 40px)' }}>
<Stack gap={0}>
<Group justify="space-between" mb="md">
<Text size="xs" fw={600} c="dimmed" tt="uppercase" lts={1}>
Руководство
</Text>
<ActionIcon
variant="subtle"
size="sm"
onClick={() => navigate('/nodes')}
>
<ActionIcon variant="subtle" size="sm" onClick={() => navigate('/nodes')}>
<IconArrowLeft size={16} />
</ActionIcon>
</Group>
<ScrollArea style={{ maxHeight: 'calc(100vh - 120px)' }}>
<Stack gap={2}>
{SECTIONS.map((section) => (
<UnstyledButton
key={section.id}
onClick={() => 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() {
}}
>
<Text
size={section.level === 2 ? 'xs' : 'sm'}
size="sm"
c={activeSection === section.id ? 'blue.7' : 'dimmed'}
fw={activeSection === section.id ? 600 : 400}
>
@ -139,531 +100,164 @@ export default function FlowTreeGuidePage() {
</Stack>
</Box>
{/* ============================================================ */}
{/* Основной контент */}
{/* ============================================================ */}
<Box style={{ flex: 1, maxWidth: 880, minWidth: 0 }}>
<Stack gap={48} pb={120}>
{/* Заголовок */}
<Box>
<Title order={1}>Как настроить дерево согласования</Title>
<Title order={1}>Как настроить дерево заявок</Title>
<Text c="dimmed" mt="sm" size="lg">
Это руководство для тех, кто настраивает бота — без программирования.
Здесь пошагово показано, как собрать «дерево» вопросов, которые бот задаёт
сотруднику, когда тот создаёт заявку: например, «Какой регион?» →
«Какая причина?» → «Опишите заявку».
Когда сотрудник создаёт заявку в боте, тот задаёт вопросы по очереди и предлагает
варианты ответа кнопками: «Какой регион?» → «Какая причина?» → «Опишите заявку». Эта
цепочка вопросов и есть <b>дерево</b>, и вы его собираете здесь — без программирования.
</Text>
</Box>
<Divider />
{/* ============================================================ */}
{/* ОБЗОР */}
{/* ============================================================ */}
<DocSection id="overview" title="Что это такое" />
<Text>
Когда сотрудник создаёт заявку в Telegram-боте, бот задаёт ему вопросы по
очереди и предлагает варианты ответов кнопками. Например: «Выберите
регион» → «Крым» или «Краснодар» → «Опишите заявку текстом». Эта
последовательность вопросов и есть <b>дерево</b>.
Каждый <b>раздел заявок</b> («Отпуска», «Возвраты» и т.д.) — это отдельное дерево вопросов.
Каждый вопрос или кнопка внутри дерева — это <b>шаг</b>. Путь, который сотрудник проходит от
первого вопроса до текстового поля, в конце превращается в конкретную тему заявки со своими
согласующими.
</Text>
<Text>
Вы настраиваете это дерево в разделе «Конструктор деревьев» — без единой
строчки кода. Каждый вопрос и каждая кнопка — это отдельный «узел», который
вы добавляете через простую форму.
</Text>
<Callout title="Зачем это нужно">
Так настраиваются любые сценарии: отпуска, больничные, внебюджетные
расходы, возвраты и любые другие заявки. Если появится новый вид заявки —
не нужно ничего программировать, достаточно собрать новое дерево здесь.
<Callout title="Три вида шагов">
🔘 <b>Кнопка</b> — сотрудник выбирает один из вариантов. 📝 <b>Текстовый ввод</b> — сотрудник
пишет заявку своими словами (этим всегда заканчивается путь). ☑️{' '}
<b>Несколько вариантов сразу</b> — как кнопка, но можно отметить сразу несколько пунктов.
</Callout>
{/* ============================================================ */}
{/* ТРИ ПОНЯТИЯ */}
{/* ============================================================ */}
<DocSection id="terms" title="Три простых понятия" />
<Text>
Прежде чем начать, важно понимать всего три вещи:
</Text>
<Table withTableBorder withColumnBorders mt="md">
<Table.Thead>
<Table.Tr>
<Table.Th style={{ width: 180 }}>Понятие</Table.Th>
<Table.Th>Что это простыми словами</Table.Th>
</Table.Tr>
</Table.Thead>
<Table.Tbody>
<Table.Tr>
<Table.Td><b>Категория</b></Table.Td>
<Table.Td>
Раздел заявок, который вы выбираете вверху страницы («Отпуска»,
«Внебюджетные расходы» и т.д.). Одно дерево всегда строится
внутри одной категории.
</Table.Td>
</Table.Tr>
<Table.Tr>
<Table.Td><b>Узел</b></Table.Td>
<Table.Td>
Один шаг в дереве: кнопка с вариантом ответа, поле ввода текста
или список для множественного выбора. Узлы соединяются друг с
другом — у каждого может быть несколько «детей» (следующих
шагов).
</Table.Td>
</Table.Tr>
<Table.Tr>
<Table.Td><b>Тема заявки</b></Table.Td>
<Table.Td>
То, во что в итоге превращается пройденный сотрудником путь по
дереву. Например, путь «Крым → За свой счёт» превращается в
конкретную тему заявки со своими согласующими.
</Table.Td>
</Table.Tr>
</Table.Tbody>
</Table>
<Callout title="Главное правило">
Дерево — это как схема метро: от начальной станции (первого вопроса) до
конечной (поля ввода текста) должен существовать путь через любые
промежуточные станции (кнопки-варианты). Ваша задача — построить эти пути.
<DocSection id="principle-1" title="1. Чтобы кнопка появилась в боте" />
<Text>Три условия, все должны выполняться одновременно:</Text>
<Stack gap="xs">
<Text size="sm">
<b>а)</b> Раздел, в котором лежит дерево, должен быть создан и активен — если раздела
ещё нет, нажмите «Новый раздел» прямо на странице конструктора.
</Text>
<Text size="sm">
<b>б)</b> От первого вопроса до этой кнопки должен существовать полный путь без обрывов
— то есть у каждого шага на пути есть родитель, а сама кнопка либо ведёт дальше, либо
заканчивается текстовым вводом.
</Text>
<Text size="sm">
<b>в)</b> Сотруднику должно быть выдано право видеть этот раздел. Это отдельная
настройка прав доступа — она делается ПОСЛЕ того, как дерево готово, в другом разделе
системы, не здесь.
</Text>
</Stack>
<Callout title="Если кнопка не появляется">
Сначала проверьте (а) и (б) — они настраиваются прямо в конструкторе. Если с деревом всё в
порядке — дело в правах доступа (в), обратитесь к тому, кто их настраивает.
</Callout>
{/* ============================================================ */}
{/* ПОРЯДОК СОЗДАНИЯ */}
{/* ============================================================ */}
<DocSection id="howto" title="Как создать дерево — по шагам" />
<Text>
Ниже — точный порядок действий от пустой категории до готового,
работающего дерева.
</Text>
<DocSection id="step-1" title="Шаг 1. Выбрать категорию" level={2} />
<Text>
Откройте страницу «Конструктор деревьев» и в выпадающем списке «Категория»
выберите нужный раздел. Если подходящей категории ещё нет — обратитесь к
администратору, чтобы её создали (это отдельная настройка, не относится к
дереву).
</Text>
<Callout title="Совет">
Если дерево для этой категории уже существует, вы увидите его сразу после
выбора. Можно смело редактировать — все изменения сохраняются
автоматически, ничего не потеряется.
</Callout>
<DocSection id="step-2" title="Шаг 2. Создать первый узел" level={2} />
<Text>
Нажмите кнопку «Добавить корневой узел». Это будет самый первый вопрос,
который увидит сотрудник. Откроется окно с тремя полями:
</Text>
<Table withTableBorder withColumnBorders mt="xs">
<Table.Thead>
<Table.Tr>
<Table.Th style={{ width: 180 }}>Поле</Table.Th>
<Table.Th>Что писать</Table.Th>
</Table.Tr>
</Table.Thead>
<Table.Tbody>
<Table.Tr>
<Table.Td>Тип узла</Table.Td>
<Table.Td>Оставьте «Кнопка» — для первого шага почти всегда нужна кнопка</Table.Td>
</Table.Tr>
<Table.Tr>
<Table.Td>Название</Table.Td>
<Table.Td>То, что увидит сотрудник, например «Отпуска»</Table.Td>
</Table.Tr>
<Table.Tr>
<Table.Td>Ключ</Table.Td>
<Table.Td>
Не трогайте — заполняется автоматически из названия
</Table.Td>
</Table.Tr>
</Table.Tbody>
</Table>
<Text mt="sm">
Нажмите «Создать». Узел появится в дереве — с него всё и начинается.
</Text>
<DocSection id="step-3" title="Шаг 3. Добавить варианты (ветки)" level={2} />
<Text>
Наведите на созданный узел — рядом появятся кнопки. Нажмите «+», чтобы
добавить к нему дочерний узел — следующий шаг вопроса. Повторяйте это для
каждого варианта ответа.
</Text>
<Text>
Например, если первый узел — «Тип отпуска», добавьте к нему детей:
«Отпуск», «Отгул», «Больничный». Каждый из них — отдельная кнопка, которую
увидит сотрудник после выбора первого шага.
</Text>
<Callout title="Важно про DataKey и DataValue" mt="md">
Для узлов-кнопок в форме есть два поля: <b>DataKey</b> — название того, что
мы запоминаем (например «тип отпуска»), и <b>DataValue</b> — конкретное
значение этой кнопки (например «отпуск»). У всех кнопок-веток одного и того
же вопроса DataKey должен быть одинаковым, а DataValue — у каждой свой.
Смотрите готовый пример ниже — там всё видно на конкретных значениях.
</Callout>
<DocSection id="step-4" title="Шаг 4. Завершить ветку вводом текста" level={2} />
<Text>
Каждая ветка дерева обязательно должна заканчиваться узлом «Текстовый
ввод» — это последний шаг, где сотрудник пишет саму заявку своими словами.
Добавьте такой узел к каждому «листу» дерева (к узлу, у которого больше нет
вариантов выбора).
</Text>
<Text>
В форме выберите тип узла «Текстовый ввод» и заполните поле «Подсказка» —
это пример того, что должен написать сотрудник, чтобы ему было понятнее.
</Text>
<Callout title="Как проверить, что дерево готово">
Пройдите мысленно (или на бумаге) каждый путь от первого узла до конца.
Если какой-то путь обрывается на кнопке, не доходя до текстового ввода —
сотрудник не сможет завершить заявку. Добавьте туда узел ввода.
</Callout>
<DocSection id="step-5" title="Шаг 5. Настроить сообщение согласующему" level={2} />
<Text>
На узле, где заявка «превращается» в конкретную тему (обычно это последний
узел-кнопка перед вводом текста), можно раскрыть блок «Шаблоны сообщения и
кода темы» и задать, как будет выглядеть уведомление у согласующего в
Telegram. Подробно про это — в разделе{' '}
<Text component="span" fw={600}>«Как писать сообщение согласующему»</Text>{' '}
ниже. Если ничего не менять — сработает оформление по умолчанию.
</Text>
<DocSection id="step-6" title="Шаг 6. Проверить результат" level={2} />
<Text>
Дерево сохраняется автоматически после каждого действия — отдельной кнопки
«Сохранить всё» нажимать не нужно. Лучший способ проверить готовое дерево —
попросить коллегу создать тестовую заявку через бота и убедиться, что все
вопросы задаются в правильном порядке, а итоговое сообщение согласующему
выглядит понятно.
</Text>
{/* ============================================================ */}
{/* ТИПЫ УЗЛОВ */}
{/* ============================================================ */}
<DocSection id="node-types" title="Три типа узлов" />
<Text>
При создании или редактировании узла вы выбираете один из трёх типов:
</Text>
<Stack gap="sm" mt="md">
<Paper withBorder p="md">
<Group gap="xs" mb={4}>
<Text size="lg">🔘</Text>
<Text fw={600}>Кнопка</Text>
</Group>
<Text size="sm" c="dimmed">
Сотрудник нажимает и переходит к следующему шагу. Используется для
любого выбора из вариантов: регион, тип заявки, филиал и т.д.
Требует заполнения DataKey и DataValue.
</Text>
</Paper>
<Paper withBorder p="md">
<Group gap="xs" mb={4}>
<Text size="lg">📝</Text>
<Text fw={600}>Текстовый ввод</Text>
</Group>
<Text size="sm" c="dimmed">
Сотрудник печатает текст. Всегда завершает ветку дерева — после
него бот создаёт заявку. Требует заполнения «Подсказки» —
примера того, что нужно написать.
</Text>
</Paper>
<Paper withBorder p="md">
<Group gap="xs" mb={4}>
<Text size="lg">☑️</Text>
<Text fw={600}>Мультивыбор</Text>
</Group>
<Text size="sm" c="dimmed">
Сотрудник может отметить сразу несколько вариантов (например,
несколько систем: «ОКБ» и «1С»). Все отмеченные варианты
сохранятся вместе, через запятую.
</Text>
</Paper>
<DocSection id="principle-2" title="2. Как создать новую тему" />
<Text>Порядок действий с нуля:</Text>
<Stack gap="xs">
<Text size="sm">
<b>Шаг 1.</b> На странице конструктора нажмите «Новый раздел», если подходящего ещё
нет — впишите название, технический код заполнится сам.
</Text>
<Text size="sm">
<b>Шаг 2.</b> Нажмите «Добавить первый вопрос» — это то, что сотрудник увидит первым.
</Text>
<Text size="sm">
<b>Шаг 3.</b> Наведите на созданный шаг, нажмите «+» и добавьте варианты ответа. У всех
кнопок одного вопроса поле «что запомнить» должно совпадать — конструктор подставляет
его сам, начиная со второй кнопки.
</Text>
<Text size="sm">
<b>Шаг 4.</b> Каждую ветку обязательно завершите шагом «Текстовый ввод» — без него
сотрудник не сможет закончить заявку.
</Text>
<Text size="sm">
<b>Шаг 5.</b> В окне редактирования любого шага есть кнопка «Проверить» — она покажет,
появилась ли для этого пути настроенная тема в системе. Если её ещё нет — рядом
появится кнопка «Создать тему», нажмите её, ничего искать в других разделах не нужно.
</Text>
<Text size="sm">
<b>Шаг 6.</b> На самом первом (корневом) шаге дерева настройте текст сообщения
согласующему — см. следующий раздел, это важно.
</Text>
</Stack>
{/* ============================================================ */}
{/* ПРИМЕР 1 */}
{/* ============================================================ */}
<DocSection id="example-1" title="Пример: дерево «Отпуска»" />
<DocSection id="principle-3" title="3. Как изменить существующую тему" />
<Text>
Разберём готовый пример целиком — от первого узла до отправки заявки.
Сценарий: сотрудник выбирает тип отсутствия, затем способ оплаты, затем
пишет причину.
Найдите нужный раздел в выпадающем списке, разверните дерево и нажмите ✏️ на шаге, который
хотите поменять. Можно переименовать шаг, поменять подсказку для текстового ввода, добавить
новые варианты ответа или переставить шаги местами кнопками ↑ ↓ (среди соседних) и стрелками
с отступом (поднять/опустить на другой уровень вложенности). Все изменения сохраняются
сразу, отдельной кнопки «Сохранить» нет.
</Text>
<Callout title="Осторожно с удалением">
Удаление шага удаляет и все шаги, которые находятся под ним. Система переспросит перед
удалением.
</Callout>
<Timeline active={5} bulletSize={28} lineWidth={2} mt="md">
<Timeline.Item title="Корневой узел">
<Text size="sm" c="dimmed">
Название: <Code>Тип отсутствия</Code>. Тип узла: Кнопка. Это
«заголовок» дерева — сам по себе кнопкой сотруднику не показывается,
но от него отходят первые варианты.
</Text>
</Timeline.Item>
<Timeline.Item title="Три дочерних узла-кнопки">
<Text size="sm" c="dimmed">
Добавляем к корню три узла: <Code>Отпуск</Code>, <Code>Отгул</Code>,{' '}
<Code>Больничный</Code>. У всех трёх DataKey одинаковый —{' '}
<Code>absence_type</Code>, а DataValue разный: <Code>vacation</Code>,{' '}
<Code>timeoff</Code>, <Code>sickleave</Code>.
</Text>
</Timeline.Item>
<Timeline.Item title="Способ оплаты — для каждой ветки">
<Text size="sm" c="dimmed">
К узлу «Отпуск» добавляем два дочерних узла: <Code>За свой счёт</Code>{' '}
и <Code>В счёт отпуска</Code>. DataKey у обоих —{' '}
<Code>payment_type</Code>, DataValue — <Code>own_expense</Code> и{' '}
<Code>vacation_account</Code> соответственно. Аналогично поступаем с
ветками «Отгул» и «Больничный».
</Text>
</Timeline.Item>
<Timeline.Item title="Текстовый ввод — конец каждой ветки">
<Text size="sm" c="dimmed">
К каждому из узлов способа оплаты добавляем узел «Текстовый ввод» с
подсказкой: <Code>Укажите даты отпуска, например: 22.02.2026 — 25.02.2026</Code>.
</Text>
</Timeline.Item>
<Timeline.Item title="Сообщение согласующему">
<Text size="sm" c="dimmed">
На узле способа оплаты (там, где заявка уже точно определена)
открываем «Шаблоны сообщения и кода темы» и вписываем текст — см.
пример ниже.
</Text>
</Timeline.Item>
</Timeline>
<CodeBlock
title="Дерево целиком выглядит так"
code={`Тип отсутствия
├── Отпуск (absence_type = vacation)
│ ├── За свой счёт (payment_type = own_expense) → Ввод текста
│ └── В счёт отпуска (payment_type = vacation_account) → Ввод текста
├── Отгул (absence_type = timeoff)
│ ├── За свой счёт (payment_type = own_expense) → Ввод текста
│ └── В счёт отпуска (payment_type = vacation_account) → Ввод текста
└── Больничный (absence_type = sickleave)
└── Официальный (payment_type = official) → Ввод текста`}
/>
<DocSection id="templates" title="Сообщение согласующему — важное правило" />
<Alert icon={<IconAlertTriangle size={16} />} color="orange" variant="light">
<Text size="sm" fw={600}>
Текст сообщения и код темы настраиваются ОДИН РАЗ — на самом первом (корневом) шаге
дерева, а не на каждой отдельной ветке.
</Text>
</Alert>
<Text mt="sm">
Что увидит сотрудник в боте: сначала кнопки «Отпуск / Отгул /
Больничный», затем — «За свой счёт / В счёт отпуска», затем поле для
ввода дат. Три нажатия и один текст — заявка готова.
Если раньше вы пытались настроить отдельное сообщение на каком-то шаге в середине дерева и
оно «не сохранялось» или не действовало — вот почему: система всегда смотрит только на
самый первый шаг. Чтобы сообщение отличалось в зависимости от выбора сотрудника, в тексте
используются условия — но настраивается это тоже на первом шаге, одним общим текстом.
</Text>
<CodeBlock
title="Пример текста сообщения согласующему (поле «Шаблон сообщения»)"
code={`📋 <b>Тип: {{.absence_type_label}}</b>
<b>{{.initiator_name}}</b> просит согласовать: {{.payment_type_label}}
{{.content}}`}
/>
<Text size="sm" c="dimmed" mt="xs">
Всё, что в фигурных скобках — подставится автоматически: название узла,
который выбрал сотрудник, его имя и текст, который он написал. Про этот
синтаксис подробнее — в разделе ниже.
</Text>
{/* ============================================================ */}
{/* ПРИМЕР 2 */}
{/* ============================================================ */}
<DocSection id="example-2" title="Пример: выбор из нескольких списков" />
<Text>
Более сложный, но частый случай: нужно спросить у сотрудника два
независимых параметра подряд — например, филиал и тип расхода.
</Text>
<CodeBlock
title="Структура"
code={`Внебюджетные расходы
├── Филиал 1 (branch = f1)
│ ├── ТМЦ (expense_type = tmc) → Ввод текста
│ └── Расходы (expense_type = expense) → Ввод текста
└── Филиал 2 (branch = f2)
├── ТМЦ (expense_type = tmc) → Ввод текста
└── Расходы (expense_type = expense) → Ввод текста`}
/>
<Text mt="sm">
Обратите внимание: узел «ТМЦ» повторяется дважды — под «Филиал 1» и под
«Филиал 2». Это нормально: узлы с одинаковым названием на разных ветках
дерева — это разные, независимые узлы, у каждого свой ключ (система
добавляет к ключу префикс родителя автоматически).
</Text>
<CodeBlock
title="Пример сообщения согласующему"
code={`📋 <b>Внебюджетные расходы — {{.branch_label}} ({{.expense_type_label}})</b>
title="Пример: сообщение, которое меняется в зависимости от выбора"
code={`📋 <b>{{if eq .branch "f1"}}Филиал 1{{else}}Филиал 2{{end}}</b>
<b>{{.initiator_name}}</b>:
{{.content}}`}
/>
{/* ============================================================ */}
{/* ШАБЛОНЫ */}
{/* ============================================================ */}
<DocSection id="template-basics" title="Как писать сообщение согласующему" />
<Text>
В блоке «Шаблоны сообщения и кода темы» вы пишете обычный текст с
HTML-разметкой (<Code>&lt;b&gt;жирный&lt;/b&gt;</Code>,{' '}
<Code>&lt;i&gt;курсив&lt;/i&gt;</Code>) — так, как хотите видеть уведомление
у согласующего. В нужных местах вставляете «плейсхолдеры» в фигурных
скобках — они подставляются автоматически.
<Text mt="sm">
Не нужно запоминать этот синтаксис — на первом шаге дерева есть кнопка «Сформировать
черновик», которая сама подставит условия на основе первого вопроса дерева. Дальше можно
поправить текст руками и сразу посмотреть, как он будет выглядеть, через «Проверить готовую
ветку» в том же окне.
</Text>
<Table withTableBorder withColumnBorders mt="md">
<Table.Thead>
<Table.Tr>
<Table.Th style={{ width: 260 }}>Что написать</Table.Th>
<Table.Th>Что подставится</Table.Th>
</Table.Tr>
</Table.Thead>
<Table.Tbody>
<Table.Tr>
<Table.Td><Code>{`{{.initiator_name}}`}</Code></Table.Td>
<Table.Td>Имя сотрудника, который создал заявку</Table.Td>
</Table.Tr>
<Table.Tr>
<Table.Td><Code>{`{{.content}}`}</Code></Table.Td>
<Table.Td>Текст, который сотрудник ввёл на последнем шаге</Table.Td>
</Table.Tr>
<Table.Tr>
<Table.Td><Code>{`{{.название_кнопки_label}}`}</Code></Table.Td>
<Table.Td>
Название выбранной сотрудником кнопки. Например, если DataKey
кнопки — <Code>region</Code>, пишите{' '}
<Code>{`{{.region_label}}`}</Code>, и туда подставится «Крым» или
«Краснодар» — смотря что выбрал сотрудник
</Table.Td>
</Table.Tr>
</Table.Tbody>
</Table>
<Callout title="Проще всего — по аналогии" mt="md">
Не нужно запоминать синтаксис. Откройте похожий уже настроенный узел (в
этой же или другой категории), скопируйте оттуда шаблон и замените
плейсхолдеры на DataKey ваших узлов.
</Callout>
<Text mt="md">
Дополнительно доступны несколько простых условий — пригодятся, если
сообщение должно немного отличаться в зависимости от выбора:
</Text>
<CodeBlock
title="Показать текст, только если поле заполнено"
code={`{{if .payment_type_label}}Способ оплаты: {{.payment_type_label}}{{end}}`}
/>
<CodeBlock
title="Показать разный текст в зависимости от выбора"
code={`{{if eq .absence_type "vacation"}}Отпуск{{else}}Отгул{{end}}`}
/>
<Text size="sm" c="dimmed" mt="xs">
Поле «Шаблон кода темы» обычно можно не трогать — если оставить пустым,
система сама соберёт код заявки из всех выборов сотрудника. Заполняйте его
только если вам явно сказали, что для этой темы нужен особый код
(например, если это уже настроенная в системе тема с заранее заданным
названием).
Поле «Код темы» почти всегда можно оставить пустым — тогда код соберётся сам из всех
выборов сотрудника.
</Text>
{/* ============================================================ */}
{/* СОВЕТЫ */}
{/* ============================================================ */}
<DocSection id="tips" title="Советы и правила" />
<Stack gap="sm" mt="md">
<TipEntry
title="Одинаковый DataKey у братьев"
text="Все узлы-кнопки, отходящие от одного и того же родителя, должны иметь одинаковый DataKey (например, все — region), а DataValue у каждого — свой (crimea, krasnodar). Иначе бот запутается, какой ответ на какой вопрос сохранён."
/>
<TipEntry
title="Каждая ветка должна заканчиваться вводом текста"
text="Если ветка обрывается на кнопке — сотрудник не сможет закончить заявку. Всегда добавляйте узел «Текстовый ввод» в конце каждого пути."
/>
<TipEntry
title="Название узла — то, что видит сотрудник"
text="Пишите названия узлов понятно и коротко: то, что вы вводите в поле «Название», один в один появится кнопкой в Telegram."
/>
<TipEntry
title="Ключ трогать не обязательно"
text="Поле «Ключ» заполняется автоматически из названия — это техническая метка, которую использует система внутри себя. Менять его вручную нужно, только если он получился слишком длинным или непонятным."
/>
<TipEntry
title="Изменения сохраняются сразу"
text="Не нужно искать кнопку «Сохранить дерево» — каждое действие (добавление, редактирование, перемещение, удаление узла) применяется мгновенно."
/>
<TipEntry
title="Удаление узла удаляет и всё, что под ним"
text="Если вы удаляете узел, у которого есть дочерние узлы — они удалятся вместе с ним. Система предупредит об этом перед удалением."
/>
</Stack>
{/* ============================================================ */}
{/* ДИАГНОСТИКА */}
{/* ============================================================ */}
<DocSection id="troubleshooting" title="Если что-то не работает" />
<DocSection id="check" title="Как проверить, что всё работает" />
<Text>
Частые ситуации и что с ними делать:
Под деревом есть блок «Проверка дерева» с кнопкой «Проверить все ветки» — он пройдёт по
каждому возможному пути и покажет, для всех ли есть настроенная тема. Это быстрее, чем
вручную проходить весь сценарий в Telegram, и находит проблему до того, как её найдёт
сотрудник.
</Text>
<DocSection id="troubleshooting" title="Если что-то не работает" />
<Stack gap="md" mt="md">
<ErrorEntry
title="Бот не находит тему заявки после всех вопросов"
description="Это значит, что набор выборов сотрудника не совпал ни с одной настроенной темой в системе."
resolution="Проверьте узел, где задан код темы (поле «Код темы» или шаблон кода) — сверьте его с администратором системы, который заводит темы заявок."
title="Бот не находит тему после всех вопросов"
description="Набор ответов сотрудника не совпал ни с одной настроенной темой."
resolution="Откройте конструктор, найдите этот путь и нажмите «Проверить» в окне редактирования последнего шага — если темы нет, там же можно её создать."
/>
<ErrorEntry
title="В сообщении согласующему вместо текста написано «<no value>»"
description="Шаблон сообщения ссылается на вариант, который сотрудник не выбирал на этом пути."
resolution="Проверьте, что в дереве действительно есть узел с таким DataKey на пути к этому сообщению, и уберите из шаблона лишние плейсхолдеры."
title="Я поменял сообщение, но согласующий видит старый текст"
description="Скорее всего, текст был изменён не на самом первом (корневом) шаге дерева."
resolution="Откройте редактирование первого шага дерева — сообщение настраивается только там."
/>
<ErrorEntry
title="Система не даёт сохранить узел — «ключ уже используется»"
description="В этой же категории уже есть узел с таким же техническим ключом."
resolution="Измените название узла (ключ сгенерируется заново) или вручную поправьте поле «Ключ» на уникальное значение."
title="Кнопка не появляется у сотрудника"
description="Либо путь до неё оборван, либо не выданы права на раздел."
resolution="Проверьте цепочку шагов в конструкторе; если с деревом всё в порядке — обратитесь по поводу прав доступа."
/>
<ErrorEntry
title="Не получается переместить узел"
description="Система не разрешает сделать узел «родителем самого себя» — например, перетащить ветку внутрь её же собственного потомка."
resolution="Выберите другого родителя, который не находится ниже перемещаемого узла по дереву."
/>
<ErrorEntry
title="Сотрудник дошёл до конца, а кнопки «Отправить» нет"
description="Скорее всего, эта ветка дерева не заканчивается узлом «Текстовый ввод»."
resolution="Найдите последнюю кнопку в этой ветке и добавьте к ней дочерний узел типа «Текстовый ввод»."
title="Не получается сохранить шаг — «ключ уже используется»"
description="В этом разделе уже есть шаг с таким же техническим ключом."
resolution="Немного измените название — ключ пересоберётся сам."
/>
</Stack>
<Divider mt="xl" />
<Text size="sm" c="dimmed" ta="center">
Остались вопросы — обратитесь к администратору системы согласований.
Остались вопросы — обратитесь к тому, кто настраивал вам эту систему.
</Text>
</Stack>
</Box>
@ -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 (
<Box id={id} pt={8}>
{level === 1 ? (
<Title order={2}>{title}</Title>
) : (
<Title order={3} c="dimmed">{title}</Title>
)}
<Title order={2}>{title}</Title>
</Box>
)
}
@ -690,23 +276,11 @@ function DocSection({ id, title, level = 1 }: { id: string; title: string; level
function CodeBlock({ title, code }: { title: string; code: string }) {
return (
<Paper withBorder mt="md">
<Group justify="space-between" px="sm" py={6} style={{ borderBottom: '1px solid var(--mantine-color-gray-3)' }}>
<Text size="xs" fw={600} c="dimmed" tt="uppercase" lts={0.5}>{title}</Text>
<CopyButton value={code}>
{({ copied, copy }) => (
<Tooltip label={copied ? 'Скопировано' : 'Копировать'}>
<ActionIcon
size="xs"
variant="subtle"
color={copied ? 'teal' : 'gray'}
onClick={copy}
>
{copied ? <IconCheck size={14} /> : <IconCopy size={14} />}
</ActionIcon>
</Tooltip>
)}
</CopyButton>
</Group>
<Box px="sm" py={6} style={{ borderBottom: '1px solid var(--mantine-color-gray-3)' }}>
<Text size="xs" fw={600} c="dimmed" tt="uppercase" lts={0.5}>
{title}
</Text>
</Box>
<Box p="sm">
<Code block style={{ fontSize: 12, whiteSpace: 'pre-wrap', lineHeight: 1.5 }}>
{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 (
<Alert
variant="light"
color="blue"
icon={<IconBulb size={16} />}
title={title}
mt={mt}
styles={{
title: { fontSize: 13, fontWeight: 600 },
message: { fontSize: 13 },
}}
>
<Alert variant="light" color="blue" icon={<IconBulb size={16} />} title={title} mt="md">
{children}
</Alert>
)
}
function TipEntry({ title, text }: { title: string; text: string }) {
return (
<Group gap="md" align="flex-start" wrap="nowrap">
<ThemeIcon variant="light" color="teal" size={28} radius="xl" style={{ flexShrink: 0 }}>
<IconBulb size={16} />
</ThemeIcon>
<Box>
<Text size="sm" fw={600}>{title}</Text>
<Text size="sm" c="dimmed">{text}</Text>
</Box>
</Group>
)
}
function ErrorEntry({ title, description, resolution }: { title: string; description: string; resolution: string }) {
return (
<Paper withBorder p="sm">
<Group gap="xs" mb={4}>
<ThemeIcon variant="light" color="orange" size={22} radius="xl">
<IconAlertTriangle size={13} />
</ThemeIcon>
<Text size="sm" fw={600}>{title}</Text>
<IconAlertTriangle size={16} color="var(--mantine-color-orange-6)" />
<Text size="sm" fw={600}>
{title}
</Text>
</Group>
<Text size="sm" c="dimmed">{description}</Text>
<Text size="sm" c="dimmed">
{description}
</Text>
<Text size="sm" mt={4}>
<Text span fw={600}>Что делать: </Text>
<Text span c="dimmed">{resolution}</Text>
<Text span fw={600}>
Что делать:{' '}
</Text>
<Text span c="dimmed">
{resolution}
</Text>
</Text>
</Paper>
)

View File

@ -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<number | null>(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<ApprovalTopicCategory | null>(() => {
return categories.find((c) => c.id === selectedCategoryId) || null
}, [categories, selectedCategoryId])
const selectedCategory = useMemo<ApprovalTopicCategory | null>(
() => 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: (
<Text size="sm">
Удалить узел <b>{node.label}</b>? Все дочерние узлы также будут удалены.
Удалить шаг <b>{node.label}</b>? Все шаги, которые идут после него, тоже удалятся.
</Text>
),
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 (
<Stack gap="md">
<Group justify="space-between">
<Text size="xl" fw={700}>Конструктор деревьев</Text>
<Text size="xl" fw={700}>
Конструктор дерева заявок
</Text>
<Group>
{selectedCategory && (
<Badge size="lg" variant="light">{totalNodes} узлов</Badge>
)}
<Button
variant="light"
leftSection={<IconBook size={16} />}
onClick={() => navigate('/guide/flow-trees')}
>
{selectedCategory && <Badge size="lg" variant="light">{totalNodes} шагов</Badge>}
<Button variant="light" leftSection={<IconBook size={16} />} onClick={() => navigate('/guide/flow-trees')}>
Руководство
</Button>
</Group>
</Group>
{/* Выбор категории */}
<Paper withBorder p="md">
<Select
label="Категория"
placeholder="Выберите категорию для редактирования дерева"
data={categoryOptions}
value={selectedCategoryId ? String(selectedCategoryId) : null}
onChange={(v) => setSelectedCategoryId(v ? Number(v) : null)}
searchable
required
/>
<Group align="end" gap="sm">
<Select
label="Раздел заявок"
placeholder="Выберите раздел, дерево которого будете настраивать"
data={categoryOptions}
value={selectedCategoryId ? String(selectedCategoryId) : null}
onChange={(v) => setSelectedCategoryId(v ? Number(v) : null)}
searchable
style={{ flex: 1 }}
/>
<Tooltip label="Завести новый раздел заявок, не выходя отсюда">
<Button
variant="default"
leftSection={<IconFolderPlus size={16} />}
onClick={() => setCategoryModalOpened(true)}
>
Новый раздел
</Button>
</Tooltip>
</Group>
</Paper>
{/* Дерево */}
{selectedCategoryId && (
<Paper withBorder p="md">
<Stack gap="md">
<Group justify="space-between">
<Group gap="xs">
<Text fw={600}>Дерево навигации</Text>
<Text fw={600}>Дерево вопросов</Text>
{treeLoading && <Loader size="xs" />}
</Group>
<Group>
<Tooltip label="Обновить">
<ActionIcon
variant="light"
onClick={() => {
if (selectedCategoryId) {
window.location.reload()
}
}}
>
<IconRefresh size={16} />
</ActionIcon>
</Tooltip>
<Button
leftSection={<IconPlus size={16} />}
onClick={handleAddRoot}
>
Добавить корневой узел
</Button>
</Group>
<Button leftSection={<IconPlus size={16} />} onClick={handleAddRoot} disabled={tree.length > 0}>
Добавить первый вопрос
</Button>
</Group>
<Alert icon={<IconInfoCircle size={16} />} color="blue" variant="light">
<Text size="sm">
<b>Совет:</b> Используйте кнопки ↑ ↓ для изменения порядка,{' '}
<b>+</b> для добавления дочернего узла, <b>📋</b> для дублирования.
Все изменения сохраняются автоматически. Шаблоны сообщения и кода
темы (Go template) задаются в редакторе узла — обычно на том узле,
где также указан <b>topic_code</b>.
Значки справа от каждого шага: ↑ ↓ — переставить среди соседних кнопок; стрелки с
отступом — поднять/опустить на другой уровень вложенности; + — добавить следующий
шаг; ✏️ — изменить; 📋 — сделать копию; 🗑 — удалить. Всё сохраняется сразу.
</Text>
</Alert>
@ -238,12 +184,9 @@ export default function FlowTreePage() {
) : tree.length === 0 ? (
<Center p={40}>
<Stack gap="sm" align="center">
<Text c="dimmed">Дерево пустое</Text>
<Button
leftSection={<IconPlus size={16} />}
onClick={handleAddRoot}
>
Добавить первый узел
<Text c="dimmed">В этом разделе пока нет вопросов</Text>
<Button leftSection={<IconPlus size={16} />} onClick={handleAddRoot}>
Добавить первый вопрос
</Button>
</Stack>
</Center>
@ -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}
/>
))}
</Stack>
@ -270,36 +215,24 @@ export default function FlowTreePage() {
</Paper>
)}
{/* Модалка редактирования узла.
Помимо key/label/data_key и т.д. должна включать поля
message_template и code_template (Go template) — они
хранятся на самом узле. saveTree/create/update передают
category_id вместо topic_id. */}
{selectedCategoryId && tree.length > 0 && <TreeHealthPanel categoryId={selectedCategoryId} tree={tree} />}
{selectedCategoryId && (
<FlowNodeEditModal
categoryId={selectedCategoryId}
tree={tree}
parentNode={editModal.parentNode}
editNode={editModal.editNode}
opened={editModal.opened}
onClose={() => setEditModal({ opened: false, parentNode: null, editNode: null })}
/>
)}
<CategoryCreateModal
opened={categoryModalOpened}
onClose={() => setCategoryModalOpened(false)}
onCreated={(newId) => setSelectedCategoryId(newId)}
/>
</Stack>
)
}
// Вспомогательная функция: найти родителя узла по 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
}

View File

@ -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<string, string> = {
а: '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<ApprovalTopicCategory>), axios кладёт его в response.data.
const newId = result?.data?.id
if (newId) onCreated(newId)
onClose()
}
return (
<Modal opened={opened} onClose={onClose} title={<Text fw={700}>Новый раздел заявок</Text>}>
<form onSubmit={form.onSubmit(handleSubmit)}>
<Stack gap="md">
<Alert icon={<IconInfoCircle size={16} />} color="blue" variant="light">
<Text size="xs">
Раздел — это то, что сотрудник увидит в главном меню бота (например, «Отпуска» или
«Возвраты»). Внутри одного раздела вы потом соберёте дерево вопросов.
</Text>
</Alert>
<TextInput
label="Название раздела"
placeholder="Например: Возвраты товара"
description="То, что увидит сотрудник в списке заявок"
required
{...form.getInputProps('name')}
/>
<TextInput
label="Технический код"
description="Заполняется само из названия. Трогать не нужно."
disabled
{...form.getInputProps('code')}
/>
<Textarea
label="Описание (необязательно)"
placeholder="Короткая заметка для себя, сотрудники её не видят"
minRows={2}
{...form.getInputProps('description')}
/>
<Group justify="flex-end" mt="sm">
<Button variant="default" onClick={onClose}>
Отмена
</Button>
<Button type="submit" loading={createCategory.isPending}>
Создать раздел
</Button>
</Group>
</Stack>
</form>
</Modal>
)
}

View File

@ -4,7 +4,6 @@ import {
Stack,
TextInput,
Textarea,
Switch,
Group,
Button,
Text,
@ -13,18 +12,38 @@ import {
Select,
Code,
Alert,
Tooltip,
Box,
Collapse,
ActionIcon,
Divider,
Loader,
} from '@mantine/core'
import { useForm } from '@mantine/form'
import { useCreateFlowNode, useUpdateFlowNode, useFlowNodesTree } from '@/features/flowNodes/hooks/useFlowNodes'
import {
IconAlertCircle,
IconInfoCircle,
IconChevronDown,
IconChevronRight,
IconWand,
IconEye,
IconCircleCheck,
IconCirclePlus,
} from '@tabler/icons-react'
import { useCreateFlowNode, useUpdateFlowNode, usePreviewFlow } from '@/features/flowNodes/hooks/useFlowNodes'
import { useCreateTopic } from '@/features/topics/hooks/useTopics'
import type { CreateTopicRequest } from '@/api/topics'
import {
collectFromPath,
collectLeafPaths,
generateDraftMessageTemplate,
getPathToNode,
pathLabel,
} from '@/features/flowNodes/utils/treeWalk'
import type { ApprovalFlowNode } from '@/types/api'
import { IconAlertCircle, IconInfoCircle, IconChevronDown, IconChevronRight } from '@tabler/icons-react'
interface FlowNodeEditModalProps {
categoryId: number
tree: ApprovalFlowNode[]
parentNode: ApprovalFlowNode | null
editNode: ApprovalFlowNode | null
opened: boolean
@ -32,44 +51,43 @@ interface FlowNodeEditModalProps {
}
const NODE_TYPE_OPTIONS = [
{ value: 'button', label: '🔘 Кнопка — пользователь нажимает и переходит дальше' },
{ value: 'input', label: '📝 Текстовый ввод — пользователь вводит текст' },
{ value: 'multiselect', label: '☑️ Мультиселект — пользователь выбирает несколько вариантов' },
{ value: 'button', label: '🔘 Кнопка — сотрудник нажимает и переходит к следующему вопросу' },
{ value: 'input', label: '📝 Текстовый ввод — сотрудник пишет заявку своими словами (конец пути)' },
{ value: 'multiselect', label: '☑️ Можно выбрать несколько вариантов сразу' },
]
// Утилиты для генерации ключей
// Таблица транслитерации
const TRANSLIT_MAP: Record<string, string> = {
'а': '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',
а: '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',
}
const transliterate = (text: string): string => {
return text
.toLowerCase()
.split('')
.map(char => TRANSLIT_MAP[char] ?? char)
.join('')
function transliterate(text: string): string {
return text.toLowerCase().split('').map((ch) => TRANSLIT_MAP[ch] ?? ch).join('')
}
const generateKeyFromLabel = (label: string): string => {
if (!label || label.trim() === '') return ''
const transliterated = transliterate(label.trim().toLowerCase())
return transliterated
.replace(/[\s\-]+/g, '_')
function slugify(label: string): string {
if (!label?.trim()) return ''
return transliterate(label.trim())
.replace(/[\s-]+/g, '_')
.replace(/[^a-z0-9_]/g, '')
.replace(/_+/g, '_')
.replace(/^_+|_+$/g, '')
.substring(0, 50)
}
function collectAllKeys(nodes: ApprovalFlowNode[]): string[] {
const keys: string[] = []
for (const node of nodes) {
if (node.key) keys.push(node.key)
if (node.children) keys.push(...collectAllKeys(node.children))
}
return keys
}
export default function FlowNodeEditModal({
categoryId,
tree,
parentNode,
editNode,
opened,
@ -77,12 +95,18 @@ export default function FlowNodeEditModal({
}: FlowNodeEditModalProps) {
const createFlowNode = useCreateFlowNode()
const updateFlowNode = useUpdateFlowNode()
const { data: treeData } = useFlowNodesTree(categoryId)
const tree = treeData?.data || []
const createTopic = useCreateTopic()
const previewFlow = usePreviewFlow(categoryId)
const [showAdvanced, setShowAdvanced] = useState(false)
const [showTemplates, setShowTemplates] = useState(false)
const [previewLeafKey, setPreviewLeafKey] = useState<string | null>(null)
const isEditMode = editNode !== null
// Корень дерева категории — узел без родителя. Только на нём имеют
// смысл шаблоны сообщения/кода: DynamicTopic на бэкенде читает их
// ИСКЛЮЧИТЕЛЬНО с узла с parent_id = null (см. approvalflow.NewDynamicTopic).
const isRootNode = parentNode === null
const form = useForm({
initialValues: {
@ -101,77 +125,64 @@ export default function FlowNodeEditModal({
auto_generate_key: true,
},
validate: {
key: (v: string | any[]) => {
if (!v || v.length < 2) return 'Ключ должен содержать минимум 2 символа'
if (!/^[a-z0-9_]+$/.test(v as string)) return 'Только lowercase буквы, цифры и подчеркивания'
// Проверка уникальности ключа
key: (v) => {
if (!v || v.length < 2) return 'Слишком короткий технический ключ'
if (!/^[a-z0-9_]+$/.test(v)) return 'Только латинские буквы, цифры и подчёркивания'
const existingKeys = collectAllKeys(tree)
if (existingKeys.includes(v as string) && (!editNode || editNode.key !== v)) {
return 'Ключ уже используется в этой категории'
}
return null
},
label: (v: string | any[]) => (!v || v.length < 1 ? 'Название обязательно' : null),
data_key: (v: string | any[], values: { nodeType: string }) => {
if (values.nodeType === 'button' || values.nodeType === 'input') {
if (!v || v.length < 1) return 'DataKey обязателен для кнопок и ввода'
}
return null
},
data_value: (v: string | any[], values: { nodeType: string }) => {
if (values.nodeType === 'button' || values.nodeType === 'input') {
if (!v || v.length < 1) return 'DataValue обязателен для кнопок и ввода'
}
return null
},
input_hint: (v: string | any[], values: { nodeType: string }) => {
if (values.nodeType === 'input' && (!v || v.length < 5)) {
return 'Подсказка должна содержать минимум 5 символов'
if (existingKeys.includes(v) && (!editNode || editNode.key !== v)) {
return 'Такой ключ уже есть в этой категории — измените название'
}
return null
},
label: (v) => (!v || v.length < 1 ? 'Название обязательно' : null),
data_key: (v, values) =>
(values.nodeType === 'button' || values.nodeType === 'input') && !v && !isRootNode
? null // необязательно даже для кнопки — но предупредим отдельно (см. warnings)
: null,
input_hint: (v, values) =>
values.nodeType === 'input' && (!v || v.length < 5) ? 'Подсказка должна быть не короче 5 символов' : null,
},
})
// Автоматическая генерация ключа из label
// Ближайшие "братья" (уже существующие соседние кнопки того же родителя) —
// используем, чтобы подсказать DataKey автоматически: у всех кнопок
// одного вопроса DataKey обязан совпадать.
const siblingDataKey = useMemo(() => {
const siblings = parentNode?.children || (parentNode === null ? [] : [])
const withKey = siblings.find((s) => s.data_key)
return withKey?.data_key || ''
}, [parentNode])
const siblingMultiKey = useMemo(() => {
const siblings = parentNode?.children || []
const withKey = siblings.find((s) => s.multi_select_key)
return withKey?.multi_select_key || ''
}, [parentNode])
// Автогенерация ключа из названия
useEffect(() => {
if (form.values.auto_generate_key && form.values.label) {
const generatedKey = generateKeyFromLabel(form.values.label)
const parentPrefix = parentNode?.key ? `${parentNode.key}_` : ''
form.setFieldValue('key', parentPrefix + generatedKey)
form.setFieldValue('key', parentPrefix + slugify(form.values.label))
}
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [form.values.label, form.values.auto_generate_key, parentNode])
// Автоматическое заполнение полей при смене типа узла
// Автоподстановка DataKey/DataValue при смене типа/названия
useEffect(() => {
const nodeType = form.values.nodeType
if (nodeType === 'button') {
// Для кнопки — типичные значения
if (!form.values.data_key) {
form.setFieldValue('data_key', 'type')
}
if (!form.values.data_value) {
form.setFieldValue('data_value', generateKeyFromLabel(form.values.label))
}
} else if (nodeType === 'input') {
// Для ввода — стандартные значения
form.setFieldValue('data_key', '')
form.setFieldValue('data_value', '')
form.setFieldValue('input_key', 'content')
} else if (nodeType === 'multiselect') {
// Для мультиселекта — типичные значения
if (!form.values.multi_select_key) {
form.setFieldValue('multi_select_key', 'options')
}
if (!form.values.multi_select_value) {
form.setFieldValue('multi_select_value', generateKeyFromLabel(form.values.label))
}
if (form.values.nodeType === 'button') {
if (!form.values.data_key) form.setFieldValue('data_key', siblingDataKey || '')
if (!form.values.data_value) form.setFieldValue('data_value', slugify(form.values.label))
} else if (form.values.nodeType === 'multiselect') {
if (!form.values.multi_select_key) form.setFieldValue('multi_select_key', siblingMultiKey || '')
if (!form.values.multi_select_value) form.setFieldValue('multi_select_value', slugify(form.values.label))
} else if (form.values.nodeType === 'input') {
if (!form.values.input_key) form.setFieldValue('input_key', 'content')
}
}, [form.values.nodeType])
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [form.values.nodeType, form.values.label, siblingDataKey, siblingMultiKey])
// Заполнение формы при редактировании
// Заполнение формы при редактировании / сброс при создании
useEffect(() => {
if (editNode) {
let nodeType: 'button' | 'input' | 'multiselect' = 'button'
@ -191,9 +202,10 @@ export default function FlowNodeEditModal({
topic_code: editNode.topic_code || '',
message_template: editNode.message_template || '',
code_template: editNode.code_template || '',
auto_generate_key: false, // При редактировании не генерируем автоматически
auto_generate_key: false,
})
setShowTemplates(!!(editNode.message_template || editNode.code_template))
setShowAdvanced(!!editNode.topic_code)
} else {
form.reset()
const baseKey = parentNode?.key || ''
@ -213,7 +225,10 @@ export default function FlowNodeEditModal({
auto_generate_key: true,
})
setShowTemplates(false)
setShowAdvanced(false)
}
previewFlow.reset()
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [editNode, parentNode, opened])
const handleSubmit = async (values: typeof form.values) => {
@ -229,8 +244,8 @@ export default function FlowNodeEditModal({
multi_select_key: values.nodeType === 'multiselect' ? values.multi_select_key : null,
multi_select_value: values.nodeType === 'multiselect' ? values.multi_select_value : null,
topic_code: values.topic_code || null,
message_template: values.message_template || null,
code_template: values.code_template || null,
message_template: isRootNode ? values.message_template || null : null,
code_template: isRootNode ? values.code_template || null : null,
}
if (isEditMode && editNode?.id) {
@ -248,28 +263,87 @@ export default function FlowNodeEditModal({
const isSubmitting = createFlowNode.isPending || updateFlowNode.isPending
const nodeType = form.values.nodeType
// Предупреждения
const warnings = useMemo(() => {
const warns: string[] = []
if (nodeType === 'button' && !form.values.data_key) {
warns.push('Для кнопки необходимо указать DataKey — ключ, куда сохранится значение')
}
if (nodeType === 'button' && !form.values.data_value) {
warns.push('Для кнопки необходимо указать DataValue — значение, которое сохранится')
}
if (nodeType === 'input' && !form.values.input_hint) {
warns.push('Рекомендуется добавить подсказку (InputHint) для пользователя')
warns.push('У кнопки нет «что запомнить» — без этого бот не поймёт, что выбрал сотрudnik. Заполните поля ниже.')
}
if (nodeType === 'multiselect' && !form.values.multi_select_key) {
warns.push('Для мультиселекта необходимо указать MultiSelectKey')
warns.push('Не заполнено, что запоминать при мультивыборе.')
}
if ((form.values.message_template || form.values.code_template) && !form.values.topic_code) {
warns.push('Шаблоны сообщения/кода обычно имеют смысл только на узле с заполненным Code темы (topic_code)')
}
return warns
}, [nodeType, form.values])
}, [nodeType, form.values.data_key, form.values.multi_select_key])
// ============================================================
// Черновик пути для предпросмотра (виртуальный узел = текущие
// значения формы, ещё не сохранённые)
// ============================================================
const pathToParent = useMemo(() => {
if (!parentNode?.id) return []
return getPathToNode(tree, parentNode.id)
}, [tree, parentNode])
const virtualNode: ApprovalFlowNode = {
...(editNode || {}),
data_key: form.values.data_key || undefined,
data_value: form.values.data_value || undefined,
multi_select_key: form.values.multi_select_key || undefined,
multi_select_value: form.values.multi_select_value || undefined,
is_input: nodeType === 'input',
} as ApprovalFlowNode
const currentPathCollected = useMemo(
() => collectFromPath([...pathToParent, virtualNode]),
// eslint-disable-next-line react-hooks/exhaustive-deps
[pathToParent, form.values.data_key, form.values.data_value, form.values.multi_select_key, form.values.multi_select_value, nodeType]
)
const handleCheckThisStep = () => {
previewFlow.mutate({ collected: currentPathCollected })
}
const handleCreateTopicFromPreview = async () => {
if (!previewFlow.data?.code) return
// Намеренно НЕ передаём message_template/code_template/is_tree_root на
// самой теме: боевой код (approvalflow.DynamicTopic) читает шаблоны
// только с корневого узла дерева, а не с ApprovalTopic — см. FlowNodeEditModal
// раздел "Сообщение согласующему" (isRootNode). Заполнение этих полей
// здесь ничего бы не включило и только запутало бы админа.
const payload: CreateTopicRequest = {
category_id: categoryId,
code: previewFlow.data.code,
name: form.values.label || previewFlow.data.code,
is_active: true,
}
await createTopic.mutateAsync(payload)
previewFlow.mutate({ collected: currentPathCollected })
}
// ============================================================
// Для корневого узла: список готовых веток дерева для предпросмотра
// ============================================================
const leafOptions = useMemo(() => {
if (!isRootNode) return []
return collectLeafPaths(tree).map((path) => ({
value: path.map((n) => n.id).join('-'),
label: pathLabel(path),
collected: collectFromPath(path),
}))
}, [isRootNode, tree])
const handleGenerateDraft = () => {
if (!editNode && !parentNode) return
const rootForDraft = editNode || { label: form.values.label, children: [] }
form.setFieldValue('message_template', generateDraftMessageTemplate(rootForDraft as ApprovalFlowNode))
}
const handlePreviewLeaf = (leafKey: string | null) => {
setPreviewLeafKey(leafKey)
const option = leafOptions.find((o) => o.value === leafKey)
if (option) {
previewFlow.mutate({ collected: option.collected })
}
}
return (
<Modal
@ -277,13 +351,10 @@ export default function FlowNodeEditModal({
onClose={onClose}
title={
<Group>
<Text fw={700}>
{isEditMode ? 'Редактирование узла' : 'Новый узел'}
</Text>
{editNode && <Badge variant="light">ID: {editNode.id}</Badge>}
<Text fw={700}>{isEditMode ? 'Изменить шаг' : 'Новый шаг'}</Text>
{parentNode && (
<Badge variant="light" color="gray">
родитель: {parentNode.label}
после: {parentNode.label}
</Badge>
)}
</Group>
@ -292,7 +363,6 @@ export default function FlowNodeEditModal({
>
<form onSubmit={form.onSubmit(handleSubmit)}>
<Stack gap="md">
{/* Предупреждения */}
{warnings.length > 0 && (
<Alert icon={<IconAlertCircle size={16} />} color="yellow" variant="light">
<Stack gap={4}>
@ -305,275 +375,280 @@ export default function FlowNodeEditModal({
</Alert>
)}
{/* Тип узла */}
<Paper withBorder p="md">
<Text size="sm" fw={600} mb="sm">
1. Выберите тип узла
1. Тип шага
</Text>
<Select
data={NODE_TYPE_OPTIONS}
value={form.values.nodeType}
onChange={(v) => form.setFieldValue('nodeType', (v as any) || 'button')}
description="Тип узла определяет, как пользователь будет взаимодействовать с этим элементом"
/>
</Paper>
{/* Основные поля */}
<Paper withBorder p="md">
<Text size="sm" fw={600} mb="sm">
2. Основные поля
2. Что увидит сотрудник
</Text>
<Stack gap="sm">
<TextInput
label="Название (Label)"
label="Название"
placeholder="Крым, ТМЦ, В счёт отпуска..."
description="Текст, который увидит пользователь на кнопке"
description="Текст на кнопке (или заголовок вопроса для первого шага)"
required
{...form.getInputProps('label')}
/>
<Group align="end" gap="sm">
<TextInput
label="Ключ (Key)"
placeholder="crimea, f1_tmc..."
description="Уникальный идентификатор узла в рамках категории (только lowercase, цифры, подчеркивания)"
required
style={{ flex: 1 }}
disabled={form.values.auto_generate_key}
{...form.getInputProps('key')}
/>
<Tooltip label={form.values.auto_generate_key ? 'Автогенерация включена' : 'Автогенерация выключена'}>
<Switch
label="Авто"
checked={form.values.auto_generate_key}
onChange={(e) => form.setFieldValue('auto_generate_key', e.currentTarget.checked)}
mb={5}
/>
</Tooltip>
</Group>
{form.values.auto_generate_key && (
<Text size="xs" c="dimmed">
💡 Ключ генерируется автоматически из названия. Можно отключить и ввести вручную.
</Text>
)}
<TextInput
label="Код темы (topic_code)"
placeholder="non_budget_f1"
description={
<Text size="xs">
Используется двояко: (1) для проверки прав — если задан,
кнопка видна только пользователям с правом <Code>create</Code> на
эту тему; (2) как код итоговой <Code>ApprovalTopic</Code>, в
которую резолвится этот путь по дереву — от него зависят
шаблоны ниже. Оставьте пустым для промежуточных узлов дерева.
</Text>
}
{...form.getInputProps('topic_code')}
/>
</Stack>
</Paper>
{/* DataKey/DataValue — для кнопок и input */}
{(nodeType === 'button' || nodeType === 'input') && (
{(nodeType === 'button' || nodeType === 'multiselect') && (
<Paper withBorder p="md">
<Text size="sm" fw={600} mb="sm">
3. Сохранение данных
3. Что запомнить при нажатии
</Text>
<Alert icon={<IconInfoCircle size={16} />} color="blue" variant="light" mb="sm">
<Text size="xs">
Когда пользователь выберет этот узел, система сохранит значение в формате:{' '}
<Code>{form.values.data_key || 'key'} = {form.values.data_value || 'value'}</Code>
Если у этого вопроса уже есть другие варианты ответа — поле «что запомнить» уже
подставлено само (оно должно быть одинаковым у всех кнопок одного вопроса).
Меняйте только «значение» — оно у каждой кнопки своё.
</Text>
</Alert>
<Group gap="sm" align="end">
<TextInput
label="DataKey (ключ)"
placeholder="region, branch, payment_type..."
description="Имя переменной, куда сохранится значение"
required={nodeType === 'button'}
style={{ flex: 1 }}
{...form.getInputProps('data_key')}
/>
<TextInput
label="DataValue (значение)"
placeholder="crimea, f1, own_expense..."
description="Значение, которое сохранится"
required={nodeType === 'button'}
style={{ flex: 1 }}
{...form.getInputProps('data_value')}
/>
</Group>
<Text size="xs" c="dimmed" mt="xs">
💡 <b>Примеры:</b> region=crimea, branch=f1, payment_type=own_expense
</Text>
{nodeType === 'button' ? (
<Group gap="sm" align="end">
<TextInput
label="Что запомнить (например: регион)"
style={{ flex: 1 }}
{...form.getInputProps('data_key')}
/>
<TextInput
label="Значение этой кнопки (например: crimea)"
style={{ flex: 1 }}
{...form.getInputProps('data_value')}
/>
</Group>
) : (
<Group gap="sm" align="end">
<TextInput
label="Что запомнить (например: системы)"
style={{ flex: 1 }}
{...form.getInputProps('multi_select_key')}
/>
<TextInput
label="Значение этого варианта"
style={{ flex: 1 }}
{...form.getInputProps('multi_select_value')}
/>
</Group>
)}
</Paper>
)}
{/* Поля для input */}
{nodeType === 'input' && (
<Paper withBorder p="md">
<Text size="sm" fw={600} mb="sm">
3. Настройки текстового ввода
3. Подсказка для сотрудника
</Text>
<Stack gap="sm">
<TextInput
label="InputKey (ключ для сохранения текста)"
placeholder="content"
description="Ключ, куда сохранится введённый пользователем текст"
required
{...form.getInputProps('input_key')}
/>
<Textarea
label="InputHint (подсказка для пользователя)"
placeholder="Опишите изменения: текущие данные → новые данные"
description="Шаблон или пример, который увидит пользователь при вводе текста"
minRows={3}
required
{...form.getInputProps('input_hint')}
/>
<Text size="xs" c="dimmed">
💡 Подсказка помогает пользователю понять, что именно нужно ввести
</Text>
<Textarea
label="Пример того, что нужно написать"
placeholder="Опишите изменения: текущие данные → новые данные"
minRows={3}
required
{...form.getInputProps('input_hint')}
/>
</Paper>
)}
{/* Живой предпросмотр этого конкретного шага — только там, где уже
можно посчитать код (обычно на текстовом вводе, но доступно и раньше) */}
<Paper withBorder p="md" bg="gray.0">
<Group justify="space-between" mb="xs">
<Text size="sm" fw={600}>
Проверка: что получится на этом пути
</Text>
<Button
size="xs"
variant="light"
leftSection={<IconEye size={14} />}
onClick={handleCheckThisStep}
loading={previewFlow.isPending}
>
Проверить
</Button>
</Group>
{previewFlow.data && (
<Stack gap={6}>
{previewFlow.data.incomplete ? (
<Text size="xs" c="dimmed">
Пока не хватает выборов на предыдущих шагах, чтобы определить тему заявки —
это нормально, если вы ещё не дошли до конца ветки.
</Text>
) : (
<>
<Text size="xs">
Код темы: <Code>{previewFlow.data.code}</Code>
</Text>
{previewFlow.data.topic_exists ? (
<Group gap={4}>
<IconCircleCheck size={14} color="var(--mantine-color-teal-6)" />
<Text size="xs" c="teal">
Такая тема уже настроена в системе ({previewFlow.data.topic_name})
</Text>
</Group>
) : (
<Group gap="xs">
<Text size="xs" c="orange">
⚠️ Темы с таким кодом пока нет — без неё бот не сможет отправить
заявку согласующим.
</Text>
<Button
size="compact-xs"
leftSection={<IconCirclePlus size={12} />}
onClick={handleCreateTopicFromPreview}
loading={createTopic.isPending}
>
Создать тему
</Button>
</Group>
)}
<Divider my={4} />
<Text size="xs" fw={600}>
Так будет выглядеть сообщение согласующему:
</Text>
<Paper withBorder p={6} bg="white">
<Text size="xs" style={{ whiteSpace: 'pre-wrap' }}>
{previewFlow.data.message}
</Text>
</Paper>
</>
)}
</Stack>
</Paper>
)}
)}
</Paper>
{/* Поля для multiselect */}
{nodeType === 'multiselect' && (
<Paper withBorder p="md">
<Text size="sm" fw={600} mb="sm">
3. Настройки мультиселекта
</Text>
<Alert icon={<IconInfoCircle size={16} />} color="blue" variant="light" mb="sm">
<Text size="xs">
Мультиселект позволяет пользователю выбрать несколько вариантов.
Все выбранные значения сохранятся через запятую в указанный ключ.
</Text>
</Alert>
<Group gap="sm" align="end">
<TextInput
label="MultiSelectKey (ключ)"
placeholder="systems, options..."
description="Ключ, куда сохранятся все выбранные значения (через запятую)"
required
style={{ flex: 1 }}
{...form.getInputProps('multi_select_key')}
/>
<TextInput
label="MultiSelectValue (значение этого варианта)"
placeholder="okb, option1..."
description="Значение именно этого варианта мультиселекта"
required
style={{ flex: 1 }}
{...form.getInputProps('multi_select_value')}
/>
</Group>
<Text size="xs" c="dimmed" mt="xs">
💡 <b>Пример:</b> Если пользователь выберет "ОКБ" и "1С", то сохранится:{' '}
<Code>systems = okb,1c</Code>
</Text>
</Paper>
)}
{/* Шаблоны темы (Go template) — хранятся на узле (message_template / code_template) */}
{/* Дополнительно: технический ключ + код проверки прав */}
<Paper withBorder p="md">
<Group
justify="space-between"
style={{ cursor: 'pointer' }}
onClick={() => setShowTemplates(!showTemplates)}
onClick={() => setShowAdvanced(!showAdvanced)}
>
<Group gap="xs">
{showTemplates ? (
<IconChevronDown size={16} />
) : (
<IconChevronRight size={16} />
)}
{showAdvanced ? <IconChevronDown size={16} /> : <IconChevronRight size={16} />}
<Text size="sm" fw={600}>
4. Шаблоны сообщения и кода темы (опционально)
Дополнительно (обычно не нужно трогать)
</Text>
</Group>
<ActionIcon variant="subtle" size="sm">
{showTemplates ? <IconChevronDown size={14} /> : <IconChevronRight size={14} />}
</ActionIcon>
</Group>
<Collapse expanded={showTemplates}>
<Collapse expanded={showAdvanced}>
<Stack gap="sm" mt="sm">
<Alert icon={<IconInfoCircle size={16} />} color="blue" variant="light">
<Text size="xs">
Задаются на узле, где также указан <Code>topic_code</Code> — то
есть в точке, где путь по дереву резолвится в конкретную тему
согласования (<Code>ApprovalTopic</Code>). Если оставить пустым,
используется поведение по умолчанию.
</Text>
</Alert>
<Textarea
label="Шаблон сообщения для согласующего (Go template)"
<TextInput
label="Технический ключ"
description="Заполняется само из названия"
disabled={form.values.auto_generate_key}
{...form.getInputProps('key')}
/>
<TextInput
label="Кто видит эту кнопку (необязательно)"
placeholder="non_budget_f1"
description={
<Text size="xs">
Доступные переменные:{' '}
<Code>{'{{.initiator_name}}'}</Code>,{' '}
<Code>{'{{.topic_name}}'}</Code>,{' '}
<Code>{'{{.content}}'}</Code>,{' '}
<Code>{'{{.region_label}}'}</Code>,{' '}
<Code>{'{{.branch_label}}'}</Code>, и любые ключи из{' '}
<Code>collected</Code> + суффикс <Code>_label</Code>
Если заполнить — эту конкретную кнопку увидят только сотрудники, у
которых есть право на такую тему. Не влияет на то, в какую тему попадёт
заявка — код темы считается автоматически по всем ответам сотрудника.
</Text>
}
minRows={6}
styles={{ input: { fontFamily: 'monospace', fontSize: 12 } }}
{...form.getInputProps('message_template')}
/>
<Textarea
label="Шаблон кода темы (Go template)"
description={
<Text size="xs">
Формирует финальный код темы. Если не задан — код формируется
автоматически из всех значений <Code>collected</Code>. Функции:{' '}
<Code>trimPrefix</Code>, <Code>eq</Code>, <Code>contains</Code>
</Text>
}
minRows={2}
styles={{ input: { fontFamily: 'monospace', fontSize: 12 } }}
{...form.getInputProps('code_template')}
{...form.getInputProps('topic_code')}
/>
{nodeType === 'input' && (
<TextInput
label="Куда сохранить введённый текст"
description="Обычно content — меняйте, только если знаете зачем"
{...form.getInputProps('input_key')}
/>
)}
</Stack>
</Collapse>
</Paper>
{/* Превью */}
<Paper withBorder p="md" bg="gray.0">
<Text size="sm" fw={600} mb="sm">
Превью для пользователя
</Text>
<Box>
<Text size="sm" c="dimmed">
Пользователь увидит:
</Text>
<Text fw={500} size="lg" mt="xs">
{form.values.label || 'Название узла'}
</Text>
{nodeType === 'input' && form.values.input_hint && (
<Text size="sm" c="dimmed" mt="xs">
💬 Подсказка: {form.values.input_hint}
</Text>
)}
{(nodeType === 'button' || nodeType === 'input') && form.values.data_key && (
<Text size="xs" c="dimmed" mt="xs">
Сохранится: <Code>{form.values.data_key} = {form.values.data_value}</Code>
</Text>
)}
{nodeType === 'multiselect' && form.values.multi_select_key && (
<Text size="xs" c="dimmed" mt="xs">
Сохранится: <Code>{form.values.multi_select_key} = ..., {form.values.multi_select_value}, ...</Code>
</Text>
)}
</Box>
</Paper>
{/* Шаблоны — ТОЛЬКО на корневом узле дерева */}
{isRootNode && (
<Paper withBorder p="md">
<Group
justify="space-between"
style={{ cursor: 'pointer' }}
onClick={() => setShowTemplates(!showTemplates)}
>
<Group gap="xs">
{showTemplates ? <IconChevronDown size={16} /> : <IconChevronRight size={16} />}
<Text size="sm" fw={600}>
Сообщение согласующему и код темы
</Text>
</Group>
</Group>
<Collapse expanded={showTemplates}>
<Stack gap="sm" mt="sm">
<Alert icon={<IconInfoCircle size={16} />} color="blue" variant="light">
<Text size="xs">
Это ОДНО сообщение на всё дерево этого раздела, а не на одну ветку.
Чтобы текст отличался в зависимости от выбора сотрудника — используйте
условия (кнопка ниже сама расставит их за вас на основе первого вопроса
в дереве, дальше можно поправить руками).
</Text>
</Alert>
<Group justify="flex-end">
<Button
size="xs"
variant="light"
leftSection={<IconWand size={14} />}
onClick={handleGenerateDraft}
>
Сформировать черновик
</Button>
</Group>
<Textarea
label="Текст сообщения согласующему"
minRows={6}
styles={{ input: { fontFamily: 'monospace', fontSize: 12 } }}
{...form.getInputProps('message_template')}
/>
<Textarea
label="Код темы (обычно оставляйте пустым)"
description="Если не трогать — система сама соберёт код из всех выборов сотрудника"
minRows={2}
styles={{ input: { fontFamily: 'monospace', fontSize: 12 } }}
{...form.getInputProps('code_template')}
/>
{leafOptions.length > 0 && (
<>
<Divider label="Проверить готовую ветку" />
<Select
placeholder="Выберите путь для проверки"
data={leafOptions.map((o) => ({ value: o.value, label: o.label }))}
value={previewLeafKey}
onChange={handlePreviewLeaf}
searchable
/>
{previewFlow.isPending && <Loader size="xs" />}
{previewFlow.data && !previewFlow.data.incomplete && (
<Paper withBorder p={6} bg="white">
<Text size="xs" c="dimmed">
Код: <Code>{previewFlow.data.code}</Code>
</Text>
<Text size="xs" mt={4} style={{ whiteSpace: 'pre-wrap' }}>
{previewFlow.data.message}
</Text>
</Paper>
)}
</>
)}
</Stack>
</Collapse>
</Paper>
)}
<Group justify="flex-end" mt="md">
<Button variant="default" onClick={onClose} disabled={isSubmitting}>
@ -587,16 +662,4 @@ export default function FlowNodeEditModal({
</form>
</Modal>
)
}
// Утилитарная функция для сбора всех ключей из дерева
function collectAllKeys(nodes: ApprovalFlowNode[]): string[] {
const keys: string[] = []
for (const node of nodes) {
if (node.key) keys.push(node.key)
if (node.children) {
keys.push(...collectAllKeys(node.children))
}
}
return keys
}

View File

@ -1,226 +1,180 @@
import { useState } from 'react'
import { Box, Group, Text, ActionIcon, Tooltip, Badge, Paper } from '@mantine/core'
import {
Group,
Text,
ActionIcon,
Badge,
Paper,
Stack,
Tooltip,
Box,
Code,
Collapse,
} from '@mantine/core'
import {
IconPencil,
IconChevronDown,
IconChevronRight,
IconPlus,
IconEdit,
IconTrash,
IconCopy,
IconPlus,
IconChevronRight,
IconChevronDown,
IconArrowUp,
IconArrowDown,
IconKeyboard,
IconCheckbox,
IconHierarchy,
IconIndentIncrease,
IconIndentDecrease,
} from '@tabler/icons-react'
import { useState } from 'react'
import type { ApprovalFlowNode } from '@/types/api'
interface FlowTreeNodeProps {
node: ApprovalFlowNode
depth: number
siblings: ApprovalFlowNode[]
index: number
onEdit: (node: ApprovalFlowNode) => void
onAddChild: (parent: ApprovalFlowNode) => void
onDelete: (node: ApprovalFlowNode) => void
onDuplicate: (node: ApprovalFlowNode) => void
onMoveUp: (node: ApprovalFlowNode) => void
onMoveDown: (node: ApprovalFlowNode) => void
index: number
onPromote: (node: ApprovalFlowNode) => void
onDemote: (node: ApprovalFlowNode) => void
}
function nodeIcon(node: ApprovalFlowNode): string {
if (node.is_input) return '📝'
if (node.is_multi_select) return '☑️'
return '🔘'
}
function nodeKindLabel(node: ApprovalFlowNode): string {
if (node.is_input) return 'Текстовый ввод — здесь сотрудник пишет заявку'
if (node.is_multi_select) return 'Можно выбрать несколько вариантов'
return 'Кнопка'
}
export default function FlowTreeNode({
node,
depth,
siblings,
index,
onEdit,
onAddChild,
onDelete,
onDuplicate,
onMoveUp,
onMoveDown,
index,
onPromote,
onDemote,
}: FlowTreeNodeProps) {
const [isExpanded, setIsExpanded] = useState(true)
const hasChildren = node.children && node.children.length > 0
// Определяем тип узла для иконки
let typeIcon = <IconHierarchy size={14} />
let typeColor = 'blue'
let typeLabel = 'Кнопка'
if (node.is_input) {
typeIcon = <IconKeyboard size={14} />
typeColor = 'orange'
typeLabel = 'Ввод'
} else if (node.is_multi_select) {
typeIcon = <IconCheckbox size={14} />
typeColor = 'violet'
typeLabel = 'Мульти'
}
const [expanded, setExpanded] = useState(true)
const hasChildren = !!node.children && node.children.length > 0
const isRoot = depth === 0
const hasTemplates = !!(node.message_template || node.code_template)
return (
<Box style={{ marginLeft: depth * 24 }}>
<Box>
<Paper
withBorder
p="xs"
style={{
backgroundColor: depth === 0 ? 'var(--mantine-color-blue-0)' : undefined,
}}
style={{ marginLeft: depth * 24, backgroundColor: isRoot ? 'var(--mantine-color-blue-0)' : undefined }}
>
<Group justify="space-between" wrap="nowrap">
<Group gap="xs" wrap="nowrap" style={{ flex: 1, minWidth: 0 }}>
{/* Раскрывалка */}
<Group gap={6} wrap="nowrap" style={{ minWidth: 0 }}>
{hasChildren ? (
<ActionIcon
variant="subtle"
size="sm"
onClick={() => setIsExpanded(!isExpanded)}
>
{isExpanded ? <IconChevronDown size={16} /> : <IconChevronRight size={16} />}
<ActionIcon size="sm" variant="subtle" onClick={() => setExpanded(!expanded)}>
{expanded ? <IconChevronDown size={14} /> : <IconChevronRight size={14} />}
</ActionIcon>
) : (
<Box w={24} />
<Box w={22} />
)}
{/* Иконка типа */}
<Tooltip label={typeLabel}>
<Badge size="xs" variant="light" color={typeColor} leftSection={typeIcon}>
{typeLabel}
</Badge>
</Tooltip>
{/* Название */}
<Text fw={500} size="sm" lineClamp={1} title={node.label}>
{node.label}
</Text>
{/* Техническая информация */}
<Code style={{ fontSize: 11 }}>{node.key}</Code>
{/* DataKey/DataValue */}
{node.data_key && node.data_value && (
<Text size="xs" c="dimmed" lineClamp={1}>
{node.data_key}={node.data_value}
<Text size="lg">{nodeIcon(node)}</Text>
<Box style={{ minWidth: 0 }}>
<Group gap={6}>
<Text fw={600} truncate>
{node.label}
</Text>
{isRoot && (
<Tooltip label="Здесь настраиваются сообщение согласующему и код темы для ВСЕГО этого дерева">
<Badge size="xs" color="blue" variant="light">
начало дерева
</Badge>
</Tooltip>
)}
{hasTemplates && (
<Tooltip label="На этом узле заданы шаблоны сообщения/кода">
<Badge size="xs" color="teal" variant="light">
есть шаблон
</Badge>
</Tooltip>
)}
</Group>
<Text size="xs" c="dimmed">
{nodeKindLabel(node)}
{node.data_key ? ` · запоминает: ${node.data_key} = ${node.data_value}` : ''}
</Text>
)}
{/* Topic code */}
{node.topic_code && (
<Badge size="xs" variant="dot" color="red">
🔒 {node.topic_code}
</Badge>
)}
</Box>
</Group>
{/* Действия */}
<Group gap={4} wrap="nowrap">
<Tooltip label="Переместить вверх">
<ActionIcon
variant="subtle"
size="sm"
color="gray"
onClick={() => onMoveUp(node)}
disabled={index === 0}
>
<Group gap={2} wrap="nowrap">
<Tooltip label="Переместить выше среди соседних кнопок">
<ActionIcon variant="subtle" size="sm" disabled={index === 0} onClick={() => onMoveUp(node)}>
<IconArrowUp size={14} />
</ActionIcon>
</Tooltip>
<Tooltip label="Переместить вниз">
<Tooltip label="Переместить ниже среди соседних кнопок">
<ActionIcon
variant="subtle"
size="sm"
color="gray"
onClick={() => onMoveDown(node)}
disabled={index === siblings.length - 1}
onClick={() => onMoveDown(node)}
>
<IconArrowDown size={14} />
</ActionIcon>
</Tooltip>
<Tooltip label="Добавить дочерний">
<ActionIcon
variant="light"
color="green"
size="sm"
onClick={() => onAddChild(node)}
>
<Tooltip label="Поднять на уровень выше (сделать соседом своего родителя)">
<ActionIcon variant="subtle" size="sm" disabled={isRoot} onClick={() => onPromote(node)}>
<IconIndentDecrease size={14} />
</ActionIcon>
</Tooltip>
<Tooltip label="Опустить на уровень ниже (вложить в предыдущего соседа)">
<ActionIcon variant="subtle" size="sm" disabled={index === 0} onClick={() => onDemote(node)}>
<IconIndentIncrease size={14} />
</ActionIcon>
</Tooltip>
<Tooltip label="Добавить следующий шаг после этой кнопки">
<ActionIcon variant="subtle" size="sm" color="blue" onClick={() => onAddChild(node)}>
<IconPlus size={14} />
</ActionIcon>
</Tooltip>
<Tooltip label="Редактировать">
<ActionIcon
variant="light"
color="blue"
size="sm"
onClick={() => onEdit(node)}
>
<IconPencil size={14} />
<Tooltip label="Изменить">
<ActionIcon variant="subtle" size="sm" onClick={() => onEdit(node)}>
<IconEdit size={14} />
</ActionIcon>
</Tooltip>
<Tooltip label="Дублировать">
<ActionIcon
variant="light"
color="violet"
size="sm"
onClick={() => onDuplicate(node)}
>
<Tooltip label="Сделать копию этого шага со всеми вложенными">
<ActionIcon variant="subtle" size="sm" onClick={() => onDuplicate(node)}>
<IconCopy size={14} />
</ActionIcon>
</Tooltip>
<Tooltip label="Удалить (с детьми)">
<ActionIcon
variant="light"
color="red"
size="sm"
onClick={() => onDelete(node)}
>
<Tooltip label="Удалить (вместе со всеми вложенными шагами)">
<ActionIcon variant="subtle" size="sm" color="red" onClick={() => onDelete(node)}>
<IconTrash size={14} />
</ActionIcon>
</Tooltip>
</Group>
</Group>
{/* Input hint preview */}
{node.is_input && node.input_hint && (
<Box ml={32} mt={4}>
<Text size="xs" c="dimmed" lineClamp={2}>
💬 {node.input_hint}
</Text>
</Box>
)}
</Paper>
{/* Дети */}
{hasChildren && (
<Collapse expanded={isExpanded}>
<Stack gap={4} mt={4}>
{node.children!.map((child, idx) => (
{expanded && hasChildren && (
<Box mt={4}>
{node.children!.map((child, i) => (
<Box key={child.id} mt={4}>
<FlowTreeNode
key={child.id}
node={child}
depth={depth + 1}
siblings={node.children!}
index={i}
onEdit={onEdit}
onAddChild={onAddChild}
onDelete={onDelete}
onDuplicate={onDuplicate}
onMoveUp={onMoveUp}
onMoveDown={onMoveDown}
index={idx}
onPromote={onPromote}
onDemote={onDemote}
/>
))}
</Stack>
</Collapse>
</Box>
))}
</Box>
)}
</Box>
)

View File

@ -0,0 +1,152 @@
import { useState } from 'react'
import { Paper, Group, Text, Button, Table, Badge, Loader, Alert } from '@mantine/core'
import { IconStethoscope, IconInfoCircle, IconCirclePlus } from '@tabler/icons-react'
import { flowNodesApi, type PreviewFlowResponse } from '@/api/flowNodes'
import { useCreateTopic } from '@/features/topics/hooks/useTopics'
import type { CreateTopicRequest } from '@/api/topics'
import { collectFromPath, collectLeafPaths, pathLabel } from '@/features/flowNodes/utils/treeWalk'
import type { ApprovalFlowNode } from '@/types/api'
interface TreeHealthPanelProps {
categoryId: number
tree: ApprovalFlowNode[]
}
interface HealthRow {
key: string
label: string
result: PreviewFlowResponse | null
error?: boolean
}
// Проходит по каждой готовой ветке дерева ("от начала до текстового ввода")
// и проверяет через реальный движок бэкенда, есть ли для неё настроенная
// тема. Так администратор видит проблему ДО того, как сотрудник наткнётся
// на неё в боте — а не после жалобы, что "заявка не отправляется".
export default function TreeHealthPanel({ categoryId, tree }: TreeHealthPanelProps) {
const [rows, setRows] = useState<HealthRow[] | null>(null)
const [checking, setChecking] = useState(false)
const createTopic = useCreateTopic()
const runCheck = async () => {
setChecking(true)
const leafPaths = collectLeafPaths(tree)
const results = await Promise.all(
leafPaths.map(async (path) => {
const key = path.map((n) => n.id).join('-')
const label = pathLabel(path)
try {
const response = await flowNodesApi.preview(categoryId, {
collected: collectFromPath(path),
})
return { key, label, result: response.data } as HealthRow
} catch {
return { key, label, result: null, error: true } as HealthRow
}
})
)
setRows(results)
setChecking(false)
}
const handleCreateTopic = async (row: HealthRow) => {
if (!row.result?.code) return
const payload: CreateTopicRequest = {
category_id: categoryId,
code: row.result.code,
name: row.label,
is_active: true,
}
await createTopic.mutateAsync(payload)
runCheck()
}
const missingCount = rows?.filter((r) => r.result && !r.result.incomplete && !r.result.topic_exists).length || 0
return (
<Paper withBorder p="md">
<Group justify="space-between" mb="sm">
<Text fw={600}>Проверка дерева</Text>
<Button
size="xs"
variant="light"
leftSection={<IconStethoscope size={14} />}
onClick={runCheck}
loading={checking}
>
Проверить все ветки
</Button>
</Group>
<Alert icon={<IconInfoCircle size={16} />} color="blue" variant="light" mb="sm">
<Text size="xs">
Пройдёт по каждому возможному пути в дереве и проверит, для всех ли есть настроенная тема
заявки. Если для какого-то пути темы нет — заявку по нему бот не сможет отправить.
</Text>
</Alert>
{rows && missingCount > 0 && (
<Alert color="orange" variant="light" mb="sm">
<Text size="sm">Не хватает тем для {missingCount} путей — см. таблицу ниже.</Text>
</Alert>
)}
{rows && missingCount === 0 && (
<Alert color="teal" variant="light" mb="sm">
<Text size="sm">Все ветки дерева ведут к настроенным темам ✅</Text>
</Alert>
)}
{checking && <Loader size="sm" />}
{rows && (
<Table striped withTableBorder>
<Table.Thead>
<Table.Tr>
<Table.Th>Путь</Table.Th>
<Table.Th>Код темы</Table.Th>
<Table.Th>Статус</Table.Th>
<Table.Th />
</Table.Tr>
</Table.Thead>
<Table.Tbody>
{rows.map((row) => (
<Table.Tr key={row.key}>
<Table.Td>
<Text size="xs">{row.label}</Text>
</Table.Td>
<Table.Td>
<Text size="xs" ff="monospace">
{row.result?.code || '—'}
</Text>
</Table.Td>
<Table.Td>
{row.error ? (
<Badge color="red">Ошибка проверки</Badge>
) : row.result?.incomplete ? (
<Badge color="gray">Путь не завершён</Badge>
) : row.result?.topic_exists ? (
<Badge color="teal">Есть тема</Badge>
) : (
<Badge color="orange">Темы нет</Badge>
)}
</Table.Td>
<Table.Td>
{row.result && !row.result.incomplete && !row.result.topic_exists && (
<Button
size="compact-xs"
leftSection={<IconCirclePlus size={12} />}
onClick={() => handleCreateTopic(row)}
loading={createTopic.isPending}
>
Создать
</Button>
)}
</Table.Td>
</Table.Tr>
))}
</Table.Tbody>
</Table>
)}
</Paper>
)
}