═══════════════════════════════════════════════════════════════════════════════
                    ПОЛНОЕ РУКОВОДСТВО ПО АДМИН-ПАНЕЛИ БОТА
═══════════════════════════════════════════════════════════════════════════════

📋 СОДЕРЖАНИЕ:
1. Первый запуск и вход в админку
2. Главное меню админки
3. Управление тестами
4. Создание теста (подробно)
5. Управление группами
6. Управление пользователями
7. Рассылка сообщений
8. Шаблоны тестов
9. Частые вопросы и решение проблем

═══════════════════════════════════════════════════════════════════════════════
1. ПЕРВЫЙ ЗАПУСК И ВХОД В АДМИНКУ
═══════════════════════════════════════════════════════════════════════════════

ШАГ 1: Запуск бота
   • Откройте Telegram
   • Найдите вашего бота по имени или ссылке
   • Нажмите кнопку "Запустить" (Start) внизу экрана
   • Или отправьте команду /start

ШАГ 2: Вход в админ-панель
   • Отправьте команду /admin
   • Если вы администратор, откроется админ-панель
   • Если команда не работает - обратитесь к создателю бота (@kolo_id)
   • Только создатель бота имеет права назначать администраторов

═══════════════════════════════════════════════════════════════════════════════
2. ГЛАВНОЕ МЕНЮ АДМИНКИ
═══════════════════════════════════════════════════════════════════════════════

После команды /admin вы увидите админ-панель с кнопками:

📝 Тесты - управление всеми тестами (создание, редактирование, удаление)
👥 Группы - управление группами студентов
👤 Пользователи - просмотр и управление пользователями бота
📢 Рассылка - отправка сообщений всем пользователям или выбранным группам
📄 Шаблоны - импорт и экспорт тестов

Чтобы выбрать нужный раздел, просто НАЖМИТЕ на соответствующую кнопку.

═══════════════════════════════════════════════════════════════════════════════
3. УПРАВЛЕНИЕ ТЕСТАМИ
═══════════════════════════════════════════════════════════════════════════════

3.1. ПРОСМОТР СПИСКА ТЕСТОВ

ШАГ 1: В админ-панели нажмите кнопку "📝 Тесты"
ШАГ 2: Вы увидите список всех созданных тестов

Обозначения в списке:
   🟢 - тест активен (студенты могут его проходить)
   🔴 - тест деактивирован (студенты НЕ видят этот тест)

ШАГ 3: Нажмите на любой тест, чтобы увидеть подробную информацию

════════════════════════════════════════════════════════════════════════════

3.2. ПРОСМОТР ИНФОРМАЦИИ О ТЕСТЕ

После выбора теста вы увидите:
   • Название теста
   • Описание
   • Статус (активен/деактивирован)
   • Количество вопросов
   • Пароль (если установлен)
   • Количество попыток (если ограничено)
   • Лимит времени (если установлен)
   • Срок действия (если установлен)
   • Для какой группы тест (если указано)
   • Видимость результатов
   • Дата создания

Доступные действия с тестом:

🟢 Активировать / 🔴 Деактивировать
   Включает или выключает доступ студентов к тесту
   Нажмите эту кнопку, чтобы изменить статус

👁 Показать результаты / 🔒 Скрыть результаты
   Определяет, видят ли студенты свои результаты после прохождения
   Нажмите, чтобы переключить видимость

📊 Статистика
   Показывает список всех, кто прошёл тест
   Отображает баллы и дату прохождения
   Нажмите на любую попытку, чтобы увидеть детальные ответы

🔗 Поделиться
   Создаёт ссылку и QR-код для теста
   Отправьте ссылку студентам для прохождения теста
   QR-код можно распечатать или показать на экране

📥 Экспорт
   Выгружает результаты теста в Excel файл
   Выберите группу для экспорта
   Получите файл со всеми результатами

✏️ Изменить
   Открывает меню редактирования теста
   Можно изменить пароль, попытки, время, группу, срок
   Можно удалить тест

◀️ Назад
   Возвращает к списку тестов

═══════════════════════════════════════════════════════════════════════════════
4. СОЗДАНИЕ ТЕСТА (ПОДРОБНАЯ ИНСТРУКЦИЯ)
═══════════════════════════════════════════════════════════════════════════════

4.1. НАЧАЛО СОЗДАНИЯ ТЕСТА

ШАГ 1: В админ-панели нажмите "📝 Тесты"
ШАГ 2: Нажмите кнопку "➕ Добавить тест" внизу списка
ШАГ 3: Начнётся процесс создания теста

⚠️ ВАЖНО: Если вы передумали создавать тест, нажмите "◀️ Отмена" на любом этапе

════════════════════════════════════════════════════════════════════════════

4.2. ЭТАП 1: НАЗВАНИЕ ТЕСТА

Что вы увидите:
   "📝 Создание теста
    💬 Введите название теста:
    (максимум 255 символов)"

Что делать:
   1. Напишите название теста (например: "Контрольная работа по математике")
   2. Отправьте сообщение
   3. Бот автоматически перейдёт к следующему шагу

Примеры хороших названий:
   ✅ "Тест по истории России - 19 век"
   ✅ "Контрольная работа №3 - Физика"
   ✅ "Входное тестирование по английскому"

Примеры плохих названий:
   ❌ "тест" (слишком общее)
   ❌ "" (пустое название)

════════════════════════════════════════════════════════════════════════════

4.3. ЭТАП 2: ОПИСАНИЕ ТЕСТА

Что вы увидите:
   "📝 Создание теста
    📄 Введите описание теста:
    (максимум 2000 символов)"

Что делать:
   1. Напишите описание теста
   2. Опишите, что будет в тесте, какие темы
   3. Отправьте сообщение

