89 lines
2.6 KiB
Markdown
89 lines
2.6 KiB
Markdown
````markdown
|
||
# Быстрый старт
|
||
|
||
## 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!
|
||
```` |