From 32683100670a7ad6e5b72231f7b21fecdcf8a7b2 Mon Sep 17 00:00:00 2001 From: kolo Date: Tue, 20 Jan 2026 09:14:56 +0300 Subject: [PATCH] update --- ADMIN_GUIDE.txt | 1234 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1234 insertions(+) diff --git a/ADMIN_GUIDE.txt b/ADMIN_GUIDE.txt index e69de29..dce0dfa 100644 --- a/ADMIN_GUIDE.txt +++ b/ADMIN_GUIDE.txt @@ -0,0 +1,1234 @@ +═══════════════════════════════════════════════════════════════════════════════ + ПОЛНОЕ РУКОВОДСТВО ПО АДМИН-ПАНЕЛИ БОТА + Пошаговая инструкция для начинающих +═══════════════════════════════════════════════════════════════════════════════ + +📋 СОДЕРЖАНИЕ: +1. Первый запуск и вход в админку +2. Главное меню админки +3. Управление тестами +4. Создание теста (подробно) +5. Управление группами +6. Управление пользователями +7. Рассылка сообщений +8. Шаблоны тестов +9. Частые вопросы и решение проблем + +═══════════════════════════════════════════════════════════════════════════════ +1. ПЕРВЫЙ ЗАПУСК И ВХОД В АДМИНКУ +═══════════════════════════════════════════════════════════════════════════════ + +ШАГ 1: Запуск бота + • Откройте Telegram + • Найдите вашего бота по имени или ссылке + • Нажмите кнопку "Запустить" (Start) внизу экрана + • Или отправьте команду /start + +ШАГ 2: Проверка прав администратора + • Если вы администратор, то при нажатии на кнопку доступных вам команд (Слева внизу) вы увидите команду /admin + • Если вы НЕ видите команду /admin - обратитесь к создателю бота + +═══════════════════════════════════════════════════════════════════════════════ +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. ИСПОЛЬЗОВАНИЕ ШАБЛОНОВ + +Сценарии использования: + +СЦЕНАРИЙ 1: Резервное копирование + 1. Экспортируйте все важные тесты + 2. Сохраните файлы на компьютере + 3. При необходимости импортируйте обратно + +СЦЕНАРИЙ 2: Обмен тестами + 1. Экспортируйте тест + 2. Отправьте файл коллеге + 3. Коллега импортирует в своего бота + +СЦЕНАРИЙ 3: Создание вариантов + 1. Экспортируйте тест + 2. Измените файл (другие вопросы) + 3. Импортируйте как новый вариант + +═══════════════════════════════════════════════════════════════════════════════ +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. БЕЗОПАСНОСТЬ + +⚠️ Важные правила: + +2. НЕ делитесь паролями от тестов публично +3. Регулярно проверяйте список администраторов +4. Сохраняйте резервные копии важных тестов +5. Не удаляйте тесты с важными результатами без экспорта + +═══════════════════════════════════════════════════════════════════════════════ +11. БЫСТРАЯ СПРАВКА - ОСНОВНЫЕ КОМАНДЫ +═══════════════════════════════════════════════════════════════════════════════ + +/start - Запуск бота / возврат в главное меню +/admin - Вход в панель администрирования + +═══════════════════════════════════════════════════════════════════════════════ +12. КОНТАКТЫ И ПОДДЕРЖКА +═══════════════════════════════════════════════════════════════════════════════ + +Если у вас возникли проблемы: + 1. Перечитайте соответствующий раздел этого руководства + 2. Попробуйте решения из раздела "Частые вопросы" + 3. Обратитесь к администратору сервера + 4. Опишите проблему максимально подробно + +При обращении укажите: + • Что вы пытались сделать + • Что произошло вместо ожидаемого + • Скриншоты (если возможно) + • Время возникновения проблемы + +═══════════════════════════════════════════════════════════════════════════════ + + КОНЕЦ РУКОВОДСТВА + + Спасибо за использование бота! Желаем успехов в работе! 🎉 + +═══════════════════════════════════════════════════════════════════════════════