breakpilot-lehrer/school-service/internal/services/grade_service_calc.go

package services

import (
	"context"
)

// =============================================
// STATISTICS METHODS
// =============================================

// ClassStatistics holds statistics for a class
type ClassStatistics struct {
	ClassID           string             `json:"class_id"`
	ClassName         string             `json:"class_name"`
	StudentCount      int                `json:"student_count"`
	ClassAverage      float64            `json:"class_average"`
	GradeDistribution map[string]int     `json:"grade_distribution"`
	BestGrade         float64            `json:"best_grade"`
	WorstGrade        float64            `json:"worst_grade"`
	PassRate          float64            `json:"pass_rate"`
	StudentsAtRisk    int                `json:"students_at_risk"`
	SubjectAverages   map[string]float64 `json:"subject_averages"`
}

// SubjectStatistics holds statistics for a subject within a class
type SubjectStatistics struct {
	ClassID           string          `json:"class_id"`
	SubjectID         string          `json:"subject_id"`
	SubjectName       string          `json:"subject_name"`
	StudentCount      int             `json:"student_count"`
	Average           float64         `json:"average"`
	Median            float64         `json:"median"`
	GradeDistribution map[string]int  `json:"grade_distribution"`
	BestGrade         float64         `json:"best_grade"`
	WorstGrade        float64         `json:"worst_grade"`
	PassRate          float64         `json:"pass_rate"`
	ExamAverages      []ExamAverage   `json:"exam_averages"`
}

// ExamAverage holds average for a single exam
type ExamAverage struct {
	ExamID   string  `json:"exam_id"`
	Title    string  `json:"title"`
	Average  float64 `json:"average"`
	ExamDate string  `json:"exam_date"`
}

// StudentStatistics holds statistics for a single student
type StudentStatistics struct {
	StudentID       string             `json:"student_id"`
	StudentName     string             `json:"student_name"`
	OverallAverage  float64            `json:"overall_average"`
	SubjectGrades   map[string]float64 `json:"subject_grades"`
	Trend           string             `json:"trend"` // "improving", "stable", "declining"
	AbsenceDays     int                `json:"absence_days"`
	ExamsCompleted  int                `json:"exams_completed"`
	StrongestSubject string            `json:"strongest_subject"`
	WeakestSubject   string            `json:"weakest_subject"`
}

// Notenspiegel represents grade distribution
type Notenspiegel struct {
	ClassID      string         `json:"class_id"`
	SubjectID    string         `json:"subject_id,omitempty"`
	ExamID       string         `json:"exam_id,omitempty"`
	Title        string         `json:"title"`
	Distribution map[string]int `json:"distribution"`
	Total        int            `json:"total"`
	Average      float64        `json:"average"`
	PassRate     float64        `json:"pass_rate"`
}