Примеры описаний:
   ✅ "Тест охватывает темы: дроби, проценты, уравнения. Всего 20 вопросов."
   ✅ "Проверка знаний по теме 'Великая Отечественная война'"
   ✅ "Входное тестирование для определения уровня знаний"

════════════════════════════════════════════════════════════════════════════

4.4. ЭТАП 3: ПАРОЛЬ (НЕОБЯЗАТЕЛЬНО)

Что вы увидите:
   "🔒 Пароль
    🔑 Введите пароль для доступа к тесту или пропустите этот шаг:
    (максимум 255 символов)"

Два варианта действий:

ВАРИАНТ А: Установить пароль
   1. Напишите пароль (например: "math2024")
   2. Отправьте сообщение
   3. Студенты должны будут ввести этот пароль перед началом теста

ВАРИАНТ Б: Без пароля
   1. Нажмите кнопку "⏭️ Без пароля"
   2. Любой студент сможет начать тест без пароля

Когда использовать пароль:
   ✅ Для контрольных работ (чтобы все начали одновременно)
   ✅ Для закрытых тестов (только для определённых студентов)
   ❌ Для обычных тренировочных тестов

════════════════════════════════════════════════════════════════════════════

4.5. ЭТАП 4: КОЛИЧЕСТВО ПОПЫТОК (НЕОБЯЗАТЕЛЬНО)

Что вы увидите:
   "🔄 Количество попыток
    🔢 Введите количество попыток (1-100) или пропустите для неограниченного количества:"

Два варианта действий:

ВАРИАНТ А: Ограничить попытки
   1. Напишите число от 1 до 100 (например: "3")
   2. Отправьте сообщение
   3. Каждый студент сможет пройти тест только указанное количество раз

ВАРИАНТ Б: Без ограничений
   1. Нажмите кнопку "⏭️ Без ограничений"
   2. Студенты смогут проходить тест сколько угодно раз

Рекомендации:
   • Для контрольных: 1 попытка
   • Для тренировочных: без ограничений или 3-5 попыток
   • Для экзаменов: 1-2 попытки

════════════════════════════════════════════════════════════════════════════

4.6. ЭТАП 5: ЛИМИТ ВРЕМЕНИ (НЕОБЯЗАТЕЛЬНО)

Что вы увидите:
   "⏱️ Лимит времени
    🔢 Введите лимит времени в минутах (1-1440) или пропустите для неограниченного времени:"

Два варианта действий:

ВАРИАНТ А: Установить лимит
   1. Напишите количество минут (например: "30")
   2. Отправьте сообщение
   3. У студента будет ровно столько времени на прохождение

ВАРИАНТ Б: Без лимита
   1. Нажмите кнопку "⏭️ Без лимита"
   2. Студенты смогут проходить тест без ограничения по времени

Рекомендации по времени:
   • 1-2 минуты на вопрос (10 вопросов = 10-20 минут)
   • Для сложных вопросов: 3-5 минут на вопрос
   • Максимум: 1440 минут (24 часа)

⚠️ ВАЖНО: Время начинает отсчитываться с момента начала теста!

════════════════════════════════════════════════════════════════════════════

4.7. ЭТАП 6: СРОК ДЕЙСТВИЯ (НЕОБЯЗАТЕЛЬНО)

Что вы увидите:
   "📅 Срок действия
    🗓 Выберите дату истечения теста или пропустите:"
   + календарь для выбора даты

Два варианта действий:

ВАРИАНТ А: Установить срок
   1. Нажмите на нужную дату в календаре
   2. После этой даты тест станет недоступен для прохождения
   3. Студенты не смогут начать тест после указанной даты

ВАРИАНТ Б: Без срока
   1. Нажмите кнопку "⏭️ Без срока"
   2. Тест будет доступен всегда (пока вы его не деактивируете)

Когда использовать срок:
   ✅ Для контрольных работ (например, до конца недели)
   ✅ Для домашних заданий с дедлайном
   ❌ Для тренировочных материалов

════════════════════════════════════════════════════════════════════════════

4.8. ЭТАП 7: ВЫБОР ГРУППЫ (НЕОБЯЗАТЕЛЬНО)

Что вы увидите:
   "👥 Группа
    🎓 Выберите группу или пропустите для всех:"
   + список всех групп

Два варианта действий:

ВАРИАНТ А: Для конкретной группы
   1. Нажмите на номер нужной группы (например: "2301")
   2. Тест будет виден только студентам этой группы
   3. Другие студенты не увидят этот тест

ВАРИАНТ Б: Для всех групп
   1. Нажмите кнопку "⏭️ Для всех"
   2. Тест будут видеть все студенты

⚠️ ВАЖНО: Если у вас нет групп, сначала создайте их в разделе "👥 Группы"

════════════════════════════════════════════════════════════════════════════

4.9. ЭТАП 8: ПОДТВЕРЖДЕНИЕ ИНФОРМАЦИИ

Что вы увидите:
   Сводку всей информации о тесте:
   • Название
   • Описание
   • Пароль (или "Без пароля")
   • Попытки (или "Без ограничений")
   • Время (или "Без лимита")
   • Срок (или "Без срока")
   • Группа (или "Для всех")

Что делать:
   1. ВНИМАТЕЛЬНО проверьте всю информацию
   2. Если всё правильно - нажмите "✅ Создать"
   3. Если нужно исправить - нажмите "❌ Отмена" и начните заново

⚠️ ВАЖНО: После создания можно будет изменить все параметры, кроме названия и описания!

════════════════════════════════════════════════════════════════════════════

4.10. ЭТАП 9: ДОБАВЛЕНИЕ ВОПРОСОВ

После подтверждения вы увидите:
   "➕ Добавление вопросов
    📊 Вопросов добавлено: 0
    💡 Добавьте вопросы к тесту:"

Две кнопки:
   ➕ Добавить вопрос - начать добавление нового вопроса
   ✅ Завершить создание - закончить создание теста

