import { useAuth } from "../auth/AuthContext";
export default function AdminDocumentationTab() {
const { user } = useAuth();
return (
Документация администратора
Ролевая модель
- Owner — полный доступ, управление сервисами systemd, debug mode
- Admin — полный доступ к данным, управление пользователями и тарифами
- Moderator — ограниченные права, настраиваемые через чекбоксы
- User — стандартный пользователь
Вкладки админ-панели
- Пользователи
- Поиск, редактирование ролей, блокировка, назначение прав модераторам
- Агенты
- Просмотр и управление агентами, включение/отключение
- Журналы
- Просмотр логов, debug mode, очистка, экспорт. Фильтрация по уровню и источнику
- Обратная связь
- Управление отзывами пользователей, изменение статуса
- Тарифы
- Создание и редактирование тарифных планов
- Фичи
- Трекер новых функций, 2FA глобальный переключатель
- Пайплайн
- Настройка VAD, wake word, семантической валидации, цепочек агентов и авто-тюнинга
- Сервисы
- Управление systemd-сервисами (только owner, только production)
- Система
- Информация о версии, БД, окружении
Настройка VAD (шумоподавление)
Вкладка «Пайплайн» позволяет точно настроить параметры обнаружения голоса:
- noise_threshold (0–1) — порог шума. Чем ниже, тем тише звуки будут считаться речью. Для тихого окружения ставьте 0.1–0.2, для шумного — 0.5–0.7
- silence_timeout_ms — сколько миллисекунд тишины нужно, чтобы считать фразу законченной. Больше = дольше ждёт паузу
- min_audio_duration_ms — минимальная длина аудио в миллисекундах. Короткие звуки (щелчки, кашель) отбрасываются
Пользователи выбирают пресеты голоса в настройках. Администратор может задать
точные значения в пайплайне — они станут базой для всех пользователей.
2FA (двухфакторная аутентификация)
Глобальный переключатель 2FA находится во вкладке «Фичи». Если 2FA отключена —
пользователи входят без кода, даже если у каждого лично 2FA была включена.
Debug Mode
Во вкладке «Журналы» доступен режим расширенного логирования (1000%).
Включается owner-ом. При активации логируются:
- Каждый HTTP-запрос (метод, path, статус, длительность)
- Каждый LLM-вызов (промпт, ответ, модель)
- Все вызовы агентов с полными данными
- Все этапы пайплайна
Логи авто-очищаются по расписанию (настраивается). Owner также может очистить
вручную. При переполнении (80%) отправляется уведомление.
Экспорт логов
Вкладка «Журналы» → кнопка «Скачать». Все логи выгружаются одним JSON-файлом
для скачивания на локальную машину. Удобно для анализа ошибок вне VPS.
{user?.role === "owner" && (
<>
Управление сервисами
Вкладка «Сервисы» доступна только владельцу. Позволяет перезапускать
systemd-юниты: voidea-api, voidea-worker, voidea-beat.
Работает только в production-окружении.
>
)}
);
}