📚 Обучающий материал

Полное руководство по использованию системы интерактивного тестирования

🏠 На главную

📑 Содержание

Часть 1: Введение и преимущества программы

1.1. Достоинства и преимущества системы

Для учителей:

⏱️ Экономия времени

Автоматическая проверка тестов освобождает часы времени, которые можно потратить на подготовку уроков и индивидуальную работу с учениками

🎨 Простота создания

Визуальный редактор позволяет создавать тесты из PDF документов за считанные минуты без специальных знаний программирования

📊 Детальная аналитика

Получайте статистику по каждому тесту, видите типичные ошибки и можете корректировать программу обучения на основе данных

💾 Автоматическое сохранение

Все результаты автоматически сохраняются в Google Sheets, доступны в любое время для анализа и экспорта

🤖 Интеллектуальная проверка

AI понимает смысл ответов, а не только точное совпадение. Система прощает опечатки и понимает синонимы. Поддержка встроенной модели без необходимости API ключа

⚙️ Индивидуальные настройки

Каждый учитель настраивает AI проверку под себя, включая или выключая её по необходимости. Выбор между встроенной моделью и внешними API

⚡ Высокая производительность

Параллельная обработка ответов позволяет проверять тесты нескольких студентов одновременно, значительно ускоряя процесс

Для учеников:

⚡ Мгновенная обратная связь

Результаты сразу после завершения теста, без ожидания проверки учителем

💡 Понятные объяснения

AI объясняет, почему ответ правильный или неправильный, помогая лучше понять материал

📱 Удобный интерфейс

Работает на всех устройствах: компьютерах, планшетах и смартфонах с современным дизайном

🎯 Многоуровневая проверка

Система прощает опечатки и понимает синонимы, оценивая знания, а не орфографию

Для школ:

🏫 Централизованное управление

Все тесты в одной системе, удобное управление доступом и результатами

📈 Масштабируемость

Работает с любым количеством учителей и учеников без снижения производительности

🔗 Интеграция с Google Sheets

Автоматический экспорт результатов в привычный формат для дальнейшего анализа

🔐 Безопасность

Защита данных и контроль доступа, соответствие требованиям безопасности

1.2. Современные технологии

Система построена на передовых технологиях, обеспечивающих надежность и производительность:

1.3. Решаемые проблемы

Система решает ключевые проблемы современного образования:

Часть 2: Начало работы

2.1. Регистрация и вход

Для работы с системой вам необходим аккаунт, созданный администратором.

1 Получение доступа
Обратитесь к администратору системы для создания аккаунта. Вам будет предоставлен логин и пароль.
2 Вход в систему
Перейдите на главную страницу и нажмите кнопку "Я — Учитель". Введите логин и пароль в форму входа.
3 Восстановление пароля
Если вы забыли пароль, вы можете восстановить его самостоятельно через email:
  • На странице входа нажмите на ссылку "Забыли пароль?"
  • Введите ваш логин или email
  • Проверьте почту и перейдите по ссылке из письма
  • Введите новый пароль (ссылка действительна 1 час)

Примечание: Для восстановления пароля через email необходимо, чтобы в вашей учетной записи был указан корректный email адрес. Если email не указан, обратитесь к администратору.

4 Настройка профиля
После входа вы можете просмотреть и при необходимости обновить данные профиля в разделе "Профиль".

2.2. Первое знакомство с интерфейсом

После входа вы попадете в редактор тестов. Основные разделы системы:

💡 Совет

Изучите интерфейс редактора перед созданием первого теста. Все основные функции доступны через интуитивно понятные кнопки и меню.

Часть 3: Создание тестов

3.1. Подготовка материалов

Перед созданием теста подготовьте необходимые материалы:

Форматы файлов

Требования к качеству изображений

Подготовка правильных ответов

Заранее подготовьте список правильных ответов для каждого вопроса. Учтите:

3.2. Создание теста шаг за шагом

Шаг 1: Загрузка документа

1 В левой панели редактора нажмите кнопку "Выбрать файл"
2 Выберите PDF файл или изображение (PNG, JPG) с вашего компьютера
3 Документ автоматически загрузится и отобразится в правой части экрана

Шаг 2: Создание полей для ответов

1 Нажмите кнопку "Добавить поле" в левой панели
2 Перетащите поле на нужное место в документе (drag & drop)
3 Измените размер поля, потянув за углы или края
4 Повторите для всех вопросов в тесте

Шаг 3: Настройка поля

1 Кликните на поле для его редактирования
2 Введите правильные варианты ответов (можно несколько, каждое с новой строки)
3 Выберите тип проверки (точное совпадение, с учетом регистра и т.д.)
4 При необходимости добавьте подсказку для ученика

3.3. Настройка теста