⚠️ ВАЖНО: Тест должен содержать хотя бы ОДИН вопрос!

Нажмите "➕ Добавить вопрос" чтобы продолжить.

════════════════════════════════════════════════════════════════════════════

4.11. СОЗДАНИЕ ВОПРОСА - ШАГ 1: ТЕКСТ ВОПРОСА

Что вы увидите:
   "❓ Текст вопроса
    📝 Отправьте текст вопроса или 📷 фото с подписью:
    (максимум 2000 символов)"

Два варианта:

ВАРИАНТ А: Текстовый вопрос
   1. Напишите текст вопроса
   2. Отправьте сообщение
   Пример: "Сколько будет 2+2?"

ВАРИАНТ Б: Вопрос с изображением
   1. Прикрепите фото
   2. В подписи к фото напишите текст вопроса
   3. Отправьте
   Пример: Фото графика + подпись "Найдите точку пересечения с осью X"

⚠️ ВАЖНО: Если отправляете фото, подпись ОБЯЗАТЕЛЬНА!

Если передумали добавлять вопрос - нажмите "◀️ Назад"

════════════════════════════════════════════════════════════════════════════

4.12. СОЗДАНИЕ ВОПРОСА - ШАГ 2: ТИП ВОПРОСА

Что вы увидите:
   "📋 Тип вопроса
    🎯 Выберите тип вопроса:"

Три варианта:

📌 Один правильный ответ
   Студент выбирает ОДИН вариант из списка
   Используйте для вопросов с одним правильным ответом
   Пример: "Столица России? а) Москва б) Киев в) Минск"

📋 Несколько правильных ответов
   Студент может выбрать НЕСКОЛЬКО вариантов
   Используйте когда правильных ответов больше одного
   Пример: "Выберите чётные числа: а) 2 б) 3 в) 4 г) 5"

✏️ Ввод текста
   Студент сам пишет ответ
   Используйте для открытых вопросов
   Пример: "Напишите столицу Франции"

Нажмите на нужный тип вопроса.

════════════════════════════════════════════════════════════════════════════

4.13. ТИП ВОПРОСА: ВВОД ТЕКСТА

Если вы выбрали "✏️ Ввод текста", вы увидите:
   "✏️ Правильный ответ
    💬 Введите правильный ответ (регистр и пробелы игнорируются):
    (максимум 255 символов)"

Что делать:
   1. Напишите правильный ответ
   2. Отправьте сообщение

Примеры:
   Вопрос: "Столица Франции?"
   Ответ: "Париж"
   
   Вопрос: "Сколько будет 5+5?"
   Ответ: "10"

⚠️ ВАЖНО: 
   • Регистр НЕ важен ("париж" = "Париж" = "ПАРИЖ")
   • Пробелы в начале и конце игнорируются
   • Ответ должен быть точным!

После ввода переходите к шагу 4.16 (Предпросмотр вопроса)

════════════════════════════════════════════════════════════════════════════

4.14. ТИП ВОПРОСА: ОДИН ИЛИ НЕСКОЛЬКО ПРАВИЛЬНЫХ - ДОБАВЛЕНИЕ ВАРИАНТОВ

Если вы выбрали "📌 Один правильный" или "📋 Несколько правильных", вы увидите:
   "📝 Варианты ответов
    📊 Добавлено вариантов: 0/10
    💬 Введите вариант ответа:
    (максимум 255 символов)"

Что делать:
   1. Напишите первый вариант ответа
   2. Отправьте сообщение
   3. Бот ответит "✅ Вариант 1 добавлен"
   4. Напишите второй вариант ответа
   5. Отправьте сообщение
   6. Бот ответит "✅ Вариант 2 добавлен"
   7. Продолжайте добавлять варианты (минимум 2, максимум 10)
   8. Когда добавили все варианты - нажмите "✅ Завершить добавление вариантов"

Пример:
   Вопрос: "Столица России?"
   Вариант 1: "Москва"
   Вариант 2: "Санкт-Петербург"
   Вариант 3: "Казань"
   Вариант 4: "Новосибирск"

⚠️ ВАЖНО: Нужно добавить минимум 2 варианта!

════════════════════════════════════════════════════════════════════════════

4.15. ОТМЕТКА ПРАВИЛЬНЫХ ОТВЕТОВ

После завершения добавления вариантов вы увидите:
   "✅ Правильные ответы
    Отметьте правильные варианты ответов:"
   + список всех вариантов

Что вы увидите:
   ❌ Москва
   ❌ Санкт-Петербург
   ❌ Казань
   ❌ Новосибирск

Что делать:

ДЛЯ ТИПА "Один правильный ответ":
   1. Нажмите на ОДИН правильный вариант
   2. Он изменится на ✅
   3. Если нажмёте на другой - предыдущий станет ❌
   4. Когда выбрали правильный - нажмите "✅ Подтвердить выбор"

ДЛЯ ТИПА "Несколько правильных ответов":
   1. Нажимайте на ВСЕ правильные варианты
   2. Они будут меняться: ❌ → ✅ → ❌
   3. Можно выбрать несколько вариантов
   4. Когда отметили все правильные - нажмите "✅ Подтвердить выбор"

Пример для "Один правильный":
   ✅ Москва          ← правильный
   ❌ Санкт-Петербург
   ❌ Казань
   ❌ Новосибирск

Пример для "Несколько правильных":
   Вопрос: "Выберите чётные числа"
   ✅ 2  ← правильный
   ❌ 3
   ✅ 4  ← правильный
   ❌ 5

⚠️ ВАЖНО: Должен быть выбран хотя бы ОДИН правильный ответ!

════════════════════════════════════════════════════════════════════════════

4.16. ПРЕДПРОСМОТР ВОПРОСА

После всех настроек вы увидите предпросмотр:
   "📝 Предпросмотр вопроса
    
    Текст: [ваш текст вопроса]
    Тип: [тип вопроса]
    Изображение: ✅ Да / ❌ Нет
    
    [Варианты ответов с отметками правильных]"

