recreate project

app/Models/WhatsappGroupLinkModel.php

@@ -0,0 +1,146 @@
+<?php namespace App\Models;
+
+use CodeIgniter\Model;
+
+class WhatsappGroupLinkModel extends Model
+{
+    protected $table         = 'whatsapp_group_links';
+    protected $primaryKey    = 'id';
+    protected $returnType    = 'array';
+    protected $allowedFields = [
+        'class_section_id',
+        'class_section_name',
+        'school_year',
+        'semester',
+        'invite_link',
+        'active',
+    ];
+    protected $useTimestamps = true; // requires created_at / updated_at columns
+
+    /**
+     * Get the link for a specific section in a specific term.
+     *
+     * @param int    $sectionId          Class/section code (not PK).
+     * @param string $year               School year, e.g. "2025-2026".
+     * @param string $sem                Semester, e.g. "Fall".
+     * @param bool   $onlyActive         If true, require active=1.
+     * @param bool   $allowNullSemester  If true, accept rows with semester IS NULL as well.
+     */
+    public function getLinkForSection(
+        int $sectionId,
+        string $year,
+        string $sem,
+        bool $onlyActive = true,
+        bool $allowNullSemester = false
+    ): ?array {
+        $year = trim($year);
+        $sem  = trim($sem);
+
+        $b = $this->asArray()
+            ->where('class_section_id', $sectionId)
+            ->where('school_year', $year);
+
+        if ($sem !== '') {
+            if ($allowNullSemester) {
+                $b = $b->groupStart()
+                        ->where('semester', $sem)
+                        ->orWhere('semester IS NULL', null, false)
+                     ->groupEnd();
+            } else {
+                $b = $b->where('semester', $sem);
+            }
+        }
+
+        if ($onlyActive) {
+            $b = $b->where('active', 1);
+        }
+
+        // If you also want to ignore blank links:
+        $b = $b->where('invite_link IS NOT NULL', null, false)
+               ->where('invite_link !=', '');
+
+        return $b->orderBy('updated_at', 'DESC')
+                 ->orderBy('id', 'DESC')
+                 ->first() ?: null;
+    }
+
+    /**
+     * Get all links for a term.
+     *
+     * @param string   $year
+     * @param string   $sem
+     * @param bool|null $onlyActive  true: active only, false: inactive only, null: both
+     * @param bool     $allowNullSemester  If true, include rows with semester IS NULL.
+     */
+    public function getAllForTerm(
+        string $year,
+        string $sem,
+        ?bool $onlyActive = null,
+        bool $allowNullSemester = false
+    ): array {
+        $year = trim($year);
+        $sem  = trim($sem);
+
+        $b = $this->asArray()
+            ->where('school_year', $year);
+
+        if ($sem !== '') {
+            if ($allowNullSemester) {
+                $b = $b->groupStart()
+                        ->where('semester', $sem)
+                        ->orWhere('semester IS NULL', null, false)
+                     ->groupEnd();
+            } else {
+                $b = $b->where('semester', $sem);
+            }
+        }
+
+        if ($onlyActive === true) {
+            $b = $b->where('active', 1);
+        } elseif ($onlyActive === false) {
+            $b = $b->where('active', 0);
+        }
+
+        return $b->orderBy('updated_at', 'DESC')
+                 ->orderBy('id', 'DESC')
+                 ->findAll();
+    }
+
+    /**
+     * Convenience: upsert a link row for a section/term.
+     * Returns the row (array) after save.
+     */
+    public function upsertLinkForSection(
+        int $sectionId,
+        string $sectionName,
+        string $year,
+        string $sem,
+        string $inviteLink,
+        bool $active = true
+    ): array {
+        $payload = [
+            'class_section_id'   => $sectionId,
+            'class_section_name' => $sectionName,
+            'school_year'        => trim($year),
+            'semester'           => trim($sem),
+            'invite_link'        => trim($inviteLink),
+            'active'             => $active ? 1 : 0,
+        ];
+
+        // Try to find existing row (exact term)
+        $existing = $this->asArray()
+            ->where('class_section_id', $sectionId)
+            ->where('school_year', $payload['school_year'])
+            ->where('semester', $payload['semester'])
+            ->first();
+
+        if ($existing) {
+            $this->update((int)$existing['id'], $payload);
+            $id = (int) $existing['id'];
+        } else {
+            $id = $this->insert($payload, true);
+        }
+
+        return $this->find($id) ?? $payload;
+    }
+}