<?php

namespace App\Models;

use CodeIgniter\Model;
use App\Models\Concerns\SchoolYearAutoFillTrait;

class QuizModel extends Model
{
    use SchoolYearAutoFillTrait;

    protected $table            = 'quiz';
    protected $primaryKey       = 'id';
    protected $useAutoIncrement = true;
    protected $returnType       = 'array';
    protected $useSoftDeletes   = false;
    protected $protectFields    = true;
    protected $allowedFields    = [
        'student_id',
        'school_id', 
        'class_section_id', 
        'updated_by',
        'quiz_index', 
        'score', 
        'comment', 
        'semester', 
        'school_year', 
        'created_at', 
        'updated_at'
    ];

    protected bool $allowEmptyInserts = false;
    protected bool $updateOnlyChanged = true;

    protected array $casts = [];
    protected array $castHandlers = [];

    // Dates
    protected $useTimestamps = false;
    protected $dateFormat    = 'datetime';
    protected $createdField  = 'created_at';
    protected $updatedField  = 'updated_at';
    protected $deletedField  = 'deleted_at';

    // Validation
    protected $validationRules      = [        'school_year' => 'required|string|max_length[9]',
];
    protected $validationMessages   = [];
    protected $skipValidation       = false;
    protected $cleanValidationRules = true;

    // Callbacks
    protected $allowCallbacks = true;
    protected $beforeInsert   = [];
    protected $afterInsert    = [];
    protected $beforeUpdate   = [];
    protected $afterUpdate    = [];
    protected $beforeFind     = [];
    protected $afterFind      = [];
    protected $beforeDelete   = [];
    protected $afterDelete    = [];


    /**
     * Calculate the average quiz score for a given student, semester, and school year.
     *
     * @param int $studentId The student's ID.
     * @param string $semester The semester (e.g., 'Fall', 'Spring').
     * @param string $schoolYear The school year (e.g., '2024-2025').
     * @param int|null $classSectionId Optional class section filter.
     * @return float|null The average quiz score, or null if no scores are found.
     */
    public function getAverageQuizScore(int $studentId, string $semester, string $schoolYear, ?int $classSectionId = null): ?float
    {
        // Fetch the quiz scores for the given student, semester, and school year
        $builder = $this->builder();
        $builder->select('score')
                ->where('student_id', $studentId)
                ->where('semester', $semester)
                ->where('school_year', $schoolYear);

        if ($classSectionId !== null) {
            $builder->where('class_section_id', $classSectionId);
        }
        
        // Execute the query and get the results
        $query = $builder->get();
        $results = $query->getResultArray();

        // If there are no scores, return null
        if (empty($results)) {
            return null;
        }

        // Calculate the average score (ignore blank/null/non-numeric)
        $totalScore = 0.0;
        $scoreCount = 0;

        foreach ($results as $result) {
            $score = $result['score'] ?? null;
            if ($score === null || (is_string($score) && trim($score) === '') || $score === '' || !is_numeric($score)) {
                continue;
            }
            $totalScore += (float) $score;
            $scoreCount++;
        }

        if ($scoreCount === 0) {
            return null;
        }

        return $totalScore / $scoreCount;
    }
}