Что делать:
   1. ВНИМАТЕЛЬНО проверьте всё
   2. Проверьте текст вопроса
   3. Проверьте правильные ответы (они отмечены ✅)
   4. Если всё правильно - нажмите "✅ Сохранить"
   5. Если нужно исправить - нажмите "❌ Отмена" и создайте вопрос заново

После сохранения:
   • Бот ответит "✅ Вопрос добавлен"
   • Вы вернётесь к экрану "➕ Добавление вопросов"
   • Счётчик вопросов увеличится: "📊 Вопросов добавлено: 1"

════════════════════════════════════════════════════════════════════════════

4.17. ЗАВЕРШЕНИЕ СОЗДАНИЯ ТЕСТА

Когда добавили все нужные вопросы:
   1. Нажмите кнопку "✅ Завершить создание"
   2. Бот ответит "✅ Тест создан"
   3. Вы вернётесь к списку тестов

⚠️ ВАЖНО: 
   • Тест создаётся ДЕАКТИВИРОВАННЫМ (🔴)
   • Студенты его НЕ видят
   • Чтобы студенты могли проходить тест - АКТИВИРУЙТЕ его!

Как активировать тест:
   1. Нажмите на созданный тест в списке
   2. Нажмите кнопку "🟢 Активировать"
   3. Теперь студенты видят тест и могут его проходить

🎉 ПОЗДРАВЛЯЕМ! Вы создали свой первый тест!

═══════════════════════════════════════════════════════════════════════════════
5. УПРАВЛЕНИЕ ГРУППАМИ
═══════════════════════════════════════════════════════════════════════════════

5.1. ЗАЧЕМ НУЖНЫ ГРУППЫ?

Группы позволяют:
   ✅ Создавать тесты для конкретных групп студентов
   ✅ Делать рассылки только определённым группам
   ✅ Фильтровать пользователей по группам
   ✅ Экспортировать результаты по группам

════════════════════════════════════════════════════════════════════════════

5.2. ПРОСМОТР СПИСКА ГРУПП

ШАГ 1: В админ-панели нажмите "👥 Группы"
ШАГ 2: Вы увидите список всех групп и их количество

Пример:
   "👥 Управление группами
    📊 Всего групп: 3
    
    Список групп:
    2301
    2302
    2401"

Доступные действия:
   ➕ Добавить группу - создать новую группу
   🗑 Удалить группу - удалить существующую группу
   ◀️ Назад - вернуться в админ-панель

════════════════════════════════════════════════════════════════════════════

5.3. ДОБАВЛЕНИЕ НОВОЙ ГРУППЫ

ШАГ 1: Нажмите кнопку "➕ Добавить группу"
ШАГ 2: Вы увидите:
   "➕ Добавление группы
    🔢 Введите номер группы (четырехзначное число 1000-9999):"

ШАГ 3: Напишите номер группы (например: "2301")
ШАГ 4: Отправьте сообщение

Что произойдёт:
   ✅ Если номер правильный - группа создана
   ❌ Если номер неправильный - бот попросит ввести заново

Правила для номера группы:
   ✅ Только цифры
   ✅ Ровно 4 цифры (от 1000 до 9999)
   ❌ Нельзя создать группу с существующим номером

Примеры:
   ✅ 2301 - правильно
   ✅ 1234 - правильно
   ❌ 123 - неправильно (3 цифры)
   ❌ 12345 - неправильно (5 цифр)
   ❌ abc1 - неправильно (буквы)

════════════════════════════════════════════════════════════════════════════

5.4. УДАЛЕНИЕ ГРУППЫ

ШАГ 1: Нажмите кнопку "🗑 Удалить группу"
ШАГ 2: Вы увидите список всех групп
ШАГ 3: Нажмите на группу, которую хотите удалить
ШАГ 4: Подтвердите удаление:
   "⚠️ Подтверждение удаления
    Точно хотите удалить группу?
    👥 [номер группы]"

ШАГ 5: Нажмите "✅ Да, удалить" или "❌ Отмена"

⚠️ ВАЖНО: 
   • Удаление группы НЕ удаляет студентов
   • Студенты просто останутся без группы
   • Тесты для этой группы станут доступны всем

═══════════════════════════════════════════════════════════════════════════════
6. УПРАВЛЕНИЕ ПОЛЬЗОВАТЕЛЯМИ
═══════════════════════════════════════════════════════════════════════════════

6.1. ПРОСМОТР СПИСКА ПОЛЬЗОВАТЕЛЕЙ

ШАГ 1: В админ-панели нажмите "👤 Пользователи"
ШАГ 2: Вы увидите список всех пользователей бота

Формат отображения:
   👑 Иван Иванов (@ivanov) - администратор
   Пётр Петров (@petrov) - обычный пользователь
   Мария Сидорова (@нет) - пользователь без username

Обозначения:
   👑 - администратор бота
   @ - username пользователя в Telegram

Доступные действия:
   🔍 Фильтр по группе - показать только пользователей определённой группы
   ✏️ Ввести ID/Username - найти конкретного пользователя
   ◀️ Назад - вернуться в админ-панель

════════════════════════════════════════════════════════════════════════════

6.2. ФИЛЬТР ПОЛЬЗОВАТЕЛЕЙ ПО ГРУППЕ

ШАГ 1: Нажмите "🔍 Фильтр по группе"
ШАГ 2: Выберите нужную группу из списка
ШАГ 3: Вы увидите только пользователей этой группы

Чтобы сбросить фильтр:
   1. Нажмите "🔍 Фильтр по группе" снова
   2. Нажмите "🗑 Сбросить фильтр"
   3. Вы снова увидите всех пользователей

════════════════════════════════════════════════════════════════════════════

6.3. ПОИСК ПОЛЬЗОВАТЕЛЯ

