From f43e1b975125ec18c65646401e069151ad2f8d38 Mon Sep 17 00:00:00 2001 From: Flatlogic Bot Date: Thu, 16 Apr 2026 08:13:52 +0000 Subject: [PATCH] updating cycle system --- approved_school.php | 246 +++++- assessments.php | 370 +++++++++ assets/css/custom.css | 10 + attendance.php | 372 +++++++++ db/migrations/20260416_school_cycles.sql | 18 + includes/app.php | 453 ++++++++++- includes/cycles.php | 910 +++++++++++++++++++++++ students.php | 115 ++- teachers.php | 126 +++- 9 files changed, 2565 insertions(+), 55 deletions(-) create mode 100644 assessments.php create mode 100644 attendance.php create mode 100644 db/migrations/20260416_school_cycles.sql create mode 100644 includes/cycles.php diff --git a/approved_school.php b/approved_school.php index 0744080..04308ad 100644 --- a/approved_school.php +++ b/approved_school.php @@ -4,7 +4,11 @@ require_once __DIR__ . '/includes/app.php'; $flash = consume_flash(); $applicationId = filter_input(INPUT_GET, 'id', FILTER_VALIDATE_INT) ?: 0; +$requestedCycleId = filter_input(INPUT_GET, 'cycle', FILTER_VALIDATE_INT) ?: 0; $application = $applicationId > 0 ? get_application($applicationId) : null; +$cycleValues = school_cycle_defaults($application ?: null); +$cycleErrors = []; +$cycleRollover = school_cycle_rollover_defaults(); if (!$application) { http_response_code(404); @@ -26,6 +30,91 @@ if (!$application) { } $isApproved = (string) $application['status'] === 'approved'; +$cycleContext = ['cycles' => [], 'selected' => null, 'active' => null, 'read_only' => false]; +$selectedCycle = null; +$selectedCycleId = 0; +$isCycleReadOnly = false; +$cycleLabel = 'لا توجد دورة بعد'; + +if ($isApproved) { + $cycleContext = resolve_school_cycle_context((int) $application['id'], $application, $requestedCycleId); + $selectedCycle = $cycleContext['selected']; + $selectedCycleId = $selectedCycle ? (int) ($selectedCycle['id'] ?? 0) : 0; + $isCycleReadOnly = (bool) $cycleContext['read_only']; + $cycleLabel = $selectedCycle ? (string) $selectedCycle['cycle_name'] : $cycleLabel; + $cycleRollover = school_cycle_rollover_defaults($selectedCycle); +} + +if ($_SERVER['REQUEST_METHOD'] === 'POST' && $isApproved) { + $cycleAction = clean_text((string) ($_POST['cycle_action'] ?? ''), 30); + if ($cycleAction === 'create_cycle') { + [$cycleValues, $cycleErrors] = validate_school_cycle_input($_POST, $application); + $cycleRollover = school_cycle_rollover_input((int) $application['id'], $_POST, $selectedCycle); + $wantsRollover = !empty($cycleRollover['copy_teachers']) || !empty($cycleRollover['copy_assessments']) || !empty($cycleRollover['copy_students']); + if ($wantsRollover && (int) $cycleRollover['source_cycle_id'] <= 0) { + $cycleErrors['form'] = 'اختر دورة مصدر إذا كنت تريد نسخ الفريق أو التقييمات أو الطلاب إلى الدورة الجديدة.'; + } + if ($cycleErrors === []) { + try { + $cycleCreation = create_school_cycle((int) $application['id'], $cycleValues, $cycleRollover); + $newCycleId = (int) ($cycleCreation['cycle_id'] ?? 0); + $rolloverSummary = (array) ($cycleCreation['rollover'] ?? []); + $flashMessage = 'تم إنشاء الدورة الموسمية الجديدة بنجاح. يمكنك الآن العمل داخل ' . format_school_cycle_name($cycleValues['season'], (int) $cycleValues['year']) . '.'; + $rolloverParts = []; + if (!empty($rolloverSummary['teachers'])) { + $rolloverParts[] = 'ترحيل ' . (int) $rolloverSummary['teachers'] . ' من أعضاء الفريق'; + } + if (!empty($rolloverSummary['assessments'])) { + $rolloverParts[] = 'نسخ ' . (int) $rolloverSummary['assessments'] . ' من بنود التقييم'; + } + if (!empty($rolloverSummary['students'])) { + $rolloverParts[] = 'نقل ' . (int) $rolloverSummary['students'] . ' من الطلاب المستمرين'; + } + if ($rolloverParts !== []) { + $sourceCycleName = (string) ($cycleCreation['source_cycle_name'] ?? 'الدورة السابقة'); + $flashMessage .= ' تم أيضاً ' . implode('، ', $rolloverParts) . ' من ' . $sourceCycleName . '.'; + } + set_flash('success', $flashMessage); + header('Location: ' . school_page_url('approved_school.php', (int) $application['id'], $newCycleId)); + exit; + } catch (PDOException $exception) { + $duplicateCode = isset($exception->errorInfo[1]) && (int) $exception->errorInfo[1] === 1062; + if ($duplicateCode) { + $cycleErrors['year'] = 'هذه الدورة موجودة مسبقاً لهذا المركز. اختر موسماً أو سنة مختلفة.'; + } else { + $cycleErrors['form'] = 'تعذر إنشاء الدورة حالياً. يرجى المحاولة مرة أخرى.'; + } + } catch (InvalidArgumentException $exception) { + $cycleErrors['form'] = 'تعذر ترحيل البيانات من الدورة المحددة. اختر دورة صحيحة ثم حاول مرة أخرى.'; + } catch (Throwable $exception) { + $cycleErrors['form'] = 'تعذر إنشاء الدورة حالياً. يرجى المحاولة مرة أخرى.'; + } + } + } elseif ($cycleAction === 'archive_cycle') { + $postedCycleId = (int) ($_POST['cycle_id'] ?? 0); + $cycleToArchive = $postedCycleId > 0 ? get_school_cycle((int) $application['id'], $postedCycleId) : null; + if (!$cycleToArchive) { + $cycleErrors['form'] = 'تعذر العثور على الدورة المطلوب أرشفتها.'; + } elseif ((string) $cycleToArchive['status'] === 'archived') { + $cycleErrors['form'] = 'هذه الدورة مؤرشفة بالفعل.'; + } else { + archive_school_cycle((int) $application['id'], $postedCycleId); + set_flash('success', 'تمت أرشفة الدورة ' . (string) $cycleToArchive['cycle_name'] . ' بنجاح. يمكنك فتح دورة جديدة متى شئت.'); + header('Location: ' . school_page_url('approved_school.php', (int) $application['id'])); + exit; + } + } + + $cycleContext = resolve_school_cycle_context((int) $application['id'], $application, $requestedCycleId); + $selectedCycle = $cycleContext['selected']; + $selectedCycleId = $selectedCycle ? (int) ($selectedCycle['id'] ?? 0) : 0; + $isCycleReadOnly = (bool) $cycleContext['read_only']; + $cycleLabel = $selectedCycle ? (string) $selectedCycle['cycle_name'] : $cycleLabel; + if ($cycleAction !== 'create_cycle') { + $cycleRollover = school_cycle_rollover_defaults($selectedCycle); + } +} + $scoreValue = $application['evaluation_score'] !== null ? max(0, min(100, (int) $application['evaluation_score'])) : null; $durationDays = 0; $startTs = strtotime((string) $application['start_date']); @@ -34,9 +123,19 @@ if ($startTs !== false && $endTs !== false && $endTs >= $startTs) { $durationDays = (int) floor(($endTs - $startTs) / 86400) + 1; } -$pageTitle = $isApproved ? 'صفحة المركز المعتمد: ' . (string) $application['center_name'] : 'صفحة المركز بعد الاعتماد'; +$studentsUrl = school_page_url('students.php', (int) $application['id'], $selectedCycleId); +$teachersUrl = school_page_url('teachers.php', (int) $application['id'], $selectedCycleId); +$assessmentsUrl = school_page_url('assessments.php', (int) $application['id'], $selectedCycleId); +$attendanceUrl = school_page_url('attendance.php', (int) $application['id'], $selectedCycleId); +$approvedSchoolUrl = school_page_url('approved_school.php', (int) $application['id'], $selectedCycleId); +$studentCycleMetrics = $isApproved && $selectedCycleId > 0 ? school_student_metrics_by_cycle((int) $application['id'], $selectedCycleId) : ['total' => 0, 'active' => 0]; +$teacherCycleMetrics = $isApproved && $selectedCycleId > 0 ? school_teacher_metrics_by_cycle((int) $application['id'], $selectedCycleId) : ['total' => 0, 'active' => 0]; +$assessmentCycleMetrics = $isApproved && $selectedCycleId > 0 ? school_assessment_metrics_by_cycle((int) $application['id'], $selectedCycleId) : ['total' => 0, 'active' => 0, 'active_weight' => 0]; +$attendanceCycleMetrics = $isApproved && $selectedCycleId > 0 ? school_attendance_metrics_by_cycle((int) $application['id'], $selectedCycleId) : ['total' => 0, 'today_count' => 0, 'latest_date' => '']; + +$pageTitle = $isApproved ? 'صفحة المركز المعتمد: ' . (string) $application['center_name'] . ($selectedCycle ? ' — ' . $cycleLabel : '') : 'صفحة المركز بعد الاعتماد'; $pageDescription = $isApproved - ? 'صفحة هبوط تشغيلية للمركز المعتمد تعرض الجاهزية، بيانات التواصل، والخطوات التالية بعد الموافقة.' + ? 'صفحة تشغيلية للمركز المعتمد تعرض الجاهزية، الدورات الموسمية، والخطوات التالية بعد الموافقة.' : 'هذه الصفحة تصبح متاحة بعد اعتماد طلب المركز من المشرف العام.'; render_page_start($pageTitle, 'approved', $pageDescription); @@ -76,8 +175,10 @@ render_flash($flash);
فتح ملف الاعتماد - تسجيل الطلاب - فريق المعلمين + تسجيل الطلاب + فريق المعلمين + التقييمات والأوزان + غياب الطلاب كل المراكز المعتمدة لوحة القيادة
@@ -106,6 +207,129 @@ render_flash($flash);
مرجع التشغيل
#
استخدم هذا الرقم في أي متابعة إدارية لاحقة.
+ +
+
+
+
+
+
الدورات الموسمية والأرشفة
+
كل الطلاب والمعلمين والتقييمات والغياب أصبحت الآن مرتبطة بدورة مستقلة مثل Summer 2026 أو Winter 2026. عند نهاية الموسم قم بأرشفة الدورة الحالية ثم ابدأ دورة جديدة للحفاظ على التاريخ بدون خلط السجلات.
+
+ +
+
+
الدورة المحددة
+
الفترة →
+
حالة الدورة
+
الطلاب
+
الفريق
+
التقييمات النشطة
+
سجلات الغياب
+
+
+ طلاب هذه الدورة + فريق هذه الدورة + تقييمات هذه الدورة + غياب هذه الدورة + +
+ + + +
+ +
+ +
هذه الدورة مؤرشفة حالياً، لذلك كل الصفحات المرتبطة بها أصبحت للقراءة فقط. يمكنك فتح دورة جديدة من النموذج المجاور.
+ +
+
+
+
+
كل دورات المركز
+
+ + → — + +
+
+
+
فتح دورة جديدة
+

استخدم هذا النموذج عند نهاية الصيف أو الشتاء لبدء دورة جديدة باسم تلقائي مثل Summer 2026 أو Winter 2026.

+
+
+ +
+ + +
+
+
+ + +
+
+
+
+ + +
+
+
+ + +
+
+
+
+ + +
+
+ +
+
ترحيل البيانات من دورة سابقة
+

اختر الدورة التي تريد النسخ منها. الغياب لا يُنقل أبداً، والطلاب المنقولون يقتصرون على الحالات المستمرة فقط.

+
+ + +
+
+ + + +
+
+ + +
+
+
+
+ +
@@ -148,8 +372,12 @@ render_flash($flash);

صفحة الفريق أصبحت جاهزة الآن لإضافة المعلمين والمشرفين وربط أدوارهم التشغيلية مباشرة بالمركز المعتمد.

- 3) متابعة التشغيل -

بعد الانطلاق يمكن توسيع هذه الصفحة لاحقاً بمؤشرات حضور يومية، تقييمات، وتنبيهات تشغيلية.

+ 3) ضبط التقييمات +

صفحة التقييمات أصبحت جاهزة الآن لتحديد نوع التقييم، المقياس، والوزن قبل بدء الرصد والمتابعة.

+
+
+ 4) متابعة الغياب +

صفحة غياب الطلاب أصبحت جاهزة الآن لتسجيل الغياب اليومي، الأعذار، وحالات التأخر لكل طالب داخل المركز.

