Gradely. Руководство пользователя

1. Глоссарий
2. Обзор
3. Основные функции
4. Размещение
5. Технические требования
6. Руководство преподавателя

• Начало работы
• Управление проверками
• Загрузка задания
• Акцентные зоны
• Загрузка решений студентов
• Управление студентами
• Просмотр результатов
• Обратная связь

7. Руководство администратора

• Управление пользователями
• Управление промптами
• Просмотр проверок
• Статистика системы
• Управление обратной связью
• Настройки системы

1 Глоссарий

Проверка (Check) — контейнер для одного задания и множества решений студентов. Основная единица работы в системе.

Работа (Work) — решение одного студента в рамках проверки.

Задание (Task) — условие задачи или контрольной работы, которое загружается преподавателем в виде одного или нескольких изображений.

Решение (Solution) — ответ студента на задание, загружается в виде одного или нескольких изображений.

Акцентная зона — выделенная область на изображении задания, на которую AI должен обратить особое внимание при проверке.

Промпт (Prompt) — системная инструкция для AI модели, определяющая критерии и стиль проверки работ.

AI-проверка — автоматический анализ решения студента с использованием искусственного интеллекта.

Студент — профиль учащегося, для которого создаются и проверяются работы.

PWA (Progressive Web Application) — веб-приложение, которое можно установить на устройство и использовать с функциями нативного приложения.

Обратная связь (Feedback) — оценка преподавателем качества AI-проверки (лайк/дизлайк с комментарием).

2 Обзор

Gradely — это интеллектуальная система автоматизированной проверки учебных работ с использованием искусственного интеллекта.

Система состоит из следующих компонентов:

Progressive Web Application (PWA) с адаптивным интерфейсом, доступная через веб-браузер на любых устройствах (десктоп, планшеты, смартфоны) с возможностью установки на домашний экран и частичной работы в offline-режиме.

Веб-портал для преподавателей, где доступна загрузка работ, создание проверок, управление студентами, просмотр результатов анализа и статистика.

Административная панель, предоставляющая доступ к управлению пользователями, настройкам системы, промптам для AI-проверки, статистике и аналитике.

3 Основные функции

3.1 Автоматизированная проверка работ

Система анализирует отсканированные или сфотографированные изображения заданий и решений учеников, проводит AI-анализ и предоставляет подробную обратную связь с выявлением ошибок, оценкой правильности решения и рекомендациями.

3.2 Гибкая работа с изображениями

Поддержка множества форматов (JPEG, PNG, WebP, GIF, HEIC/HEIF, PDF), автоматическая оптимизация, возможность фотографирования напрямую с камеры устройства.

3.3 Управление студентами

Создание профилей студентов, просмотр истории их работ, отслеживание прогресса.

3.4 Система обратной связи

Преподаватели могут оценивать качество AI-проверки, что помогает улучшать систему.

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

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

4 Размещение

Gradely развернут на сервере и доступен через веб-браузер по адресу: gradely.ru

Система работает в облачном режиме: 

• Все данные хранятся на защищенных серверах
• Доступ осуществляется через HTTPS для обеспечения безопасности 
• Резервное копирование данных выполняется автоматически

5 Технические требования

5.1 Для работы с веб-приложением

Компьютер (десктоп):

• Процессор: двухъядерный 2.0 ГГц или выше
• RAM: 4 ГБ и выше
• ОС: Windows 10/11, macOS 12 Monterey и выше, любой дистрибутив Linux
• Браузер: Google Chrome (рекомендуется), Mozilla Firefox, Microsoft Edge, Safari (последние версии)
• Экран: минимум 1366×768 px, рекомендуется FullHD (1920×1080 px)
• Стабильное интернет-соединение (минимум 2 Мбит/с)

Планшет:

• ОС: iOS 14 и выше / Android 10 и выше
• RAM: 3 ГБ и выше
• Браузер: Safari (iOS) / Chrome (Android)
• Стабильное интернет-соединение (минимум 2 Мбит/с)

Смартфон:

• ОС: iOS 14 и выше / Android 10 и выше
• RAM: 2 ГБ и выше
• Браузер: Safari (iOS) / Chrome (Android)
• Стабильное интернет-соединение (минимум 2 Мбит/с)

