NetWho Bot

AI-ассистент для нетворкинга. Умная записная книжка, напоминания (Recall system) и генерация интро. 📢 Telegram Community

🛠 Стек

• Python 3.11+ (в Docker используется 3.11-slim)
• Aiogram 3.x (Telegram Bot API)
• Supabase (PostgreSQL + Auth)
• OpenRouter / OpenAI (LLM inference)
• Groq (Voice transcription)
• APScheduler (Background tasks)
• uv (Package manager)

🚀 Запуск

Docker (Продакшен)

1. Создайте .env (на основе .env.example):

   cp .env.example .env

2. Запустите контейнер:

   docker compose up -d --build

3. Просмотр логов:

   docker compose logs -f bot

Локальный запуск (Разработка)

1. Установите uv (если еще не установлен):

   # Windows (PowerShell)
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   
   # Linux/Mac
   curl -LsSf https://astral.sh/uv/install.sh | sh

2. Установите зависимости:

   uv sync

3. Запустите бота:

   uv run python -m app.main

⚙️ Конфигурация (.env)

Основные переменные для продакшена.

Переменная	Обязательно	Описание
BOT_TOKEN	✅	Токен от @BotFather
SUPABASE_URL	✅	URL проекта Supabase
SUPABASE_KEY	⚠️	Устаревший, используй SUPABASE_SERVICE_ROLE_KEY
SUPABASE_SERVICE_ROLE_KEY	✅	Service Role ключ (обходит RLS, для доступа к БД)
OPENROUTER_API_KEY	✅	Ключ OpenRouter (или OpenAI)
ADMIN_ID	✅	Telegram ID владельца (для админ-команд)
LOG_LEVEL	❌	Уровень логирования: DEBUG, INFO, WARNING, ERROR (дефолт: INFO)
GROQ_API_KEY	❌	Для распознавания ГС (если не задан — войсы игнорируются)
LLM_MODEL	❌	Дефолт: openai/gpt-4o-mini

📦 База данных и Миграции

Проект использует Supabase (PostgreSQL).

• SQL-миграции находятся в папке /migrations.
• Применение: Вручную через Supabase Dashboard (SQL Editor) или psql. Автоматического наката миграций при старте нет.

🔧 Администрирование

Админ-команды (доступны ADMIN_ID):

• /admin — Список всех команд.
• /check_user <user_id> — Проверить статус подписки, триала и лимитов пользователя.
• /give_pro <user_id> <days> — Выдать Premium на N дней.
• /revoke_pro <user_id> — Аннулировать подписку.
• /debug_user <user_id> — Детальная отладочная информация о пользователе.

Полезные скрипты (в папке /scripts):

• uv run python scripts/check_db.py — Проверка подключения к БД.
• uv run python scripts/test_db.py — Прямой тест Supabase (проверка контактов, RLS).
• uv run python scripts/revoke_trial.py — Массовый отзыв триалов (если нужно).
• uv run python scripts/test_ai.py — Тест LLM коннектора.

Актуальность

Проект време