// GetClassStatistics returns statistics for a class
func (s *GradeService) GetClassStatistics(ctx context.Context, classID string, semester int) (*ClassStatistics, error) {
	stats := &ClassStatistics{
		ClassID:           classID,
		GradeDistribution: make(map[string]int),
		SubjectAverages:   make(map[string]float64),
	}

	// Initialize grade distribution
	for i := 1; i <= 6; i++ {
		stats.GradeDistribution[string('0'+rune(i))] = 0
	}

	// Get class info and student count
	err := s.db.QueryRow(ctx, `
		SELECT c.name, COUNT(s.id)
		FROM classes c
		LEFT JOIN students s ON s.class_id = c.id
		WHERE c.id = $1
		GROUP BY c.name
	`, classID).Scan(&stats.ClassName, &stats.StudentCount)
	if err != nil {
		return nil, err
	}

	// Build semester condition
	semesterCond := ""
	if semester > 0 {
		semesterCond = " AND go.semester = " + string('0'+rune(semester))
	}

	// Get overall statistics from grade_overview
	var avgGrade, bestGrade, worstGrade float64
	var totalPassed, totalStudents int
	err = s.db.QueryRow(ctx, `
		SELECT
			COALESCE(AVG(go.final_grade), 0),
			COALESCE(MIN(go.final_grade), 0),
			COALESCE(MAX(go.final_grade), 0),
			COUNT(CASE WHEN go.final_grade <= 4.0 THEN 1 END),
			COUNT(go.id)
		FROM grade_overview go
		JOIN students s ON s.id = go.student_id
		WHERE s.class_id = $1 AND go.final_grade IS NOT NULL`+semesterCond+`
	`, classID).Scan(&avgGrade, &bestGrade, &worstGrade, &totalPassed, &totalStudents)

	if err == nil {
		stats.ClassAverage = avgGrade
		stats.BestGrade = bestGrade
		stats.WorstGrade = worstGrade
		if totalStudents > 0 {
			stats.PassRate = float64(totalPassed) / float64(totalStudents) * 100
		}
	}

	// Get grade distribution
	rows, err := s.db.Query(ctx, `
		SELECT FLOOR(go.final_grade) as grade_bucket, COUNT(*) as count
		FROM grade_overview go
		JOIN students s ON s.id = go.student_id
		WHERE s.class_id = $1 AND go.final_grade IS NOT NULL`+semesterCond+`
		GROUP BY FLOOR(go.final_grade)
	`, classID)
	if err == nil {
		defer rows.Close()
		for rows.Next() {
			var bucket int
			var count int
			if err := rows.Scan(&bucket, &count); err == nil && bucket >= 1 && bucket <= 6 {
				stats.GradeDistribution[string('0'+rune(bucket))] = count
			}
		}
	}

	// Count students at risk
	s.db.QueryRow(ctx, `
		SELECT COUNT(DISTINCT s.id)
		FROM students s
		JOIN grade_overview go ON go.student_id = s.id
		WHERE s.class_id = $1 AND go.final_grade >= 4.5
	`, classID).Scan(&stats.StudentsAtRisk)

	// Get subject averages
	subjectRows, err := s.db.Query(ctx, `
		SELECT sub.name, AVG(go.final_grade)
		FROM grade_overview go
		JOIN subjects sub ON sub.id = go.subject_id
		JOIN students s ON s.id = go.student_id
		WHERE s.class_id = $1 AND go.final_grade IS NOT NULL`+semesterCond+`
		GROUP BY sub.name
	`, classID)
	if err == nil {
		defer subjectRows.Close()
		for subjectRows.Next() {
			var name string
			var avg float64
			if err := subjectRows.Scan(&name, &avg); err == nil {
				stats.SubjectAverages[name] = avg
			}
		}
	}

	return stats, nil
}

