# Быстрая шпаргалка - Команды администратора

## 🚀 Основные команды

### Добавление счетов

**Один счет (быстро):**
```
/add_account 2223 11-22-33-44-55-66-77
```

**Несколько счетов (пакетом):**
```
/add_account

2223 11-22-33-44-55-66-77
2223 88-99-00-11-22-33-44
3334 12-34-56-78-90-12-34
```

### Управление счетами

```
/remove_account 11-22-33-44-55-66-77    # Деактивировать
/user_info 2223                         # Информация о пользователе
```

### Работа с розыгрышами

```
/winner_status 1                        # Статус победителей
/verify_winner AB12CD34 1               # Подтвердить выигрыш
```

---

## 📋 Типичные сценарии

### Новый клиент (полный цикл)

1. Клиент регистрируется: `/start` → "Зарегистрироваться"
2. Админ добавляет счета:
   ```
   /add_account 2223 11-22-33-44-55-66-77
   ```
3. Выбрать розыгрыш из списка
4. Готово!

### Массовое добавление (10+ счетов)

```
/add_account

2223 11-22-33-44-55-66-77
2223 22-33-44-55-66-77-88
3334 33-44-55-66-77-88-99
3334 44-55-66-77-88-99-00
5556 55-66-77-88-99-00-11
```

→ Выбрать розыгрыш → Готово!

### Проведение розыгрыша

1. В боте: "Розыгрыши" → Выбрать → "Провести розыгрыш"
2. Победители получат уведомления автоматически
3. Проверить: `/winner_status 1`

### Подтверждение победителя

1. Победитель сообщает код: `AB12CD34`
2. Админ: `/verify_winner AB12CD34 1`
3. Система подтверждает и уведомляет победителя

---

## 💡 Полезные советы

- **Формат счета:** `XX-XX-XX-XX-XX-XX-XX` (7 пар цифр)
- **Клубная карта:** Любые цифры (например: 2223, 5556)
- **Код верификации:** Генерируется автоматически при регистрации
- **Отмена операции:** `/cancel` во время ввода данных

---

## ⚠️ Частые ошибки

| Ошибка | Причина | Решение |
|--------|---------|---------|
| "Пользователь не найден" | Клубная карта не зарегистрирована | Попросить зарегистрироваться через /start |
| "Счет уже существует" | Номер занят другим пользователем | Проверить номер или деактивировать старый |
| "Неверный формат" | Формат счета неправильный | Использовать XX-XX-XX-XX-XX-XX-XX |
| Нет розыгрышей | Нет активных розыгрышей | Создать розыгрыш через админ-панель |

---

## 🔍 Проверка данных

### Проверить пользователя:
```
/user_info 2223
```

Увидите:
- Все счета пользователя
- Код верификации
- Историю выигрышей

### Проверить победителей:
```
/winner_status 1
```

Увидите:
- Список всех победителей
- Статус подтверждения (✅/⏳)
- Информацию о владельцах

---

## 📞 Пользовательские команды

Клиенты используют:
- `/start` - Главное меню / регистрация
- `/my_code` - Показать код верификации
- `/my_accounts` - Список счетов
- "Мой счет" (через меню) - Подробная информация

---

## 🎯 Быстрый старт (за 1 минуту)

```bash
# 1. Клиент регистрируется
Клиент → /start → "Зарегистрироваться" → Вводит данные

# 2. Админ добавляет счета
/add_account
2223 11-22-33-44-55-66-77
2223 88-99-00-11-22-33-44

# 3. Выбрать розыгрыш
Нажать "🎯 Новогодний розыгрыш"

# 4. Провести розыгрыш
"Розыгрыши" → Выбрать → "Провести"

# 5. Подтвердить победителя
/verify_winner AB12CD34 1

✅ Готово!
```