add projet

2026-03-05 12:29:37 -05:00
parent 8d1eef8ba8
commit 23b7db1107
9109 changed files with 1106501 additions and 73 deletions
@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Models;
+
+use App\Models\BaseModel;
+
+class Refund extends BaseModel
+{
+    protected $table = 'refunds';
+    protected $primaryKey = 'id';
+    protected $fillable = [
+        'parent_id',
+        'school_year',
+        'invoice_id',
+        'refund_amount',
+        'requested_at',
+        'approved_at',
+        'refunded_at',
+        'status',
+        'reason',
+        'refund_paid_amount',
+        'request',
+        'note',
+        'approved_by',
+        'updated_by',
+        'refund_method',
+        'check_nbr',
+        'check_file',
+        'created_at',
+        'updated_at',
+        'semester',
+    ];
+    public $timestamps = true;
+    const CREATED_AT = 'created_at';
+    const UPDATED_AT = 'updated_at';
+
+    /**
+     * Get total approved refund for a parent in a specific school year.
+     *
+     * @param int $parentId
+     * @param string $schoolYear
+     * @return float
+     */
+    public function getTotalApprovedRefundByParentIdAndSchoolYear(int $parentId, string $schoolYear): float
+    {
+        // Sum refunds that have been at least partially paid out to the parent
+        $result = $this->selectSum('refund_paid_amount', 'total_paid')
+            ->where('parent_id', $parentId)
+            ->where('school_year', $schoolYear)
+            ->whereIn('status', ['Partial', 'Paid'])
+            ->get()
+            ->getRowArray();
+
+        return $result && isset($result['total_paid']) ? (float) $result['total_paid'] : 0.00;
+    }
+}