feat: Система автоматического подтверждения выигрышей с поддержкой множественных счетов
Some checks reported errors
continuous-integration/drone/push Build encountered an error

Основные изменения:

 Новые функции:
- Система регистрации пользователей с множественными счетами
- Автоматическое подтверждение выигрышей через inline-кнопки
- Механизм переигровки для неподтвержденных выигрышей (24 часа)
- Подтверждение на уровне счетов (каждый счет подтверждается отдельно)
- Скрипт полной очистки базы данных

🔧 Технические улучшения:
- Исправлена ошибка MissingGreenlet при lazy loading (добавлен joinedload/selectinload)
- Добавлено поле claimed_at для отслеживания времени подтверждения
- Пакетное добавление счетов с выбором розыгрыша
- Проверка владения конкретным счетом при подтверждении

📚 Документация:
- docs/AUTO_CONFIRM_SYSTEM.md - Полная документация системы подтверждения
- docs/ACCOUNT_BASED_CONFIRMATION.md - Подтверждение на уровне счетов
- docs/REGISTRATION_SYSTEM.md - Система регистрации
- docs/ADMIN_COMMANDS.md - Команды администратора
- docs/CLEAR_DATABASE.md - Очистка БД
- docs/QUICK_GUIDE.md - Быстрое начало
- docs/UPDATE_LOG.md - Журнал обновлений

🗄️ База данных:
- Миграция 003: Таблицы accounts, winner_verifications
- Миграция 004: Поле claimed_at в таблице winners
- Скрипт scripts/clear_database.py для полной очистки

🎮 Новые команды:
Админские:
- /check_unclaimed <lottery_id> - Проверка неподтвержденных выигрышей
- /redraw <lottery_id> - Повторный розыгрыш
- /add_accounts - Пакетное добавление счетов
- /list_accounts <telegram_id> - Список счетов пользователя

Пользовательские:
- /register - Регистрация с вводом данных
- /my_account - Просмотр своих счетов
- Callback confirm_win_{id} - Подтверждение выигрыша

🛠️ Makefile:
- make clear-db - Очистка всех данных из БД (с подтверждением)

🔒 Безопасность:
- Проверка владения счетом при подтверждении
- Защита от подтверждения чужих счетов
- Независимое подтверждение каждого выигрышного счета

📊 Логика работы:
1. Пользователь регистрируется и добавляет счета
2. Счета участвуют в розыгрыше
3. Победители получают уведомление с кнопкой подтверждения
4. Каждый счет подтверждается отдельно (24 часа на подтверждение)
5. Неподтвержденные выигрыши переигрываются через /redraw
This commit is contained in:
2025-11-16 14:01:30 +09:00
parent 31c4c5382a
commit 505d26f0e9
21 changed files with 4217 additions and 68 deletions

72
docs/CLEAR_DATABASE.md Normal file
View File

@@ -0,0 +1,72 @@
# Очистка базы данных - Краткое руководство
## 🎯 Быстрый старт
```bash
make clear-db
```
Система попросит подтверждение, введите `yes`.
## ✅ Результат
База данных будет полностью очищена:
- ✅ Удалены все пользователи
- ✅ Удалены все розыгрыши
- ✅ Удалены все счета
- ✅ Удалены все участия
- ✅ Удалены все победители
- ✅ Сброшены счетчики ID (начнутся с 1)
## 📊 Статистика очистки
Скрипт покажет сколько строк удалено из каждой таблицы:
```
✅ winner_verifications - удалено 0 строк
✅ winners - удалено 2 строк
✅ participations - удалено 1 строк
✅ accounts - удалено 2 строк
✅ lotteries - удалено 1 строк
✅ users - удалено 2 строк
```
## ⚠️ ВНИМАНИЕ
**Данные удаляются БЕЗ ВОЗМОЖНОСТИ ВОССТАНОВЛЕНИЯ!**
Перед запуском на production всегда делайте бэкап:
```bash
pg_dump -h 192.168.0.102 -U bot_user -d bot_db > backup.sql
```
## 🔧 Альтернативные способы
### Через Python напрямую
```bash
source .venv/bin/activate
python scripts/clear_database.py
```
### Через SQL (только данные, без сброса ID)
```sql
DELETE FROM winner_verifications;
DELETE FROM winners;
DELETE FROM participations;
DELETE FROM accounts;
DELETE FROM lotteries;
DELETE FROM users;
```
## 📖 Подробная документация
См. `scripts/README_CLEAR_DB.md` для полной документации.
## 🆘 Восстановление из бэкапа
```bash
psql -h 192.168.0.102 -U bot_user -d bot_db < backup.sql
```