Gradely. Описание функциональных характеристик ПО

1 Реферат

Название программного обеспечения: Gradely

Предыдущие и (или) альтернативные названия программного обеспечения: отсутствуют

Назначение ПО:

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

Продукт состоит из:

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

2 Описание функциональных характеристик

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

3 Функциональные характеристики общие для всех пользователей

3.1 Аутентификация и управление аккаунтом

• Регистрация нового пользователя по email
• Авторизация по логину (email) и паролю
• JWT-аутентификация с автоматическим продлением сессии
• Восстановление пароля через email с одноразовым кодом подтверждения
• Просмотр и редактирование профиля пользователя
• Удаление аккаунта с подтверждением

3.2 Progressive Web Application (PWA)

• Установка приложения на домашний экран устройства (iOS, Android, Desktop)
• Работа в offline-режиме с кэшированием статических ресурсов
• Автоматическое обновление приложения при появлении новой версии
• Адаптивный интерфейс для всех типов устройств

3.3 Работа с изображениями

• Поддержка форматов: JPEG, PNG, WebP, GIF, HEIC/HEIF
• Автоматическая конвертация HEIC в JPEG на стороне клиента
• Оптимизация изображений для снижения размера файлов
• Генерация превью (thumbnails) для быстрой загрузки
• Загрузка изображений через drag & drop или выбор файлов
• Захват изображений напрямую с камеры устройства
• Поддержка PDF документов с конвертацией в изображения

3.4 Интерфейс и навигация

• Адаптивный дизайн для работы на мобильных устройствах и десктопе
• Интуитивная навигация между разделами
• Загрузчики (loaders) для отображения процесса обработки
• Toast-уведомления об успешных операциях и ошибках
• Модальные окна для подтверждения критических действий

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

• HTTPS для всех соединений
• Защита от XSS атак через CORS политики
• Валидация всех входящих данных на клиенте и сервере
• Ограничение размера загружаемых файлов
• Автоматическое завершение неактивных сессий
• Хеширование паролей с использованием bcrypt

4 Функциональные характеристики для преподавателей

4.1 Основной рабочий процесс (Checks Flow)

Система построена вокруг концепции “Проверки” (Check) — это контейнер для одного задания и множества решений студентов.

Типичный сценарий использования:

1. Преподаватель создает новую проверку (например, “Контрольная работа №1”)
2. Загружает фотографии условий задания (одна или несколько страниц)
3. При необходимости выделяет акцентные зоны на изображениях
4. Последовательно загружает решения студентов
5. Для каждого решения выбирает или создает профиль студента
6. Система автоматически запускает AI-проверку
7. Преподаватель просматривает результаты для каждого студента

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

Создание и настройка:

• Создание новой проверки одной кнопкой с автоматическим названием “Новая проверка”
• Редактирование названия проверки (например, “Контрольная работа по алгебре №3”)
• Просмотр списка всех проверок с сортировкой по дате создания
• Автоматическая пагинация списка проверок (подгрузка по 20 элементов)
• Отображение количества проверенных работ в каждой проверке
• Удаление проверки с подтверждением (с каскадным удалением всех связанных работ)

Интерфейс:

• Десктопный режим: двухпанельный интерфейс (список проверок + детали)
• Мобильный режим: последовательная навигация между экранами
• Автоматический выбор первой проверки при открытии на десктопе
• История просмотра через URL параметры

4.3 Загрузка изображений задания

Способы загрузки:

• Фотографирование с камеры устройства (основной способ)
• Загрузка файлов с устройства через файловый менеджер
• Drag & Drop загрузка (на десктопе)
• Загрузка PDF файлов с автоматической конвертацией в изображения

Процесс фотографирования:

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

Работа с изображениями задания:

• Просмотр миниатюр всех загруженных изображений
• Просмотр изображений в полном размере
• Удаление отдельных изображений задания

4.4 Установка акцентных зон

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

