'integer', 'class_section_id' => 'integer', 'school_id' => 'integer', 'student_id' => 'integer', 'modified_by' => 'integer', ]; /* ========================= * Relationships (optional) * ========================= */ public function student() { return $this->belongsTo(Student::class, 'student_id'); } public function classSection() { return $this->belongsTo(ClassSection::class, 'class_section_id'); } /* ========================= * DATETIME helpers * ========================= */ private static function dayRange(string $day): array { $day = substr($day, 0, 10); // YYYY-MM-DD $start = $day; $endEx = Carbon::parse($day)->addDay()->toDateString(); // exclusive return [$start, $endEx]; } /* ========================= * legacy method equivalents * ========================= */ /** * Retrieve attendance by class and section for a specific date (DATETIME-safe). */ public static function getAttendanceByClass(int $classId, int $classSectionId, string $date) { [$start, $endEx] = static::dayRange($date); return static::query() ->where('class_id', $classId) ->where('class_section_id', $classSectionId) ->where('date', '>=', $start) ->where('date', '<', $endEx) ->get(); } /** * Update attendance record by PK. */ public static function updateAttendance(int $attendanceId, array $data): bool { $affected = static::query()->whereKey($attendanceId)->update($data); return $affected >= 0; } /** * Retrieve attendance for a specific student, class section, and date (DATETIME-safe). */ public static function getAttendance(int $studentId, int $classSectionId, string $date): ?self { [$start, $endEx] = static::dayRange($date); return static::query() ->where('student_id', $studentId) ->where('class_section_id', $classSectionId) ->where('date', '>=', $start) ->where('date', '<', $endEx) ->first(); } /** * Retrieve reported attendance for a specific date or range (DATETIME-safe). */ public static function getReportedAttendance(string $startDate, ?string $endDate = null) { $q = static::query(); static::applyReportedFilter($q); [$start] = static::dayRange($startDate); if ($endDate) { [, $endEx] = static::dayRange($endDate); // end exclusive of next day $q->where('date', '>=', $start)->where('date', '<', $endEx); } else { [, $endEx] = static::dayRange($startDate); $q->where('date', '>=', $start)->where('date', '<', $endEx); } return $q->get(); } public static function getTodayAbsentees(?int $classSectionId = null, ?string $schoolYear = null, ?string $semester = null) { [$start, $endEx] = [now()->startOfDay(), now()->addDay()->startOfDay()]; $q = static::query() ->where('date', '>=', $start) ->where('date', '<', $endEx) ->where(function ($w) { $w->whereIn(DB::raw('UPPER(TRIM(status))'), ['ABSENT', 'ABS', 'A']) ->orWhereRaw("UPPER(TRIM(status)) LIKE 'ABS%'"); }); if ($classSectionId !== null) { $q->where('class_section_id', $classSectionId); } if ($schoolYear !== null) { $q->where('school_year', $schoolYear); } if ($semester !== null) { $q->where('semester', $semester); } return $q->get(); } public static function getTodayLates(?int $classSectionId = null, ?string $schoolYear = null, ?string $semester = null) { [$start, $endEx] = [now()->startOfDay(), now()->addDay()->startOfDay()]; $q = static::query() ->where('date', '>=', $start) ->where('date', '<', $endEx) ->where(function ($w) { $w->whereIn(DB::raw('UPPER(TRIM(status))'), ['LATE', 'L']) ->orWhereRaw("UPPER(TRIM(status)) LIKE 'LATE%'"); }); if ($classSectionId !== null) { $q->where('class_section_id', $classSectionId); } if ($schoolYear !== null) { $q->where('school_year', $schoolYear); } if ($semester !== null) { $q->where('semester', $semester); } return $q->get(); } public static function getAbsencesByClassSection(int $classSectionId, string $schoolYear, string $semester) { return static::query() ->where('class_section_id', $classSectionId) ->where('school_year', $schoolYear) ->where('semester', $semester) ->where(function ($w) { $w->whereIn(DB::raw('UPPER(TRIM(status))'), ['ABSENT', 'ABS', 'A']) ->orWhereRaw("UPPER(TRIM(status)) LIKE 'ABS%'"); }) ->orderByDesc('date') ->get(); } /** * Fetch attendance rows for a student, optionally filtered by date range. * Note: Uses inclusive date range by day using datetime bounds. */ public static function getStudentAttendance( int $studentId, ?string $startDate = null, ?string $endDate = null, ?string $schoolYear = null, ?string $semester = null ) { $q = static::query()->where('student_id', $studentId); if (! empty($startDate)) { [$start] = static::dayRange($startDate); $q->where('date', '>=', $start); } if (! empty($endDate)) { [, $endEx] = static::dayRange($endDate); $q->where('date', '<', $endEx); } if (! empty($schoolYear)) { $q->where('school_year', $schoolYear); } if (! empty($semester)) { $q->where('semester', $semester); } return $q->orderByDesc('date')->get(); } /** * Convenience: attendance for an exact date (DATETIME-safe). */ public static function getStudentAttendanceOnDate(int $studentId, string $date): ?self { [$start, $endEx] = static::dayRange($date); return static::query() ->where('student_id', $studentId) ->where('date', '>=', $start) ->where('date', '<', $endEx) ->first(); } /** * Unreported rows for students in term. */ public static function unreportedTermRows(array $studentIds, string $schoolYear, ?string $semester) { $q = static::query() ->select(['id', 'student_id', 'class_id', 'class_section_id', 'date', 'status', 'reason', 'school_year', 'semester', 'is_reported']) ->where('school_year', $schoolYear); if ($semester !== null && $semester !== '') { $q->where('semester', $semester); } if (! empty($studentIds)) { $q->whereIn('student_id', array_map('intval', $studentIds)); } static::applyUnreportedFilter($q); return $q->orderByDesc('date')->get(); } /** * NOT-REPORTED absences/lates for ALL students in optional term filters. * Returns grouped array: [student_id => ['absences'=>[], 'lates'=>[], 'counts'=>...]] */ public static function getUnreportedAbsencesAndLates(?string $schoolYear = null, ?string $semester = null): array { $q = static::query() ->select(['id', 'student_id', 'class_id', 'class_section_id', 'date', 'status', 'reason', 'school_year', 'semester', 'is_reported']); static::applyUnreportedFilter($q); // Not notified yet: supports 0/'0'/NULL and string enums like 'yes' $q->where(function ($w) { $w->whereNull('is_notified') ->orWhere('is_notified', 0) ->orWhere('is_notified', '0') ->orWhereRaw("LOWER(TRIM(COALESCE(is_notified, ''))) != 'yes'"); }); if (! empty($schoolYear)) { $q->where('school_year', $schoolYear); } if (! empty($semester)) { $q->where('semester', $semester); } // Status filter: exact + prefixes (ABS_3, LATE_2, etc.) $q->where(function ($w) { $w->whereIn(DB::raw('UPPER(TRIM(status))'), ['ABS', 'ABSENT', 'LATE', 'A', 'L']) ->orWhereRaw("UPPER(TRIM(status)) LIKE 'ABS%'") ->orWhereRaw("UPPER(TRIM(status)) LIKE 'LATE%'"); }); $rows = $q->orderBy('student_id')->orderByDesc('date')->get()->toArray(); $out = []; foreach ($rows as $r) { $sid = (int) ($r['student_id'] ?? 0); if (! isset($out[$sid])) { $out[$sid] = [ 'absences' => [], 'lates' => [], 'counts' => ['absences' => 0, 'lates' => 0, 'total' => 0], ]; } $st = strtoupper(trim((string) ($r['status'] ?? ''))); $isAbs = ($st === 'ABS' || $st === 'ABSENT' || $st === 'A' || str_starts_with($st, 'ABS')); $isLate = ($st === 'LATE' || $st === 'L' || str_starts_with($st, 'LATE')); $rec = [ 'id' => $r['id'] ?? null, 'date' => $r['date'] ?? null, 'status' => $r['status'] ?? null, 'reason' => $r['reason'] ?? null, 'class_id' => $r['class_id'] ?? null, 'class_section_id' => $r['class_section_id'] ?? null, 'school_year' => $r['school_year'] ?? null, 'semester' => $r['semester'] ?? null, ]; if ($isAbs) { $out[$sid]['absences'][] = $rec; $out[$sid]['counts']['absences']++; } elseif ($isLate) { $out[$sid]['lates'][] = $rec; $out[$sid]['counts']['lates']++; } $out[$sid]['counts']['total'] = $out[$sid]['counts']['absences'] + $out[$sid]['counts']['lates']; } return $out; } /** * Mark rule as notified for a student on a specific day (DATETIME-safe). */ public static function markRuleAsNotifiedData( int $studentId, string $date, ?string $semester = null, ?string $schoolYear = null ): bool { [$start, $endEx] = static::dayRange($date); $q = static::query() ->where('student_id', $studentId) ->where('date', '>=', $start) ->where('date', '<', $endEx); if (! empty($semester)) { $q->where('semester', $semester); } if (! empty($schoolYear)) { $q->where('school_year', $schoolYear); } $affected = $q->update([ 'is_notified' => 'yes', 'updated_at' => now(), ]); return $affected >= 0; } /** * Mark specific attendance dates as reported + notified for a student (DATETIME index-friendly). */ public static function markReportedAndNotified(int $studentId, array $dates, ?string $semester = null, ?string $schoolYear = null): bool { $dates = array_values(array_unique(array_filter($dates, static function ($d) { return is_string($d) && preg_match('/^\d{4}-\d{2}-\d{2}$/', $d); }))); if (empty($dates)) { return true; } $q = static::query() ->where('student_id', $studentId) ->whereRaw("LOWER(TRIM(status)) IN ('absent','late')"); if (! empty($semester)) { $q->where('semester', $semester); } if (! empty($schoolYear)) { $q->where('school_year', $schoolYear); } // OR day ranges instead of DATE(date) $q->where(function ($w) use ($dates) { foreach ($dates as $d) { [$start, $endEx] = static::dayRange($d); $w->orWhere(function ($x) use ($start, $endEx) { $x->where('date', '>=', $start)->where('date', '<', $endEx); }); $w->orWhere('date', $d); } }); $payload = [ 'updated_at' => now(), 'is_notified' => 'yes', ]; $cols = static::reportedColumns(); if (! empty($cols['is_reported'])) { $payload['is_reported'] = 'yes'; } if (! empty($cols['reported'])) { $payload['reported'] = 1; } $affected = $q->update($payload); return $affected >= 0; } /** * Fetch unreported dates for a student within N days for the given status set (DATETIME-safe). */ public static function getRecentUnreportedDates( int $studentId, array $statuses, ?string $incidentDate = null, int $lookbackDays = 35, ?string $semester = null, ?string $schoolYear = null ): array { if ($studentId <= 0 || empty($statuses)) { return []; } $statuses = array_map('strtolower', $statuses); $day = ($incidentDate && preg_match('/^\d{4}-\d{2}-\d{2}$/', $incidentDate)) ? $incidentDate : now()->toDateString(); $startDay = Carbon::parse($day)->subDays(max(0, $lookbackDays))->toDateString(); [$start] = static::dayRange($startDay); [, $endEx] = static::dayRange($day); $q = static::query() ->select('date') ->where('student_id', $studentId) ->where('date', '>=', $start) ->where('date', '<', $endEx) ->whereIn(DB::raw('LOWER(TRIM(status))'), $statuses); static::applyUnreportedFilter($q); if (! empty($semester)) { $q->where('semester', $semester); } if (! empty($schoolYear)) { $q->where('school_year', $schoolYear); } $rows = $q->orderByDesc('date')->pluck('date')->all(); return array_values(array_unique(array_map(static function ($d) { return substr((string) $d, 0, 10); // YYYY-MM-DD }, $rows))); } /* ========================= * Filters / schema helpers * ========================= */ private static function reportedColumns(): array { static $cache = null; if ($cache !== null) { return $cache; } $table = (new static)->getTable(); $cache = [ 'is_reported' => static::columnExists($table, 'is_reported'), 'reported' => static::columnExists($table, 'reported'), ]; return $cache; } private static function columnExists(string $table, string $column): bool { try { return DB::connection() ->getSchemaBuilder() ->hasColumn($table, $column); } catch (\Throwable) { return false; } } /** * Not-reported filter: * - is_reported = 'no' OR 0 OR NULL (if column exists) * - legacy 'reported' column: treat values yes/1/true/on as reported, so exclude those */ private static function applyUnreportedFilter($q): void { $cols = static::reportedColumns(); if (! empty($cols['is_reported'])) { $q->where(function ($w) { $w->whereNull('is_reported') ->orWhere('is_reported', 0) ->orWhere('is_reported', '0') ->orWhereRaw("LOWER(TRIM(COALESCE(is_reported, ''))) = 'no'"); }); } if (! empty($cols['reported'])) { $q->whereRaw("(LOWER(TRIM(COALESCE(reported, ''))) NOT IN ('yes','1','true','y','on'))"); } } /** * Reported filter best-effort (used by getReportedAttendance()). */ private static function applyReportedFilter($q): void { $q->where(function ($w) { $w->where('is_reported', 1) ->orWhere('is_reported', '1') ->orWhereRaw("LOWER(TRIM(COALESCE(is_reported, ''))) = 'yes'"); }); } }