1 Выберите класс, для которого предназначен тест (можно выбрать несколько классов)
2 Выберите предмет из списка или создайте новый
3 Введите название темы теста (например, "Дроби", "Вторая мировая война")
4 Вставьте ссылку на Google Таблицу для сохранения результатов (см. раздел 4)

3.4. Получение ссылки на тест

1 Нажмите кнопку "Сохранить шаблон"
2 После сохранения появится блок "Ссылка на тест" с уникальной ссылкой
3 Ссылка имеет формат: https://docquiz.predmet.kz/student/{city_code}/{school_code}
4 Скопируйте ссылку и поделитесь ею с учениками через мессенджер, email или разместите на сайте

💡 Важно

По одной ссылке доступны все тесты вашей школы. Ученики смогут выбрать нужный тест, используя фильтры: класс → предмет → тема → тест.

Часть 4: Настройка Google Sheets

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

Следуйте инструкции ниже точно, шаг за шагом.

4.1. Создание таблицы

1 Откройте Google Sheets в браузере
2 Создайте новую таблицу или используйте существующую
3 Назовите таблицу, например: "Результаты тестов" или "Результаты тестирования"

4.2. Предоставление доступа

🔑 КРИТИЧЕСКИ ВАЖНО: Предоставьте доступ сервисному аккаунту!

1 В Google Таблице нажмите кнопку "Настройки доступа" (справа вверху, кнопка "Поделиться")
2 В поле "Добавить пользователей или группы" введите следующий email:
3 Выберите уровень доступа: "Редактор" (полный доступ для записи данных)
4 Нажмите "Готово" или "Отправить"

✅ Проверка доступа

После предоставления доступа сервисный аккаунт сможет автоматически создавать вкладку "Результаты" и сохранять туда данные о прохождении тестов. Проверьте, что доступ предоставлен корректно.

4.3. Использование результатов

Все результаты сохраняются в одну таблицу "Результаты" со следующей структурой:

Фильтрация результатов

1 В Google Таблице выделите первую строку с заголовками
2 Нажмите "Данные" → "Создать фильтр"
3 Используйте стрелки в заголовках для фильтрации по теме, предмету, классу, дате или ФИО ученика

Экспорт данных

Для экспорта результатов:

4.4. Новая функция: Настройка таблиц для классов

💡 Удобная настройка таблиц

Теперь вы можете настроить Google Sheets таблицы для каждого класса один раз, и они будут автоматически использоваться при создании тестов.

1 Перейдите в раздел "⚙️ Настройки Google Sheets" (доступен в навигации редактора)
2 Нажмите кнопку "+ Добавить таблицу"
3 Выберите класс из списка или введите его вручную (например, "10А", "11Б")
4 Вставьте ссылку на Google Таблицу для этого класса
5 Нажмите "Проверить доступ" - система автоматически проверит, предоставлен ли доступ сервисному аккаунту
6 Если доступа нет, вы увидите email сервисного аккаунта и инструкцию по предоставлению доступа
7 После успешной проверки нажмите "Сохранить"

✅ Преимущества

  • Один раз настроили таблицу для класса - используете во всех тестах
  • Автоматическая проверка доступа при сохранении
  • При создании теста можно выбрать таблицу из списка вместо ввода ссылки вручную
  • Все старые тесты продолжают работать как раньше

Часть 5: Настройки AI проверки

5.1. Включение AI проверки

1 Перейдите в раздел "Настройки AI" (кнопка в навигации редактора)
2 Переключите "Включить AI проверку" в положение "Включено"
3 Нажмите "Сохранить настройки"

💡 Важно

Настройка AI проверки индивидуальна для каждого учителя. По умолчанию AI проверка выключена. Вы можете включить её только для своих тестов. Когда AI проверка выключена, все связанные элементы на странице настроек скрываются.

5.2. Выбор модели AI

Система поддерживает два типа AI моделей:

🚀 Встроенная модель (Ollama)

💡 Как получить доступ к встроенной модели

Обратитесь к администратору системы, чтобы он предоставил вам доступ к встроенной модели Ollama в вашем профиле.

🌐 Внешние модели (Gemini, Groq и др.)

5.3. Параметры проверки

При включенной AI проверке доступны следующие параметры:

⚡ Производительность

Система использует параллельную обработку для проверки ответов нескольких студентов одновременно. Это значительно ускоряет проверку при высокой нагрузке.

5.4. Когда используется AI

Система использует многоуровневую проверку ответов:

  1. Точное совпадение - проверка на полное совпадение с правильным ответом
  2. Fuzzy matching - проверка с учетом опечаток и небольших различий
  3. Семантический анализ - проверка смысла ответа через локальные модели
  4. AI проверка - используется только если предыдущие методы не дали результата и AI проверка включена

💡 Пример работы AI

Если правильный ответ: "город Астана", а ученик написал "Астана" или "столица Казахстана", AI поймет, что ответ правильный, даже если формулировка отличается.

Часть 6: Работа с результатами