• Выбор изображения для установки акцентной зоны
• Интерактивное выделение прямоугольной области на изображении
• Изменение размера и положения акцентной зоны
• Предпросмотр выделенной области
• Сохранение акцентной зоны с привязкой к изображению
• Редактирование ранее установленной акцентной зоны
• Удаление акцентной зоны
• Акцентные зоны используются AI для фокусировки на важных частях задания

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

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

Процесс загрузки решения:

• Кнопка “Загрузить решение ученика”
• Активация камеры для фотографирования работы студента
• Возможность сделать несколько фотографий для многостраничных решений
• Автоматическое создание новой “работы” (work) для каждого студента

Особенности:

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

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

Выбор или создание студента:

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

• Просмотр списка всех студентов преподавателя
• Выбор существующего студента одним тапом
• Создание нового профиля студента “на лету”:
• Ввод имени студента
• Мгновенное создание профиля
• Автоматическая привязка к текущей работе
• Просмотр истории работ каждого студента

4.7 Автоматическая AI-проверка

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

Процесс обработки:

• Автоматический запуск AI-анализа после выбора студента
• Отправка изображений задания и решения на AI сервис вместе с системным промптом
• Статусы обработки:
• pending — задача в очереди
• processing — идет анализ
• completed — проверка завершена
• failed — произошла ошибка

Индикация процесса:

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

4.8 Просмотр результатов проверки

Интерфейс результатов:

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

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

• Общий анализ работы от AI
• Разбиение на подзадачи (если задание составное)
• Для каждой подзадачи:
• Условие задачи
• Решение студента
• Правильный ответ
• Оценка правильности

Отображение математики:

• Автоматический рендеринг математических формул через MathJax
• Поддержка LaTeX синтаксиса в результатах
• Корректное отображение на всех устройствах
• Масштабирование формул под размер экрана

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

Преподаватель может оценить качество AI-проверки:

• Оценка каждой подзадачи отдельно (лайк/дизлайк)
• Добавление текстового комментария к оценке
• Редактирование ранее оставленной обратной связи
• Отправка обратной связи в систему для улучшения AI
• История всех оценок

4.10 Онбординг и помощь

Для новых пользователей:

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

Информационная поддержка:

• Всплывающие подсказки на ключевых элементах
• Справочная информация о форматах файлов
• Рекомендации по качеству фотографий
• Инструкции по работе с акцентными зонами

5 Функциональные характеристики административной панели

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

• Просмотр полного списка зарегистрированных пользователей
• Фильтрация пользователей по статусу:
• Активные/неактивные
• Заблокированные
• Удаленные
• Скрытые
• Администраторы
• Сортировка пользователей по различным параметрам (дата регистрации, имя, email)
• Просмотр детальной информации о пользователе:
• ID пользователя
• Имя
• Email
• Дата регистрации
• Статус аккаунта
• Роль (админ/пользователь)
• Блокировка пользователя (запрет доступа к системе)
• Разблокировка пользователя
• Удаление пользователя (мягкое удаление с сохранением данных)
• Восстановление удаленного пользователя
• Активация пользователя без верификации email
• Назначение прав администратора
• Снятие прав администратора
• Подсчет общего количества пользователей

5.2 Управление промптами для AI-проверки

• Просмотр полного списка промптов в системе
• Создание нового промпта с указанием:
• Названия промпта
• Содержимого промпта (инструкции для AI)
• Редактирование существующих промптов:
• Изменение названия
• Изменение содержимого
• Защита системных промптов от удаления

5.3 Просмотр всех проверок в системе

• Просмотр списка всех проверок всех пользователей
• Фильтрация проверок по:
• Пользователю
• Дате создания
• Статусу
• Сортировка проверок
• Пагинация для больших списков (по 50 элементов на странице)
• Просмотр детальной информации о любой проверке
• Просмотр работ студентов в рамках проверки
• Переход к просмотру конкретной работы

5.4 Статистика и аналитика системы

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

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

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

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

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

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

