ЗНАЙ (ZNAI)
Система оценки профессиональных компетенций
РУКОВОДСТВО ФУНКЦИОНАЛЬНОГО АДМИНИСТРАТОРА
Версия 1.8.2 | Март 2026
1. Введение
Настоящее руководство предназначено для функциональных администраторов системы ЗНАЙ (ZNAI) — сотрудников, отвечающих за настройку и содержание системы в рамках своих должностных обязанностей. Документ описывает все функции административной панели системы. Доступ к административной панели осуществляется по адресу http://<URL_сервера>/admin с использованием учётных данных администратора. Разделы административной панели:
| Раздел | URL | Назначение |
|---|---|---|
| Дашборд | /administ | Обзор статистики |
| Карты компетенций | /administ/maps | Управление картами для должностей |
| Вопросы | /administ/questions | Управление вопросами |
| Компетенции | /administ/competencies | Управление элементами компетенций |
| Провайдеры ИИ | /administ/providers | Настройка LLM-провайдеров |
| Инструкции ИИ | /administ/prompts | Редактирование промптов (8 в 4 категориях) |
| Сессии | /administ/sessions | Просмотр результатов оценок |
| Пользователи | /administ/users | Управление пользователями |
| Администраторы | /administ/admin | Управление администраторами |
| LLM Operations | /administ/llm-operations | Мониторинг операций с ИИ |
2. Управление пользователями
Раздел «Пользователи» (/admin/users) предоставляет полный контроль над учётными записями сотрудников.
2.1. Создание пользователя
- Перейдите в раздел «Пользователи»
- Нажмите «Добавить пользователя»
- Заполните обязательные поля: логин, полное имя (ФИО), пароль
- Назначьте тарифный план и лимиты сессий
- Выберите доступные карты компетенций
- Сохраните пользователя
2.2. Тарифы и лимиты
| Тариф | Код | Типы сессий | AI Coach |
|---|---|---|---|
| Стандарт | standard | Обычное прохождение | Недоступен |
| ПРО | pro | Обычное + Обучение | Доступен |
| Корпоративный | corporate | Все типы | Доступен |
| Аудит | audit | Аудит | Недоступен |
Лимиты сессий настраиваются по трём типам: sessionsLimitStandard (обычные), sessionsLimitTraining (обучение), sessionsLimitAudit (аудит). Каждому пользователю можно назначить определённое количество сессий каждого типа.
2.3. Редактирование и сброс пароля
Для редактирования найдите пользователя в списке и нажмите иконку карандаша. Для сброса пароля нажмите «Сбросить пароль», введите новый пароль и сообщите его сотруднику.
3. Управление картами компетенций
Карты компетенций являются основой системы. Каждая карта определяет набор компетенций для конкретной должности и содержит пороговые значения для определения грейда.
3.1. Создание карты
Карты создаются двумя способами:
• Через генерацию ИИ: укажите название должности и описание — система создаст структуру компетенций, вопросы и пороги грейдов
• Вручную: полный контроль над содержимым — заполните название, описание, категории компетенций и пороги грейдов
3.2. Редактирование компетенций
Для каждой компетенции настраиваются: название, код (уникальный идентификатор), описание, максимальный балл (1–5, по умолчанию 3), категория и дескрипторы уровней (0–3). Дескрипторы используются при оценке ответов LLM и для формирования отчётов.
3.3. Импорт и экспорт
Экспорт: откройте карту и нажмите «Экспорт». Форматы: JSON (полная структура для импорта) и Markdown (для документирования). Импорт: нажмите «Импорт», загрузите JSON-файл, проверьте структуру и подтвердите.
4. Управление вопросами
4.1. Типы вопросов
| Тип | Код | Проверка | Множитель |
|---|---|---|---|
| Выбор ответа | single_choice | Автоматическая | 0.5 |
| Множественный выбор | multiple_choice | Автоматическая | 0.75 |
| Кейс | case_study | LLM-оценка | 1.5 |
| Открытый вопрос | open | LLM-оценка | 1.0 |
| Интерактивное | interactive | Авто + LLM | 1.25 |
4.2. Создание вопроса
- Перейдите в «Вопросы», нажмите «Добавить вопрос»
- Выберите тип вопроса
- Заполните текст вопроса и варианты ответов
- Привяжите вопрос к компетенциям карты
- Укажите maxPoints (0.5–10, по умолчанию 3)
4.3. Интерактивные задания
Система поддерживает три типа: UserStoryBuilder (конструктор User Story), PrioritySort (сортировка приоритетов), MatchingGame (игра на соответствие). Оценивают практические навыки через drag-and-drop взаимодействия.
5. Настройка LLM-провайдеров
LLM-провайдеры обеспечивают оценку открытых ответов, генерацию контента и работу AI Coach. Раздел «Провайдеры ИИ» (/admin/providers).
5.1. Поддерживаемые провайдеры
| Провайдер | Код | Модели | Авторизация |
|---|---|---|---|
| z.ai Subscription | zai_subscription | glm-4.7, glm-4.6, glm-4.5, glm-5 | Bearer token |
| z.ai Pay-as-you-go | zai_payg | Те же модели | API key |
| OpenAI Compatible | custom | Любые OpenAI-совместимые | API key |
| OpenRouter | openrouter | Множество моделей | API key |
5.2. Настройка провайдера
- Нажмите «Добавить провайдера»
- Выберите тип, заполните API URL и токен
- Укажите модель, температуру (рек. 0.3), макс. токены
- Нажмите «Тест» для проверки подключения
- Сохраните настройки
5.3. Частые ошибки подключения
| Ошибка | Причина | Решение |
|---|---|---|
| 401 Unauthorized | Неверный токен | Проверьте API ключ |
| 404 Not Found | Неверный URL | Проверьте endpoint |
| Timeout | Сервер не отвечает | Проверьте сеть, увеличьте таймаут |
| Model not found | Неверная модель | Выберите модель из списка |
6. Управление промптами ИИ
Раздел «Инструкции ИИ» (/admin/prompts) позволяет редактировать промпты для каждого типа операции с ИИ.
6.1. Категории промптов
| Категория | Промпты | Назначение |
|---|---|---|
| evaluation | answer_evaluation, training_analysis | Оценка ответов |
| generation | competency_generation, question_generation | Генерация контента |
| reports | report_generation, resume_generation | Отчёты и резюме |
| coaching | coach_system, coach_checklist | AI-коучинг |
6.2. Переменные в промптах
Промпты поддерживают переменные {variableName}, автоматически заменяемые при обработке: {question}, {answer}, {competency}, {roleName}, {grade}, {scores}. Маркер [USER_PROMPT] разделяет system и user prompt.
Внимание: Некорректные изменения промптов могут нарушить работу системы. Сохраняйте резервные копии. Для восстановления: bun run seed:prompts
6.3. Тестирование промптов
Доступны два типа тестирования: тест рендера (просмотр итогового промпта без вызова LLM) и тест с LLM (реальный запрос к ИИ). Тест с LLM использует токены активного провайдера.
7. Система оценки компетенций
7.1. Параметры оценки
Диапазоны значений: maxScore (компетенция) — 1–5 (по умолчанию 3); maxPoints (вопрос) — 0.5–10 (по умолчанию 3). Множители по типам вопросов: кейс — 1.5, интерактивное — 1.25, открытый — 1.0, множественный выбор — 0.75, одиночный выбор — 0.5.
7.2. Пороги грейдов
| Грейд | Коэффициент | Пример (макс. 100) |
|---|---|---|
| Junior | 15% | 15 баллов |
| Junior+ | 25% | 25 баллов |
| Middle | 35% | 35 баллов |
| Middle+ | 45% | 45 баллов |
| Senior- | 55% | 55 баллов |
| Senior | 65% | 65 баллов |
| Senior+ | 75% | 75 баллов |
| Lead | 85% | 85 баллов |
7.3. Fallback-оценка
Автоматически активируется при недоступности LLM. Анализирует: длину ответа (до 1.5 баллов), ключевые слова (до 1.0), структуру (до 0.5). Проверяет наличие абзацев, списков, примеров, метрик и выводов.
8. Мониторинг и результаты
8.1. Раздел «Сессии»
Отображаются все пройденные оценки: сотрудник, роль, грейд, статус, тип сессии, дата. Доступны фильтры по статусу и поиск по имени.
8.2. Детальный просмотр сессии
При клике открывается детальный просмотр с 4 вкладками:
• Ответы на вопросы: текст вопроса, ответ сотрудника, оценка, обоснование ИИ
• Компетенции: баллы по каждой компетенции с radar-диаграммой
• Динамика: линейный график прогресса с сравнением предыдущих оценок
• Отчёт ИИ: сильные стороны, зоны роста, план действий
8.3. Экспорт данных
Экспорт отдельной сессии: PDF (форматированный отчёт) и JSON (структурированные данные). Массовый экспорт: выберите несколько сессий и скачайте архив.
8.4. AI-операции
Раздел «LLM Operations» (/admin/llm-operations) показывает лог всех операций с ИИ: промпт, модель, провайдер, время ответа, токены, результат (успех/ошибка).
9. Управление компетенциями
Раздел «Компетенции» (/admin/competencies) позволяет управлять отдельными компетенциями без привязки к конкретной карте. Доступны: просмотр с группировкой по категориям, фильтрация по карте/категории, поиск, создание, редактирование. При редактировании компетенции настраиваются: название, код, категория, описание, критерии оценки, максимальный балл (1–5) и дескрипторы уровней (0–3 с описанием ожидаемого поведения).
10. Решение проблем
10.1. Частые ошибки
LLM недоступен Проверьте настройки провайдера, нажмите «Тест», проверьте токен и модель, убедитесь в наличии средств на балансе.
write a readonly database Linux: chmod 777 db/ && chmod 666 db/production.db. Windows: icacls db/grant Everyone:F && icacls db\production.db /grant Everyone:F.
Port 3000 already in use Определите процесс на порту: netstat -ano | findstr :3000 (Windows) / lsof -i :3000 (Linux). Завершите его или измените порт через PORT.
Cannot find module '@prisma/client' Выполните bun run db:generate.
10.2. FAQ
- • Как сменить пароль суперадминистратора? Раздел «Администраторы» → найти учётную запись → «Сменить пароль»
- • Можно ли использовать систему без ИИ? Да, ручное создание карт и вопросов. Для открытых вопросов — fallback-оценка.
- • Как добавить новую должность? «Карты компетенций» → «Создать карту» → заполните информацию или используйте генерацию через ИИ.
- • Сколько хранятся результаты? Бессрочно в базе данных. Удалите вручную через интерфейс.
- • ИИ некорректно оценивает? Скорректируйте промпт answer_evaluation в «Инструкциях ИИ» или попробуйте другую модель.
— Конец документа —