ШАГ 1: Нажмите "✏️ Ввести ID/Username"
ШАГ 2: Напишите ID или username пользователя
ШАГ 3: Отправьте сообщение

Форматы поиска:
   • По ID: напишите число (например: "123456789")
   • По username: напишите с @ (например: "@ivanov")

Что произойдёт:
   ✅ Если пользователь найден - откроется его профиль
   ❌ Если не найден - бот сообщит об ошибке

════════════════════════════════════════════════════════════════════════════

6.4. ПРОСМОТР ПРОФИЛЯ ПОЛЬЗОВАТЕЛЯ

После выбора пользователя вы увидите:
   "👤 Информация о пользователе
    
    ID: [числовой ID]
    Ник: [имя в Telegram]
    Имя и фамилия: [полное имя или —]
    Username: [@username или —]
    Группа: [номер группы или —]
    Администратор: ✅ Да / ❌ Нет"

Доступные действия:

📊 Статистика
   Показывает все пройденные тесты
   Отображает баллы и даты
   Можно посмотреть детальные ответы

◀️ Назад
   Вернуться к списку пользователей

════════════════════════════════════════════════════════════════════════════

6.5. СТАТИСТИКА ПОЛЬЗОВАТЕЛЯ

ШАГ 1: В профиле пользователя нажмите "📊 Статистика"
ШАГ 2: Вы увидите:
   "📊 Статистика: [Имя пользователя]
    
    📝 Пройдено тестов: [число]
    📊 Средняя точность: [процент]%
    
    [Список всех попыток]"

Формат списка попыток:
   ✅ Название теста — 85% (01.01.2024) - тест пройден
   ❌ Название теста — 45% (02.01.2024) - тест не пройден

ШАГ 3: Нажмите на любую попытку, чтобы увидеть детальные ответы

Детальный просмотр покажет:
   • Все вопросы теста
   • Ответы пользователя
   • Правильные ответы
   • Отметки правильности (✅/❌)

═══════════════════════════════════════════════════════════════════════════════
7. РАССЫЛКА СООБЩЕНИЙ
═══════════════════════════════════════════════════════════════════════════════

7.1. ЧТО ТАКОЕ РАССЫЛКА?

Рассылка позволяет отправить одно сообщение:
   ✅ Всем пользователям бота
   ✅ Выбранным группам
   ✅ Нескольким группам одновременно

Можно отправлять:
   ✅ Текстовые сообщения
   ✅ Фотографии с подписью
   ✅ Документы
   ✅ Любой тип сообщения Telegram

════════════════════════════════════════════════════════════════════════════

7.2. СОЗДАНИЕ РАССЫЛКИ

ШАГ 1: В админ-панели нажмите "📢 Рассылка"

ШАГ 2: Выберите целевую аудиторию
   Вы увидите:
   "📢 Рассылка
    Выберите группы для рассылки:"
   + список всех групп с галочками

ШАГ 3: Выберите группы (необязательно)
   • Нажимайте на группы, чтобы отметить их галочками
   • ⬜ - группа НЕ выбрана
   • ✅ - группа выбрана
   • Можно выбрать несколько групп

ШАГ 4: Выберите действие:

ВАРИАНТ А: Отправить выбранным группам
   1. Отметьте нужные группы галочками
   2. Нажмите "📤 Отправить выбранным"
   3. Сообщение получат только студенты выбранных групп

ВАРИАНТ Б: Отправить всем
   1. Нажмите "📢 Отправить всем"
   2. Сообщение получат ВСЕ пользователи бота
   3. Группы игнорируются

════════════════════════════════════════════════════════════════════════════

7.3. ОТПРАВКА СООБЩЕНИЯ

После выбора аудитории вы увидите:
   "📢 Рассылка
    Отправьте сообщение, которое хотите разослать:"

ШАГ 1: Создайте сообщение
   • Напишите текст
   • Или отправьте фото с подписью
   • Или отправьте документ
   • Или любое другое сообщение

ШАГ 2: Отправьте сообщение боту

ШАГ 3: Подтвердите рассылку
   Вы увидите:
   "⚠️ Подтверждение рассылки
    Вы уверены, что хотите отправить это сообщение [кому]?"

   [кому] может быть:
   • "всем пользователям"
   • "группам: 2301, 2302"

ШАГ 4: Нажмите "✅ Да" или "❌ Нет"

════════════════════════════════════════════════════════════════════════════

7.4. ПРОЦЕСС РАССЫЛКИ

После подтверждения:
   1. Бот напишет "⏳ Рассылка началась..."
   2. Начнётся отправка сообщений
   3. Это может занять время (зависит от количества пользователей)
   4. После завершения вы увидите статистику:

   "✅ Рассылка завершена
    
    Всего пользователей: 100
    Успешно отправлено: 95
    Не удалось отправить: 5"

⚠️ ВАЖНО:
   • Не удалось отправить - это нормально
   • Причины: пользователь заблокировал бота, удалил аккаунт и т.д.
   • Рассылка может занять несколько минут для большого количества пользователей

════════════════════════════════════════════════════════════════════════════

7.5. СОВЕТЫ ПО РАССЫЛКЕ

✅ ХОРОШИЕ ПРАКТИКИ:
   • Пишите понятные и короткие сообщения
   • Используйте эмодзи для привлечения внимания
   • Указывайте важную информацию в начале
   • Проверяйте текст перед отправкой

❌ ПЛОХИЕ ПРАКТИКИ:
   • Слишком частые рассылки (раздражают)
   • Очень длинные сообщения (не читают)
   • Рассылка без важной причины
   • Отправка всем, когда нужна только одна группа

Примеры хороших рассылок:
   ✅ "📢 Внимание! Завтра контрольная работа по математике. Подготовьтесь!"
   ✅ "🎉 Новый тест доступен: 'История России'. Пройдите до пятницы!"
   ✅ "⚠️ Изменение расписания: занятия переносятся на 15:00"

