diff --git a/src/pages/flowNodes/FlowTreeGuidePage.tsx b/src/pages/flowNodes/FlowTreeGuidePage.tsx index 9c62157..646dbe5 100644 --- a/src/pages/flowNodes/FlowTreeGuidePage.tsx +++ b/src/pages/flowNodes/FlowTreeGuidePage.tsx @@ -9,7 +9,6 @@ import { Title, Table, Divider, - Anchor, ActionIcon, Tooltip, CopyButton, @@ -17,12 +16,15 @@ import { Badge, Alert, UnstyledButton, + Timeline, + ThemeIcon, } from '@mantine/core' import { IconArrowLeft, IconCopy, IconCheck, - IconChevronRight, + IconBulb, + IconAlertTriangle, } from '@tabler/icons-react' import { useNavigate } from 'react-router-dom' @@ -37,30 +39,27 @@ interface DocSection { } const SECTIONS: DocSection[] = [ - { id: 'overview', title: 'Обзор', level: 1 }, - { id: 'architecture', title: 'Архитектура', level: 1 }, - { id: 'data-model', title: 'Модель данных', level: 1 }, - { id: 'node-types', title: 'Типы узлов', level: 1 }, - { id: 'node-button', title: ' Кнопка', level: 2 }, - { id: 'node-input', title: ' Текстовый ввод', level: 2 }, - { id: 'node-multiselect', title: ' Мультиселект', level: 2 }, - { id: 'data-flow', title: 'Поток данных', level: 1 }, - { id: 'collected', title: 'Структура collected', level: 1 }, - { id: 'templates', title: 'Шаблонизация', level: 1 }, - { id: 'message-template', title: ' message_template', level: 2 }, - { id: 'code-template', title: ' code_template', level: 2 }, - { id: 'syntax', title: 'Синтаксис шаблонов', level: 1 }, - { id: 'variables', title: 'Справочник переменных', level: 1 }, - { id: 'examples', title: 'Примеры конфигураций', level: 1 }, - { id: 'constraints', title: 'Ограничения и валидация', level: 1 }, - { id: 'troubleshooting', title: 'Диагностика ошибок', level: 1 }, + { 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 @@ -95,7 +94,7 @@ export default function FlowTreeGuidePage() { - Документация + Руководство - {/* Заголовок документа */} + {/* Заголовок */} - v1.0 - Обновлено: 22 июня 2026 + Простыми словами - Конструктор деревьев навигации + Как настроить дерево согласования - Техническая документация по настройке деревьев навигации для системы - согласования заявок. Описывает архитектуру, модель данных, синтаксис - шаблонов и примеры конфигураций. + Это руководство для тех, кто настраивает бота — без программирования. + Здесь пошагово показано, как собрать «дерево» вопросов, которые бот задаёт + сотруднику, когда тот создаёт заявку: например, «Какой регион?» → + «Какая причина?» → «Опишите заявку». {/* ============================================================ */} - {/* 1. ОБЗОР */} + {/* ОБЗОР */} {/* ============================================================ */} - + - Дерево навигации — иерархическая структура узлов, определяющая последовательность - шагов, которые проходит пользователь при создании заявки в Telegram-боте. Каждый - узел дерева представляет собой либо кнопку выбора значения, либо поле ввода - произвольного текста. + Когда сотрудник создаёт заявку в Telegram-боте, бот задаёт ему вопросы по + очереди и предлагает варианты ответов кнопками. Например: «Выберите + регион» → «Крым» или «Краснодар» → «Опишите заявку текстом». Эта + последовательность вопросов и есть дерево. - Система предназначена для конфигурирования произвольных бизнес-процессов - согласования без изменения исходного кода сервиса. Администратор создаёт дерево - через веб-интерфейс, а бот динамически строит интерфейс на основе этой - конфигурации. + Вы настраиваете это дерево в разделе «Конструктор деревьев» — без единой + строчки кода. Каждый вопрос и каждая кнопка — это отдельный «узел», который + вы добавляете через простую форму. - - Деревья используются для тем согласования: отпуска, внебюджетные расходы, - возвраты, изменения клиентов и прочие бизнес-процессы, требующие сбора - структурированных данных от пользователя перед отправкой на согласование. + + Так настраиваются любые сценарии: отпуска, больничные, внебюджетные + расходы, возвраты и любые другие заявки. Если появится новый вид заявки — + не нужно ничего программировать, достаточно собрать новое дерево здесь. {/* ============================================================ */} - {/* 2. АРХИТЕКТУРА */} + {/* ТРИ ПОНЯТИЯ */} {/* ============================================================ */} - + - Система состоит из трёх уровней сущностей: + Прежде чем начать, важно понимать всего три вещи: - Уровень - Сущность - Назначение + Понятие + Что это простыми словами + Категория - approval_topic_categories - - Категория - - Группировка тем. Отображается как кнопка первого уровня в меню бота. + Раздел заявок, который вы выбираете вверху страницы («Отпуска», + «Внебюджетные расходы» и т.д.). Одно дерево всегда строится + внутри одной категории. + Узел - approval_topics - - Тема - - Конкретный тип согласования. Содержит настройки, шаблоны сообщений - и код для идентификации. + Один шаг в дереве: кнопка с вариантом ответа, поле ввода текста + или список для множественного выбора. Узлы соединяются друг с + другом — у каждого может быть несколько «детей» (следующих + шагов). + Тема заявки - approval_flow_nodes - - Узел дерева - - Отдельный шаг навигации: кнопка, поле ввода или мультиселект. - Связан с темой через topic_id. + То, во что в итоге превращается пройденный сотрудником путь по + дереву. Например, путь «Крым → За свой счёт» превращается в + конкретную тему заявки со своими согласующими.
- - Узлы образуют древовидную структуру через поле parent_id. Корневой - узел имеет parent_id = NULL. Порядок отображения узлов одного - уровня определяется полем sort_order. - - - + + Дерево — это как схема метро: от начальной станции (первого вопроса) до + конечной (поля ввода текста) должен существовать путь через любые + промежуточные станции (кнопки-варианты). Ваша задача — построить эти пути. + {/* ============================================================ */} - {/* 3. МОДЕЛЬ ДАННЫХ */} + {/* ПОРЯДОК СОЗДАНИЯ */} {/* ============================================================ */} - + - Структура таблицы approval_flow_nodes: + Ниже — точный порядок действий от пустой категории до готового, + работающего дерева. - + + + + Откройте страницу «Конструктор деревьев» и в выпадающем списке «Категория» + выберите нужный раздел. Если подходящей категории ещё нет — обратитесь к + администратору, чтобы её создали (это отдельная настройка, не относится к + дереву). + + + + Если дерево для этой категории уже существует, вы увидите его сразу после + выбора. Можно смело редактировать — все изменения сохраняются + автоматически, ничего не потеряется. + + + + + + Нажмите кнопку «Добавить корневой узел». Это будет самый первый вопрос, + который увидит сотрудник. Откроется окно с тремя полями: + + +
Поле - Тип - Описание + Что писать - id - BIGINT PK - Уникальный идентификатор узла + Тип узла + Оставьте «Кнопка» — для первого шага почти всегда нужна кнопка - topic_id - BIGINT FK - Ссылка на тему согласования + Название + То, что увидит сотрудник, например «Отпуска» - parent_id - BIGINT FK NULL - Ссылка на родительский узел. NULL для корня - - - key - TEXT NOT NULL + Ключ - Уникальный в рамках темы идентификатор узла. Используется - системой для навигации + Не трогайте — заполняется автоматически из названия - - label - TEXT NOT NULL - Текст, отображаемый пользователю - - - data_key - TEXT NULL - - Имя переменной, в которую сохраняется data_value при - выборе узла - - - - data_value - TEXT NULL - Значение, сохраняемое в data_key - - - is_input - BOOLEAN - Признак узла текстового ввода - - - input_key - TEXT NULL - Ключ для сохранения введённого текста (обычно content) - - - input_hint - TEXT NULL - Подсказка-шаблон для пользователя - - - is_multi_select - BOOLEAN - Признак узла мультиселекта - - - multi_select_key - TEXT NULL - Ключ для сохранения выбранных значений - - - multi_select_value - TEXT NULL - Значение данного варианта мультиселекта - - - topic_code - TEXT NULL - - Код темы для проверки прав доступа. Если задан — узел отображается - только пользователям с правом create на указанную тему - - - - sort_order - INTEGER - Порядок сортировки среди узлов одного родителя -
- - На таблицу наложен уникальный индекс UNIQUE(topic_id, key). Это - гарантирует, что в рамках одной темы не существует двух узлов с одинаковым - key. Нарушение этого условия приведёт к ошибке - SQLSTATE 23505 при сохранении. - + + Нажмите «Создать». Узел появится в дереве — с него всё и начинается. + - {/* ============================================================ */} - {/* 4. ТИПЫ УЗЛОВ */} - {/* ============================================================ */} - + - Система поддерживает три типа узлов, определяемых комбинацией булевых полей - is_input и is_multi_select. + Наведите на созданный узел — рядом появятся кнопки. Нажмите «+», чтобы + добавить к нему дочерний узел — следующий шаг вопроса. Повторяйте это для + каждого варианта ответа. + + + + Например, если первый узел — «Тип отпуска», добавьте к нему детей: + «Отпуск», «Отгул», «Больничный». Каждый из них — отдельная кнопка, которую + увидит сотрудник после выбора первого шага. + + + + Для узлов-кнопок в форме есть два поля: DataKey — название того, что + мы запоминаем (например «тип отпуска»), и DataValue — конкретное + значение этой кнопки (например «отпуск»). У всех кнопок-веток одного и того + же вопроса DataKey должен быть одинаковым, а DataValue — у каждой свой. + Смотрите готовый пример ниже — там всё видно на конкретных значениях. + + + + + + Каждая ветка дерева обязательно должна заканчиваться узлом «Текстовый + ввод» — это последний шаг, где сотрудник пишет саму заявку своими словами. + Добавьте такой узел к каждому «листу» дерева (к узлу, у которого больше нет + вариантов выбора). + + + + В форме выберите тип узла «Текстовый ввод» и заполните поле «Подсказка» — + это пример того, что должен написать сотрудник, чтобы ему было понятнее. + + + + Пройдите мысленно (или на бумаге) каждый путь от первого узла до конца. + Если какой-то путь обрывается на кнопке, не доходя до текстового ввода — + сотрудник не сможет завершить заявку. Добавьте туда узел ввода. + + + + + + На узле, где заявка «превращается» в конкретную тему (обычно это последний + узел-кнопка перед вводом текста), можно раскрыть блок «Шаблоны сообщения и + кода темы» и задать, как будет выглядеть уведомление у согласующего в + Telegram. Подробно про это — в разделе{' '} + «Как писать сообщение согласующему»{' '} + ниже. Если ничего не менять — сработает оформление по умолчанию. + + + + + + Дерево сохраняется автоматически после каждого действия — отдельной кнопки + «Сохранить всё» нажимать не нужно. Лучший способ проверить готовое дерево — + попросить коллегу создать тестовую заявку через бота и убедиться, что все + вопросы задаются в правильном порядке, а итоговое сообщение согласующему + выглядит понятно. + + + {/* ============================================================ */} + {/* ТИПЫ УЗЛОВ */} + {/* ============================================================ */} + + + + При создании или редактировании узла вы выбираете один из трёх типов: + + + + + + 🔘 + Кнопка + + + Сотрудник нажимает и переходит к следующему шагу. Используется для + любого выбора из вариантов: регион, тип заявки, филиал и т.д. + Требует заполнения DataKey и DataValue. + + + + + 📝 + Текстовый ввод + + + Сотрудник печатает текст. Всегда завершает ветку дерева — после + него бот создаёт заявку. Требует заполнения «Подсказки» — + примера того, что нужно написать. + + + + + ☑️ + Мультивыбор + + + Сотрудник может отметить сразу несколько вариантов (например, + несколько систем: «ОКБ» и «1С»). Все отмеченные варианты + сохранятся вместе, через запятую. + + + + + {/* ============================================================ */} + {/* ПРИМЕР 1 */} + {/* ============================================================ */} + + + + Разберём готовый пример целиком — от первого узла до отправки заявки. + Сценарий: сотрудник выбирает тип отсутствия, затем способ оплаты, затем + пишет причину. + + + + + + Название: Тип отсутствия. Тип узла: Кнопка. Это + «заголовок» дерева — сам по себе кнопкой сотруднику не показывается, + но от него отходят первые варианты. + + + + + Добавляем к корню три узла: Отпуск, Отгул,{' '} + Больничный. У всех трёх DataKey одинаковый —{' '} + absence_type, а DataValue разный: vacation,{' '} + timeoff, sickleave. + + + + + К узлу «Отпуск» добавляем два дочерних узла: За свой счёт{' '} + и В счёт отпуска. DataKey у обоих —{' '} + payment_type, DataValue — own_expense и{' '} + vacation_account соответственно. Аналогично поступаем с + ветками «Отгул» и «Больничный». + + + + + К каждому из узлов способа оплаты добавляем узел «Текстовый ввод» с + подсказкой: Укажите даты отпуска, например: 22.02.2026 — 25.02.2026. + + + + + На узле способа оплаты (там, где заявка уже точно определена) + открываем «Шаблоны сообщения и кода темы» и вписываем текст — см. + пример ниже. + + + + + + + + Что увидит сотрудник в боте: сначала кнопки «Отпуск / Отгул / + Больничный», затем — «За свой счёт / В счёт отпуска», затем поле для + ввода дат. Три нажатия и один текст — заявка готова. + + + Тип: {{.absence_type_label}} + +{{.initiator_name}} просит согласовать: {{.payment_type_label}} +{{.content}}`} + /> + + + Всё, что в фигурных скобках — подставится автоматически: название узла, + который выбрал сотрудник, его имя и текст, который он написал. Про этот + синтаксис подробнее — в разделе ниже. + + + {/* ============================================================ */} + {/* ПРИМЕР 2 */} + {/* ============================================================ */} + + + + Более сложный, но частый случай: нужно спросить у сотрудника два + независимых параметра подряд — например, филиал и тип расхода. + + + + + + Обратите внимание: узел «ТМЦ» повторяется дважды — под «Филиал 1» и под + «Филиал 2». Это нормально: узлы с одинаковым названием на разных ветках + дерева — это разные, независимые узлы, у каждого свой ключ (система + добавляет к ключу префикс родителя автоматически). + + + Внебюджетные расходы — {{.branch_label}} ({{.expense_type_label}}) + +{{.initiator_name}}: +{{.content}}`} + /> + + {/* ============================================================ */} + {/* ШАБЛОНЫ */} + {/* ============================================================ */} + + + + В блоке «Шаблоны сообщения и кода темы» вы пишете обычный текст с + HTML-разметкой (<b>жирный</b>,{' '} + <i>курсив</i>) — так, как хотите видеть уведомление + у согласующего. В нужных местах вставляете «плейсхолдеры» в фигурных + скобках — они подставляются автоматически. - Тип - is_input - is_multi_select - Назначение + Что написать + Что подставится - Кнопка - false - false - Выбор значения и переход к следующему шагу + {`{{.initiator_name}}`} + Имя сотрудника, который создал заявку - Текстовый ввод - true - false - Ввод произвольного текста пользователем + {`{{.content}}`} + Текст, который сотрудник ввёл на последнем шаге - Мультиселект - false - true - Выбор нескольких значений из списка + {`{{.название_кнопки_label}}`} + + Название выбранной сотрудником кнопки. Например, если DataKey + кнопки — region, пишите{' '} + {`{{.region_label}}`}, и туда подставится «Крым» или + «Краснодар» — смотря что выбрал сотрудник +
- - - - Базовый тип узла. При выборе кнопки система записывает в контекст пользователя - пару data_key = data_value и переходит к дочерним узлам. - - - Обязательные поля: - - - - Поле - Требования - Пример - - - - - key - Уникальный в теме, snake_case - crimea - - - label - Непустая строка - Крым - - - data_key - snake_case, осмысленное имя - region - - - data_value - snake_case, уникальное в рамках data_key - crimea - - -
- - - Все дочерние узлы одного родителя должны иметь одинаковое значение{' '} - data_key, но различные data_value. Это необходимо - для корректной работы шаблонизации: система ожидает, что по ключу{' '} - region будет получено ровно одно значение. + + Не нужно запоминать синтаксис. Откройте похожий уже настроенный узел (в + этой же или другой категории), скопируйте оттуда шаблон и замените + плейсхолдеры на DataKey ваших узлов. - - - - Терминальный узел, запрашивающий у пользователя произвольный текст. Введённый - текст сохраняется в контекст по ключу input_key. - - - Обязательные поля: - - - - Поле - Требования - Пример - - - - - input_key - Обычно content - content - - - input_hint - Конкретный пример заполнения - Опишите изменения: текущие → новые - - -
- - - Каждый путь от корня до листа дерева должен заканчиваться узлом типа «Текстовый - ввод». Отсутствие такого узла приведёт к невозможности завершения создания - заявки. - - - - - - Специализированный узел, позволяющий пользователю выбрать несколько значений - одновременно. Все выбранные значения сохраняются через запятую в ключ - multi_select_key. - - - Обязательные поля: - - - - Поле - Требования - Пример - - - - - multi_select_key - Одинаковый для всех дочерних узлов - systems - - - multi_select_value - Уникальный для каждого дочернего узла - okb, 1c - - -
- - При выборе нескольких значений формируется строка вида{' '} - systems = "okb,1c". Автоматически создаётся производная - переменная systems_label, содержащая человекочитаемые названия - через запятую: "ОКБ, 1С". + Дополнительно доступны несколько простых условий — пригодятся, если + сообщение должно немного отличаться в зависимости от выбора: + + + + + + + + Поле «Шаблон кода темы» обычно можно не трогать — если оставить пустым, + система сама соберёт код заявки из всех выборов сотрудника. Заполняйте его + только если вам явно сказали, что для этой темы нужен особый код + (например, если это уже настроенная в системе тема с заранее заданным + названием). {/* ============================================================ */} - {/* 5. ПОТОК ДАННЫХ */} + {/* СОВЕТЫ */} {/* ============================================================ */} - - - - При прохождении пользователем дерева навигации формируется контекст - collected — ассоциативный массив, аккумулирующий все выбранные - значения. Процесс состоит из следующих этапов: - + - - - - - - - {/* ============================================================ */} - {/* 6. СТРУКТУРА COLLECTED */} + {/* ДИАГНОСТИКА */} {/* ============================================================ */} - + - Контекст collected — это map[string]string, содержащий - все данные, собранные в процессе прохождения дерева. Структура формируется - детерминированно на основе конфигурации узлов. - - - - - - Переменные с суффиксом _label формируются автоматически и не - требуют явного указания в дереве. Их значения соответствуют полю{' '} - label узла, в котором был задан соответствующий{' '} - data_key. - - - - Ключ content зарезервирован для текста заявки, вводимого - пользователем. Ключ instructions заполняется автоматически из - поля instructions темы, если оно задано. - - - {/* ============================================================ */} - {/* 7. ШАБЛОНИЗАЦИЯ */} - {/* ============================================================ */} - - - - Шаблоны используют синтаксис text/template стандартной библиотеки - Go. Шаблоны хранятся в таблице approval_topics в полях - message_template и code_template. - - - - - - Определяет формат сообщения, отправляемого согласующему в Telegram. Поддерживает - HTML-разметку (<b>, <i>,{' '} - <code>). - - - Менеджерские расходы — {{.region_label}} - -{{.initiator_name}}: -{{.content}}`} - /> - - - - - Определяет алгоритм формирования кода темы на основе collected. - Полученный код используется для поиска записи в таблице{' '} - approval_topics. Если шаблон не задан, код формируется - автоматически конкатенацией всех значений collected через - символ подчёркивания. - - - - - - Результат применения code_template должен точно соответствовать - значению поля code существующей записи в{' '} - approval_topics. В противном случае система вернёт ошибку - approval topic not found. - - - {/* ============================================================ */} - {/* 8. СИНТАКСИС */} - {/* ============================================================ */} - - - - Доступные конструкции языка шаблонов: - - - - - - Конструкция - Семантика - - - - - {`{{.key}}`} - Вывод значения переменной - - - {`{{if .key}}...{{end}}`} - Условный вывод (проверяется непустота) - - - - {`{{if eq .key "val"}}A{{else}}B{{end}}`} - - Ветвление по значению - - - - {`{{if ...}}...{{else if ...}}...{{else}}...{{end}}`} - - Множественное ветвление - - - {`{{trimPrefix .key "prefix"}}`} - Удаление префикса из значения - - - {`{{trimSuffix .key "suffix"}}`} - Удаление суффикса из значения - - - {`{{toUpper .key}}`} - Приведение к верхнему регистру - - - {`{{toLower .key}}`} - Приведение к нижнему регистру - - - {`{{contains .key "substr"}}`} - Проверка вхождения подстроки - - -
- - - При обращении к несуществующему ключу шаблонизатор выводит строку{' '} - <no value>. Это признак ошибки конфигурации: либо в дереве - отсутствует узел с соответствующим data_key, либо пользователь - не прошёл необходимый шаг. - - - {/* ============================================================ */} - {/* 9. СПРАВОЧНИК ПЕРЕМЕННЫХ */} - {/* ============================================================ */} - - - - Переменные, доступные в шаблонах, делятся на две категории: встроенные - (предоставляются системой) и пользовательские (формируются из дерева). - - - Встроенные переменные - - - - Переменная - Источник - Описание - - - - - initiator_name - Таблица users - ФИО пользователя, создавшего заявку - - - topic_name - Таблица approval_topics - Название темы - - - content - Текстовый ввод пользователя - Основной текст заявки - - - instructions - Поле instructions темы - Инструкция для согласующего - - -
- - Пользовательские переменные - - Формируются на основе data_key узлов дерева. Для каждого - data_key автоматически создаётся производная переменная с суффиксом - _label. - - - - - - Переменная - Типичное значение - Описание - - - - - region - crimea, krasnodar - Идентификатор региона - - - region_label - Крым, Краснодар - Человекочитаемое название региона - - - branch - f1, f2 - Идентификатор филиала - - - payment_type - own_expense - Тип оплаты - - - systems - okb,1c - Выбранные системы (мультиселект) - - - systems_label - ОКБ, 1С - Названия выбранных систем - - -
- - {/* ============================================================ */} - {/* 10. ПРИМЕРЫ */} - {/* ============================================================ */} - - - - Ниже приведены типовые конфигурации для различных сценариев. Шаблоны могут - быть скопированы и адаптированы под конкретные требования. - - - {/* Пример 1 */} - 10.1. Простая тема с выбором региона - - Сценарий: пользователь выбирает регион, затем вводит текст заявки. - - - - - Менеджерские расходы — {{.region_label}} - -{{.initiator_name}}: -{{.content}}`} - /> - - - - {/* Пример 2 */} - 10.2. Многоуровневая тема с условной логикой - - Сценарий: филиал → тип расхода → признак ПП → ввод. Формат кода темы - зависит от наличия признака ПП. - - - - - Внебюджетные расходы — {{.branch_label}} ({{.expense_type_label}}) -{{if .pp_required}}💳 ПП: {{.pp_required_label}}{{end}} - -{{.initiator_name}}: -{{.content}}`} - /> - - - - {/* Пример 3 */} - 10.3. Тема с мультиселектом - - Сценарий: пользователь выбирает несколько систем одновременно. - - - - - Изменение клиентов: {{.change_type_label}} -🖥 Системы: {{.systems_label}} -📍 Регион: {{.region_label}} - -{{.initiator_name}}: -{{.content}}`} - /> - - - - {/* Пример 4 */} - 10.4. Составная тема с множественными сценариями - - Сценарий: единая тема объединяет несколько подтипов (отпуск, отгул, - больничный) с различным форматированием сообщений. - - - Тип: Отгул - -{{.initiator_name}}: прошу согласовать отгул -{{.content}} -{{.payment_type_label}} -{{else if eq .absence_type "vacation"}}📋 Тип: Отпуск - -{{.initiator_name}}: прошу согласовать отпуск -{{.content}} -{{.payment_type_label}} -{{else if eq .absence_type "sickleave"}}📋 Тип: Официальный больничный - -{{.initiator_name}}: прошу согласовать больничный -{{if .open_date}}Дата открытия: {{.open_date}}. -{{end}}{{.content}} -{{.payment_type_label}} -{{end}}`} - /> - - - - {/* ============================================================ */} - {/* 11. ОГРАНИЧЕНИЯ */} - {/* ============================================================ */} - - - - При конфигурации деревьев необходимо соблюдать следующие ограничения: - - - - - - № - Ограничение - Обоснование - - - - - 1 - Уникальность key в рамках темы - - Обеспечивается уникальным индексом (topic_id, key). - Нарушение приводит к ошибке SQLSTATE 23505. - - - - 2 - - Единообразие data_key на одном уровне - - - Все дочерние узлы одного родителя должны иметь одинаковый{' '} - data_key. В противном случае в collected{' '} - появятся конфликтующие значения. - - - - 3 - - Уникальность data_value среди братьев - - - Система не сможет различить узлы с одинаковыми data_key{' '} - и data_value. - - - - 4 - Терминальность путей - - Каждый путь от корня до листа должен заканчиваться узлом типа - «Текстовый ввод». - - - - 5 - Отсутствие циклов - - parent_id не может указывать на собственный узел или - его потомка. Проверяется при операциях перемещения. - - - - 6 - Формат key, data_key, data_value - - Только строчные латинские буквы, цифры и символ подчёркивания - (snake_case). - - - - 7 - Согласованность code_template с БД - - Результат применения шаблона должен соответствовать существующей - записи в approval_topics. - - - -
- - {/* ============================================================ */} - {/* 12. ДИАГНОСТИКА */} - {/* ============================================================ */} - - - - Типовые ошибки и методы их устранения: + Частые ситуации и что с ними делать: - - Конец документации. По вопросам конфигурации обращаться к разработчикам системы. + Остались вопросы — обратитесь к администратору системы согласований.
@@ -1141,11 +723,11 @@ function Callout({ title, children, mt = 'md' }: { title: string; children: Reac return ( } title={title} mt={mt} styles={{ - root: { borderLeft: '3px solid var(--mantine-color-gray-5)' }, title: { fontSize: 13, fontWeight: 600 }, message: { fontSize: 13 }, }} @@ -1155,39 +737,32 @@ function Callout({ title, children, mt = 'md' }: { title: string; children: Reac ) } -function FlowStep({ step, title, description }: { step: number; title: string; description: string }) { +function TipEntry({ title, text }: { title: string; text: string }) { return ( - - - {step} - - + + + + + {title} - {description} + {text} ) } -function ErrorEntry({ code, description, resolution }: { code: string; description: string; resolution: string }) { +function ErrorEntry({ title, description, resolution }: { title: string; description: string; resolution: string }) { return ( - {code} - {description} + + + + + {title} + + {description} - Решение: + Что делать: {resolution}