105 lines
4.0 KiB
Markdown
105 lines
4.0 KiB
Markdown
# Руководство администратора 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+)
|
|
|
|
```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`.
|