═══════════════════════════════════════════════════════════════════════════════
8. ШАБЛОНЫ ТЕСТОВ
═══════════════════════════════════════════════════════════════════════════════

8.1. ЧТО ТАКОЕ ШАБЛОНЫ?

Шаблоны позволяют:
   ✅ Экспортировать тесты в файл
   ✅ Импортировать тесты из файла
   ✅ Делиться тестами с другими администраторами
   ✅ Создавать резервные копии тестов

════════════════════════════════════════════════════════════════════════════

8.2. ЭКСПОРТ ТЕСТА

ШАГ 1: В админ-панели нажмите "📄 Шаблоны"
ШАГ 2: Нажмите "📤 Экспорт"
ШАГ 3: Выберите тест из списка
ШАГ 4: Бот отправит вам JSON файл с тестом

Что содержит файл:
   • Название и описание теста
   • Все вопросы теста
   • Все варианты ответов
   • Правильные ответы
   • Типы вопросов
   • Пароль теста (если установлен)
   • Настройки попыток (если установлены)
   • Лимит времени (если установлен)
   • Группу (если указана)
   • Срок действия (если установлен)

⚠️ ВАЖНО: Файл НЕ содержит только результаты прохождений студентов

════════════════════════════════════════════════════════════════════════════

8.3. ИМПОРТ ТЕСТА

ШАГ 1: В админ-панели нажмите "📄 Шаблоны"
ШАГ 2: Нажмите "📥 Импорт"
ШАГ 3: Отправьте JSON файл с тестом
ШАГ 4: Бот создаст новый тест из файла

Что произойдёт:
   ✅ Создастся новый тест со всеми настройками из файла
   ✅ Все вопросы будут добавлены
   ✅ Тест будет деактивирован
   ✅ Все параметры (пароль, время, попытки и т.д.) будут восстановлены

⚠️ ВАЖНО:
   • Файл должен быть в правильном формате
   • Если файл повреждён - импорт не сработает
   • После импорта проверьте тест!

════════════════════════════════════════════════════════════════════════════

8.4. ФОРМАТ JSON ФАЙЛА

JSON файл теста имеет следующую структуру:

{
  "title": "Название теста",
  "description": "Описание теста",
  "questions": [
    {
      "text": "Текст вопроса",
      "type": "single",
      "options": [
        {
          "text": "Вариант ответа 1",
          "is_correct": true
        },
        {
          "text": "Вариант ответа 2",
          "is_correct": false
        }
      ]
    }
  ]
}

ОПИСАНИЕ ПОЛЕЙ:

title (обязательное)
   Название теста
   Тип: строка
   Максимум: 255 символов
   Пример: "Тест по математике"

description (обязательное)
   Описание теста
   Тип: строка
   Максимум: 2000 символов
   Пример: "Проверка знаний по алгебре"

questions (обязательное)
   Массив вопросов
   Тип: массив объектов
   Минимум: 1 вопрос

СТРУКТУРА ВОПРОСА:

text (обязательное)
   Текст вопроса
   Тип: строка
   Максимум: 2000 символов
   Пример: "Сколько будет 2+2?"

type (обязательное)
   Тип вопроса
   Тип: строка
   Возможные значения:
      "single" - один правильный ответ
      "multiple" - несколько правильных ответов
      "input" - ввод текста

options (обязательное для single и multiple)
   Массив вариантов ответа
   Тип: массив объектов
   Минимум: 2 варианта для single/multiple
   Для типа "input" должен быть ровно 1 вариант с правильным ответом

СТРУКТУРА ВАРИАНТА ОТВЕТА:

text (обязательное)
   Текст варианта ответа
   Тип: строка
   Максимум: 255 символов
   Пример: "Москва"

is_correct (обязательное)
   Является ли вариант правильным
   Тип: boolean (true/false)
   Для "single": только один вариант должен быть true
   Для "multiple": один или несколько вариантов могут быть true
   Для "input": единственный вариант должен быть true

════════════════════════════════════════════════════════════════════════════

8.5. ПРИМЕРЫ JSON ФАЙЛОВ

ПРИМЕР 1: Тест с одним правильным ответом

{
  "title": "Столицы мира",
  "description": "Проверка знаний столиц",
  "questions": [
    {
      "text": "Столица России?",
      "type": "single",
      "options": [
        {"text": "Москва", "is_correct": true},
        {"text": "Санкт-Петербург", "is_correct": false},
        {"text": "Казань", "is_correct": false}
      ]
    }
  ]
}

ПРИМЕР 2: Тест с несколькими правильными ответами

{
  "title": "Математика",
  "description": "Чётные числа",
  "questions": [
    {
      "text": "Выберите чётные числа",
      "type": "multiple",
      "options": [
        {"text": "2", "is_correct": true},
        {"text": "3", "is_correct": false},
        {"text": "4", "is_correct": true},
        {"text": "5", "is_correct": false}
      ]
    }
  ]
}

ПРИМЕР 3: Тест с вводом текста

{
  "title": "География",
  "description": "Знание столиц",
  "questions": [
    {
      "text": "Напишите столицу Франции",
      "type": "input",
      "options": [
        {"text": "Париж", "is_correct": true}
      ]
    }
  ]
}

ПРИМЕР 4: Полный тест с разными типами вопросов

{
  "title": "Комплексный тест",
  "description": "Разные типы вопросов",
  "questions": [
    {
      "text": "Столица России?",
      "type": "single",
      "options": [
        {"text": "Москва", "is_correct": true},
        {"text": "Киев", "is_correct": false}
      ]
    },
    {
      "text": "Выберите простые числа",
      "type": "multiple",
      "options": [
        {"text": "2", "is_correct": true},
        {"text": "3", "is_correct": true},
        {"text": "4", "is_correct": false}
      ]
    },
    {
      "text": "Сколько будет 5+5?",
      "type": "input",
      "options": [
        {"text": "10", "is_correct": true}
      ]
    }
  ]
}

