Обзор
Этот кейс представляет разработку и тестирование полностью встраиваемого интерактивного генератора математических заданий, предназначенного для работы внутри HTML iframe Wix. Цель состояла в создании браузерного учебного инструмента, который позволяет ученикам генерировать математические задания, практиковать методы решения, проверять ответы, просматривать подсказки и изучать пошаговые решения без backend-системы, внешних скриптов или стороннего отслеживания.
Финальное решение было создано как один полностью автономный HTML-файл, содержащий HTML, CSS и JavaScript. Его можно напрямую вставить в элемент Wix Embed Code / HTML iframe и использовать как интерактивный образовательный виджет на сайте Wix.
Цель проекта
Основная задача состояла в создании практичного инструмента для изучения математики, который можно быстро и безопасно добавить на сайт Wix. Инструмент должен был поддерживать несколько экзаменационных программ, уровней обучения, тем, подтем и вариантов сложности, оставаясь при этом простым для учеников.
Решение разработано для учеников, учителей, репетиторов и владельцев сайтов Wix, которым нужен интерактивный образовательный инструмент без сложной настройки.
Решение
Финальный код обеспечивает интерактивную практику математики непосредственно в браузере. Пользователь может выбрать экзаменационную программу, уровень, тему, подтему и сложность, а затем сгенерировать случайное математическое задание. Каждое задание содержит понятную формулировку, подсказки по формуле или методу, при необходимости диаграмму, область для заметок и вычислений, проверку ответа, подсказки и пошаговое решение.
Приложение также содержит панель прогресса, показывающую количество попыток, правильных ответов, точность, серию правильных решений, число сгенерированных заданий, текущую тему, текущую сложность, ID упражнения и ID варианта.
Поскольку решение полностью автономно, ему не нужны база данных, сервер, система входа, внешняя библиотека JavaScript или настройка Wix Velo. Это делает его удобным для простого встраивания в Wix и быстрого развёртывани я.
Основные функции
Maths Practice Generator включает интерактивную генерацию заданий, фильтры экзаменационной программы и темы, случайные ID упражнения и варианта, проверку ответов, подсказки, пошаговые решения, диаграммы, область для записей ученика, адаптивный дизайн и браузерное отслеживание прогресса.
Он поддерживает несколько типов ответов, включая числовые значения, денежные суммы, проценты, вероятность, алгебру, координаты и ответы из нескольких чисел. Также распознаются распространённые единицы измерения: cm, cm², cm³, km/h, m/s, kg, N, Nm, градусы и валюта.
Улучшения, внесённые во время проверки
Во время тестирования были выявлены и внесены несколько улучшений, чтобы код лучше подходил для встраивания в Wix и реаль ного использования учениками.
Область улучшения | Обнаруженная проблема | Применённое решение |
Проверка ответов | Некоторые естественно введённые ответы с единицами измерения отклонялись. | Расширена обработка ответов, чтобы принимать такие единицы, как km/h, m/s, cm³, Nm, kg, градусы и валюту. |
Префиксы ответов | Некоторые правильные ответы с префиксами отклонялись, например k = 24 или Example: 2. | Добавлена поддержка распространённых префиксов, включая answer =, k = и example:. |
Мобильный ввод | Поле ответа открывало десятичную клавиатуру даже для алгебраических или текстовых ответов. | Добавлен динамический режим ввода: для числовых ответов используется десятичная клавиатура, а для алгебраических и текстовых — обы чная текстовая клавиатура. |
Отслеживание прогресса | Прогресс сбрасывался после обновления iframe или страницы. | Добавлено локальное хранилище браузера для попыток, правильных ответов, серии и количества сгенерированных заданий. |
Публичная формулировка | Фраза «1,000 seed exercises» могла вводить в заблуждение. | Формулировка изменена на «1,000 exercise IDs» для более ясного и точного представления. |
Результаты тестирования кода
Перед использованием кода в Wix были проведены два основных теста для проверки его надёжности.
Тест 1: синтаксис, загрузка страницы и базовый пользовательский сценарий
Этот тест проверял, корректно ли загружается HTML-файл и работает ли основной пользовательский сценарий ожидаемым образом.
Область теста | Что проверялось | Результат |
Синтаксис JavaScript | Проверено отсутствие ошибок, нарушающих синтаксис скрипта. | Пройден |
Загрузка страницы | HTML-файл открыт как автономное приложение. | Пройден |
DOM-элементы | Проверено отсутствие обязательных ID элементов. | Пройден |
Генерация задания | Из интерфейса сгенерировано математическое задание. | Пройден |
Панель задания | Подтверждено корректное открытие панели задания. | Пройден |
Проверка ответа | Введён ответ и запущена функция проверки ответа. | Пройден |
Ошибки консоли и выполнения | Проверено наличие видимых ошибок выполнения JavaScript. | Обнаружено 0 ошибок |
Тест 2: полная проверка комбинаций генератора
Этот тест проверял генератор вопросов для всех доступных комбинаций уровня, темы, подтемы и сложности. Это было важно, поскольку некоторые ошибки проявляются только в определённых сочетаниях тем.
Область теста | Результат |
Всего протестировано комбинаций | 380 |
Успешно пройдено комбинаций | 380 |
Неудачных комбинаций | 0 |
Общий результат | Пройден |
Пригодность для встраивания в Wix
Финальный код подходит для Wix, поскольку упакован в один полный HTML-документ. Его можно разместить внутри HTML iframe Wix с помощью элемента Embed Code. Приложение адаптивно внутри собственного макета, однако высоту iframe в Wix следует установить достаточно большой, чтобы избежать обрезки контента.
Настройка Wix | Рекомендация |
Тип встраивания | Embed Code / HTML iframe |
Ширина | 100% |
Высота на компьютере | 900–1100px |
Высота н а мобильном устройстве | 1200–1500px |
Прокрутка | Включить, если контент выше iframe |
Требуется backend | Нет |
Требуется Wix Velo | Нет |
Требуются внешние скрипты | Нет |
Результат
Итогом стал полноценный интерактивный инструмент для практики математики, который можно встроить на сайт Wix и сразу использовать. Он обеспечивает удобный опыт для ученика, поддерживает широкий диапазон математических тем и сохраняет всю функциональность внутри браузера.
Область результата | Результат |
Автономное HTML-приложение | Работает |
Пригодность для Wix iframe | Подходит |
Генерация заданий | Работает во всех протестированных комбинациях |
Проверка ответов | Улучшена и работает |
Удобство на мобильных устройствах | Улучшено |
Отслеживание прогресса | Добавлено через локальное хранилище |
Зависимость от backend | Отсутствует |
Финальный технический результат | Тестирование пройдено |
Код после исправлений — DEMO
Заключение
Этот проект показывает, как один автономный HTML-файл может создать мощный интерактивный учебный опыт внутри Wix. Maths Practice Generator объединяет генерацию заданий, проверку ответов, подсказки, пошаговые решения, диаграммы, отслеживание прогресса и адаптивный дизайн в одном встраиваемом решении.
Благодаря лёгкой архитектуре, работе непосредственно в браузере и независимости от внешних сервисов финальный код легко разворачивать и обслуживать, и он хорошо подходит для образовательных сайтов, созданных на Wix.
Что было создано в этом кейсе Wix?
Этот кейс посвящён созданию интерактивного генератора математических заданий, разработанного специально для сайтов Wix. Инструмент создан как полностью автономный HTML-файл с использованием HTML, CSS и JavaScript. Его можно разместить внутри элемента Wix Embed Code / HTML iframe и использовать непосредственно на сайте без backend, базы данных, настройки Wix Velo или внешних скриптов.
Генератор позволяет ученикам выбрать экзаменационную программу, уровень, тему, подтему и сложность. После выбора фильтров можно генерировать случайные математические задания, вводить ответы, записывать ход решения, просматривать подсказки и открывать пошаговые решения. Приложение также отслеживает прогресс: количество попыток, правильных ответов, точность, серию правильных решений и число сгенерированных заданий.
Как код был протестирован перед использованием в Wix?
Код был проверен в рамках двух основных тестов. Первый тест был сосредоточен на базовом техническом сценарии работы приложения: проверке синтаксиса JavaScript, загрузке страницы как автономного HTML-файла, наличии всех необходимых DOM-элементов, генерации задания, открытии панели вопроса, вводе ответа и использовании функции проверки ответа. Во время этого теста не было обнаружено ошибок выполнения или ошибок в консоли.
Второй тест проверял всю систему генерации вопросов для всех доступных комбинаций уровня, темы, подтемы и сложности. Всего было протестировано 380 комбинаций, и все 380 успешно прошли проверку без единого неудачного варианта. Это подтвердило надёжную работу генератора во всех доступных категориях практики.
Почему это решение полезно для сайтов Wix?
Это решение полезно для сайтов Wix, поскольку предоставляет интерактивный учебный инструмент, который можно встроить без сложной настройки. Владелец сайта может добавить приложение через HTML iframe Wix, вставить полный код и опубликовать его как часть образовательного сайта, сайта репетитора или школы.
Инструмент практичен и потому, что полностью работает в браузере. Ему не нужны сервер, база данных, система входа или внешнее программное обеспечение. Ученики могут решать математические задания прямо на странице, проверять ответы, просматривать подсказки и учиться по пошаговым решениям. Финальный код также был улучшен для мобильных устройств, проверки ответов и сохранения прогресса, поэтому подходит реальным пользователям как на компьютерах, так и на мобильных устройствах.

