Student Progress Analyzer

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

Student Progress Analyzer — инструмент анализа данных для оценки динамики успеваемости и посещаемости студентов на основе табличных данных (CSV / Excel).

Проект ориентирован на образовательную сферу и демонстрирует практическое применение анализа данных и автоматизации с использованием CI/CD.

Назначение проекта

• выявление студентов с риском снижения успеваемости;
• наглядная аналитика учебного прогресса;
• автоматическая генерация аналитических отчётов.

Основные возможности

• анализ оценок и посещаемости;
• расчёт агрегированных показателей;
• формирование аналитических отчётов;
• автоматическая генерация отчётов по расписанию (CI/CD).

---

Установка и требования

Требования

• Python 3.8+
• pip

Установка

git clone https://gitverse.ru/TrollFace324/Student_Progress_Analyzer.git
cd student-progress-analyzer
pip install -r requirements.txt

---

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

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

1. Подготовьте входные данные в формате CSV (пример в папке
   data/
   ).
2. Запустите анализ:
   python -m src.main --input data/sample_grades.csv --output data/report.html
3. Откройте
   report.html
   в браузере.

---

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

student-progress-analyzer/
├── src/
│ ├── main.py
│ └── analyzer.py
├── tests/
├── data/
├── docs/
├── .gitverse/workflows/
├── requirements.txt
├── .gitignore
└── README.md

---

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

pytest
pytest --cov=src tests/

---

CI/CD

Используется CI/CD (GitVerse):

• запуск тестов при push и pull request;
• проверка качества кода (pytest, flake8, black);
• запланированный workflow (cron) для регулярной генерации отчётов;
• генерация артефактов (отчётов).

---

Автор

Тимофеев Матвей РИ-150921