add whatsup logic

2026-03-10 16:31:35 -04:00
parent 20ee70d153
commit 3bf4c687da
33 changed files with 2800 additions and 1329 deletions
@@ -0,0 +1,102 @@
+<?php
+
+namespace App\Services\Whatsapp;
+
+use App\Models\Configuration;
+use App\Models\StudentClass;
+
+class WhatsappContextService
+{
+    /** @var array<string,bool> */
+    private array $rosterPresenceCache = [];
+
+    public function schoolYear(?string $override = null): string
+    {
+        $override = trim((string) $override);
+        if ($override !== '') {
+            return $override;
+        }
+
+        return trim((string) (Configuration::getConfig('school_year') ?? ''));
+    }
+
+    public function semester(?string $override = null): string
+    {
+        $override = trim((string) $override);
+        if ($override !== '') {
+            return $override;
+        }
+
+        return trim((string) (Configuration::getConfig('semester') ?? ''));
+    }
+
+    /**
+     * School-year aliases like 2025-2026, 2025/2026, 2025-26, 2025.
+     *
+     * @return array{0: array<int,string>, 1: string, 2: int}
+     */
+    public function schoolYearAliases(string $schoolYear): array
+    {
+        $trim = trim($schoolYear);
+        $normalized = str_replace(["\u{2013}", "\u{2014}", '/'], '-', $trim);
+
+        if (preg_match('/\b(20\d{2})\b/', $normalized, $m)) {
+            $start = (int) $m[1];
+        } else {
+            $start = (int) date('Y');
+        }
+
+        $end = $start + 1;
+        $canonical = $start . '-' . $end;
+
+        $aliases = [
+            $canonical,
+            $start . '/' . $end,
+            sprintf('%d-%02d', $start, $end % 100),
+            (string) $start,
+        ];
+
+        return [array_values(array_unique($aliases)), $canonical, $start];
+    }
+
+    /**
+     * Semester aliases for filtering.
+     *
+     * @return array<int,string>
+     */
+    public function semesterAliases(string $semester): array
+    {
+        $s = strtolower(trim($semester));
+        if ($s === 'fall') {
+            return ['fall', 'sem1', 'semester 1', '1', 'f'];
+        }
+        if ($s === 'spring') {
+            return ['spring', 'sem2', 'semester 2', '2', 's'];
+        }
+        if ($s === 'summer') {
+            return ['summer', 'sem3', '3'];
+        }
+
+        return $s === '' ? [] : [$s];
+    }
+
+    public function hasRosterForYear(string $schoolYear): bool
+    {
+        $year = trim($schoolYear);
+        if ($year === '') {
+            return false;
+        }
+
+        if (array_key_exists($year, $this->rosterPresenceCache)) {
+            return $this->rosterPresenceCache[$year];
+        }
+
+        $exists = StudentClass::query()
+            ->where('school_year', $year)
+            ->exists();
+
+        $this->rosterPresenceCache[$year] = $exists;
+
+        return $exists;
+    }
+}