@@ -174,8 +402,10 @@ render_flash($flash);
روابط تشغيلية سريعة
- تسجيل الطلابفتح صفحة القيد وكشف المدرسة لهذا المركز. - فريق المعلمينإدارة المعلمين والمشرفين والكوادر التشغيلية للمركز. + تسجيل الطلابفتح صفحة القيد وكشف المدرسة لهذا المركز. + فريق المعلمينإدارة المعلمين والمشرفين والكوادر التشغيلية للمركز. + التقييمات والأوزانتعريف أنواع التقييم، المقاييس، والأوزان التشغيلية لهذا المركز. + غياب الطلابتسجيل الغياب اليومي، الأعذار، وحالات التأخر للطلاب المعتمدين. ملف الاعتمادالعودة إلى سجل القرار والتقييم. المراكز المعتمدةعرض بقية المراكز الجاهزة للتشغيل. لوحة القيادةالرجوع إلى المؤشرات العامة على مستوى الولاية. diff --git a/assessments.php b/assessments.php new file mode 100644 index 0000000..aa08ef3 --- /dev/null +++ b/assessments.php @@ -0,0 +1,370 @@ + 0 ? get_application($applicationId) : null; +$isApprovedSchool = $application && (string) $application['status'] === 'approved'; +$values = assessment_defaults(); +$errors = []; +$cycleContext = ['cycles' => [], 'selected' => null, 'active' => null, 'read_only' => false]; +$selectedCycle = null; +$selectedCycleId = 0; +$isCycleReadOnly = false; +$cycleLabel = 'لا توجد دورة بعد'; + +if ($application && $isApprovedSchool) { + $cycleContext = resolve_school_cycle_context((int) $application['id'], $application, $requestedCycleId); + $selectedCycle = $cycleContext['selected']; + $selectedCycleId = $selectedCycle ? (int) ($selectedCycle['id'] ?? 0) : 0; + $isCycleReadOnly = (bool) $cycleContext['read_only']; + $cycleLabel = $selectedCycle ? (string) $selectedCycle['cycle_name'] : $cycleLabel; +} + +if ($_SERVER['REQUEST_METHOD'] === 'POST' && $application) { + [$values, $errors] = validate_assessment_input($_POST); + + if (!$isApprovedSchool) { + $errors['form'] = 'لا يمكن إعداد التقييمات قبل اعتماد المركز.'; + } elseif ($selectedCycleId <= 0) { + $errors['form'] = 'يرجى إنشاء دورة موسمية أولاً من صفحة المركز.'; + } elseif ($isCycleReadOnly) { + $errors['form'] = 'هذه الدورة مؤرشفة للقراءة فقط. افتح دورة جديدة أو اختر دورة نشطة لإضافة تقييمات جديدة.'; + } + + if ($errors === []) { + try { + create_assessment_type_in_cycle((int) $application['id'], $selectedCycleId, $values); + set_flash('success', 'تم حفظ نوع التقييم داخل الدورة الموسمية المحددة.'); + header('Location: ' . school_page_url('assessments.php', (int) $application['id'], $selectedCycleId)); + exit; + } catch (Throwable $exception) { + $errors['form'] = 'تعذر حفظ نوع التقييم حالياً. يرجى المحاولة مرة أخرى.'; + } + } +} + +$assessments = $isApprovedSchool && $selectedCycleId > 0 ? list_school_assessments_by_cycle((int) $application['id'], $selectedCycleId) : []; +$metrics = $isApprovedSchool && $selectedCycleId > 0 ? school_assessment_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ + 'total' => 0, + 'active' => 0, + 'inactive' => 0, + 'total_weight' => 0.0, + 'active_weight' => 0.0, + 'average_max_score' => 0.0, + 'percentage' => 0, + 'points' => 0, + 'rubric' => 0, +]; +$studentMetrics = $isApprovedSchool && $selectedCycleId > 0 ? school_student_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ + 'total' => 0, + 'boys' => 0, + 'girls' => 0, + 'active' => 0, + 'waiting' => 0, + 'withdrawn' => 0, +]; +$teacherMetrics = $isApprovedSchool && $selectedCycleId > 0 ? school_teacher_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ + 'total' => 0, + 'active' => 0, + 'pending' => 0, + 'inactive' => 0, + 'email_ready' => 0, + 'supervisors' => 0, +]; + +$activeWeight = round((float) $metrics['active_weight'], 2); +$weightGap = round(100 - $activeWeight, 2); +$pageTitle = $application ? 'التقييمات والأوزان: ' . (string) $application['center_name'] . ($selectedCycle ? ' — ' . $cycleLabel : '') : 'التقييمات والأوزان'; +$pageDescription = 'صفحة مستقلة لتعريف أنواع التقييم، المقاييس، والأوزان لكل مدرسة معتمدة داخل دورة موسمية محددة.'; +$approvedSchoolUrl = $application ? school_page_url('approved_school.php', (int) $application['id'], $selectedCycleId) : 'approved_school.php'; +$studentsUrl = $application ? school_page_url('students.php', (int) $application['id'], $selectedCycleId) : 'students.php'; +$teachersUrl = $application ? school_page_url('teachers.php', (int) $application['id'], $selectedCycleId) : 'teachers.php'; +$attendanceUrl = $application ? school_page_url('attendance.php', (int) $application['id'], $selectedCycleId) : 'attendance.php'; +$applicationDetailUrl = $application ? 'application_detail.php?id=' . urlencode((string) $application['id']) : 'application_detail.php'; + +if (!$application) { + http_response_code(404); +} + +render_page_start($pageTitle, 'approved', $pageDescription); +render_flash($flash); +?> +
+
+ +
+
المدرسة غير موجودة
+

تحقق من رابط المدرسة أو ارجع إلى قائمة المراكز المعتمدة.

+ المراكز المعتمدة +
+ +
+
+
+ التقييمات تبدأ بعد الاعتماد +

+

تم تجهيز صفحة أنواع التقييم، لكن استخدامها مرتبط بتحويل حالة المركز إلى معتمد أولاً حتى تبقى الخطة الأكاديمية مرتبطة فقط بالمراكز الجاهزة للتشغيل.

+
+ الحالة الحالية: + المدينة: +
+
+ العودة لملف الاعتماد + صفحة المركز +
+
+
+
+ +
+
+
+ صفحة مستقلة للتقييمات والأوزان +

خطة التقييم —

+

هنا يتم تعريف أنواع التقييم الخاصة بالمركز بعد تجهيز الطلاب والمعلمين: اسم التقييم، فئته، المقياس المستخدم، والوزن التشغيلي ضمن الخطة الأكاديمية.

+
+ + تقييمات مفعلة + إجمالي الأوزان المفعلة % +
+
+ العودة لصفحة المركز + تسجيل الطلاب + فريق المعلمين + غياب الطلاب + ملف الاعتماد +
+
+
+
+
توازن الأوزان
+ +
ممتاز — الأوزان المفعلة تساوي 100% وجاهزة للاستخدام.
+ 100): ?> +
مجموع الأوزان المفعلة يتجاوز 100% بمقدار %. يحتاج إلى إعادة موازنة.
+ +
المجموع الحالي للأوزان المفعلة هو %، والمتبقي % لاستكمال الخطة.
+ +
+
التقييمات المفعلة
+
متوسط الدرجة القصوى
+
فريق التدريس عضو
+
+
+
+
+
+ + + +
+
+
+
+
+
الدورة الموسمية الحالية
+
كل عناصر خطة التقييم في هذه الصفحة تخص الدورة . يمكنك مراجعة مواسمك السابقة أو الحالية مباشرة من هنا.
+
+ +
+
+
اسم الدورة
+
الفترة →
+
عدد الدورات دورة للمركز
+
التقييمات كلها
+
التقييمات المفعلة
+
الأوزان المفعلة%
+
+
+ إدارة الدورات الموسمية +
+ +
هذه الدورة مؤرشفة، لذلك تبقى خطة التقييم للقراءة فقط حالياً.
+ +
+
+
+
+
التبديل بين الدورات
+

افتح نفس صفحة التقييمات لأي موسم سابق أو حالي حتى تراجع الأوزان والخطط التاريخية بسرعة.

+
+ + + +
+ + +
+ + +
+
+
+
+ + +
+
+
+
إضافة نوع تقييم جديد
+

أدخل نوع التقييم مرة واحدة، ثم استخدم القائمة في الأسفل كمرجع للخطة الأكاديمية الخاصة بالمركز.

+ + +
+ + + +
هذه الدورة مؤرشفة. يمكنك مراجعة خطة التقييم فقط، أو فتح دورة جديدة من صفحة المركز.
+ +
+
+ + +
+
+ +
+
+ + +
+
+
+ + +
+
+
+ + +
+
+
+ + +
+
+
+ +
+ + +
+ +
+ + +
+ +
+ +
+
+ +
+ +
+
الخطوة التالية بعد الخطة
+
    +
  • غياب الطلابالصفحة أصبحت جاهزة الآن لتتبع الغياب اليومي، الأعذار، وحالات التأخر.
    فتح صفحة الغياب
    • +
  • المتابعة الأكاديميةيمكن لاحقاً ربط نتائج التقييم بالطلاب والحصص أو الأسابيع التشغيلية.
    • +
+
+
+ +
+
+
+
+
خريطة التقييمات
+
جميع أنواع التقييم المعرفة لهذا المركز فقط، مرتبة بحسب التفعيل والوزن.
+
+ نسبي / Rubric +
+ +
+
إجمالي الأنواع نوع
+
المفعّل الآن نوع
+
الأوزان المفعلة%
+
+ + +
+
لا توجد تقييمات معرفة بعد
+

ابدأ من النموذج في الجانب الأيمن لإضافة أول نوع تقييم إلى خطة المركز.

