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

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

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

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

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

### Агенты
- Просмотр списка агентов
- Включение/отключение агентов
- Редактирование описания

### Журналы
- Фильтрация по уровню (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+)

```bash
# Клонирование
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`.