AI LEVEL UP
ДОКУМЕНТАЦИЯ ПРОЕКТА AI LEVELUP
1. НАЗНАЧЕНИЕ СИСТЕМЫ
AI LevelUp — образовательная платформа Maqsut Narikbayev University для организации онлайн-обучения. Система объединяет учебные курсы, тестирование, контроль прогресса, взаимодействие с преподавателями и AI-чат.
Основные возможности:
- регистрация и авторизация пользователей;
- прохождение курсов, модулей и тестов;
- отслеживание учебного прогресса;
- взаимодействие с AI-чат-ботом;
- управление учебным контентом;
- формирование PDF-сертификатов с QR-кодом;
- проверка подлинности сертификатов;
- сбор заявок через публичный лендинг.
2. ИСТОЧНИКИ ДАННЫХ
Основные источники:
- студенты — регистрационные данные, ответы, прогресс и вопросы;
- преподаватели — курсы, модули, тесты и ответы студентам;
- администраторы — пользователи, потоки, группы, курсы и шаблоны сертификатов;
- Supabase — данные приложения;
- файловое хранилище — сертификаты, QR-коды и другие файлы;
- публичная форма — заявки с лендинга, передаваемые в Google Sheets.
3. КАКИЕ ДАННЫЕ ОБРАБАТЫВАЮТСЯ
В системе обрабатываются:
- ФИО, e-mail и телефон;
- специальность, место работы и год выпуска;
- роль, статус, поток и учебная группа;
- курсы, модули и результаты тестирования;
- прогресс прохождения обучения;
- вопросы студентов и ответы преподавателей;
- данные заявок с публичного лендинга;
- шаблоны сертификатов;
- PDF-сертификаты, QR-коды и коды проверки.
4. КАК ПЕРЕДАЮТСЯ И ЗАЩИЩАЮТСЯ ДАННЫЕ
Обмен внутри системы выполняется через API-маршруты Next.js по HTTP(S) в формате JSON.
Авторизация реализована с использованием JWT, который хранится в HttpOnly cookie. Middleware проверяет сессию и роль пользователя при обращении к защищённым разделам.
Внешний обмен:
- SMTP — подтверждение e-mail, восстановление пароля и отправка сертификатов;
- Google Sheets API — передача заявок с лендинга;
- AI-чат — передача сообщений через внешний webhook.
5. РАЗДЕЛЫ СИСТЕМЫ И ИНТЕГРАЦИИ
Основные рабочие зоны:
- Student Dashboard — курсы, модули, тесты, прогресс и AI-чат;
- Lecturer — управление контентом, просмотр прогресса групп и ответы студентам;
- Admin — пользователи, потоки, группы, курсы и сертификаты;
- Certificate — публичная проверка сертификата по QR-коду;
- Templates — управление шаблонами;
- Auth — регистрация, вход, подтверждение e-mail и восстановление пароля;
- Landing — публичная форма сбора заявок.
AI LevelUp интегрирован с Supabase, SMTP-сервисом, Google Sheets API и внешним AI-чатом. Генерация PDF и QR-кодов выполняется внутри приложения с помощью pdf-lib и qrcode.
ТЕХНОЛОГИЧЕСКАЯ ОСНОВА
Next.js 14, TypeScript, API Routes, Supabase, JWT, Docker, SMTP, Google Sheets API, webhooks, pdf-lib и qrcode. Фронтенд и серверные API развёртываются как единое приложение.