5.2 Дополнительные требования

• Поддержка JavaScript (должен быть включен)
• Поддержка cookies и localStorage
• Для фотографирования работ: устройство с камерой
• Для работы с PDF: поддержка современных веб-стандартов
• Для отображения математических формул: поддержка WebGL

6 Руководство преподавателя

Преподаватель использует веб-приложение для создания проверок, загрузки заданий и решений студентов, просмотра результатов AI-анализа и управления профилями студентов.

6.1 Начало работы

6.1.1 Регистрация в системе

• Перейдите на сайт gradely.ru
• Нажмите кнопку “Зарегистрироваться”
• Укажите следующие данные:
• Email (будет использоваться для входа)
• Имя и фамилия
• Пароль (минимум 8 символов)
• Нажмите “Продолжить”

6.1.2 Вход в систему

• Перейдите на сайт gradely.ru
• Введите email и пароль
• Нажмите кнопку “Продолжить”

6.1.3 Восстановление пароля

Если вы забыли пароль:

• На странице входа нажмите “Забыли пароль?”
• Введите ваш email
• На email придет письмо с одноразовым кодом подтверждения
• Введите код подтверждения
• Задайте новый пароль
• Нажмите “Сохранить”

6.1.4 Установка PWA приложения

Для удобной работы вы можете установить Gradely как приложение на свое устройство:

На компьютере (Chrome/Edge):

• Откройте gradely.ru в браузере
• В адресной строке справа появится значок установки ⊕
• Нажмите на него и выберите “Установить”

На iPhone/iPad:

• Откройте gradely.ru в Safari
• Нажмите кнопку “Поделиться” (квадрат со стрелкой вверх)
• Выберите “На экран «Домой»”
• Нажмите “Добавить”

На Android:

• Откройте gradely.ru в Chrome
• Нажмите меню (три точки) в правом верхнем углу
• Выберите “Установить приложение” или “Добавить на главный экран”

6.2 Управление проверками

Проверка (Check) — это центральная единица работы в системе. Она включает в себя условие задания и все решения студентов по этому заданию.

6.2.1 Главная страница

После входа в систему вы попадаете на главную страницу с списком ваших проверок.

Интерфейс:

• На десктопе: двухпанельный интерфейс (список проверок слева + детали справа)
• На мобильном: последовательная навигация между экранами
  
  

6.2.2 Создание новой проверки

• На главной странице нажмите кнопку “Новая проверка”
• Автоматически создастся новая проверка с названием “Новая проверка”
• Вы будете перенаправлены на страницу детальной информации о проверке

6.2.3 Редактирование названия проверки

• Откройте нужную проверку из списка
• Нажмите на название проверки или на значок редактирования ✎
• Введите новое название (например, “Сумма слагаемых”)
• Нажмите “галочку” или клавишу Enter, для отмены нажмите “крестик”

6.2.4 Просмотр списка проверок

В списке проверок отображается: - Название проверки - Дата создания - Количество проверенных работ - Статус (активная/завершенная)

Список автоматически подгружает проверки по 20 элементов при прокрутке (бесконечная пагинация).

6.3 Загрузка задания

После создания проверки необходимо загрузить изображения условия задания.

6.3.1 Способы загрузки изображений

При первом взаимодействии с системой вам будет предложен интерактивный онбординг с пошаговыми инструкциями по работе с платформой.

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

Фотографирование с камеры (для мобильных устройств):

• При первом обращении разрешите приложению использовать камеру
• Наведите камеру на задание
• Нажмите кнопку съемки
• Проверьте качество фотографии в предпросмотре

Загрузка файлов с устройства (для декстопных устройств):

• Нажмите кнопку “Загрузить файл” или значок 📁
• Выберите файл(ы) через файловый менеджер
• Подтвердите выбор

Drag & Drop (на десктопе):

• Перетащите файл(ы) в область загрузки
• Изображения автоматически загрузятся

6.3.2 Поддерживаемые форматы

• Изображения: JPEG, PNG, WebP, GIF, HEIC/HEIF
• Документы: PDF (для декстоп, автоматически конвертируется в изображения)