// GetSubjectStatistics returns statistics for a specific subject in a class
func (s *GradeService) GetSubjectStatistics(ctx context.Context, classID, subjectID string, semester int) (*SubjectStatistics, error) {
	stats := &SubjectStatistics{
		ClassID:           classID,
		SubjectID:         subjectID,
		GradeDistribution: make(map[string]int),
		ExamAverages:      []ExamAverage{},
	}

	// Initialize grade distribution
	for i := 1; i <= 6; i++ {
		stats.GradeDistribution[string('0'+rune(i))] = 0
	}

	// Get subject name and basic stats
	semesterCond := ""
	if semester > 0 {
		semesterCond = " AND go.semester = " + string('0'+rune(semester))
	}

	err := s.db.QueryRow(ctx, `
		SELECT
			sub.name,
			COUNT(DISTINCT s.id),
			COALESCE(AVG(go.final_grade), 0),
			COALESCE(MIN(go.final_grade), 0),
			COALESCE(MAX(go.final_grade), 0),
			COUNT(CASE WHEN go.final_grade <= 4.0 THEN 1 END),
			COUNT(go.id)
		FROM grade_overview go
		JOIN subjects sub ON sub.id = go.subject_id
		JOIN students s ON s.id = go.student_id
		WHERE s.class_id = $1 AND go.subject_id = $2 AND go.final_grade IS NOT NULL`+semesterCond+`
		GROUP BY sub.name
	`, classID, subjectID).Scan(
		&stats.SubjectName, &stats.StudentCount, &stats.Average,
		&stats.BestGrade, &stats.WorstGrade,
		new(int), new(int), // We'll calculate pass rate separately
	)
	if err != nil {
		return nil, err
	}

	// Get grade distribution
	rows, err := s.db.Query(ctx, `
		SELECT FLOOR(go.final_grade), COUNT(*)
		FROM grade_overview go
		JOIN students s ON s.id = go.student_id
		WHERE s.class_id = $1 AND go.subject_id = $2 AND go.final_grade IS NOT NULL`+semesterCond+`
		GROUP BY FLOOR(go.final_grade)
	`, classID, subjectID)
	if err == nil {
		defer rows.Close()
		var passed, total int
		for rows.Next() {
			var bucket, count int
			if err := rows.Scan(&bucket, &count); err == nil && bucket >= 1 && bucket <= 6 {
				stats.GradeDistribution[string('0'+rune(bucket))] = count
				total += count
				if bucket <= 4 {
					passed += count
				}
			}
		}
		if total > 0 {
			stats.PassRate = float64(passed) / float64(total) * 100
		}
	}

	// Get exam averages
	examRows, err := s.db.Query(ctx, `
		SELECT e.id, e.title, AVG(er.grade), COALESCE(e.exam_date::text, '')
		FROM exams e
		JOIN exam_results er ON er.exam_id = e.id
		JOIN students s ON er.student_id = s.id
		WHERE s.class_id = $1 AND e.subject_id = $2 AND er.grade IS NOT NULL
		GROUP BY e.id, e.title, e.exam_date
		ORDER BY e.exam_date DESC NULLS LAST
	`, classID, subjectID)
	if err == nil {
		defer examRows.Close()
		for examRows.Next() {
			var ea ExamAverage
			if err := examRows.Scan(&ea.ExamID, &ea.Title, &ea.Average, &ea.ExamDate); err == nil {
				stats.ExamAverages = append(stats.ExamAverages, ea)
			}
		}
	}

	return stats, nil
}

// GetStudentStatistics returns statistics for a specific student
func (s *GradeService) GetStudentStatistics(ctx context.Context, studentID string) (*StudentStatistics, error) {
	stats := &StudentStatistics{
		StudentID:     studentID,
		SubjectGrades: make(map[string]float64),
	}

	// Get student name
	err := s.db.QueryRow(ctx, `
		SELECT CONCAT(first_name, ' ', last_name) FROM students WHERE id = $1
	`, studentID).Scan(&stats.StudentName)
	if err != nil {
		return nil, err
	}

	// Get subject grades and calculate overall average
	var totalGrade, numSubjects float64
	var bestGrade float64 = 6
	var worstGrade float64 = 1
	var bestSubject, worstSubject string

	rows, err := s.db.Query(ctx, `
		SELECT sub.name, go.final_grade
		FROM grade_overview go
		JOIN subjects sub ON sub.id = go.subject_id
		WHERE go.student_id = $1 AND go.final_grade IS NOT NULL
		ORDER BY sub.name
	`, studentID)
	if err != nil {
		return nil, err
	}
	defer rows.Close()

	for rows.Next() {
		var name string
		var grade float64
		if err := rows.Scan(&name, &grade); err == nil {
			stats.SubjectGrades[name] = grade
			totalGrade += grade
			numSubjects++
			if grade < bestGrade {
				bestGrade = grade
				bestSubject = name
			}
			if grade > worstGrade {
				worstGrade = grade
				worstSubject = name
			}
		}
	}

	if numSubjects > 0 {
		stats.OverallAverage = totalGrade / numSubjects
		stats.StrongestSubject = bestSubject
		stats.WeakestSubject = worstSubject
	}

	// Count exams completed
	s.db.QueryRow(ctx, `
		SELECT COUNT(*) FROM exam_results WHERE student_id = $1 AND grade IS NOT NULL
	`, studentID).Scan(&stats.ExamsCompleted)

	// Count absence days
	s.db.QueryRow(ctx, `
		SELECT COALESCE(SUM(periods), 0) FROM attendance
		WHERE student_id = $1 AND status IN ('absent_excused', 'absent_unexcused')
	`, studentID).Scan(&stats.AbsenceDays)

	// Determine trend (simplified - compare first and last exam grades)
	stats.Trend = "stable"
	var firstGrade, lastGrade float64
	s.db.QueryRow(ctx, `
		SELECT grade FROM exam_results
		WHERE student_id = $1 AND grade IS NOT NULL
		ORDER BY created_at ASC LIMIT 1
	`, studentID).Scan(&firstGrade)
	s.db.QueryRow(ctx, `
		SELECT grade FROM exam_results
		WHERE student_id = $1 AND grade IS NOT NULL
		ORDER BY created_at DESC LIMIT 1
	`, studentID).Scan(&lastGrade)

	if lastGrade < firstGrade-0.5 {
		stats.Trend = "improving"
	} else if lastGrade > firstGrade+0.5 {
		stats.Trend = "declining"
	}

	return stats, nil
}