+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + +
التقييمالفئةالمقياسالدرجةالوزنالحالةالإضافة
+ + + %
+
+ +
+ +
+
سياق المدرسة
+
+
مدير المركز
+
قيد الطلاب النشط طالب/طالبة
+
الفريق التعليمي عضو
+
التقييمات النقطية نوع
+
+
+ العودة إلى المعلمين + العودة إلى الطلاب + فتح الغياب + صفحة المركز +
+
+
+
+ +
+
+ 0 ? get_application($applicationId) : null; +$isApprovedSchool = $application && (string) $application['status'] === 'approved'; +$values = attendance_defaults(); +$errors = []; +$cycleContext = ['cycles' => [], 'selected' => null, 'active' => null, 'read_only' => false]; +$selectedCycle = null; +$selectedCycleId = 0; +$isCycleReadOnly = false; +$cycleLabel = 'لا توجد دورة بعد'; + +if ($application && $isApprovedSchool) { + $cycleContext = resolve_school_cycle_context((int) $application['id'], $application, $requestedCycleId); + $selectedCycle = $cycleContext['selected']; + $selectedCycleId = $selectedCycle ? (int) ($selectedCycle['id'] ?? 0) : 0; + $isCycleReadOnly = (bool) $cycleContext['read_only']; + $cycleLabel = $selectedCycle ? (string) $selectedCycle['cycle_name'] : $cycleLabel; +} + +if ($_SERVER['REQUEST_METHOD'] === 'POST' && $application) { + if (!$isApprovedSchool) { + $errors['form'] = 'لا يمكن فتح سجل الغياب قبل اعتماد المركز.'; + } elseif ($selectedCycleId <= 0) { + $errors['form'] = 'يرجى إنشاء دورة موسمية أولاً من صفحة المركز.'; + } elseif ($isCycleReadOnly) { + $errors['form'] = 'هذه الدورة مؤرشفة للقراءة فقط. افتح دورة جديدة أو اختر دورة نشطة لإضافة غياب جديد.'; + } else { + [$values, $errors] = validate_attendance_input_for_cycle((int) $application['id'], $selectedCycleId, $_POST); + if ($errors === []) { + try { + create_attendance_record_in_cycle((int) $application['id'], $selectedCycleId, $values); + set_flash('success', 'تم حفظ سجل الغياب داخل الدورة الموسمية المحددة.'); + header('Location: ' . school_page_url('attendance.php', (int) $application['id'], $selectedCycleId)); + exit; + } catch (PDOException $exception) { + $duplicateCode = isset($exception->errorInfo[1]) && (int) $exception->errorInfo[1] === 1062; + if ($duplicateCode) { + $errors['attendance_date'] = 'يوجد سجل غياب سابق لهذا الطالب في نفس التاريخ داخل هذه الدورة.'; + } else { + $errors['form'] = 'تعذر حفظ سجل الغياب حالياً. يرجى المحاولة مرة أخرى.'; + } + } catch (Throwable $exception) { + $errors['form'] = 'تعذر حفظ سجل الغياب حالياً. يرجى المحاولة مرة أخرى.'; + } + } + } +} + +$students = $isApprovedSchool && $selectedCycleId > 0 ? list_school_students_by_cycle((int) $application['id'], $selectedCycleId) : []; +$studentOptions = $isApprovedSchool && $selectedCycleId > 0 ? school_student_options_by_cycle((int) $application['id'], $selectedCycleId) : []; +$records = $isApprovedSchool && $selectedCycleId > 0 ? list_school_attendance_records_by_cycle((int) $application['id'], $selectedCycleId) : []; +$metrics = $isApprovedSchool && $selectedCycleId > 0 ? school_attendance_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ + 'total' => 0, + 'absent' => 0, + 'excused' => 0, + 'late' => 0, + 'affected_students' => 0, + 'latest_date' => '', + 'today_count' => 0, +]; +$studentMetrics = $isApprovedSchool && $selectedCycleId > 0 ? school_student_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ + 'total' => 0, + 'boys' => 0, + 'girls' => 0, + 'active' => 0, + 'waiting' => 0, + 'withdrawn' => 0, +]; +$teacherMetrics = $isApprovedSchool && $selectedCycleId > 0 ? school_teacher_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ + 'total' => 0, + 'active' => 0, + 'pending' => 0, + 'inactive' => 0, + 'teachers' => 0, + 'supervisors' => 0, +]; +$assessmentMetrics = $isApprovedSchool && $selectedCycleId > 0 ? school_assessment_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ + 'total' => 0, + 'active' => 0, + 'inactive' => 0, + 'total_weight' => 0, + 'active_weight' => 0, + 'average_max_score' => 0, + 'percentage' => 0, + 'points' => 0, + 'rubric' => 0, +]; + +$trackedStudents = max(1, $studentMetrics['active']); +$incidentRate = $metrics['total'] > 0 ? round(($metrics['affected_students'] / $trackedStudents) * 100, 1) : 0.0; +$latestDateLabel = $metrics['latest_date'] !== '' ? $metrics['latest_date'] : 'لا يوجد'; +$pageTitle = $application ? 'غياب الطلاب: ' . (string) $application['center_name'] . ($selectedCycle ? ' — ' . $cycleLabel : '') : 'غياب الطلاب'; +$pageDescription = 'صفحة مستقلة لتسجيل غياب الطلاب والأعذار وحالات التأخر للمراكز المعتمدة داخل دورة موسمية محددة.'; +$approvedSchoolUrl = $application ? school_page_url('approved_school.php', (int) $application['id'], $selectedCycleId) : 'approved_school.php'; +$studentsUrl = $application ? school_page_url('students.php', (int) $application['id'], $selectedCycleId) : 'students.php'; +$teachersUrl = $application ? school_page_url('teachers.php', (int) $application['id'], $selectedCycleId) : 'teachers.php'; +$assessmentsUrl = $application ? school_page_url('assessments.php', (int) $application['id'], $selectedCycleId) : 'assessments.php'; +$applicationDetailUrl = $application ? 'application_detail.php?id=' . urlencode((string) $application['id']) : 'application_detail.php'; + +if (!$application) { + http_response_code(404); +} + +render_page_start($pageTitle, 'approved', $pageDescription); +render_flash($flash); +?> +
+
+ +
+
المدرسة غير موجودة
+

تحقق من رابط المدرسة أو ارجع إلى قائمة المراكز المعتمدة.

+ المراكز المعتمدة +
+ +
+
+
+ الغياب يبدأ بعد الاعتماد +

+

تم تجهيز صفحة غياب الطلاب، لكن استخدامها مرتبط بتحويل حالة المركز إلى معتمد أولاً حتى يبقى السجل اليومي محصوراً بالمراكز الجاهزة للتشغيل.

+
+ الحالة الحالية: + المدينة: +
+
+ العودة لملف الاعتماد + صفحة المركز +
+
+
+
+ +
+
+
+ صفحة مستقلة لغياب الطلاب +

سجل الغياب —

+

هنا يتم تسجيل الغياب اليومي، الأعذار، وحالات التأخر في صفحة تشغيلية منفصلة. كل سجل يرتبط مباشرة بطالب محدد داخل هذا المركز فقط.

+
+ + طلاب عليهم ملاحظات حضور + آخر تحديث +
+
+ العودة لصفحة المركز + تسجيل الطلاب + فريق المعلمين + التقييمات والأوزان + ملف الاعتماد +
+
+
+
+
ملخص الانضباط اليومي
+ 0): ?> +
%نسبة الطلاب المتأثرين
+
+ +
+
السجلات اليوم
+
الغياب بدون عذر
+
الغياب بعذر / تأخر
+
+
+
+
+
+ + + +
+
+
+
+
+
الدورة الموسمية الحالية
+
سجلات الغياب في هذه الصفحة تخص الدورة . عند أرشفة الدورة تبقى السجلات محفوظة للمراجعة فقط بدون خلطها بالموسم التالي.
+
+ +
+
+
اسم الدورة
+
الفترة →
+
عدد الدورات دورة للمركز
+
+
+ إدارة الدورات الموسمية +
+ +
هذه الدورة مؤرشفة، لذلك تبقى صفحة الغياب للقراءة فقط حالياً.
+ +
+
+
+
+
التبديل بين الدورات
+

افتح سجل الغياب لنفس المركز في أي موسم سابق أو حالي مباشرة من هذه الصفحة.

+
+ + + +
+ + +
+ + +
+
+
+
+ + +
+
+
+
تسجيل غياب أو تأخر
+

اختر الطالب والتاريخ والحالة، ثم أضف سبباً مختصراً وملاحظة متابعة عند الحاجة.

+ + +
هذه الدورة مؤرشفة. يمكنك مراجعة السجل فقط، أو فتح دورة جديدة من صفحة المركز.
+ +
ابدأ أولاً من صفحة الطلاب لإضافة الطلاب قبل تسجيل أي غياب.
+ + +
+ + +
+
+ + +
+
+ +
+ + +
+
+ +
+ + +
+
+ +
+ + +
+
+ +
+ + +
+ +
+ +
+
+ +
+ +
+
خطوات المتابعة التالية
+
    +
  • التواصل مع أولياء الأموريمكن لاحقاً إضافة إشعارات أو رسائل عند تكرار الغياب لنفس الطالب.
    • +
  • تقارير أسبوعيةالمرحلة القادمة الطبيعية هي تلخيص السجلات حسب الأسبوع أو الفصل التشغيلي.
    • +
+
+
+ +
+
+
+
+
كشف الغياب اليومي
+
جميع سجلات الغياب والتأخر المرتبطة بهذا المركز فقط، مرتبة من الأحدث إلى الأقدم.
+
+ سجل / طلاب +
+ +
+
الغياب حالة
+
بعذر حالة
+
تأخر حالة
+
السجلات اليوم حالة
+
+ + +
+
لا توجد سجلات غياب بعد
+

ابدأ من النموذج في الجانب الأيمن لإضافة أول سجل غياب أو تأخر لهذا المركز.

