admin_ruspet/src/pages/flowNodes/FlowTreeGuidePage.tsx

767 lines
48 KiB
TypeScript
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

import { useState, useEffect } from 'react'
import {
Stack,
Text,
Code,
Paper,
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 { useNavigate } from 'react-router-dom'
// ================================================================
// Структура документации
// ================================================================
interface DocSection {
id: string
title: string
level: number
}
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: 'troubleshooting', title: 'Если что-то не работает', level: 1 },
]
export default function FlowTreeGuidePage() {
const navigate = useNavigate()
const [activeSection, setActiveSection] = useState('overview')
useEffect(() => {
const handleScroll = () => {
const scrollPosition = window.scrollY + 100
for (const section of [...SECTIONS].reverse()) {
const element = document.getElementById(section.id)
if (element && element.offsetTop <= scrollPosition) {
setActiveSection(section.id)
break
}
}
}
window.addEventListener('scroll', handleScroll)
return () => window.removeEventListener('scroll', handleScroll)
}, [])
const scrollTo = (id: string) => {
document.getElementById(id)?.scrollIntoView({ behavior: 'smooth', block: 'start' })
setActiveSection(id)
}
return (
<Box style={{ display: 'flex', gap: 32, alignItems: 'flex-start' }}>
<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')}
>
<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}
py={6}
style={{
borderRadius: 4,
backgroundColor:
activeSection === section.id
? 'var(--mantine-color-blue-0)'
: 'transparent',
borderLeft:
activeSection === section.id
? '2px solid var(--mantine-color-blue-6)'
: '2px solid transparent',
}}
>
<Text
size={section.level === 2 ? 'xs' : 'sm'}
c={activeSection === section.id ? 'blue.7' : 'dimmed'}
fw={activeSection === section.id ? 600 : 400}
>
{section.title}
</Text>
</UnstyledButton>
))}
</Stack>
</ScrollArea>
</Stack>
</Box>
{/* ============================================================ */}
{/* Основной контент */}
{/* ============================================================ */}
<Box style={{ flex: 1, maxWidth: 880, minWidth: 0 }}>
<Stack gap={48} pb={120}>
{/* Заголовок */}
<Box>
<Title order={1}>Как настроить дерево согласования</Title>
<Text c="dimmed" mt="sm" size="lg">
Это руководство для тех, кто настраивает бота — без программирования.
Здесь пошагово показано, как собрать «дерево» вопросов, которые бот задаёт
сотруднику, когда тот создаёт заявку: например, «Какой регион?» →
«Какая причина?» → «Опишите заявку».
</Text>
</Box>
<Divider />
{/* ============================================================ */}
{/* ОБЗОР */}
{/* ============================================================ */}
<DocSection id="overview" title="Что это такое" />
<Text>
Когда сотрудник создаёт заявку в Telegram-боте, бот задаёт ему вопросы по
очереди и предлагает варианты ответов кнопками. Например: «Выберите
регион» → «Крым» или «Краснодар» → «Опишите заявку текстом». Эта
последовательность вопросов и есть <b>дерево</b>.
</Text>
<Text>
Вы настраиваете это дерево в разделе «Конструктор деревьев» — без единой
строчки кода. Каждый вопрос и каждая кнопка — это отдельный «узел», который
вы добавляете через простую форму.
</Text>
<Callout title="Зачем это нужно">
Так настраиваются любые сценарии: отпуска, больничные, внебюджетные
расходы, возвраты и любые другие заявки. Если появится новый вид заявки —
не нужно ничего программировать, достаточно собрать новое дерево здесь.
</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="Главное правило">
Дерево — это как схема метро: от начальной станции (первого вопроса) до
конечной (поля ввода текста) должен существовать путь через любые
промежуточные станции (кнопки-варианты). Ваша задача — построить эти пути.
</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>
</Stack>
{/* ============================================================ */}
{/* ПРИМЕР 1 */}
{/* ============================================================ */}
<DocSection id="example-1" title="Пример: дерево «Отпуска»" />
<Text>
Разберём готовый пример целиком — от первого узла до отправки заявки.
Сценарий: сотрудник выбирает тип отсутствия, затем способ оплаты, затем
пишет причину.
</Text>
<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) → Ввод текста`}
/>
<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>
<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>
<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="Если что-то не работает" />
<Text>
Частые ситуации и что с ними делать:
</Text>
<Stack gap="md" mt="md">
<ErrorEntry
title="Бот не находит тему заявки после всех вопросов"
description="Это значит, что набор выборов сотрудника не совпал ни с одной настроенной темой в системе."
resolution="Проверьте узел, где задан код темы (поле «Код темы» или шаблон кода) — сверьте его с администратором системы, который заводит темы заявок."
/>
<ErrorEntry
title="В сообщении согласующему вместо текста написано «<no value>»"
description="Шаблон сообщения ссылается на вариант, который сотрудник не выбирал на этом пути."
resolution="Проверьте, что в дереве действительно есть узел с таким DataKey на пути к этому сообщению, и уберите из шаблона лишние плейсхолдеры."
/>
<ErrorEntry
title="Система не даёт сохранить узел — «ключ уже используется»"
description="В этой же категории уже есть узел с таким же техническим ключом."
resolution="Измените название узла (ключ сгенерируется заново) или вручную поправьте поле «Ключ» на уникальное значение."
/>
<ErrorEntry
title="Не получается переместить узел"
description="Система не разрешает сделать узел «родителем самого себя» — например, перетащить ветку внутрь её же собственного потомка."
resolution="Выберите другого родителя, который не находится ниже перемещаемого узла по дереву."
/>
<ErrorEntry
title="Сотрудник дошёл до конца, а кнопки «Отправить» нет"
description="Скорее всего, эта ветка дерева не заканчивается узлом «Текстовый ввод»."
resolution="Найдите последнюю кнопку в этой ветке и добавьте к ней дочерний узел типа «Текстовый ввод»."
/>
</Stack>
<Divider mt="xl" />
<Text size="sm" c="dimmed" ta="center">
Остались вопросы — обратитесь к администратору системы согласований.
</Text>
</Stack>
</Box>
</Box>
)
}
// ================================================================
// Вспомогательные компоненты
// ================================================================
function DocSection({ id, title, level = 1 }: { id: string; title: string; level?: number }) {
return (
<Box id={id} pt={8}>
{level === 1 ? (
<Title order={2}>{title}</Title>
) : (
<Title order={3} c="dimmed">{title}</Title>
)}
</Box>
)
}
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 p="sm">
<Code block style={{ fontSize: 12, whiteSpace: 'pre-wrap', lineHeight: 1.5 }}>
{code}
</Code>
</Box>
</Paper>
)
}
function Callout({ title, children, mt = 'md' }: { title: string; children: React.ReactNode; mt?: string }) {
return (
<Alert
variant="light"
color="blue"
icon={<IconBulb size={16} />}
title={title}
mt={mt}
styles={{
title: { fontSize: 13, fontWeight: 600 },
message: { fontSize: 13 },
}}
>
{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>
</Group>
<Text size="sm" c="dimmed">{description}</Text>
<Text size="sm" mt={4}>
<Text span fw={600}>Что делать: </Text>
<Text span c="dimmed">{resolution}</Text>
</Text>
</Paper>
)
}