6.1. Просмотр результатов

Все результаты сохраняются в Google Таблицу, которую вы указали при создании теста, во вкладку "Результаты".

Где найти результаты

1 Откройте Google Таблицу, ссылку на которую вы указали при создании теста
2 Перейдите на вкладку "Результаты" (создается автоматически)
3 Просмотрите все результаты прохождения тестов

6.2. Аналитика

Используйте встроенные функции Google Sheets для анализа результатов:

Статистика по тестам

Типичные ошибки

Графики и диаграммы

Создайте визуализации в Google Sheets:

6.3. Экспорт данных

Для экспорта результатов из Google Sheets:

Часть 7: Продвинутые возможности

7.1. Управление тестами

Редактирование существующих тестов

1 В редакторе загрузите существующий тест из списка
2 Внесите необходимые изменения (поля, правильные ответы, настройки)
3 Сохраните тест - изменения применятся автоматически

Удаление тестов

Для удаления теста обратитесь к администратору системы.

7.2. Профиль пользователя

В разделе "Профиль" доступна следующая информация:

7.3. Статистика

В разделе "Статистика" доступна общая информация:

Часть 8: Практические примеры

8.1. Пример 1: Создание теста по математике

1 Подготовка: Сканируйте или создайте PDF с задачами по математике
2 Загрузка: Загрузите PDF в редактор
3 Создание полей: Добавьте поля для числовых ответов (результаты вычислений)
4 Настройка: Укажите правильные числовые ответы. Учтите разные форматы: "5", "5.0", "5,0"
5 Проверка: Для математики можно использовать точное совпадение или AI для проверки формул

8.2. Пример 2: Создание теста по истории

1 Подготовка: Подготовьте изображения с вопросами по истории
2 Загрузка: Загрузите изображения в редактор
3 Создание полей: Добавьте поля для текстовых ответов (даты, названия, имена)
4 Настройка: Укажите правильные ответы. Включите AI проверку для понимания синонимов
5 Проверка: AI поможет проверить развернутые ответы, понимая смысл, а не только точное совпадение

8.3. Пример 3: Создание теста по языку

1 Подготовка: Подготовьте PDF с упражнениями по языку
2 Загрузка: Загрузите PDF в редактор
3 Создание полей: Добавьте поля для текстовых ответов
4 Множественные варианты: Укажите все возможные правильные варианты (синонимы, альтернативные формулировки)
5 Проверка: Используйте AI проверку для понимания синонимов и альтернативных формулировок

Часть 9: Решение проблем

9.1. Частые проблемы

Результаты не сохраняются в Google Sheets

Решение:

  1. Убедитесь, что вы предоставили доступ сервисному аккаунту pdf-test-app@pdftest-473116.iam.gserviceaccount.com
  2. Проверьте, что уровень доступа установлен как "Редактор"
  3. Убедитесь, что ссылка на таблицу вставлена правильно в настройках теста
  4. Проверьте, что таблица существует и доступна
  5. Попробуйте создать новую таблицу и предоставить доступ заново

AI проверка не работает

Решение:

  1. Проверьте, что AI проверка включена в ваших настройках (по умолчанию выключена)
  2. Убедитесь, что указан API ключ Gemini в настройках AI
  3. Проверьте, что API ключ действителен и не истек
  4. Помните, что AI используется только если обычная проверка не дала результата

Проблемы с доступом

Решение:

  1. Проверьте правильность логина и пароля
  2. Убедитесь, что ваш аккаунт активен (обратитесь к администратору)
  3. Попробуйте очистить кэш браузера и cookies

Ошибки при создании теста

Решение:

  1. Проверьте формат загружаемого файла (PDF, PNG, JPG)
  2. Убедитесь, что размер файла не превышает 10 МБ
  3. Проверьте, что все обязательные поля заполнены (класс, предмет, тема)
  4. Убедитесь, что указана корректная ссылка на Google Таблицу

9.2. Обращение в поддержку

Если проблема не решена, обратитесь в поддержку:

1 Перейдите на страницу "Поддержка" или "Контакты"
2 Заполните форму обратной связи, указав:
  • Категорию проблемы (техническая, функциональная, другое)
  • Подробное описание проблемы
  • Шаги для воспроизведения проблемы
  • Скриншоты (если применимо)
3 Отправьте обращение и ожидайте ответа от службы поддержки

Часть 10: Лучшие практики

10.1. Создание эффективных тестов

Как формулировать вопросы

Как указывать правильные ответы

Использование AI проверки

10.2. Организация работы

Структурирование тестов по темам

Использование Google Sheets для аналитики

Регулярный анализ результатов

✅ Чек-лист для создания качественного теста

Поздравляем! Вы завершили изучение обучающего материала.

Теперь вы готовы эффективно использовать систему интерактивного тестирования.

Система интерактивного тестирования © 2026

🏠 На главную