⚠️ Рекомендации по качеству:

• Размер файла: до 10 МБ на изображение
• Разрешение: минимум 800×600 px, рекомендуется 1920×1080 px
• Освещение: равномерное, без бликов и теней
• Текст должен быть четким и читаемым
• Избегайте наклона и искажения перспективы

6.3.3 Работа с несколькими изображениями

Если задание многостраничное:

• Загрузите первое изображение
• Нажмите “Добавить еще”
• Загрузите следующее изображение
• Повторите для всех страниц задания

6.4 Акцентные зоны

Акцентные зоны позволяют выделить важные части задания, на которые AI должен обратить особое внимание при проверке.

6.4.1 Когда использовать акцентные зоны

Акцентные зоны полезны, когда: 

• Задание содержит несколько подзадач, и нужно выделить конкретную
• На изображении есть дополнительная информация, которую AI не должен учитывать 
• Нужно сфокусировать внимание AI на критически важной части условия

6.5 Загрузка решений студентов

После загрузки задания можно приступать к загрузке решений студентов.

6.5.1 Загрузка решения

• Откройте нужную проверку
• Нажмите кнопку “Перейти к фото решения”
• Загрузите одно или несколько изображений решения

Рекомендации для фотографирования решений:

• Решение должно быть полностью в кадре
• Текст и формулы должны быть четкими
• Избегайте теней от руки или телефона
• При необходимости сделайте несколько фотографий для многостраничных решений

6.5.2 Работа с несколькими страницами решения

Если решение студента занимает несколько страниц:

• Загрузите первую страницу решения
• Нажмите “Добавить еще”
• Загрузите следующую страницу
• Повторите для всех страниц

Все страницы будут автоматически связаны с одной работой студента.

6.5.3 Автоматическое создание работы

После загрузки решения система автоматически:

• Создает новую работу (Work) в рамках проверки
• Переводит вас на экран выбора студента
• Сохраняет изображения решения

Каждое решение создает отдельную работу, что обеспечивает изоляцию данных разных студентов.

6.6 Управление студентами

После загрузки решения необходимо указать, какому студенту принадлежит эта работа.

6.6.1 Выбор существующего студента

После загрузки решения система автоматически показывает экран выбора студента:

• В списке отображаются все ваши студенты
• Нажмите на карточку нужного студента
• Система автоматически привяжет работу к студенту и запустит AI-проверку
  
  

6.6.2 Создание нового студента

Если студента еще нет в системе:

• На экране выбора кликните в “ФИО ученика”
• Введите имя студента (например, “Иванов Иван” или “Иван И.”)
• Нажмите “Сохранить”
• Студент будет автоматически привязан к текущей работе
• Система запустит AI-проверку

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

После выбора студента система автоматически запускает AI-проверку.

6.7.1 Процесс AI-проверки

Во время проверки:

• Система отправляет изображения задания и решения в AI-сервис
• На экране отображается анимированный индикатор процесса
• Показывается текущий статус:
• “В очереди” (pending) — задача ожидает обработки
• “Обработка” (processing) — идет анализ работы
• “Завершено” (completed) — проверка завершена
• “Ошибка” (failed) — произошла ошибка

Среднее время проверки: 30-60 секунд

6.7.2 Структура результатов

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

Для каждой подзадачи: 

• Анализ решения — анализ ошибок, если есть
• Решение студента — что сделал студент 
• Правильный ответ — эталонное решение или ответ 

6.7.3 Отображение математических формул

Система автоматически рендерит математические формулы в результатах проверки:

• Формулы отображаются в читаемом виде (не как LaTeX код)
• Поддерживаются сложные математические выражения
• Формулы корректно масштабируются под размер экрана

Пример: 

• Входной LaTeX: $\int_{0}^{\infty} x^2 dx$ 
• Отображение: ∫₀^∞ x² dx

6.7.4 Просмотр всех работ в проверке

Чтобы просмотреть все работы студентов в рамках одной проверки:

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

Для каждого студента показывается: 

• Имя студента 
• Дата проверки 
• Статус проверки (завершена/в процессе/ошибка) 
• Краткие результаты