════════════════════════════════════════════════════════════════════════════

8.6. ИСПОЛЬЗОВАНИЕ ШАБЛОНОВ

Сценарии использования:

СЦЕНАРИЙ 1: Резервное копирование
   1. Экспортируйте все важные тесты
   2. Сохраните файлы на компьютере
   3. При необходимости импортируйте обратно

СЦЕНАРИЙ 2: Обмен тестами
   1. Экспортируйте тест
   2. Отправьте файл коллеге
   3. Коллега импортирует в своего бота

СЦЕНАРИЙ 3: Создание вариантов
   1. Экспортируйте тест
   2. Измените файл (другие вопросы)
   3. Импортируйте как новый вариант

СЦЕНАРИЙ 4: Редактирование теста
   1. Экспортируйте тест
   2. Откройте JSON в текстовом редакторе
   3. Измените вопросы или ответы
   4. Сохраните файл
   5. Импортируйте обратно

═══════════════════════════════════════════════════════════════════════════════
9. ЧАСТЫЕ ВОПРОСЫ И РЕШЕНИЕ ПРОБЛЕМ
═══════════════════════════════════════════════════════════════════════════════

9.1. ВОПРОСЫ ПО ТЕСТАМ

❓ Студенты не видят мой тест. Почему?

Возможные причины:
   1. Тест деактивирован (🔴)
      Решение: Откройте тест → нажмите "🟢 Активировать"
   
   2. Тест для другой группы
      Решение: Откройте тест → "✏️ Изменить" → "👥 Группа" → "🗑 Для всех групп"
   
   3. Истёк срок действия теста
      Решение: Откройте тест → "✏️ Изменить" → "📅 Срок действия" → "🗑 Удалить срок"
   
   4. Студент исчерпал попытки
      Решение: Откройте тест → "✏️ Изменить" → "🔄 Попытки" → увеличьте или уберите

════════════════════════════════════════════════════════════════════════════

❓ Как изменить вопросы в уже созданном тесте?

К сожалению, изменить вопросы напрямую нельзя.

Решение:
   1. Экспортируйте тест ("📄 Шаблоны" → "📤 Экспорт")
   2. Удалите старый тест
   3. Отредактируйте JSON файл
   4. Импортируйте обратно
   
   ИЛИ
   
   1. Создайте новый тест с нуля
   2. Деактивируйте старый тест
   3. Активируйте новый тест

════════════════════════════════════════════════════════════════════════════

❓ Студент не может начать тест. Пишет "Неверный пароль"

Причина: Студент вводит неправильный пароль

Решение:
   1. Откройте тест
   2. Посмотрите пароль в информации о тесте
   3. Сообщите правильный пароль студенту
   
   ИЛИ
   
   1. Откройте тест → "✏️ Изменить" → "🔑 Пароль"
   2. Нажмите "🗑 Удалить пароль"
   3. Теперь тест доступен без пароля

════════════════════════════════════════════════════════════════════════════

❓ Как посмотреть ответы конкретного студента?

ШАГ 1: Откройте тест
ШАГ 2: Нажмите "📊 Статистика"
ШАГ 3: Найдите студента в списке
ШАГ 4: Нажмите на его попытку
ШАГ 5: Вы увидите все его ответы

ИЛИ

ШАГ 1: "👤 Пользователи"
ШАГ 2: Найдите студента
ШАГ 3: Нажмите "📊 Статистика"
ШАГ 4: Выберите нужный тест

════════════════════════════════════════════════════════════════════════════

❓ Студент говорит, что не видит результаты теста

Причина: Результаты скрыты

Решение:
   1. Откройте тест
   2. Нажмите "👁 Показать результаты"
   3. Теперь студенты видят свои баллы и ответы

════════════════════════════════════════════════════════════════════════════

❓ Как удалить тест?

ШАГ 1: Откройте тест
ШАГ 2: Нажмите "✏️ Изменить"
ШАГ 3: Нажмите "🗑 Удалить тест"
ШАГ 4: Подтвердите удаление

⚠️ ВАЖНО: Удаление необратимо! Все результаты будут потеряны!

════════════════════════════════════════════════════════════════════════════

9.2. ВОПРОСЫ ПО ГРУППАМ

❓ Как добавить студента в группу?

К сожалению, администратор не может добавить студента в группу напрямую.

Решение:
   • Студент должен сам указать свою группу при регистрации
   • Или студент может изменить группу через свой профиль в боте

════════════════════════════════════════════════════════════════════════════

❓ Что будет, если удалить группу?

При удалении группы:
   ✅ Студенты останутся в боте
   ✅ Студенты просто будут без группы
   ✅ Тесты для этой группы станут доступны всем
   ❌ Данные студентов НЕ удаляются

════════════════════════════════════════════════════════════════════════════

❓ Можно ли переименовать группу?

Нет, переименовать группу нельзя.

Решение:
   1. Создайте новую группу с нужным номером
   2. Попросите студентов изменить группу в профиле
   3. Удалите старую группу

════════════════════════════════════════════════════════════════════════════

9.3. ВОПРОСЫ ПО ПОЛЬЗОВАТЕЛЯМ

❓ Как удалить пользователя из бота?

Удалить пользователя из бота нельзя.

Причина: Пользователь сам управляет своим аккаунтом в Telegram.

Что можно сделать:
   • Заблокировать пользователя в Telegram (он не сможет писать боту)
   • Не создавать для него тесты
   • Не добавлять в группы

════════════════════════════════════════════════════════════════════════════

❓ Пользователь не получает сообщения от бота

