Представь утро понедельника на фулфилмент-складе после запуска новой ERP. На смену выходит новый кладовщик: перед ним открыт экран приёмки, нужно срочно принять поставку и напечатать этикетки, а он не понимает, какой статус выбрать. Если на экране есть иконка «?», сотрудник за минуту открывает пошаговый регламент под свою роль и закрывает задачу сам; если справки нет — через пять минут он звонит управляющему, а управляющий пишет тебе.
Даже в Yoolip.ai, где интерфейс кажется мне очевидным, новые пользователи каждый день задают одни и те же базовые вопросы просто потому, что не знают логику продукта. У создателя вся схема в голове, а у команды заказчика — чистый лист. Сдать систему без встроенной документации значит подписаться на бесконечные созвоны с объяснением кнопок.
Почему внешние инструкции в Google Docs никто не читает и зачем встраивать базу знаний внутрь продукта
Классическая ошибка после разработки — накидать ссылку на Google Docs и отправить руководителю в чат. В реальной работе документ теряется в переписке на второй день, а через пару недель после правок интерфейса ещё и устаревает. Когда вопрос возникает посреди смены, никто не пойдёт искать файл на диске.
Поэтому база знаний — обязательная часть любого B2B-продукта с несколькими ролями. Она должна отвечать на семь прикладных вопросов прямо внутри интерфейса:
- как устроена конкретная страница и за что отвечает каждый блок;
- что означает каждый статус заказа, поставки или счёта;
- как завести нового клиента, товар, заявку или коммерческое предложение;
- в какой последовательности выполнять ежедневные операции;
- что делать при возникновении типовой ошибки;
- где смотреть ключевую информацию и финансы;
- какие системные ограничения действуют на этом этапе.
Писать десятки статей руками с нуля не нужно. Claude Code уже знает карту страниц, схему базы данных и бизнес-логику приложения, поэтому за один прогон собирает основу всей базы примерно за полчаса.
Генерация ролевых пользовательских гайдов из исходного кода: промпт для Claude Code
Сначала спланируй движок базы знаний в Claude Cowork и передай план в Claude Code, причём не пиши текстовый редактор с нуля — встрой готовое решение вроде Tiptap с поддержкой Markdown. Разметка Markdown сразу даёт заголовки, списки, ссылки, вставку скриншотов и видеоуроков.
Когда раздел создан, запускаем наполнение. В качестве эталона структуры удобно взять публичную справку сервиса WEEEK, где статьи аккуратно разбиты по категориям и легко читаются. Ниже — базовый запрос для Claude Code в корне проекта (при желании в режиме /goal), чтобы агент сам обошёл все экраны и написал гайды.
Изучи карту страниц (Site Map), документацию в docs/ и исходный код всех роутов приложения для каждой роли: управляющий, менеджер, упаковщик и селлер (клиент).
Твоя задача:
1. Составь полный список рабочих функций и страниц для каждой роли.
2. Сгенерируй подробные статьи в формате Markdown для встроенной базы знаний по каждой функции (ориентир — минимум 30 статей).
3. Пиши понятным человеческим языком для сотрудника без технического бэкграунда: без терминов разработки, имен таблиц БД и английских названий моделей.
4. В каждой статье добавь: цель страницы, пошаговую инструкцию «1-2-3», пояснение статусов, блок «На что обратить внимание» и плейсхолдеры [СКРИНШОТ: описание экрана].
5. Распредели статьи по категориям и настрой права видимости по ролям, чтобы внешние клиенты не видели внутренние регламенты склада и финансов.
6. Загрузи статьи в локальную базу данных и выведи итоговый список по ролям.
Обрати внимание на запрет технического сленга: иначе агент вываливает в справку имена таблиц из Drizzle или Prisma, которые менеджеру ни о чём не говорят. Плейсхолдеры сразу размечают места, куда потом легко вставить реальные скриншоты — вручную или через Playwright.
После первого прогона открой статьи глазами пользователя. Если тексты вышли слишком сухими, не переписывай 30 гайдов руками: покажи агенту одну эталонную статью из WEEEK и попроси дотянуть все материалы до этого уровня. Заодно сразу проверь, чтобы в редакторе была возможность создавать, переименовывать и удалять категории — о ней на первой итерации часто забывают.
Если поручаешь браузерному агенту пройти по страницам и вставить скриншоты в статьи, заранее проверь права тестового пользователя. На реальном проекте у меня 10 скриншотов получились пустыми белыми экранами только потому, что тестовый аккаунт клиента не был привязан к организации.
Архитектура раздела «База знаний» внутри ERP: категории по должностям, полнотекстовый поиск и чеклисты
Универсальная база знаний живёт в базе данных с поиском, фильтрацией и привязкой к URL. На старте зафиксируй четыре правила: кто редактирует статьи (обычно владелец или управляющий), какие роли какие разделы видят, какие форматы поддерживаются (Markdown, картинки, ссылки на короткие YouTube-инструкции) и где в меню лежит ссылка на раздел.
Самый чувствительный узел — разграничение прав. Упаковщику не нужна документация по финансам, а клиенту-селлеру нельзя показывать статьи «под капотом» про твой внутренний ДДС или админку. Если у роли в какой-то категории нет ни одной доступной статьи, саму категорию нужно полностью скрывать из меню.
| Роль сотрудника | Доступные разделы справки | Примеры статей | Что строго скрыто |
|---|---|---|---|
| Управляющий и владелец | Все разделы и редактор базы знаний | Финансы и ДДС, настройка прайсов, доступы, разбор багов | Ничего — полный доступ |
| Менеджер | Клиенты, КП, поставки, коммуникации | Создание расчёта, привязка Telegram-чата, счета, статусы | Системные настройки админки |
| Кладовщик и упаковщик | Складские операции, сканер, смены | Приёмка партии, сканирование, старт смены, расчёт выработки | Финансы, ДДС, база клиентов |
| Клиент (селлер) | Кабинет, заявки, товары, магазин | Подключение Ozon, создание заявки, правила маркировки | Внутренние регламенты и ДДС |
Убедись, что ссылка на базу знаний вынесена в боковое меню не только у управляющего, но и в кабинетах клиента и упаковщика с учётом их фильтров.
При автогенерации агент иногда помечает внутренние регламенты статусом «для всех» и оставляет в кабинете селлера описание админки. Перед выкладкой на боевой сервер зайди под тестовым аккаунтом клиента и убедись, что ни одна закрытая категория ему не видна.
Контекстная иконка помощи (?) на каждом экране: мгновенный вызов инструкции для открытой страницы
Раздел /help с поиском хорош, когда человек решил изучить систему целиком. Но посреди рабочего дня менеджер не пойдёт искать нужную статью по ключевым словам — справка должна открываться ровно там, где возник вопрос.
Для этого к статье в базе данных привязывается целевой роут страницы, а в интерфейсе появляется иконка «?». По клику открывается модальное окно или боковая панель с инструкцией именно для текущего экрана:
Архитектура встроенной ролевой базы знаний: раздел /help с разграничением прав и контекстная кнопка помощи «?» по pageRoute.
- Привязка статьи к роуту — добавь в таблицу статей поле
pageRoute(или массив маршрутов) для точного сопоставления со страницей. - Размещение без конфликтов верстки — не бросай парящий знак вопроса в правый верхний угол, иначе он перекроет кнопки сохранения; выровняй его по правому краю чуть выше нижней кнопки быстрых действий.
- Запасной сценарий (Fallback) — если для редкой страницы ещё нет точечной статьи, кнопка «?» показывает список популярных инструкций для текущей роли.
Связка «раздел /help + контекстная помощь на каждом экране» снимает до 80% рутинных вопросов команды клиента. Проверь себя простым вопросом: если завтра на смену выйдет новый упаковщик или менеджер без созвона с тобой, найдёт ли он инструкцию на каждом рабочем экране и не увидит ли лишнего? Дальше разберём, как ускорить ежедневную работу сотрудников и забрать поток баг-репортов из лички внутрь системы.