add projet

app/Models/Quiz.php

@@ -0,0 +1,95 @@
+<?php
+
+namespace App\Models;
+
+use App\Models\BaseModel;
+
+class Quiz extends BaseModel
+{
+    protected $table = 'quiz';
+    protected $primaryKey       = 'id';
+    protected $useAutoIncrement = true;
+    protected $useSoftDeletes   = false;
+    protected $protectFields    = true;
+    protected $fillable = [
+        '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 $casts = [];
+    protected $castHandlers = [];
+
+    // Dates
+    public $timestamps = true;
+    protected $dateFormat    = 'datetime';
+    const CREATED_AT = 'created_at';
+    const UPDATED_AT = 'updated_at';
+    protected $deletedField  = 'deleted_at';
+
+    // Validation
+    protected $validationRules      = [];
+    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').
+     * @return float The average quiz score, or 0 if no scores are found.
+     */
+    public function getAverageQuizScore(int $studentId, string $semester, string $schoolYear): 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);
+        
+        // Execute the query and get the results
+        $query = $builder->get();
+        $results = $query->getResultArray();
+
+        // If there are no scores, return 0
+        if (empty($results)) {
+            return 0.0;
+        }
+
+        // Calculate the average score
+        $totalScore = 0;
+        $scoreCount = count($results);
+
+        foreach ($results as $result) {
+            $totalScore += $result['score'];
+        }
+
+        return $totalScore / $scoreCount;
+    }
+}