Статистика производительности:

• Среднее время обработки работы (в секундах)
• Распределение времени проверки по периодам
• Графики нагрузки на систему

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

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

Визуализация данных:

• Графики активности пользователей
• Диаграммы распределения проверок по датам
• Графики обратной связи (Chart.js)
• Тренды использования системы

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

• Просмотр всей обратной связи от пользователей
• Фильтрация по типу оценки (лайк/дизлайк)
• Фильтрация по пользователю
• Фильтрация по дате
• Просмотр текстовых комментариев пользователей
• Сортировка обратной связи
• Пагинация (по 50 элементов на странице)
• Переход к работе, по которой оставлена обратная связь
• Просмотр контекста проверки

5.6 Управление настройками системы

• Просмотр всех настроек системы
• Редактирование настроек различных типов:
• Булевы значения (включено/выключено)
• Числовые параметры
• Текстовые параметры
• JSON конфигурации
• Настройка лимитов:
• Максимальный размер загружаемых файлов
• Лимиты на количество проверок
• Лимиты токенов AI
• Настройка AI моделей:
• Выбор провайдера AI (Yandex, Gigachat, DeepSeek и др.)
• Выбор модели для проверки
• Настройка параметров модели
• Настройка уведомлений:
• Email уведомления
• Мессенджер уведомления
• Push-уведомления
• Сохранение изменений настроек с подтверждением

5.7 AI тесты и отладка

• Тестирование работы AI модели
• Просмотр сырых ответов от AI
• Тестирование различных промптов
• Отладка парсинга результатов
• Просмотр логов обращений к AI
• Мониторинг использования токенов

5.8 Отладка сессий пользователей

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

5.9 Мониторинг системы

• Просмотр логов ошибок
• Уведомления о критических ошибках (5xx) в Мессенджер
• Раздельные каналы для development и production ошибок
• Автоматическая очистка старых ошибок
• Health check статус всех сервисов
• Мониторинг доступности базы данных
• Мониторинг доступности AI сервиса

6 Функциональные характеристики технического уровня

6.1 Обработка изображений

• Автоматическая оптимизация качества изображений
• Изменение размера для снижения нагрузки
• Генерация миниатюр (thumbnails) для предпросмотра
• Обрезка изображений по акцентной зоне
• Конвертация форматов на лету
• Ленивая загрузка изображений (lazy loading)
• Прогрессивная загрузка JPEG

6.2 Работа с AI моделью

• Асинхронная обработка запросов к AI
• Retry механизм при сбоях
• Таймауты для предотвращения зависаний
• Форматирование промптов с изображениями
• Парсинг структурированных ответов от AI
• Валидация результатов AI
• Логирование всех обращений к AI
• Подсчет потраченных токенов

6.3 Управление данными

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

6.4 Производительность и масштабируемость

• Кеширование данных на клиенте
• Кеширование статических ресурсов
• Connection pooling для базы данных
• Горизонтальное масштабирование backend
• Stateless архитектура для легкого масштабирования
• CDN для статических файлов (в production)
• Оптимизация SQL запросов

6.5 Безопасность и надежность

• JWT токены с автоматическим обновлением
• Валидация всех входящих данных
• Защита от SQL инъекций
• Rate limiting на уровне Nginx
• CORS политики для защиты от XSS
• Изоляция сервисов через Docker network
• Graceful shutdown для корректного завершения запросов
• Healthcheck для автоматического перезапуска сервисов

7 Заключение

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

• Интуитивный интерфейс для преподавателей и студентов
• Мощные инструменты AI-анализа для объективной оценки работ
• Гибкую систему промптов для адаптации под различные типы заданий
• Детальную аналитику для администраторов
• Высокую производительность и надежность системы
• Безопасность данных пользователей

Масштабируемость для роста нагрузки

Информация, необходимая для установки и эксплуатации Gradely находится по ссылке: https://collaboteam.ru/user-guide