Raporlar
Modüller: src/modules/wreport, src/modules/wdeficiencies, src/modules/gain
Rapor Modülü (wreport)
Beş farklı rapor servisi var, her biri farklı bir soruya cevap verir.
1. Öğrenci Raporu (student.report.service.js)
Bir öğrencinin sınav performansını detaylı analiz eder.
Ana metodlar:
| Metod | Açıklama |
|---|---|
getStudentReport |
Öğrencinin tüm sınav geçmişi, ders ve konu bazında istatistikler |
getStudentReportSummary |
Özet istatistikler (toplam soru, net, doğruluk oranı) |
getStudentTestsList |
Öğrencinin girdiği sınavların listesi |
getStudentHomeworkTestReports |
Ödev sınavlarından üretilen raporlar |
getStudentTestReports |
Bağımsız (ödev dışı) sınav raporları |
getStudentAvailableLessons |
Öğrencinin rapor çıkarılabilir dersleri |
getStudentAvailableTopics |
Seçilen derse ait konular |
getParentChildrenReports |
Veli görünümü — bağlı çocukların raporları |
Sayfalama limiti: BASE_LIMIT = 100 öğrenci.
2. Başarı Puanı Raporu (success.score.report.service.js)
Departman bazlı başarı puanı analizi.
| Metod | Açıklama |
|---|---|
getSuccessScoreReport |
Bir departmandaki tüm öğrencilerin başarı puanı sıralaması |
getUserDetailScores |
Tek bir öğrencinin ders bazında detaylı puan dağılımı |
getBranchSuccessScoreReport |
Bir üst departmanın doğrudan alt departmanlarını karşılaştırmalı olarak gösterir |
Başarı puanı, ödev sınavlarının metadata'sından çıkarılır (extractScoreFromMetadata).
3. Aylık Başarı Raporu (monthly.success.report.service.js)
Öğrenci bazında aylık performans özeti. Periyodik olarak (cron job veya tetiklendiğinde) tüm öğrenciler için hesaplanabilir.
| Metod | Açıklama |
|---|---|
generateMonthlyReport |
Bir kullanıcı için belirli ay/yıl raporu üretir |
generateMonthlyReportsForAllUsers |
Tüm kullanıcılar için toplu rapor üretimi (batch işlem) |
getMonthlyReports |
Bir kullanıcının aylık raporlarını listeler |
getMonthlyReport |
Belirli bir ayın raporunu getirir |
Her ödev için o tarihe en yakın sınav girişi seçilir (pickBestExamForHomework) — ödev sonrası birden fazla deneme varsa en iyi skoru değil, zamanlamaya en yakın olanı alır.
4. Departman Ödev Raporu (department.homework.report.service.js)
Bir departmana gönderilen ödevlerin tamamlanma oranlarını gösterir.
5. Öğretmen Ödev Raporu (teacher.homework.report.service.js)
Öğretmenin gönderdiği ödevlerin durumunu öğrenci bazında takip etmesini sağlar.
Eksiklik Tespiti (wdeficiencies)
Modül: src/modules/wdeficiencies
Öğrencinin hangi kazanımlarda eksik olduğunu otomatik olarak hesaplar.
Algoritma
Her kazanım için sınav cevapları analiz edilir:
totalQuestions = kazanıma bağlı toplam soru sayısı
correctAnswers = doğru cevap sayısı
incorrectAnswers = yanlış cevap sayısı
errorRate = incorrectAnswers / totalQuestions
isDeficient = errorRate >= 0.20 VE totalQuestions >= 3
Eşik kuralı: %20 hata oranı. Ancak 3'ten az soru varsa değerlendirme yapılmaz — az veriyle yanlış alarm üretmemek için.
Metodlar
| Metod | Kapsam |
|---|---|
getStudentDeficiencies |
Öğrencinin tüm derslerindeki eksiklikler |
getStudentDeficienciesByLesson |
Tek ders kapsamında |
getContentRecommendations |
Eksik kazanım için izlenmesi önerilen içerikler |
getContentRecommendations, eksik kazanımın bağlı olduğu LessonSectionContentGain kayıtlarını ve o kazanımın video zaman aralıklarını döner — Eksiklik Öğretmeni bu veriyi kullanır.
Kazanım Raporları (gain)
Modül: src/modules/gain
Servis: src/modules/gain/services/gain.report.service.js
Departman ve okul genelinde kazanım çözüm oranlarını gösterir.
Metodlar
| Metod | Açıklama |
|---|---|
getDepartmentGainReports |
Bir departmanın (ve alt departmanlarının) kazanım çözüm oranları |
getAllDepartmentsGainReports |
Tüm departmanların özet karşılaştırması — sadece isSuperAdmin erişebilir |
getDepartmentGainReports şunları hesaplar:
- Departman ağacı yinelemeli olarak çözülür (tüm alt departmanlar dahil)
- Her kullanıcı, ders, konu ve kazanım için çözüm oranı hesaplanır
- Sonuç: kazanım bazında departman geneli başarı yüzdesi
Excel Export
wreport modülünde ExcelJS kütüphanesi kullanılarak bazı raporlar doğrudan .xlsx dosyası olarak indirilebilir. Bu özellik özellikle öğretmen ve yönetici raporlarında kullanılmaktadır.