+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
الطالبالتاريخالحالةالسببالمتابعة
+ + — + + + +
+
+ +
+ +
+
سياق المدرسة
+
+
الطلاب النشطون طالب/طالبة
+
الفريق التعليمي عضو
+
التقييمات المفعلة نوع
+
آخر سجل
+
+
+ العودة إلى التقييمات + العودة إلى المعلمين + العودة إلى الطلاب + صفحة المركز +
+
+
+
+ +
+
+query("SELECT id FROM center_applications WHERE status = 'approved' ORDER BY id ASC LIMIT 1")->fetchColumn(); + $approvedStmt = $pdo->query("SELECT * FROM center_applications WHERE status = 'approved' ORDER BY id ASC LIMIT 1"); + $approvedApplication = $approvedStmt ? ($approvedStmt->fetch() ?: null) : null; + if (!$approvedApplication) { + return; + } + + $approvedId = (int) ($approvedApplication['id'] ?? 0); if ($approvedId <= 0) { return; } + $defaultCycleId = ensure_default_school_cycle_record($pdo, $approvedApplication); + $studentCount = (int) $pdo->query('SELECT COUNT(*) FROM school_students')->fetchColumn(); if ($studentCount === 0) { $studentRows = [ @@ -158,11 +168,11 @@ function seed_school_module_demo_data(PDO $pdo): void $studentStmt = $pdo->prepare( 'INSERT INTO school_students ( - center_application_id, student_code, full_name, gender, grade_level, + center_application_id, cycle_id, student_code, full_name, gender, grade_level, guardian_name, guardian_phone, birth_date, enrollment_status, notes, created_at, updated_at ) VALUES ( - :center_application_id, :student_code, :full_name, :gender, :grade_level, + :center_application_id, :cycle_id, :student_code, :full_name, :gender, :grade_level, :guardian_name, :guardian_phone, :birth_date, :enrollment_status, :notes, NOW(), NOW() )' @@ -171,6 +181,7 @@ function seed_school_module_demo_data(PDO $pdo): void foreach ($studentRows as $row) { $studentStmt->execute([ ':center_application_id' => $approvedId, + ':cycle_id' => $defaultCycleId, ':student_code' => $row[0], ':full_name' => $row[1], ':gender' => $row[2], @@ -194,11 +205,11 @@ function seed_school_module_demo_data(PDO $pdo): void $teacherStmt = $pdo->prepare( 'INSERT INTO school_teachers ( - center_application_id, full_name, role_title, specialization, + center_application_id, cycle_id, full_name, role_title, specialization, phone, email, employment_status, notes, created_at, updated_at ) VALUES ( - :center_application_id, :full_name, :role_title, :specialization, + :center_application_id, :cycle_id, :full_name, :role_title, :specialization, :phone, :email, :employment_status, :notes, NOW(), NOW() )' @@ -207,6 +218,7 @@ function seed_school_module_demo_data(PDO $pdo): void foreach ($teacherRows as $row) { $teacherStmt->execute([ ':center_application_id' => $approvedId, + ':cycle_id' => $defaultCycleId, ':full_name' => $row[0], ':role_title' => $row[1], ':specialization' => $row[2], @@ -217,6 +229,99 @@ function seed_school_module_demo_data(PDO $pdo): void ]); } } + + $assessmentCount = (int) $pdo->query('SELECT COUNT(*) FROM school_assessment_types')->fetchColumn(); + if ($assessmentCount === 0) { + $assessmentRows = [ + ['الاختبار التشخيصي', 'تشخيصي', 'percentage', 100.00, 10.00, 1, 'يقيس مستوى الانطلاق في بداية البرنامج.'], + ['المشاركة الصفية', 'مشاركة', 'points', 20.00, 15.00, 1, 'متابعة التفاعل اليومي والانضباط داخل الحلقة أو الصف.'], + ['المشروع التطبيقي', 'مشاريع', 'rubric', 4.00, 35.00, 1, 'يقيس التطبيق العملي والابتكار والعمل الجماعي.'], + ['الاختبار الختامي', 'ختامي', 'percentage', 100.00, 40.00, 1, 'يعكس المخرجات النهائية ونسبة الإتقان العامة.'], + ]; + + $assessmentStmt = $pdo->prepare( + 'INSERT INTO school_assessment_types ( + center_application_id, cycle_id, title, category, scale_type, + max_score, weight_percentage, is_active, notes, + created_at, updated_at + ) VALUES ( + :center_application_id, :cycle_id, :title, :category, :scale_type, + :max_score, :weight_percentage, :is_active, :notes, + NOW(), NOW() + )' + ); + + foreach ($assessmentRows as $row) { + $assessmentStmt->execute([ + ':center_application_id' => $approvedId, + ':cycle_id' => $defaultCycleId, + ':title' => $row[0], + ':category' => $row[1], + ':scale_type' => $row[2], + ':max_score' => $row[3], + ':weight_percentage' => $row[4], + ':is_active' => $row[5], + ':notes' => $row[6], + ]); + } + } + + $attendanceCount = (int) $pdo->query('SELECT COUNT(*) FROM school_attendance_records')->fetchColumn(); + if ($attendanceCount === 0) { + $studentStmt = $pdo->prepare( + 'SELECT id FROM school_students + WHERE center_application_id = :center_application_id AND cycle_id = :cycle_id + ORDER BY id ASC' + ); + $studentStmt->execute([ + ':center_application_id' => $approvedId, + ':cycle_id' => $defaultCycleId, + ]); + $studentRows = $studentStmt->fetchAll(); + + if ($studentRows !== []) { + $studentIds = []; + foreach ($studentRows as $studentRow) { + $studentIds[] = (int) ($studentRow['id'] ?? 0); + } + + $attendanceRows = []; + if (isset($studentIds[0])) { + $attendanceRows[] = [$studentIds[0], '2026-04-13', 'absent', 'ظرف صحي', 'تم التواصل مع ولي الأمر والمتابعة جارية.']; + $attendanceRows[] = [$studentIds[0], '2026-04-15', 'late', 'تأخر في المواصلات', 'دخل بعد بداية الفترة الأولى بـ 15 دقيقة.']; + } + if (isset($studentIds[1])) { + $attendanceRows[] = [$studentIds[1], '2026-04-14', 'excused', 'موعد عائلي مسبق', 'غياب بعذر وتمت مشاركة الواجبات مع الطالبة.']; + } + if (isset($studentIds[2])) { + $attendanceRows[] = [$studentIds[2], '2026-04-15', 'absent', 'لم يتم الرد على الاتصال', 'يحتاج إلى متابعة إضافية بسبب تكرر الغياب.']; + } + + if ($attendanceRows !== []) { + $attendanceStmt = $pdo->prepare( + 'INSERT INTO school_attendance_records ( + center_application_id, cycle_id, student_id, attendance_date, attendance_status, + absence_reason, notes, created_at, updated_at + ) VALUES ( + :center_application_id, :cycle_id, :student_id, :attendance_date, :attendance_status, + :absence_reason, :notes, NOW(), NOW() + )' + ); + + foreach ($attendanceRows as $row) { + $attendanceStmt->execute([ + ':center_application_id' => $approvedId, + ':cycle_id' => $defaultCycleId, + ':student_id' => $row[0], + ':attendance_date' => $row[1], + ':attendance_status' => $row[2], + ':absence_reason' => $row[3], + ':notes' => $row[4], + ]); + } + } + } + } } function seed_center_application_demo_data(PDO $pdo): void @@ -774,6 +879,342 @@ function school_teacher_metrics(int $centerApplicationId): array ]; } + +function assessment_defaults(): array +{ + return [ + 'title' => '', + 'category' => 'اختبار قصير', + 'scale_type' => 'percentage', + 'max_score' => '100', + 'weight_percentage' => '10', + 'is_active' => '1', + 'notes' => '', + ]; +} + +function assessment_category_options(): array +{ + return [ + 'تشخيصي', + 'واجب', + 'مشاركة', + 'مشروع', + 'أداء', + 'اختبار قصير', + 'اختبار نهائي', + ]; +} + +function assessment_scale_type_map(): array +{ + return [ + 'percentage' => ['label' => 'نسبة مئوية', 'class' => 'status-approved'], + 'points' => ['label' => 'نقاط', 'class' => 'status-submitted'], + 'rubric_4' => ['label' => 'Rubric / 4', 'class' => 'status-review'], + 'rubric_5' => ['label' => 'Rubric / 5', 'class' => 'status-review'], + ]; +} + +function assessment_scale_type_label(string $scaleType): string +{ + $map = assessment_scale_type_map(); + return (string) ($map[$scaleType]['label'] ?? 'غير محدد'); +} + +function assessment_scale_type_badge(string $scaleType): string +{ + $map = assessment_scale_type_map(); + $meta = $map[$scaleType] ?? ['label' => 'غير محدد', 'class' => 'status-muted']; + return '' . e($meta['label']) . ''; +} + +function assessment_active_badge(int $isActive): string +{ + $meta = $isActive === 1 + ? ['label' => 'مفعل', 'class' => 'status-approved'] + : ['label' => 'مؤرشف', 'class' => 'status-muted']; + + return '' . e($meta['label']) . ''; +} + +function validate_assessment_input(array $input): array +{ + $data = assessment_defaults(); + $data['title'] = clean_text((string) ($input['title'] ?? ''), 150); + $data['category'] = clean_text((string) ($input['category'] ?? ''), 80); + $data['scale_type'] = clean_text((string) ($input['scale_type'] ?? ''), 40); + $data['notes'] = clean_text((string) ($input['notes'] ?? ''), 1000); + $data['is_active'] = ((string) ($input['is_active'] ?? '1')) === '1' ? '1' : '0'; + + $errors = []; + + if ($data['title'] === '') { + $errors['title'] = 'يرجى إدخال اسم نوع التقييم.'; + } + if (!in_array($data['category'], assessment_category_options(), true)) { + $errors['category'] = 'يرجى اختيار فئة تقييم صحيحة.'; + } + + $scaleMap = assessment_scale_type_map(); + if (!array_key_exists($data['scale_type'], $scaleMap)) { + $errors['scale_type'] = 'يرجى اختيار مقياس تقييم صحيح.'; + } + + $maxScoreRaw = str_replace(',', '.', (string) ($input['max_score'] ?? '')); + if ($maxScoreRaw === '' || !is_numeric($maxScoreRaw)) { + $errors['max_score'] = 'أدخل الدرجة النهائية بصيغة رقمية.'; + } else { + $maxScore = round((float) $maxScoreRaw, 2); + if ($maxScore <= 0 || $maxScore > 1000) { + $errors['max_score'] = 'يجب أن تكون الدرجة النهائية بين 0.01 و1000.'; + } else { + $data['max_score'] = number_format($maxScore, 2, '.', ''); + } + } + + $weightRaw = str_replace(',', '.', (string) ($input['weight_percentage'] ?? '')); + if ($weightRaw === '' || !is_numeric($weightRaw)) { + $errors['weight_percentage'] = 'أدخل وزن التقييم بصيغة رقمية.'; + } else { + $weight = round((float) $weightRaw, 2); + if ($weight < 0 || $weight > 100) { + $errors['weight_percentage'] = 'يجب أن يكون الوزن بين 0 و100٪.'; + } else { + $data['weight_percentage'] = number_format($weight, 2, '.', ''); + } + } + + return [$data, $errors]; +} + +function create_assessment_type(int $centerApplicationId, array $data): int +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'INSERT INTO school_assessment_types ( + center_application_id, title, category, scale_type, max_score, + weight_percentage, is_active, notes, + created_at, updated_at + ) VALUES ( + :center_application_id, :title, :category, :scale_type, :max_score, + :weight_percentage, :is_active, :notes, + NOW(), NOW() + )' + ); + + $stmt->bindValue(':center_application_id', $centerApplicationId, PDO::PARAM_INT); + $stmt->bindValue(':title', $data['title'], PDO::PARAM_STR); + $stmt->bindValue(':category', $data['category'], PDO::PARAM_STR); + $stmt->bindValue(':scale_type', $data['scale_type'], PDO::PARAM_STR); + $stmt->bindValue(':max_score', (float) $data['max_score']); + $stmt->bindValue(':weight_percentage', (float) $data['weight_percentage']); + $stmt->bindValue(':is_active', (int) $data['is_active'], PDO::PARAM_INT); + $stmt->bindValue(':notes', $data['notes'] !== '' ? $data['notes'] : null, $data['notes'] !== '' ? PDO::PARAM_STR : PDO::PARAM_NULL); + $stmt->execute(); + + return (int) $pdo->lastInsertId(); +} + +function list_school_assessments(int $centerApplicationId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'SELECT * + FROM school_assessment_types + WHERE center_application_id = :center_application_id + ORDER BY is_active DESC, weight_percentage DESC, created_at DESC, id DESC' + ); + $stmt->bindValue(':center_application_id', $centerApplicationId, PDO::PARAM_INT); + $stmt->execute(); + return $stmt->fetchAll(); +} + +function school_assessment_metrics(int $centerApplicationId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + "SELECT + COUNT(*) AS total, + COALESCE(SUM(is_active = 1), 0) AS active_count, + COALESCE(SUM(is_active = 0), 0) AS inactive_count, + COALESCE(SUM(weight_percentage), 0) AS total_weight, + COALESCE(SUM(CASE WHEN is_active = 1 THEN weight_percentage ELSE 0 END), 0) AS active_weight, + COALESCE(AVG(max_score), 0) AS average_max_score, + COALESCE(SUM(scale_type = 'percentage'), 0) AS percentage_count, + COALESCE(SUM(scale_type = 'points'), 0) AS points_count, + COALESCE(SUM(scale_type IN ('rubric_4', 'rubric_5')), 0) AS rubric_count + FROM school_assessment_types + WHERE center_application_id = :center_application_id" + ); + $stmt->bindValue(':center_application_id', $centerApplicationId, PDO::PARAM_INT); + $stmt->execute(); + $row = $stmt->fetch() ?: []; + + return [ + 'total' => (int) ($row['total'] ?? 0), + 'active' => (int) ($row['active_count'] ?? 0), + 'inactive' => (int) ($row['inactive_count'] ?? 0), + 'total_weight' => round((float) ($row['total_weight'] ?? 0), 2), + 'active_weight' => round((float) ($row['active_weight'] ?? 0), 2), + 'average_max_score' => round((float) ($row['average_max_score'] ?? 0), 2), + 'percentage' => (int) ($row['percentage_count'] ?? 0), + 'points' => (int) ($row['points_count'] ?? 0), + 'rubric' => (int) ($row['rubric_count'] ?? 0), + ]; +} + + +function attendance_defaults(): array +{ + return [ + 'student_id' => '', + 'attendance_date' => date('Y-m-d'), + 'attendance_status' => 'absent', + 'absence_reason' => '', + 'notes' => '', + ]; +} + +function attendance_status_map(): array +{ + return [ + 'absent' => ['label' => 'غياب', 'class' => 'status-rejected'], + 'excused' => ['label' => 'غياب بعذر', 'class' => 'status-review'], + 'late' => ['label' => 'تأخر', 'class' => 'status-submitted'], + ]; +} + +function attendance_status_badge(string $status): string +{ + $map = attendance_status_map(); + $meta = $map[$status] ?? ['label' => 'غير محدد', 'class' => 'status-muted']; + return '' . e($meta['label']) . ''; +} + +function school_student_options(int $centerApplicationId): array +{ + $students = list_school_students($centerApplicationId); + $options = []; + foreach ($students as $student) { + $studentId = (int) ($student['id'] ?? 0); + if ($studentId <= 0) { + continue; + } + + $options[$studentId] = [ + 'label' => trim((string) ($student['full_name'] ?? '')), + 'status' => (string) ($student['enrollment_status'] ?? ''), + 'grade_level' => (string) ($student['grade_level'] ?? ''), + 'guardian_phone' => (string) ($student['guardian_phone'] ?? ''), + ]; + } + + return $options; +} + +function validate_attendance_input(int $centerApplicationId, array $input): array +{ + $data = attendance_defaults(); + $data['student_id'] = (string) ((int) ($input['student_id'] ?? 0)); + $data['attendance_status'] = clean_text((string) ($input['attendance_status'] ?? ''), 30); + $data['absence_reason'] = clean_text((string) ($input['absence_reason'] ?? ''), 190); + $data['notes'] = clean_text((string) ($input['notes'] ?? ''), 1000); + $data['attendance_date'] = clean_text((string) ($input['attendance_date'] ?? ''), 20); + + $errors = []; + $studentId = (int) $data['student_id']; + $studentOptions = school_student_options($centerApplicationId); + + if ($studentId <= 0 || !array_key_exists($studentId, $studentOptions)) { + $errors['student_id'] = 'يرجى اختيار طالب صحيح من نفس المركز.'; + } + + $statusMap = attendance_status_map(); + if (!array_key_exists($data['attendance_status'], $statusMap)) { + $errors['attendance_status'] = 'يرجى اختيار حالة غياب صحيحة.'; + } + + if ($data['attendance_date'] === '' || strtotime($data['attendance_date']) === false) { + $errors['attendance_date'] = 'يرجى إدخال تاريخ صحيح للسجل اليومي.'; + } + + if ($data['attendance_status'] !== 'late' && $data['absence_reason'] === '') { + $errors['absence_reason'] = 'يرجى إدخال سبب الغياب أو العذر.'; + } + + return [$data, $errors]; +} + +function create_attendance_record(int $centerApplicationId, array $data): int +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'INSERT INTO school_attendance_records ( + center_application_id, student_id, attendance_date, attendance_status, + absence_reason, notes, created_at, updated_at + ) VALUES ( + :center_application_id, :student_id, :attendance_date, :attendance_status, + :absence_reason, :notes, NOW(), NOW() + )' + ); + + $stmt->bindValue(':center_application_id', $centerApplicationId, PDO::PARAM_INT); + $stmt->bindValue(':student_id', (int) $data['student_id'], PDO::PARAM_INT); + $stmt->bindValue(':attendance_date', $data['attendance_date'], PDO::PARAM_STR); + $stmt->bindValue(':attendance_status', $data['attendance_status'], PDO::PARAM_STR); + $stmt->bindValue(':absence_reason', $data['absence_reason'] !== '' ? $data['absence_reason'] : null, $data['absence_reason'] !== '' ? PDO::PARAM_STR : PDO::PARAM_NULL); + $stmt->bindValue(':notes', $data['notes'] !== '' ? $data['notes'] : null, $data['notes'] !== '' ? PDO::PARAM_STR : PDO::PARAM_NULL); + $stmt->execute(); + + return (int) $pdo->lastInsertId(); +} + +function list_school_attendance_records(int $centerApplicationId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'SELECT ar.*, s.student_code, s.full_name, s.grade_level, s.guardian_phone + FROM school_attendance_records ar + INNER JOIN school_students s ON s.id = ar.student_id + WHERE ar.center_application_id = :center_application_id + ORDER BY ar.attendance_date DESC, ar.created_at DESC, ar.id DESC' + ); + $stmt->bindValue(':center_application_id', $centerApplicationId, PDO::PARAM_INT); + $stmt->execute(); + return $stmt->fetchAll(); +} + +function school_attendance_metrics(int $centerApplicationId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + "SELECT + COUNT(*) AS total, + COALESCE(SUM(attendance_status = 'absent'), 0) AS absent_count, + COALESCE(SUM(attendance_status = 'excused'), 0) AS excused_count, + COALESCE(SUM(attendance_status = 'late'), 0) AS late_count, + COUNT(DISTINCT student_id) AS affected_students, + MAX(attendance_date) AS latest_date, + COALESCE(SUM(attendance_date = CURDATE()), 0) AS today_count + FROM school_attendance_records + WHERE center_application_id = :center_application_id" + ); + $stmt->bindValue(':center_application_id', $centerApplicationId, PDO::PARAM_INT); + $stmt->execute(); + $row = $stmt->fetch() ?: []; + + return [ + 'total' => (int) ($row['total'] ?? 0), + 'absent' => (int) ($row['absent_count'] ?? 0), + 'excused' => (int) ($row['excused_count'] ?? 0), + 'late' => (int) ($row['late_count'] ?? 0), + 'affected_students' => (int) ($row['affected_students'] ?? 0), + 'latest_date' => (string) ($row['latest_date'] ?? ''), + 'today_count' => (int) ($row['today_count'] ?? 0), + ]; +} + function render_page_start(string $pageTitle, string $active = 'home', string $pageDescription = ''): void { $projectName = project_name(); diff --git a/includes/cycles.php b/includes/cycles.php new file mode 100644 index 0000000..b93480f --- /dev/null +++ b/includes/cycles.php @@ -0,0 +1,910 @@ +prepare( + 'SELECT COUNT(*) FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = :table_name AND COLUMN_NAME = :column_name' + ); + $stmt->execute([ + ':table_name' => $table, + ':column_name' => $column, + ]); + + return (int) $stmt->fetchColumn() > 0; +} + +function schema_table_has_index(PDO $pdo, string $table, string $index): bool +{ + $stmt = $pdo->prepare( + 'SELECT COUNT(*) FROM information_schema.STATISTICS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = :table_name AND INDEX_NAME = :index_name' + ); + $stmt->execute([ + ':table_name' => $table, + ':index_name' => $index, + ]); + + return (int) $stmt->fetchColumn() > 0; +} + +function schema_table_has_foreign_key(PDO $pdo, string $table, string $constraint): bool +{ + $stmt = $pdo->prepare( + 'SELECT COUNT(*) FROM information_schema.TABLE_CONSTRAINTS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = :table_name AND CONSTRAINT_NAME = :constraint_name AND CONSTRAINT_TYPE = "FOREIGN KEY"' + ); + $stmt->execute([ + ':table_name' => $table, + ':constraint_name' => $constraint, + ]); + + return (int) $stmt->fetchColumn() > 0; +} + +function ensure_school_cycle_schema(PDO $pdo): void +{ + static $done = false; + if ($done) { + return; + } + + $migrationPath = __DIR__ . '/../db/migrations/20260416_school_cycles.sql'; + if (is_file($migrationPath)) { + $sql = file_get_contents($migrationPath); + if (is_string($sql) && trim($sql) !== '') { + $pdo->exec($sql); + } + } + + $tables = [ + 'school_students' => [ + 'index' => 'idx_school_students_cycle', + 'foreign_key' => 'fk_school_students_cycle', + ], + 'school_teachers' => [ + 'index' => 'idx_school_teachers_cycle', + 'foreign_key' => 'fk_school_teachers_cycle', + ], + 'school_assessment_types' => [ + 'index' => 'idx_school_assessments_cycle', + 'foreign_key' => 'fk_school_assessments_cycle', + ], + 'school_attendance_records' => [ + 'index' => 'idx_school_attendance_cycle', + 'foreign_key' => 'fk_school_attendance_cycle', + ], + ]; + + foreach ($tables as $table => $meta) { + if (!schema_table_has_column($pdo, $table, 'cycle_id')) { + $pdo->exec('ALTER TABLE ' . $table . ' ADD COLUMN cycle_id INT UNSIGNED NULL AFTER center_application_id'); + } + + if (!schema_table_has_index($pdo, $table, $meta['index'])) { + $pdo->exec('ALTER TABLE ' . $table . ' ADD INDEX ' . $meta['index'] . ' (cycle_id)'); + } + } + + ensure_school_cycle_backfill($pdo); + + if (schema_table_has_index($pdo, 'school_students', 'uniq_school_student_code') && !schema_table_has_index($pdo, 'school_students', 'uniq_school_student_cycle_code')) { + $pdo->exec('ALTER TABLE school_students DROP INDEX uniq_school_student_code'); + } + if (!schema_table_has_index($pdo, 'school_students', 'uniq_school_student_cycle_code')) { + $pdo->exec('ALTER TABLE school_students ADD UNIQUE KEY uniq_school_student_cycle_code (center_application_id, cycle_id, student_code)'); + } + + foreach ($tables as $table => $meta) { + if (!schema_table_has_foreign_key($pdo, $table, $meta['foreign_key'])) { + $pdo->exec( + 'ALTER TABLE ' . $table . ' ADD CONSTRAINT ' . $meta['foreign_key'] . ' FOREIGN KEY (cycle_id) REFERENCES school_cycles(id) ON DELETE CASCADE' + ); + } + } + + $done = true; +} + +function ensure_school_cycle_backfill(PDO $pdo): void +{ + $applicationRows = $pdo->query( + "SELECT * FROM center_applications WHERE status = 'approved' OR id IN ( + SELECT center_application_id FROM school_students + UNION SELECT center_application_id FROM school_teachers + UNION SELECT center_application_id FROM school_assessment_types + UNION SELECT center_application_id FROM school_attendance_records + ) ORDER BY id ASC" + )->fetchAll(); + + foreach ($applicationRows as $application) { + $applicationId = (int) ($application['id'] ?? 0); + if ($applicationId <= 0) { + continue; + } + + $cycleId = ensure_default_school_cycle_record($pdo, $application); + foreach (['school_students', 'school_teachers', 'school_assessment_types', 'school_attendance_records'] as $table) { + if (!schema_table_has_column($pdo, $table, 'cycle_id')) { + continue; + } + + $stmt = $pdo->prepare('UPDATE ' . $table . ' SET cycle_id = :cycle_id WHERE center_application_id = :center_application_id AND cycle_id IS NULL'); + $stmt->execute([ + ':cycle_id' => $cycleId, + ':center_application_id' => $applicationId, + ]); + } + } +} + +function school_cycle_season_map(): array +{ + return [ + 'summer' => ['label' => 'Summer', 'label_ar' => 'صيف'], + 'winter' => ['label' => 'Winter', 'label_ar' => 'شتاء'], + ]; +} + +function school_cycle_status_map(): array +{ + return [ + 'active' => ['label' => 'نشطة', 'class' => 'status-approved'], + 'upcoming' => ['label' => 'قادمة', 'class' => 'status-review'], + 'archived' => ['label' => 'مؤرشفة', 'class' => 'status-muted'], + ]; +} + +function school_cycle_status_badge(string $status): string +{ + $map = school_cycle_status_map(); + $meta = $map[$status] ?? ['label' => 'غير محدد', 'class' => 'status-muted']; + return '' . e($meta['label']) . ''; +} + +function school_cycle_season_options(): array +{ + return school_cycle_season_map(); +} + +function detect_school_cycle_season(?string $date = null): string +{ + $ts = $date ? strtotime($date) : time(); + if ($ts === false) { + $ts = time(); + } + + $month = (int) date('n', $ts); + return $month >= 5 && $month <= 9 ? 'summer' : 'winter'; +} + +function format_school_cycle_name(string $season, int $year): string +{ + $map = school_cycle_season_map(); + $label = $map[$season]['label'] ?? 'Cycle'; + return $label . ' ' . $year; +} + +function school_cycle_defaults(?array $application = null): array +{ + $season = detect_school_cycle_season((string) ($application['start_date'] ?? '')); + $year = (int) date('Y', strtotime((string) ($application['start_date'] ?? 'now')) ?: time()); + $startDate = clean_text((string) ($application['start_date'] ?? date('Y-m-d')), 20); + $endDate = clean_text((string) ($application['end_date'] ?? date('Y-m-d', strtotime('+90 days'))), 20); + + return [ + 'season' => $season, + 'year' => (string) $year, + 'start_date' => $startDate, + 'end_date' => $endDate, + 'status' => 'active', + ]; +} + +function validate_school_cycle_input(array $input, ?array $application = null): array +{ + $defaults = school_cycle_defaults($application); + $data = $defaults; + $data['season'] = clean_text((string) ($input['season'] ?? $defaults['season']), 20); + $data['year'] = clean_text((string) ($input['year'] ?? $defaults['year']), 4); + $data['start_date'] = clean_text((string) ($input['start_date'] ?? $defaults['start_date']), 20); + $data['end_date'] = clean_text((string) ($input['end_date'] ?? $defaults['end_date']), 20); + $data['status'] = clean_text((string) ($input['status'] ?? 'active'), 20); + + $errors = []; + if (!array_key_exists($data['season'], school_cycle_season_options())) { + $errors['season'] = 'يرجى اختيار موسم صحيح.'; + } + + $year = (int) $data['year']; + if ((string) $year !== $data['year'] || $year < 2020 || $year > 2100) { + $errors['year'] = 'يرجى إدخال سنة صحيحة مثل 2026.'; + } + + if ($data['start_date'] === '' || strtotime($data['start_date']) === false) { + $errors['start_date'] = 'يرجى إدخال تاريخ بداية صحيح.'; + } + if ($data['end_date'] === '' || strtotime($data['end_date']) === false) { + $errors['end_date'] = 'يرجى إدخال تاريخ نهاية صحيح.'; + } + if (!isset($errors['start_date'], $errors['end_date']) && strtotime($data['end_date']) < strtotime($data['start_date'])) { + $errors['end_date'] = 'تاريخ النهاية يجب أن يكون بعد البداية أو مساوياً لها.'; + } + + if (!in_array($data['status'], ['active', 'upcoming'], true)) { + $errors['status'] = 'يرجى اختيار حالة تشغيل صحيحة للدورة.'; + } + + return [$data, $errors]; +} + +function normalize_school_cycle_row(array $row): array +{ + $row['id'] = (int) ($row['id'] ?? 0); + $row['center_application_id'] = (int) ($row['center_application_id'] ?? 0); + $row['year'] = (int) ($row['year'] ?? 0); + $row['cycle_name'] = (string) ($row['cycle_name'] ?? format_school_cycle_name((string) ($row['season'] ?? ''), (int) ($row['year'] ?? 0))); + $row['status'] = (string) ($row['status'] ?? 'upcoming'); + return $row; +} + +function ensure_default_school_cycle_record(PDO $pdo, array $application): int +{ + $applicationId = (int) ($application['id'] ?? 0); + if ($applicationId <= 0) { + throw new InvalidArgumentException('Missing application id for school cycle.'); + } + + $stmt = $pdo->prepare('SELECT * FROM school_cycles WHERE center_application_id = :center_application_id ORDER BY FIELD(status, "active", "upcoming", "archived"), start_date DESC, id DESC LIMIT 1'); + $stmt->execute([':center_application_id' => $applicationId]); + $existing = $stmt->fetch(); + if ($existing) { + return (int) $existing['id']; + } + + $season = detect_school_cycle_season((string) ($application['start_date'] ?? '')); + $year = (int) date('Y', strtotime((string) ($application['start_date'] ?? 'now')) ?: time()); + $startDate = (string) ($application['start_date'] ?? date('Y-m-d')); + $endDate = (string) ($application['end_date'] ?? $startDate); + $cycleName = format_school_cycle_name($season, $year); + $status = ((string) ($application['status'] ?? '') === 'approved') ? 'active' : 'upcoming'; + + $insert = $pdo->prepare( + 'INSERT INTO school_cycles ( + center_application_id, season, year, cycle_name, start_date, end_date, + status, archived_at, created_at, updated_at + ) VALUES ( + :center_application_id, :season, :year, :cycle_name, :start_date, :end_date, + :status, NULL, NOW(), NOW() + )' + ); + $insert->execute([ + ':center_application_id' => $applicationId, + ':season' => $season, + ':year' => $year, + ':cycle_name' => $cycleName, + ':start_date' => $startDate, + ':end_date' => $endDate, + ':status' => $status, + ]); + + return (int) $pdo->lastInsertId(); +} + +function list_school_cycles(int $centerApplicationId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare('SELECT * FROM school_cycles WHERE center_application_id = :center_application_id ORDER BY start_date DESC, id DESC'); + $stmt->execute([':center_application_id' => $centerApplicationId]); + $rows = $stmt->fetchAll(); + + return array_map('normalize_school_cycle_row', $rows); +} + +function get_school_cycle(int $centerApplicationId, int $cycleId): ?array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare('SELECT * FROM school_cycles WHERE center_application_id = :center_application_id AND id = :id LIMIT 1'); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':id' => $cycleId, + ]); + $row = $stmt->fetch(); + + return $row ? normalize_school_cycle_row($row) : null; +} + + +function school_cycle_rollover_defaults(?array $selectedCycle = null): array +{ + return [ + 'source_cycle_id' => $selectedCycle ? (int) ($selectedCycle['id'] ?? 0) : 0, + 'copy_teachers' => true, + 'copy_assessments' => true, + 'copy_students' => false, + ]; +} + +function school_cycle_rollover_input(int $centerApplicationId, array $input, ?array $selectedCycle = null): array +{ + $defaults = school_cycle_rollover_defaults($selectedCycle); + $sourceCycleId = isset($input['source_cycle_id']) ? (int) $input['source_cycle_id'] : (int) $defaults['source_cycle_id']; + $sourceCycle = $sourceCycleId > 0 ? get_school_cycle($centerApplicationId, $sourceCycleId) : null; + + return [ + 'source_cycle_id' => $sourceCycle ? (int) ($sourceCycle['id'] ?? 0) : 0, + 'source_cycle' => $sourceCycle, + 'copy_teachers' => isset($input['copy_teachers']) ? (bool) $input['copy_teachers'] : false, + 'copy_assessments' => isset($input['copy_assessments']) ? (bool) $input['copy_assessments'] : false, + 'copy_students' => isset($input['copy_students']) ? (bool) $input['copy_students'] : false, + ]; +} + +function copy_school_cycle_rollover(PDO $pdo, int $centerApplicationId, int $sourceCycleId, int $targetCycleId, array $rollover): array +{ + $summary = [ + 'teachers' => 0, + 'assessments' => 0, + 'students' => 0, + ]; + + if (!empty($rollover['copy_teachers'])) { + $stmt = $pdo->prepare( + 'INSERT INTO school_teachers ( + center_application_id, cycle_id, full_name, role_title, specialization, + phone, email, employment_status, notes, + created_at, updated_at + ) + SELECT + center_application_id, :target_cycle_id, full_name, role_title, specialization, + phone, email, employment_status, notes, + NOW(), NOW() + FROM school_teachers + WHERE center_application_id = :center_application_id AND cycle_id = :source_cycle_id' + ); + $stmt->execute([ + ':target_cycle_id' => $targetCycleId, + ':center_application_id' => $centerApplicationId, + ':source_cycle_id' => $sourceCycleId, + ]); + $summary['teachers'] = $stmt->rowCount(); + } + + if (!empty($rollover['copy_assessments'])) { + $stmt = $pdo->prepare( + 'INSERT INTO school_assessment_types ( + center_application_id, cycle_id, title, category, scale_type, + max_score, weight_percentage, is_active, notes, + created_at, updated_at + ) + SELECT + center_application_id, :target_cycle_id, title, category, scale_type, + max_score, weight_percentage, is_active, notes, + NOW(), NOW() + FROM school_assessment_types + WHERE center_application_id = :center_application_id AND cycle_id = :source_cycle_id' + ); + $stmt->execute([ + ':target_cycle_id' => $targetCycleId, + ':center_application_id' => $centerApplicationId, + ':source_cycle_id' => $sourceCycleId, + ]); + $summary['assessments'] = $stmt->rowCount(); + } + + if (!empty($rollover['copy_students'])) { + $stmt = $pdo->prepare( + "INSERT INTO school_students ( + center_application_id, cycle_id, student_code, full_name, gender, grade_level, + guardian_name, guardian_phone, birth_date, enrollment_status, notes, + created_at, updated_at + ) + SELECT + center_application_id, :target_cycle_id, student_code, full_name, gender, grade_level, + guardian_name, guardian_phone, birth_date, enrollment_status, notes, + NOW(), NOW() + FROM school_students + WHERE center_application_id = :center_application_id + AND cycle_id = :source_cycle_id + AND enrollment_status IN ('active', 'waiting')" + ); + $stmt->execute([ + ':target_cycle_id' => $targetCycleId, + ':center_application_id' => $centerApplicationId, + ':source_cycle_id' => $sourceCycleId, + ]); + $summary['students'] = $stmt->rowCount(); + } + + return $summary; +} + +function create_school_cycle(int $centerApplicationId, array $data, array $rollover = []): array +{ + $pdo = db_connection(); + $season = $data['season']; + $year = (int) $data['year']; + $cycleName = format_school_cycle_name($season, $year); + $rollover = array_merge(school_cycle_rollover_defaults(), $rollover); + $sourceCycleId = (int) ($rollover['source_cycle_id'] ?? 0); + + $pdo->beginTransaction(); + try { + $sourceCycle = null; + if ($sourceCycleId > 0) { + $sourceStmt = $pdo->prepare('SELECT * FROM school_cycles WHERE center_application_id = :center_application_id AND id = :id LIMIT 1'); + $sourceStmt->execute([ + ':center_application_id' => $centerApplicationId, + ':id' => $sourceCycleId, + ]); + $sourceCycleRow = $sourceStmt->fetch(); + if ($sourceCycleRow) { + $sourceCycle = normalize_school_cycle_row($sourceCycleRow); + } elseif (!empty($rollover['copy_teachers']) || !empty($rollover['copy_assessments']) || !empty($rollover['copy_students'])) { + throw new InvalidArgumentException('Source cycle not found for rollover.'); + } + } + + if ($data['status'] === 'active') { + $archiveStmt = $pdo->prepare( + "UPDATE school_cycles + SET status = 'archived', archived_at = COALESCE(archived_at, NOW()), updated_at = NOW() + WHERE center_application_id = :center_application_id AND status = 'active'" + ); + $archiveStmt->execute([':center_application_id' => $centerApplicationId]); + } + + $insert = $pdo->prepare( + 'INSERT INTO school_cycles ( + center_application_id, season, year, cycle_name, start_date, end_date, + status, archived_at, created_at, updated_at + ) VALUES ( + :center_application_id, :season, :year, :cycle_name, :start_date, :end_date, + :status, :archived_at, NOW(), NOW() + )' + ); + $insert->execute([ + ':center_application_id' => $centerApplicationId, + ':season' => $season, + ':year' => $year, + ':cycle_name' => $cycleName, + ':start_date' => $data['start_date'], + ':end_date' => $data['end_date'], + ':status' => $data['status'], + ':archived_at' => $data['status'] === 'archived' ? date('Y-m-d H:i:s') : null, + ]); + + $cycleId = (int) $pdo->lastInsertId(); + $rolloverSummary = ['teachers' => 0, 'assessments' => 0, 'students' => 0]; + + if ($sourceCycle && ($rollover['copy_teachers'] || $rollover['copy_assessments'] || $rollover['copy_students'])) { + $rolloverSummary = copy_school_cycle_rollover($pdo, $centerApplicationId, (int) $sourceCycle['id'], $cycleId, $rollover); + } + + $pdo->commit(); + + return [ + 'cycle_id' => $cycleId, + 'cycle_name' => $cycleName, + 'source_cycle_name' => $sourceCycle ? (string) ($sourceCycle['cycle_name'] ?? '') : '', + 'rollover' => $rolloverSummary, + ]; + } catch (Throwable $exception) { + if ($pdo->inTransaction()) { + $pdo->rollBack(); + } + throw $exception; + } +} + +function archive_school_cycle(int $centerApplicationId, int $cycleId): void +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + "UPDATE school_cycles + SET status = 'archived', archived_at = COALESCE(archived_at, NOW()), updated_at = NOW() + WHERE center_application_id = :center_application_id AND id = :id" + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':id' => $cycleId, + ]); +} + +function resolve_school_cycle_context(int $centerApplicationId, ?array $application, int $requestedCycleId = 0): array +{ + if ($application && (string) ($application['status'] ?? '') === 'approved') { + $pdo = db_connection(); + ensure_default_school_cycle_record($pdo, $application); + } + + $cycles = list_school_cycles($centerApplicationId); + $selected = null; + $active = null; + + foreach ($cycles as $cycle) { + if ($cycle['status'] === 'active' && $active === null) { + $active = $cycle; + } + if ($requestedCycleId > 0 && (int) $cycle['id'] === $requestedCycleId) { + $selected = $cycle; + } + } + + if ($selected === null) { + $selected = $active ?? ($cycles[0] ?? null); + } + + return [ + 'cycles' => $cycles, + 'selected' => $selected, + 'active' => $active, + 'read_only' => $selected ? ((string) ($selected['status'] ?? '') === 'archived') : false, + ]; +} + +function school_page_url(string $page, int $applicationId, ?int $cycleId = null): string +{ + $url = $page . '?id=' . urlencode((string) $applicationId); + if ($cycleId !== null && $cycleId > 0) { + $url .= '&cycle=' . urlencode((string) $cycleId); + } + return $url; +} + +function create_student_in_cycle(int $centerApplicationId, int $cycleId, array $data): int +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'INSERT INTO school_students ( + center_application_id, cycle_id, student_code, full_name, gender, grade_level, + guardian_name, guardian_phone, birth_date, enrollment_status, notes, + created_at, updated_at + ) VALUES ( + :center_application_id, :cycle_id, :student_code, :full_name, :gender, :grade_level, + :guardian_name, :guardian_phone, :birth_date, :enrollment_status, :notes, + NOW(), NOW() + )' + ); + + $stmt->bindValue(':center_application_id', $centerApplicationId, PDO::PARAM_INT); + $stmt->bindValue(':cycle_id', $cycleId, PDO::PARAM_INT); + $stmt->bindValue(':student_code', $data['student_code'], PDO::PARAM_STR); + $stmt->bindValue(':full_name', $data['full_name'], PDO::PARAM_STR); + $stmt->bindValue(':gender', $data['gender'], PDO::PARAM_STR); + $stmt->bindValue(':grade_level', $data['grade_level'], PDO::PARAM_STR); + $stmt->bindValue(':guardian_name', $data['guardian_name'], PDO::PARAM_STR); + $stmt->bindValue(':guardian_phone', $data['guardian_phone'], PDO::PARAM_STR); + $stmt->bindValue(':birth_date', $data['birth_date'] !== '' ? $data['birth_date'] : null, $data['birth_date'] !== '' ? PDO::PARAM_STR : PDO::PARAM_NULL); + $stmt->bindValue(':enrollment_status', $data['enrollment_status'], PDO::PARAM_STR); + $stmt->bindValue(':notes', $data['notes'] !== '' ? $data['notes'] : null, $data['notes'] !== '' ? PDO::PARAM_STR : PDO::PARAM_NULL); + $stmt->execute(); + + return (int) $pdo->lastInsertId(); +} + +function list_school_students_by_cycle(int $centerApplicationId, int $cycleId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'SELECT * FROM school_students + WHERE center_application_id = :center_application_id AND cycle_id = :cycle_id + ORDER BY created_at DESC, id DESC' + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ]); + return $stmt->fetchAll(); +} + +function school_student_metrics_by_cycle(int $centerApplicationId, int $cycleId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + "SELECT + COUNT(*) AS total, + COALESCE(SUM(gender = 'طالب'), 0) AS boys_count, + COALESCE(SUM(gender = 'طالبة'), 0) AS girls_count, + COALESCE(SUM(enrollment_status = 'active'), 0) AS active_count, + COALESCE(SUM(enrollment_status = 'waiting'), 0) AS waiting_count, + COALESCE(SUM(enrollment_status = 'withdrawn'), 0) AS withdrawn_count + FROM school_students + WHERE center_application_id = :center_application_id AND cycle_id = :cycle_id" + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ]); + $row = $stmt->fetch() ?: []; + + return [ + 'total' => (int) ($row['total'] ?? 0), + 'boys' => (int) ($row['boys_count'] ?? 0), + 'girls' => (int) ($row['girls_count'] ?? 0), + 'active' => (int) ($row['active_count'] ?? 0), + 'waiting' => (int) ($row['waiting_count'] ?? 0), + 'withdrawn' => (int) ($row['withdrawn_count'] ?? 0), + ]; +} + +function create_teacher_in_cycle(int $centerApplicationId, int $cycleId, array $data): int +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'INSERT INTO school_teachers ( + center_application_id, cycle_id, full_name, role_title, specialization, + phone, email, employment_status, notes, + created_at, updated_at + ) VALUES ( + :center_application_id, :cycle_id, :full_name, :role_title, :specialization, + :phone, :email, :employment_status, :notes, + NOW(), NOW() + )' + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ':full_name' => $data['full_name'], + ':role_title' => $data['role_title'], + ':specialization' => $data['specialization'] !== '' ? $data['specialization'] : null, + ':phone' => $data['phone'] !== '' ? $data['phone'] : null, + ':email' => $data['email'] !== '' ? $data['email'] : null, + ':employment_status' => $data['employment_status'], + ':notes' => $data['notes'] !== '' ? $data['notes'] : null, + ]); + return (int) $pdo->lastInsertId(); +} + +function list_school_teachers_by_cycle(int $centerApplicationId, int $cycleId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'SELECT * FROM school_teachers + WHERE center_application_id = :center_application_id AND cycle_id = :cycle_id + ORDER BY created_at DESC, id DESC' + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ]); + return $stmt->fetchAll(); +} + +function school_teacher_metrics_by_cycle(int $centerApplicationId, int $cycleId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + "SELECT + COUNT(*) AS total, + COALESCE(SUM(employment_status = 'active'), 0) AS active_count, + COALESCE(SUM(employment_status = 'pending'), 0) AS pending_count, + COALESCE(SUM(employment_status = 'inactive'), 0) AS inactive_count, + COALESCE(SUM(role_title = 'معلم' OR role_title = 'معلمة'), 0) AS teachers_count, + COALESCE(SUM(role_title LIKE '%مشرف%' OR role_title LIKE '%منسق%'), 0) AS supervisors_count, + COALESCE(SUM(email IS NOT NULL AND email <> ''), 0) AS email_ready_count + FROM school_teachers + WHERE center_application_id = :center_application_id AND cycle_id = :cycle_id" + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ]); + $row = $stmt->fetch() ?: []; + + return [ + 'total' => (int) ($row['total'] ?? 0), + 'active' => (int) ($row['active_count'] ?? 0), + 'pending' => (int) ($row['pending_count'] ?? 0), + 'inactive' => (int) ($row['inactive_count'] ?? 0), + 'teachers' => (int) ($row['teachers_count'] ?? 0), + 'supervisors' => (int) ($row['supervisors_count'] ?? 0), + 'email_ready' => (int) ($row['email_ready_count'] ?? 0), + ]; +} + +function create_assessment_type_in_cycle(int $centerApplicationId, int $cycleId, array $data): int +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'INSERT INTO school_assessment_types ( + center_application_id, cycle_id, title, category, scale_type, + max_score, weight_percentage, is_active, notes, + created_at, updated_at + ) VALUES ( + :center_application_id, :cycle_id, :title, :category, :scale_type, + :max_score, :weight_percentage, :is_active, :notes, + NOW(), NOW() + )' + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ':title' => $data['title'], + ':category' => $data['category'], + ':scale_type' => $data['scale_type'], + ':max_score' => (float) $data['max_score'], + ':weight_percentage' => (float) $data['weight_percentage'], + ':is_active' => (int) $data['is_active'], + ':notes' => $data['notes'] !== '' ? $data['notes'] : null, + ]); + return (int) $pdo->lastInsertId(); +} + +function list_school_assessments_by_cycle(int $centerApplicationId, int $cycleId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'SELECT * FROM school_assessment_types + WHERE center_application_id = :center_application_id AND cycle_id = :cycle_id + ORDER BY is_active DESC, created_at DESC, id DESC' + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ]); + return $stmt->fetchAll(); +} + +function school_assessment_metrics_by_cycle(int $centerApplicationId, int $cycleId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + "SELECT + COUNT(*) AS total, + COALESCE(SUM(is_active = 1), 0) AS active_count, + COALESCE(SUM(is_active = 0), 0) AS inactive_count, + COALESCE(SUM(weight_percentage), 0) AS total_weight, + COALESCE(SUM(CASE WHEN is_active = 1 THEN weight_percentage ELSE 0 END), 0) AS active_weight, + COALESCE(AVG(max_score), 0) AS average_max_score, + COALESCE(SUM(scale_type = 'percentage'), 0) AS percentage_count, + COALESCE(SUM(scale_type = 'points'), 0) AS points_count, + COALESCE(SUM(scale_type = 'rubric'), 0) AS rubric_count + FROM school_assessment_types + WHERE center_application_id = :center_application_id AND cycle_id = :cycle_id" + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ]); + $row = $stmt->fetch() ?: []; + + return [ + 'total' => (int) ($row['total'] ?? 0), + 'active' => (int) ($row['active_count'] ?? 0), + 'inactive' => (int) ($row['inactive_count'] ?? 0), + 'total_weight' => (float) ($row['total_weight'] ?? 0), + 'active_weight' => (float) ($row['active_weight'] ?? 0), + 'average_max_score' => (float) ($row['average_max_score'] ?? 0), + 'percentage' => (int) ($row['percentage_count'] ?? 0), + 'points' => (int) ($row['points_count'] ?? 0), + 'rubric' => (int) ($row['rubric_count'] ?? 0), + ]; +} + +function school_student_options_by_cycle(int $centerApplicationId, int $cycleId): array +{ + $students = list_school_students_by_cycle($centerApplicationId, $cycleId); + $options = []; + foreach ($students as $student) { + $studentId = (int) ($student['id'] ?? 0); + if ($studentId <= 0) { + continue; + } + + $options[$studentId] = [ + 'label' => trim((string) ($student['full_name'] ?? '')), + 'status' => (string) ($student['enrollment_status'] ?? ''), + 'grade_level' => (string) ($student['grade_level'] ?? ''), + 'guardian_phone' => (string) ($student['guardian_phone'] ?? ''), + ]; + } + + return $options; +} + +function validate_attendance_input_for_cycle(int $centerApplicationId, int $cycleId, array $input): array +{ + $data = attendance_defaults(); + $data['student_id'] = (string) ((int) ($input['student_id'] ?? 0)); + $data['attendance_status'] = clean_text((string) ($input['attendance_status'] ?? ''), 30); + $data['absence_reason'] = clean_text((string) ($input['absence_reason'] ?? ''), 190); + $data['notes'] = clean_text((string) ($input['notes'] ?? ''), 1000); + $data['attendance_date'] = clean_text((string) ($input['attendance_date'] ?? ''), 20); + + $errors = []; + $studentId = (int) $data['student_id']; + $studentOptions = school_student_options_by_cycle($centerApplicationId, $cycleId); + + if ($studentId <= 0 || !array_key_exists($studentId, $studentOptions)) { + $errors['student_id'] = 'يرجى اختيار طالب صحيح من نفس الدورة الموسمية.'; + } + + $statusMap = attendance_status_map(); + if (!array_key_exists($data['attendance_status'], $statusMap)) { + $errors['attendance_status'] = 'يرجى اختيار حالة غياب صحيحة.'; + } + + if ($data['attendance_date'] === '' || strtotime($data['attendance_date']) === false) { + $errors['attendance_date'] = 'يرجى إدخال تاريخ صحيح للسجل اليومي.'; + } + + if ($data['attendance_status'] !== 'late' && $data['absence_reason'] === '') { + $errors['absence_reason'] = 'يرجى إدخال سبب الغياب أو العذر.'; + } + + return [$data, $errors]; +} + +function create_attendance_record_in_cycle(int $centerApplicationId, int $cycleId, array $data): int +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'INSERT INTO school_attendance_records ( + center_application_id, cycle_id, student_id, attendance_date, attendance_status, + absence_reason, notes, created_at, updated_at + ) VALUES ( + :center_application_id, :cycle_id, :student_id, :attendance_date, :attendance_status, + :absence_reason, :notes, NOW(), NOW() + )' + ); + + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ':student_id' => (int) $data['student_id'], + ':attendance_date' => $data['attendance_date'], + ':attendance_status' => $data['attendance_status'], + ':absence_reason' => $data['absence_reason'] !== '' ? $data['absence_reason'] : null, + ':notes' => $data['notes'] !== '' ? $data['notes'] : null, + ]); + + return (int) $pdo->lastInsertId(); +} + +function list_school_attendance_records_by_cycle(int $centerApplicationId, int $cycleId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + 'SELECT ar.*, s.student_code, s.full_name, s.grade_level, s.guardian_phone + FROM school_attendance_records ar + INNER JOIN school_students s ON s.id = ar.student_id + WHERE ar.center_application_id = :center_application_id AND ar.cycle_id = :cycle_id + ORDER BY ar.attendance_date DESC, ar.created_at DESC, ar.id DESC' + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ]); + return $stmt->fetchAll(); +} + +function school_attendance_metrics_by_cycle(int $centerApplicationId, int $cycleId): array +{ + $pdo = db_connection(); + $stmt = $pdo->prepare( + "SELECT + COUNT(*) AS total, + COALESCE(SUM(attendance_status = 'absent'), 0) AS absent_count, + COALESCE(SUM(attendance_status = 'excused'), 0) AS excused_count, + COALESCE(SUM(attendance_status = 'late'), 0) AS late_count, + COUNT(DISTINCT student_id) AS affected_students, + MAX(attendance_date) AS latest_date, + COALESCE(SUM(attendance_date = CURDATE()), 0) AS today_count + FROM school_attendance_records + WHERE center_application_id = :center_application_id AND cycle_id = :cycle_id" + ); + $stmt->execute([ + ':center_application_id' => $centerApplicationId, + ':cycle_id' => $cycleId, + ]); + $row = $stmt->fetch() ?: []; + + return [ + 'total' => (int) ($row['total'] ?? 0), + 'absent' => (int) ($row['absent_count'] ?? 0), + 'excused' => (int) ($row['excused_count'] ?? 0), + 'late' => (int) ($row['late_count'] ?? 0), + 'affected_students' => (int) ($row['affected_students'] ?? 0), + 'latest_date' => (string) ($row['latest_date'] ?? ''), + 'today_count' => (int) ($row['today_count'] ?? 0), + ]; +} diff --git a/students.php b/students.php index 95cfc3e..e145867 100644 --- a/students.php +++ b/students.php @@ -4,28 +4,46 @@ require_once __DIR__ . '/includes/app.php'; $flash = consume_flash(); $applicationId = filter_input(INPUT_GET, 'id', FILTER_VALIDATE_INT) ?: 0; +$requestedCycleId = filter_input(INPUT_GET, 'cycle', FILTER_VALIDATE_INT) ?: 0; $application = $applicationId > 0 ? get_application($applicationId) : null; $isApprovedSchool = $application && (string) $application['status'] === 'approved'; $values = student_defaults(); $errors = []; +$cycleContext = ['cycles' => [], 'selected' => null, 'active' => null, 'read_only' => false]; +$selectedCycle = null; +$selectedCycleId = 0; +$isCycleReadOnly = false; +$cycleLabel = 'لا توجد دورة بعد'; + +if ($application && $isApprovedSchool) { + $cycleContext = resolve_school_cycle_context((int) $application['id'], $application, $requestedCycleId); + $selectedCycle = $cycleContext['selected']; + $selectedCycleId = $selectedCycle ? (int) ($selectedCycle['id'] ?? 0) : 0; + $isCycleReadOnly = (bool) $cycleContext['read_only']; + $cycleLabel = $selectedCycle ? (string) $selectedCycle['cycle_name'] : $cycleLabel; +} if ($_SERVER['REQUEST_METHOD'] === 'POST' && $application) { [$values, $errors] = validate_student_input($_POST); if (!$isApprovedSchool) { $errors['form'] = 'لا يمكن فتح تسجيل الطلاب قبل اعتماد المركز.'; + } elseif ($selectedCycleId <= 0) { + $errors['form'] = 'يرجى إنشاء دورة موسمية أولاً من صفحة المركز.'; + } elseif ($isCycleReadOnly) { + $errors['form'] = 'هذه الدورة مؤرشفة للقراءة فقط. افتح دورة جديدة أو اختر دورة نشطة لإضافة طلاب جدد.'; } if ($errors === []) { try { - create_student((int) $application['id'], $values); - set_flash('success', 'تم تسجيل الطالب بنجاح وإضافته إلى كشف المدرسة.'); - header('Location: students.php?id=' . urlencode((string) $application['id'])); + create_student_in_cycle((int) $application['id'], $selectedCycleId, $values); + set_flash('success', 'تم تسجيل الطالب بنجاح داخل الدورة الموسمية المحددة.'); + header('Location: ' . school_page_url('students.php', (int) $application['id'], $selectedCycleId)); exit; } catch (PDOException $exception) { $duplicateCode = isset($exception->errorInfo[1]) && (int) $exception->errorInfo[1] === 1062; if ($duplicateCode) { - $errors['student_code'] = 'هذا الكود مستخدم مسبقاً داخل نفس المدرسة.'; + $errors['student_code'] = 'هذا الكود مستخدم مسبقاً داخل نفس الدورة الموسمية.'; } else { $errors['form'] = 'تعذر حفظ بيانات الطالب حالياً. يرجى المحاولة مرة أخرى.'; } @@ -35,8 +53,8 @@ if ($_SERVER['REQUEST_METHOD'] === 'POST' && $application) { } } -$students = $isApprovedSchool ? list_school_students((int) $application['id']) : []; -$metrics = $isApprovedSchool ? school_student_metrics((int) $application['id']) : [ +$students = $isApprovedSchool && $selectedCycleId > 0 ? list_school_students_by_cycle((int) $application['id'], $selectedCycleId) : []; +$metrics = $isApprovedSchool && $selectedCycleId > 0 ? school_student_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ 'total' => 0, 'boys' => 0, 'girls' => 0, @@ -47,8 +65,13 @@ $metrics = $isApprovedSchool ? school_student_metrics((int) $application['id']) $expectedCapacity = $application ? (int) ($application['expected_students'] ?? 0) : 0; $remainingSeats = max(0, $expectedCapacity - $metrics['total']); -$pageTitle = $application ? 'تسجيل الطلاب: ' . (string) $application['center_name'] : 'تسجيل الطلاب'; -$pageDescription = 'صفحة مستقلة لتسجيل الطلاب وإدارة كشف المدرسة بعد الاعتماد، مع فصل واضح بين النموذج والكشف والجاهزية التشغيلية.'; +$pageTitle = $application ? 'تسجيل الطلاب: ' . (string) $application['center_name'] . ($selectedCycle ? ' — ' . $cycleLabel : '') : 'تسجيل الطلاب'; +$pageDescription = 'صفحة مستقلة لتسجيل الطلاب وإدارة كشف المدرسة بعد الاعتماد، مع ربط كل البيانات بالدورة الموسمية النشطة أو المؤرشفة.'; +$approvedSchoolUrl = $application ? school_page_url('approved_school.php', (int) $application['id'], $selectedCycleId) : 'approved_school.php'; +$teachersUrl = $application ? school_page_url('teachers.php', (int) $application['id'], $selectedCycleId) : 'teachers.php'; +$assessmentsUrl = $application ? school_page_url('assessments.php', (int) $application['id'], $selectedCycleId) : 'assessments.php'; +$attendanceUrl = $application ? school_page_url('attendance.php', (int) $application['id'], $selectedCycleId) : 'attendance.php'; +$applicationDetailUrl = $application ? 'application_detail.php?id=' . urlencode((string) $application['id']) : 'application_detail.php'; if (!$application) { http_response_code(404); @@ -77,8 +100,8 @@ render_flash($flash); المدينة:
- العودة لملف الاعتماد - صفحة المركز + العودة لملف الاعتماد + صفحة المركز
@@ -96,9 +119,11 @@ render_flash($flash); المقاعد المتبقية
- العودة لصفحة المركز - فريق المعلمين - ملف الاعتماد + العودة لصفحة المركز + فريق المعلمين + التقييمات والأوزان + غياب الطلاب + ملف الاعتماد
@@ -116,6 +141,56 @@ render_flash($flash);
+ + +
+
+
+
+
+
الدورة الموسمية الحالية
+
كل بيانات هذه الصفحة مرتبطة الآن بالدورة . عند انتهاء الموسم يمكنك أرشفتها من صفحة المركز والبدء بدورة جديدة بدون فقدان السجلات القديمة.
+
+ +
+
+
اسم الدورة
+
الفترة →
+
عدد الدورات دورة للمركز
+
+
+ إدارة الدورات الموسمية +
+ +
هذه الدورة مؤرشفة حالياً، لذلك تبقى السجلات قابلة للمراجعة فقط بدون إضافة طلاب جدد.
+ +
+
+
+
+
التبديل بين الدورات
+

يمكنك فتح نفس صفحة الطلاب لأي موسم سابق أو حالي مباشرة من هنا بدون الرجوع إلى صفحة المركز.

+
+ + + +
+ + +
+ + +
+
+
+
+ +
@@ -130,7 +205,10 @@ render_flash($flash);
-
+ +
هذه الدورة مؤرشفة. يمكنك مراجعة كشف الطلاب فقط، أو فتح دورة جديدة من صفحة المركز.
+ +
@@ -214,15 +292,16 @@ render_flash($flash);
- + +
جاهزية بقية الوحدات
    -
  • المعلمينالصفحة أصبحت جاهزة الآن لإدارة الفريق التعليمي لهذا المركز.
    فتح صفحة المعلمين
    • -
  • التقييمات والأوزانالأساس جاهز لتخزين نوع التقييم، المقياس، والوزن.
    • -
  • غياب الطلابسجل الغياب موجود في القاعدة وسيتم بناء صفحته المنفصلة لاحقاً.
    • +
  • المعلمينالصفحة أصبحت جاهزة الآن لإدارة الفريق التعليمي لهذا المركز.
    فتح صفحة المعلمين
    • +
  • التقييمات والأوزانالصفحة أصبحت جاهزة الآن لتعريف أنواع التقييم والمقاييس والأوزان.
    فتح صفحة التقييمات
    • +
  • غياب الطلابالصفحة أصبحت جاهزة الآن لتسجيل الغياب اليومي، الأعذار، وحالات التأخر.
    فتح صفحة الغياب
diff --git a/teachers.php b/teachers.php index 66ea2a8..155a64d 100644 --- a/teachers.php +++ b/teachers.php @@ -4,51 +4,73 @@ require_once __DIR__ . '/includes/app.php'; $flash = consume_flash(); $applicationId = filter_input(INPUT_GET, 'id', FILTER_VALIDATE_INT) ?: 0; +$requestedCycleId = filter_input(INPUT_GET, 'cycle', FILTER_VALIDATE_INT) ?: 0; $application = $applicationId > 0 ? get_application($applicationId) : null; $isApprovedSchool = $application && (string) $application['status'] === 'approved'; $values = teacher_defaults(); $errors = []; +$cycleContext = ['cycles' => [], 'selected' => null, 'active' => null, 'read_only' => false]; +$selectedCycle = null; +$selectedCycleId = 0; +$isCycleReadOnly = false; +$cycleLabel = 'لا توجد دورة بعد'; + +if ($application && $isApprovedSchool) { + $cycleContext = resolve_school_cycle_context((int) $application['id'], $application, $requestedCycleId); + $selectedCycle = $cycleContext['selected']; + $selectedCycleId = $selectedCycle ? (int) ($selectedCycle['id'] ?? 0) : 0; + $isCycleReadOnly = (bool) $cycleContext['read_only']; + $cycleLabel = $selectedCycle ? (string) $selectedCycle['cycle_name'] : $cycleLabel; +} if ($_SERVER['REQUEST_METHOD'] === 'POST' && $application) { [$values, $errors] = validate_teacher_input($_POST); if (!$isApprovedSchool) { $errors['form'] = 'لا يمكن فتح صفحة المعلمين قبل اعتماد المركز.'; + } elseif ($selectedCycleId <= 0) { + $errors['form'] = 'يرجى إنشاء دورة موسمية أولاً من صفحة المركز.'; + } elseif ($isCycleReadOnly) { + $errors['form'] = 'هذه الدورة مؤرشفة للقراءة فقط. افتح دورة جديدة أو اختر دورة نشطة لإضافة أعضاء جدد.'; } if ($errors === []) { try { - create_teacher((int) $application['id'], $values); - set_flash('success', 'تمت إضافة عضو الفريق بنجاح إلى سجل المدرسة.'); - header('Location: teachers.php?id=' . urlencode((string) $application['id'])); + create_teacher_in_cycle((int) $application['id'], $selectedCycleId, $values); + set_flash('success', 'تمت إضافة عضو الفريق داخل الدورة الموسمية المحددة بنجاح.'); + header('Location: ' . school_page_url('teachers.php', (int) $application['id'], $selectedCycleId)); exit; } catch (Throwable $exception) { - $errors['form'] = 'تعذر حفظ بيانات عضو الفريق حالياً. يرجى المحاولة مرة أخرى.'; + $errors['form'] = 'تعذر حفظ بيانات الفريق حالياً. يرجى المحاولة مرة أخرى.'; } } } -$teachers = $isApprovedSchool ? list_school_teachers((int) $application['id']) : []; -$metrics = $isApprovedSchool ? school_teacher_metrics((int) $application['id']) : [ +$teachers = $isApprovedSchool && $selectedCycleId > 0 ? list_school_teachers_by_cycle((int) $application['id'], $selectedCycleId) : []; +$metrics = $isApprovedSchool && $selectedCycleId > 0 ? school_teacher_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ 'total' => 0, 'active' => 0, 'pending' => 0, 'inactive' => 0, - 'email_ready' => 0, + 'teachers' => 0, 'supervisors' => 0, + 'email_ready' => 0, ]; - -$studentMetrics = $isApprovedSchool ? school_student_metrics((int) $application['id']) : [ +$studentMetrics = $isApprovedSchool && $selectedCycleId > 0 ? school_student_metrics_by_cycle((int) $application['id'], $selectedCycleId) : [ 'total' => 0, + 'boys' => 0, + 'girls' => 0, 'active' => 0, 'waiting' => 0, 'withdrawn' => 0, - 'boys' => 0, - 'girls' => 0, ]; - -$pageTitle = $application ? 'فريق المعلمين: ' . (string) $application['center_name'] : 'فريق المعلمين'; -$pageDescription = 'صفحة مستقلة لإدارة المعلمين والمشرفين بعد اعتماد المدرسة، مع فصل واضح بين إضافة الكادر وكشف الفريق ومؤشرات الجاهزية.'; +$pageTitle = $application ? 'فريق المعلمين: ' . (string) $application['center_name'] . ($selectedCycle ? ' — ' . $cycleLabel : '') : 'فريق المعلمين'; +$pageDescription = 'صفحة مستقلة لإدارة المعلمين والمشرفين بعد اعتماد المدرسة، مع ربط كل فريق بالدورة الموسمية المناسبة.'; +$approvedSchoolUrl = $application ? school_page_url('approved_school.php', (int) $application['id'], $selectedCycleId) : 'approved_school.php'; +$studentsUrl = $application ? school_page_url('students.php', (int) $application['id'], $selectedCycleId) : 'students.php'; +$assessmentsUrl = $application ? school_page_url('assessments.php', (int) $application['id'], $selectedCycleId) : 'assessments.php'; +$attendanceUrl = $application ? school_page_url('attendance.php', (int) $application['id'], $selectedCycleId) : 'attendance.php'; +$applicationDetailUrl = $application ? 'application_detail.php?id=' . urlencode((string) $application['id']) : 'application_detail.php'; if (!$application) { http_response_code(404); @@ -77,8 +99,8 @@ render_flash($flash); المدينة:
- العودة لملف الاعتماد - صفحة المركز + العودة لملف الاعتماد + صفحة المركز
@@ -96,9 +118,11 @@ render_flash($flash); أدوار إشرافية
- العودة لصفحة المركز - تسجيل الطلاب - ملف الاعتماد + العودة لصفحة المركز + تسجيل الطلاب + التقييمات والأوزان + غياب الطلاب + ملف الاعتماد
@@ -115,6 +139,56 @@ render_flash($flash);
+ + +
+
+
+
+
+
الدورة الموسمية الحالية
+
أعضاء الفريق في هذه الصفحة مرتبطون بالدورة . عند أرشفة الموسم ستبقى القائمة محفوظة للرجوع إليها لاحقاً.
+
+ +
+
+
اسم الدورة
+
الفترة →
+
عدد الدورات دورة للمركز
+
+
+ إدارة الدورات الموسمية +
+ +
هذه الدورة مؤرشفة، لذلك تبقى صفحة الفريق للقراءة فقط حالياً.
+ +
+
+
+
+
التبديل بين الدورات
+

بدّل مباشرة إلى نفس صفحة الفريق في أي دورة سابقة أو حالية لمراجعة الكادر بدون الرجوع إلى صفحة المركز.

+
+ + + +
+ + +
+ + +
+
+
+
+ +
إجمالي الفريق
عدد أعضاء الكادر المسجلين لهذا المركز.
مفعلون
جاهزون للبدء الفعلي ضمن الخطة التشغيلية.
@@ -136,6 +210,9 @@ render_flash($flash);
+ +
هذه الدورة مؤرشفة. يمكنك مراجعة الفريق فقط، أو فتح دورة جديدة من صفحة المركز.
+
@@ -191,13 +268,14 @@ render_flash($flash);
+
الخطوة التالية بعد الفريق
@@ -268,8 +346,10 @@ render_flash($flash);
البريد الرسمي
- العودة إلى الطلاب - صفحة المركز + العودة إلى الطلاب + فتح التقييمات + فتح الغياب + صفحة المركز