// GetNotenspiegel returns grade distribution (Notenspiegel)
func (s *GradeService) GetNotenspiegel(ctx context.Context, classID, subjectID, examID string, semester int) (*Notenspiegel, error) {
	ns := &Notenspiegel{
		ClassID:      classID,
		SubjectID:    subjectID,
		ExamID:       examID,
		Distribution: make(map[string]int),
	}

	// Initialize distribution
	for i := 1; i <= 6; i++ {
		ns.Distribution[string('0'+rune(i))] = 0
	}

	var query string
	var args []interface{}

	if examID != "" {
		// Notenspiegel for specific exam
		query = `
			SELECT e.title, FLOOR(er.grade), COUNT(*), AVG(er.grade)
			FROM exam_results er
			JOIN exams e ON e.id = er.exam_id
			WHERE er.exam_id = $1 AND er.grade IS NOT NULL
			GROUP BY e.title, FLOOR(er.grade)
		`
		args = []interface{}{examID}
	} else if subjectID != "" {
		// Notenspiegel for subject in class
		semesterCond := ""
		if semester > 0 {
			semesterCond = " AND go.semester = " + string('0'+rune(semester))
		}
		query = `
			SELECT sub.name, FLOOR(go.final_grade), COUNT(*), AVG(go.final_grade)
			FROM grade_overview go
			JOIN subjects sub ON sub.id = go.subject_id
			JOIN students s ON s.id = go.student_id
			WHERE s.class_id = $1 AND go.subject_id = $2 AND go.final_grade IS NOT NULL` + semesterCond + `
			GROUP BY sub.name, FLOOR(go.final_grade)
		`
		args = []interface{}{classID, subjectID}
	} else {
		// Notenspiegel for entire class
		semesterCond := ""
		if semester > 0 {
			semesterCond = " AND go.semester = " + string('0'+rune(semester))
		}
		query = `
			SELECT c.name, FLOOR(go.final_grade), COUNT(*), AVG(go.final_grade)
			FROM grade_overview go
			JOIN students s ON s.id = go.student_id
			JOIN classes c ON c.id = s.class_id
			WHERE s.class_id = $1 AND go.final_grade IS NOT NULL` + semesterCond + `
			GROUP BY c.name, FLOOR(go.final_grade)
		`
		args = []interface{}{classID}
	}

	rows, err := s.db.Query(ctx, query, args...)
	if err != nil {
		return nil, err
	}
	defer rows.Close()

	var passed int
	for rows.Next() {
		var title string
		var bucket, count int
		var avg float64
		if err := rows.Scan(&title, &bucket, &count, &avg); err == nil {
			ns.Title = title
			if bucket >= 1 && bucket <= 6 {
				ns.Distribution[string('0'+rune(bucket))] = count
				ns.Total += count
				if bucket <= 4 {
					passed += count
				}
			}
			ns.Average = avg
		}
	}

	if ns.Total > 0 {
		ns.PassRate = float64(passed) / float64(ns.Total) * 100
	}

	return ns, nil
}