Возможные причины:
   1. Пользователь заблокировал бота
      Решение: Попросите разблокировать
   
   2. Пользователь удалил переписку
      Решение: Попросите написать боту /start
   
   3. Проблемы с Telegram
      Решение: Подождите или попросите переустановить Telegram

════════════════════════════════════════════════════════════════════════════

9.4. ВОПРОСЫ ПО РАССЫЛКЕ

❓ Рассылка не доходит до всех. Это нормально?

Да, это нормально!

Причины:
   • Пользователь заблокировал бота
   • Пользователь удалил аккаунт
   • Временные проблемы с Telegram

Обычно доходит 90-95% сообщений.

════════════════════════════════════════════════════════════════════════════

❓ Можно ли отменить рассылку?

Нет, после нажатия "✅ Да" рассылка начинается немедленно.

Совет: Всегда проверяйте сообщение перед отправкой!

════════════════════════════════════════════════════════════════════════════

❓ Как сделать рассылку только одной группе?

ШАГ 1: "📢 Рассылка"
ШАГ 2: Отметьте галочкой ТОЛЬКО нужную группу
ШАГ 3: Нажмите "📤 Отправить выбранным"
ШАГ 4: Отправьте сообщение

════════════════════════════════════════════════════════════════════════════

9.5. ТЕХНИЧЕСКИЕ ПРОБЛЕМЫ

❓ Бот не отвечает на команды

Решение:
   1. Подождите 1-2 минуты
   2. Отправьте /start
   3. Если не помогло - обратитесь к администратору сервера

════════════════════════════════════════════════════════════════════════════

❓ Кнопки не работают / не нажимаются

Решение:
   1. Перезапустите Telegram
   2. Отправьте /start
   3. Обновите Telegram до последней версии

════════════════════════════════════════════════════════════════════════════

❓ Бот отправляет сообщения с задержкой

Причины:
   • Много пользователей одновременно
   • Рассылка в процессе
   • Проблемы с сервером

Решение: Подождите несколько минут

════════════════════════════════════════════════════════════════════════════

❓ Потерялись данные / результаты тестов

Если это произошло:
   1. Немедленно сообщите администратору сервера
   2. Не удаляйте и не изменяйте ничего
   3. Возможно, есть резервная копия

Профилактика:
   • Регулярно экспортируйте тесты
   • Сохраняйте важные результаты (скриншоты, Excel файлы)

═══════════════════════════════════════════════════════════════════════════════
10. СОВЕТЫ И ЛУЧШИЕ ПРАКТИКИ
═══════════════════════════════════════════════════════════════════════════════

10.1. СОЗДАНИЕ КАЧЕСТВЕННЫХ ТЕСТОВ

✅ Хорошие вопросы:
   • Чёткие и понятные
   • Без двусмысленности
   • Проверяют конкретные знания
   • Имеют однозначный правильный ответ

❌ Плохие вопросы:
   • Слишком сложные или запутанные
   • С несколькими правильными интерпретациями
   • Слишком лёгкие (угадываются)
   • С ошибками в тексте

════════════════════════════════════════════════════════════════════════════

10.2. НАСТРОЙКА ПАРАМЕТРОВ ТЕСТА

Рекомендации:

ПАРОЛЬ:
   • Используйте для контрольных работ
   • Сообщайте пароль непосредственно перед началом
   • Используйте простые пароли (легко запомнить)

ПОПЫТКИ:
   • Контрольные: 1 попытка
   • Тренировочные: 3-5 попыток или без ограничений
   • Экзамены: 1-2 попытки

ВРЕМЯ:
   • 1-2 минуты на простой вопрос
   • 3-5 минут на сложный вопрос
   • Добавьте 20% запаса времени

СРОК:
   • Устанавливайте для домашних заданий
   • Не устанавливайте для справочных материалов

════════════════════════════════════════════════════════════════════════════

10.3. ОРГАНИЗАЦИЯ РАБОТЫ

✅ Регулярно:
   • Проверяйте статистику тестов
   • Отвечайте на вопросы студентов
   • Обновляйте тесты при необходимости
   • Делайте резервные копии (экспорт)

✅ Перед контрольной:
   • Проверьте все вопросы
   • Убедитесь, что тест активирован
   • Проверьте настройки (время, попытки)
   • Подготовьте пароль

✅ После контрольной:
   • Проверьте результаты
   • Экспортируйте статистику
   • Деактивируйте тест (если нужно)

════════════════════════════════════════════════════════════════════════════

10.4. БЕЗОПАСНОСТЬ

⚠️ Важные правила:

1. НЕ делитесь паролями от тестов публично
2. Регулярно проверяйте список администраторов
3. Сохраняйте резервные копии важных тестов
4. Не удаляйте тесты с важными результатами без экспорта
5. Проверяйте тесты перед активацией

═══════════════════════════════════════════════════════════════════════════════
11. БЫСТРАЯ СПРАВКА - ОСНОВНЫЕ КОМАНДЫ
═══════════════════════════════════════════════════════════════════════════════

/start - Запуск бота / возврат в главное меню
/admin - Открыть админ-панель (только для администраторов)

═══════════════════════════════════════════════════════════════════════════════
12. КОНТАКТЫ И ПОДДЕРЖКА
═══════════════════════════════════════════════════════════════════════════════

Если у вас возникли проблемы:
   1. Перечитайте соответствующий раздел этого руководства
   2. Попробуйте решения из раздела "Частые вопросы"
   3. Обратитесь к создателю бота: @kolo_id
   4. Опишите проблему максимально подробно

При обращении укажите:
   • Что вы пытались сделать
   • Что произошло вместо ожидаемого
   • Скриншоты (если возможно)
   • Время возникновения проблемы

Создатель бота: @kolo_id

═══════════════════════════════════════════════════════════════════════════════

                            КОНЕЦ РУКОВОДСТВА

        Спасибо за использование бота! Желаем успехов в работе! 🎉

═══════════════════════════════════════════════════════════════════════════════
