<?php

namespace App\Models;

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

class FinalExamModel extends Model
{
    use SchoolYearAutoFillTrait;

    protected $table            = 'final_exam';
    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', 
        'score', 
        '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    = [];

    public function getFinalExamScore($studentId, string $semester, $schoolYear, ?int $classSectionId = null)
    {
        $builder = $this->select('score')
            ->where('student_id', $studentId)
            ->where('semester', $semester)
            ->where('school_year', $schoolYear);

        if ($classSectionId !== null) {
            $builder->where('class_section_id', $classSectionId);
        }

        $result = $builder->first();

        return $result ? $result['score'] : null;
    }
}