update controllers logic

2026-04-23 00:04:35 -04:00
parent 1977a513df
commit ca4ba272fc
353 changed files with 13402 additions and 1301 deletions
@@ -2,6 +2,169 @@

 namespace App\Services\AttendanceTracking;

+use Illuminate\Support\Facades\Validator;
+
+/**
+ * Facade used by {@see \App\Http\Controllers\Api\AttendanceTracking\AttendanceTrackingController}.
+ */
 class AttendanceTrackingService
 {
+    public function __construct(
+        protected AttendancePendingViolationService $pendingViolationService,
+        protected AttendanceCaseQueryService $caseQueryService,
+        protected AttendanceNotificationWorkflowService $workflowService,
+        protected AttendanceCommunicationSupportService $communicationSupportService,
+    ) {
+    }
+
+    protected function defaultSchoolYear(): string
+    {
+        return (string) (Configuration::getConfig('school_year') ?? '');
+    }
+
+    protected function defaultSemester(): string
+    {
+        return (string) (Configuration::getConfig('semester') ?? '');
+    }
+
+    public function getPendingViolations(?string $schoolYearParam, ?string $semesterParam): array
+    {
+        return $this->pendingViolationService->getPendingViolations(
+            $this->defaultSchoolYear(),
+            $schoolYearParam,
+            $semesterParam
+        );
+    }
+
+    public function getNotifiedViolations(?string $schoolYearParam, ?string $semesterParam): array
+    {
+        return $this->caseQueryService->getNotifiedViolations(
+            $schoolYearParam,
+            $semesterParam,
+            $this->defaultSchoolYear(),
+            $this->defaultSemester()
+        );
+    }
+
+    public function getStudentCase(
+        int $studentId,
+        ?string $codeParam,
+        ?string $incidentDate,
+        bool $includeNotified,
+        bool $pendingOnly,
+        ?string $schoolYearFilter,
+        ?string $semesterFilter,
+    ): array {
+        return $this->caseQueryService->getStudentCase(
+            $studentId,
+            $codeParam,
+            $incidentDate,
+            $includeNotified,
+            $pendingOnly,
+            $schoolYearFilter,
+            $semesterFilter,
+            $this->defaultSchoolYear(),
+            $this->defaultSemester()
+        );
+    }
+
+    public function record(array $data): array
+    {
+        return $this->workflowService->record($data);
+    }
+
+    /**
+     * CodeIgniter POST attendance/send-auto-emails — runs auto_email actions on current pending violations.
+     */
+    public function sendAutoEmails(mixed $variantInput): array
+    {
+        $variant = is_string($variantInput) ? $variantInput : null;
+
+        $pending = $this->getPendingViolations(null, null);
+        $violations = $pending['students'] ?? [];
+
+        return $this->workflowService->sendAutoEmails($violations, $variant);
+    }
+
+    public function compose(int $studentId, string $code, string $variant, ?string $incidentDate): array
+    {
+        return $this->communicationSupportService->compose($studentId, $code, $variant, $incidentDate);
+    }
+
+    public function parentsInfo(int $studentId): array
+    {
+        return $this->communicationSupportService->parentsInfo($studentId);
+    }
+
+    public function sendEmailManual(array $data): array
+    {
+        $studentId = (int) ($data['student_id'] ?? 0);
+        $code = (string) ($data['code'] ?? '');
+        $incidentRaw = $data['incident_date'] ?? null;
+        $incidentDate = $incidentRaw !== null && $incidentRaw !== ''
+            ? substr((string) $incidentRaw, 0, 10)
+            : null;
+
+        $violationDates = $this->communicationSupportService->getViolationDatesForStudent(
+            $studentId,
+            $code,
+            $incidentDate
+        );
+
+        return $this->workflowService->sendEmailManual($data, $violationDates);
+    }
+
+    public function saveNotificationNote(array $data): array
+    {
+        return $this->workflowService->saveNotificationNote($data);
+    }
+
+    /**
+     * CodeIgniter route referenced {@see View\AttendanceTrackingController::notify_parent} was never implemented in CI;
+     * this matches the attendance notification modal (student_id, to, subject, message, subject_type, date).
+     */
+    public function notifyParent(array $input): array
+    {
+        $validator = Validator::make($input, [
+            'student_id' => ['required', 'integer', 'min:1'],
+            'to' => ['required', 'email'],
+            'subject' => ['required', 'string'],
+            'message' => ['required', 'string'],
+            'subject_type' => ['nullable', 'string'],
+            'date' => ['nullable', 'date'],
+        ]);
+
+        if ($validator->fails()) {
+            return [
+                'success' => false,
+                'message' => 'Validation failed.',
+                'errors' => $validator->errors(),
+                'status' => 422,
+            ];
+        }
+
+        $data = $validator->validated();
+        $subjectType = strtolower((string) ($data['subject_type'] ?? 'absent'));
+
+        $code = str_contains($subjectType, 'late') ? 'LATE_1' : 'ABS_1';
+
+        $ymd = null;
+        if (! empty($data['date'])) {
+            try {
+                $ymd = \Carbon\Carbon::parse((string) $data['date'])->format('Y-m-d');
+            } catch (\Throwable) {
+                $ymd = null;
+            }
+        }
+
+        return $this->sendEmailManual([
+            'student_id' => (int) $data['student_id'],
+            'to' => (string) $data['to'],
+            'subject' => (string) $data['subject'],
+            'body_html' => (string) $data['message'],
+            'code' => $code,
+            'variant' => 'default',
+            'incident_date' => $ymd,
+        ]);
+    }
 }