🎓 AI Learning Assistant - Генератор персональных учебных планов

AI-powered система для анализа успеваемости студентов и генерации персонализированных учебных планов с использованием машинного обучения и NLP.

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

• 📊 Анализ успеваемости с вычислением 10+ метрик
• 🎯 NLP-анализ интересов студента
• 🤖 Рекомендательная система курсов на основе ML
• 📈 Персонализированные учебные планы с оценкой времени
• ⚡ Автоматическая генерация отчетов (JSON, визуализации)
• 🔄 CI/CD с креативными workflow (ежедневные отчеты, артефакты)

🚀 Быстрый старт

Установка

Использование

Пример вывода

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

🔧 Тестирование

⚡ CI/CD Pipeline

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

1. Tests and Code Quality (

tests.yml

)

• ✅ Запускается при каждом push/pull request
• ✅ Проверка на Python 3.9, 3.10, 3.11
• ✅ Linting с flake8
• ✅ Форматирование с black
• ✅ Unit тесты с pytest
• ✅ Покрытие кода и загрузка в Codecov
• ✅ Артефакты: отчеты о покрытии

2. Daily Learning Report (

daily_report.yml

) 🎯 КРЕАТИВНЫЙ!

• ⏰ Запуск по расписанию каждый день в 8 утра
• 🎛️ Ручной запуск с параметрами через
  workflow_dispatch
• 📊 Генерация ежедневных отчетов для студентов
• 📦 Сохранение артефактов (JSON, PDF отчеты)
• 🚀 Авто-деплой на GitHub Pages
• 🔔 Уведомления о статусе выполнения

📈 Метрики и анализ

Проект рассчитывает более 15 метрик для каждого студента:

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

🛠️ Технологии

• Python 3.9+ с type hints
• Pandas & NumPy для анализа данных
• Scikit-learn для ML рекомендаций
• NLTK & TextBlob для NLP анализа интересов
• Pytest для тестирования (100% coverage goal)

👥 Автор

• @Foutx

🙏 Благодарности

• Преподавателям курса за вдохновляющую задачу
• Сообществу open-source за прекрасные библиотеки
• Всем, кто верит в силу образования и ИИ