6.7.5 Развернутый просмотр результата

Чтобы просмотреть детальные результаты:

• Нажмите на карточку студента
• Карточка развернется, показав полную информацию
• Вы можете:
• Читать все комментарии AI
• Просматривать разбивку по подзадачам
• Оставить обратную связь (см. раздел 8)
• Просмотреть изображения задания и решения

6.7.6 Обработка ошибок

Если при проверке произошла ошибка:

• В карточке работы отображается статус “Ошибка”
• Показывается сообщение о причине ошибки
• Доступна кнопка “Повторить проверку”

Возможные причины ошибок:

• Низкое качество изображений 
• Проблемы с подключением к AI-сервису
• Неподдерживаемый формат данных

6.8 Обратная связь

Система обратной связи помогает улучшать качество AI-проверки.

6.8.1 Оценка качества проверки

Вы можете оценить качество AI-проверки для каждой подзадачи:

• Откройте результаты проверки студента
• В каждой подзадаче найдите блок “Оцените качество проверки”
• Нажмите:
• 👍 Полезно — если AI-проверка точная и полезная
• 👎 Бесполезно — если AI-проверка неточная или неполная
  
  
  

6.8.2 Добавление комментария

После оценки вы можете добавить текстовый комментарий:

• После нажатия полезно или бесполезно откроется поле для комментария
• Опишите, что именно вам понравилось или не понравилось:
• Нажмите “Отправить”

6.8.3 Редактирование обратной связи

Вы можете изменить свою оценку и комментарий:

• Откройте результаты проверки с вашей обратной связью
• Кликните в Полезно или Бесполедно
• Напишите новый комментарий
• Нажмите “Сохранить”
  
  

7 Руководство администратора

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

7.1 Доступ к административной панели

• Войдите в систему с учетной записью администратора
• В главном меню появится дополнительный пункт “Админ-панель”
• Нажмите на него для перехода в административную панель

Административная панель включает следующие разделы:

• Пользователи — управление учетными записями
• Проверки — просмотр всех проверок в системе
• Промпты — управление инструкциями для AI
• Статистика — аналитика и метрики системы
• Обратная связь — просмотр оценок пользователей
• Настройки — конфигурация системы
• AI тесты — отладка AI-проверки
• Сессии — мониторинг активности пользователей

7.2 Управление пользователями

Раздел позволяет просматривать и управлять всеми пользователями системы.

7.2.1 Просмотр списка пользователей

• В админ-панели перейдите в раздел “Пользователи”
• Отображается список всех зарегистрированных пользователей

Для каждого пользователя показывается: 

• ID пользователя
• Имя и фамилия 
• Email 
• Дата регистрации 
• Статус аккаунта (активен/заблокирован/удален) 
• Роль (администратор/пользователь)

7.2.2 Блокировка пользователя

Для блокировки доступа пользователя к системе:

• Откройте карточку пользователя
• Нажмите кнопку “Заблокировать”
• Подтвердите действие

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

7.2.3 Разблокировка пользователя

• Откройте карточку заблокированного пользователя
• Нажмите кнопку “Разблокировать”
• Подтвердите действие

7.2.4 Активация пользователя без верификации email

Если пользователь не получил письмо с подтверждением:

• Откройте карточку пользователя
• Нажмите кнопку “Активировать”
• Пользователь сможет войти в систему

7.3 Управление промптами

Промпты — это системные инструкции для AI-модели, определяющие, как проверять работы студентов.

7.3.1 Просмотр списка промптов

• В админ-панели перейдите в раздел “Промпты”
• Отображается список всех промптов в системе

Для каждого промпта показывается: 

• ID промпта 
• Название 
• Дата создания 
• Дата последнего изменения - Статус (активен/системный)

7.3.2 Создание нового промпта

• Нажмите кнопку “Добавить промпт”
• Заполните форму:
• Название промпта (например, “Проверка задач по алгебре 9 класс”)
• Содержимое промпта — инструкции для AI в текстовом формате
• Нажмите “Создать”

Пример содержимого промпта:

