new_lottery_bot/docs/QUICKSTART.md

# Быстрый старт

## 1. Создание бота в Telegram

1. Найдите @BotFather в Telegram
2. Отправьте команду `/newbot`
3. Следуйте инструкциям для создания бота
4. Сохраните полученный токен

## 2. Получение вашего Telegram ID

1. Найдите @userinfobot в Telegram
2. Отправьте команду `/start`
3. Запишите ваш ID (число)

## 3. Настройка проекта

```bash
# Копируйте файл конфигурации
cp .env.example .env

# Отредактируйте .env файл, заполнив:
# BOT_TOKEN=ваш_токен_от_BotFather
# ADMIN_IDS=ваш_telegram_id
```

## 4. Быстрый запуск

```bash
# Автоматический запуск (рекомендуется)
./start.sh

# Или ручная установка:
pip install -r requirements.txt
python utils.py init
python utils.py setup-admins
python main.py
```

## 5. Тестирование

```bash
# Создать тестовый розыгрыш
python utils.py sample

# Посмотреть статистику
python utils.py stats
```

## 6. Использование бота

1. Найдите вашего бота в Telegram по имени
2. Отправьте `/start`
3. Используйте кнопки меню для навигации

### Как провести розыгрыш:

1. **Создайте розыгрыш** (только админы)
   - Нажмите "➕ Создать розыгрыш"
   - Введите название, описание и призы

2. **Установите ручных победителей** (опционально)
   - Нажмите "👑 Установить победителя"
   - Выберите розыгрыш и место
   - Введите Telegram ID пользователя

3. **Дождитесь участников**
   - Участники нажимают "🎫 Участвовать"

4. **Проведите розыгрыш**
   - Выберите розыгрыш
   - Нажмите "🎲 Провести розыгрыш"
   - Ручные победители займут свои места автоматически

## Смена базы данных

### На PostgreSQL:

1. Установите PostgreSQL
2. Создайте базу данных
3. В .env измените:
```env
DATABASE_URL=postgresql+asyncpg://username:password@localhost/lottery_bot_db
```
4. Перезапустите бота

Все данные автоматически мигрируют благодаря SQLAlchemy ORM!