MathRogue — геймифицированный тренажёр математики

📌 Описание проекта

MathRogue — это обучающая игра с элементами rogue-like, направленная на развитие математических навыков у подростков 12–14 лет.
Проект сочетает короткие игровые сессии, процедурную генерацию уровней и адаптивную сложность заданий.

Основная идея - повысить интерес к обучению за счёт игровых механик (прогресс, риск/награда, прокачка), сохраняя при этом образовательную ценность.

---

🎯 Цель проекта

Создать прототип обучающей игры, которая:

• мотивирует подростков регулярно тренировать математику;
• подходит для коротких сессий (10–15 минут);
• адаптируется под уровень пользователя.

---

👥 Целевая аудитория

• Основная аудитория: подростки 12–14 лет

---

🧩 Ключевые функции (MVP)

• Процедурная генерация игровых комнат
• Типы заданий:
  • числовой ответ
  • короткая текстовая задача
  • выбор ответа из предложенных
• Прогресс игрока
• Подсчёт точности решений (% правильных ответов)
• Учёт активности пользователя (возвраты, длительность сессий)

---

🧠 Педагогическая модель

• Короткие задачи без перегрузки
• Пошаговые объяснения решений
• Постепенное усложнение заданий
• Акцент на понимание, а не заучивание

---

🏗 Архитектура и технологии

• Игровой движок: Unity
• Язык разработки: C#
• База данных (этапы):
  • прототип: SQLite
  • масштабирование: PostgreSQL
• Хранение данных:
  • user_id
  • псевдоним
  • игровые и учебные метрики

---

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

• Минимальный объём персональных данных
• Отсутствие хранения ФИО и контактной информации

---

📊 Метрики проекта

• Точность выполнения заданий (%)
• Возврат пользователей (DAU/WAU)
• Среднее время на решение задачи

---

🚧 Текущий статус

Проект находится на этапе аналитики, проектирования и подготовки MVP.
Игровая логика и код Unity находятся в разработке и будут добавлены на следующем этапе.

---

📚 Документация и материалы

• Презентация: https://docs.google.com/presentation/d/1CSruimvd6Y3bevm3lFqggtfktcCFw-Zz/edit?usp=sharing&ouid=107967492631232666855&rtpof=true&sd=true
• Описание проекта (DOCX): https://docs.google.com/document/d/1eijWGm7kO68KSg1hsmm8KIEfB7uaBmM4/edit?usp=sharing&ouid=107967492631232666855&rtpof=true&sd=true

---

🗄 Структура базы данных

• 📐 ER-диаграмма базы данных (DrawSQL):
  https://drawsql.app/teams/g-225/diagrams/math-roguelike
• 💾 Физическая реализация базы данных (SQLite) с CSV и JSON находится в папке:
  /Database

---

🗂 Структура проекта

Проект MathRogue - Unity (URP). В репозитории хранятся основные ассеты и проектные настройки.

Папки в Unity/Assets/

• Unity/Assets/MaterialUI/ - вспомогательная UI-библиотека (готовые компоненты интерфейса).
• Unity/Assets/Scenes/ - сцены проекта (Main.unity и т.д.).
• Unity/Assets/Sprites/ - графика и спрайты.
• Unity/Assets/UI Toolkit/ - шаблоны пользовательского интерфейса.
• Unity/Assets/Settings/ - локальные ассеты настроек, префабы и конфигурации.

Ключевые файлы

• Unity/Assets/Main.unity - основная сцена проекта.
• Unity/Assets/GameManager.cs - управление логикой игры (загрузка вопросов, переходы сцен, учёт очков).
• Unity/Assets/Question.cs - модель вопроса (id, тема, класс, тип, текст, ответ, пояснение).
• Unity/Assets/Drag.cs - скрипт механики drag & drop.
• Unity/Assets/InputSystem_Actions.inputactions - настройки Unity Input System.

Packages

• Unity/Packages/manifest.json - список используемых пакетов Unity (URP, Input System и др.).

ProjectSettings

• Unity/ProjectSettings/ - глобальные настройки проекта (графика, качество, ввод, версия Unity).

---

👥 Авторы

Группа 4 - Рамиль (аналитика, документация, SQL-разработчик ) + Артём (backend / frontend, Unity реализация)

---

📄 Лицензия

Проект распространяется под лицензией MIT.