Вы — опытный учитель математики. Проверьте решение студента по следующим критериям:
1. Правильность итогового ответа
2. Корректность хода решения
3. Наличие пояснений к действиям
4. Оформление решения

Укажите найденные ошибки и дайте рекомендации по улучшению.

7.3.3 Редактирование промпта

• В списке промптов найдите нужный промпт
• Нажмите на кнопку “Изменить” в карточке промпта
• Измените название или содержимое
• Нажмите “Сохранить”

⚠️ Внимание: Изменения промпта повлияют на все будущие проверки, но не изменят результаты уже выполненных проверок.

7.3.4 Системные промпты

Некоторые промпты помечены как “Системные” — они используются по умолчанию и защищены от удаления. Вы можете редактировать их содержимое, но не можете удалить.

7.4 Просмотр всех проверок

Раздел позволяет просматривать все проверки всех пользователей в системе.

7.4.1 Список всех проверок

• В админ-панели перейдите в раздел “Проверки”
• Отображается список всех проверок в системе

Для каждой проверки показывается: 

• ID проверки 
• Название 
• Автор (преподаватель) 
• Дата создания 
• Количество работ студентов 

7.4.2 Пагинация

Список автоматически подгружает проверки по 50 элементов при прокрутке.

7.4.3 Просмотр работ студентов

В детальной информации о проверке:

• Нажмите на кнопку Развернуть
• Нажмите на карточке студента кнопку Просмотр
• Откроются результаты AI-проверки

Вы можете просматривать результаты, но не можете редактировать их или оставлять обратную связь (это доступно только автору проверки).

7.5 Статистика системы

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

7.5.1 Обзор статистики

• В админ-панели перейдите в раздел “Аналитика системы”
• Отображается дашборд с ключевыми метриками

7.5.2 Общие метрики

Метрики пользователей: 

• Общее количество пользователей в системе 
• Количество активных пользователей

Метрики проверок: 

• Общее количество проверок 
• Проверок за последний месяц
• Проверок за последнюю неделю 
• Проверок за последний день

7.5.3 Статистика по заданиям

Метрики о загруженных заданиях: 

• Общее количество загруженных изображений заданий 
• Заданий за последний месяц 
• Заданий за последнюю неделю 
• Заданий за последний день 
• Среднее количество изображений на одно задание

7.5.4 Статистика по решениям

Метрики о проверках решений: 

• Общее количество проверок решений через AI 
• Проверок за последний месяц 
• Проверок за последнюю неделю 
• Проверок за последний день 
• Общее количество загруженных изображений решений 
• Изображений решений за месяц/неделю/день 
• Среднее количество изображений на одно решение

7.5.5 Статистика обратной связи

Метрики по оценкам пользователей:

Положительные оценки (лайки): 

•  Общее количество лайков 
• Лайков за месяц/неделю/день

Отрицательные оценки (дизлайки): 

• Общее количество дизлайков 
• Дизлайков за месяц/неделю/день

График обратной связи: Визуализирует динамику положительных и отрицательных оценок.

7.5.6 Графики активности пользователей

График количества активных пользователей по дням: Показывает количество уникальных пользователей по датам, использующих систему.

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

7.6 Управление обратной связью

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

7.6.1 Просмотр списка обратной связи

• В админ-панели перейдите в раздел “Фидбек”
• Отображается список всех оценок от пользователей

Для каждой записи показывается: 

• Тип оценки (👍 Полезно / 👎 Бесполезно) 
• Пользователь (преподаватель) 
• Дата оценки - Комментарий (если есть) 
• Проверка, к которой относится оценка 
• Комментарий

7.6.2 Фильтрация обратной связи

Вы можете фильтровать обратную связь по: 

• Типу оценки (лайки/дизлайки/все) 
• Пользователю (конкретный преподаватель) 

7.6.3 Пагинация обратной связи

Список автоматически подгружает записи по 50 элементов при прокрутке.

7.6.4 Переход к проверке из обратной связи

Из карточки обратной связи вы можете:

• Нажать кнопку “Перейти к работе”
• Откроется страница проверки с результатами

Это позволяет увидеть контекст оценки и понять, почему пользователь оставил именно такую обратную связь.