voidea/docs/admin-guide.md

Руководство администратора VoIdeaAI

Ролевая модель

Роль	Описание
Owner	Полный доступ, управление systemd-сервисами
Admin	Полный доступ к данным, управление пользователями и тарифами
Moderator	Ограниченные права, настраиваемые через permissions
User	Стандартный пользователь

Вкладки админ-панели

Пользователи

• Поиск пользователей по имени или email
• Редактирование роли (user/moderator/admin)
• Назначение прав модераторам (чекбоксы)
• Блокировка/разблокировка
• Owner защищён от изменений

Агенты

• Просмотр списка агентов (13 + Meta-agent)
• Включение/отключение агентов
• Редактирование описания
• Meta-agent — конфигурация JSON (cron_schedule, weights, sources_count, auto_create)
• Ручной запуск любого агента кнопкой «Запустить»
• Meta-agent по умолчанию запускается по расписанию 0 9 * * 1,4 (пн и чт в 9:00)

Журналы

• Фильтрация по уровню (DEBUG, INFO, WARNING, ERROR)
• Фильтрация по источнику
• Просмотр деталей записи

Обратная связь

• Просмотр отзывов пользователей
• Изменение статуса (new, read, replied, done)
• Удаление отзывов

Тарифы

• Создание новых тарифных планов
• Редактирование существующих
• Удаление
• Параметры: название, код, цена, описание, features JSON

Фичи

• Трекер функций (backlog)
• Статусы: pending, in_progress, done
• Категория: feature, general
• Приоритет: low, medium, high, critical

Сервисы (Owner only, production)

• Статус systemd-юнитов
• Перезапуск сервисов
• Доступно только в production

Система

• Версия приложения
• Окружение
• Статус БД
• Версия Python

Telegram Bot

Вкладка «Telegram Bot» в админ-панели:

• Список команд — все зарегистрированные @bot_command хендлеры
• Включение/отключение — toggle для каждой команды
• Синхронизация — принудительная синхронизация команд с Telegram API
• Команды автоматически синхронизируются при старте сервера
• Для работы требуется TELEGRAM_BOT_TOKEN в .env

Развёртывание (VPS Ubuntu 22.04+)

# Клонирование
git clone https://github.com/anomalyco/voidea /opt/voidea
cd /opt/voidea

# Настройка окружения
cp .env.example .env
# Заполните DATABASE_URL, JWT_SECRET_KEY, SYSTEM_OWNER_EMAIL

# --- Backend ---
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
alembic upgrade head

# --- Frontend ---
cd webui
npm ci          # чистая установка (lockfile)
npm run build   # сборка в dist/
cd ..

# --- Deploy скрипт (автоматизация) ---
chmod +x deploy/deploy.sh
./deploy/deploy.sh

# Сервисы запускаются через systemd
sudo systemctl start voidea-web     # Uvicorn
sudo systemctl start voidea-celery  # Celery worker
sudo systemctl start voidea-nginx   # Nginx reverse proxy

См. deploy/deploy.sh для полной автоматизации. Jenkins/GitHub Actions — deploy.yml.