Initial commit: VoIdeaAI - voice-first AI idea assistant

2026-05-13 12:51:42 +03:00
commit 688d043dad
421 changed files with 47915 additions and 0 deletions
@@ -0,0 +1,101 @@
+# Руководство администратора 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`.