قواعد الحضور والورديات الكاملة — Moon HR

استثناء للسيدات المرضعات — سماح إضافي في الحضور.

على الموظف: حقل is_nursing: boolean + nursing_start_date: date

على الموظف: حقل is_special_needs: boolean + special_needs_type: varchar

بصمات إضافية أثناء الدوام للتأكد إن الموظف موجود في مكان العمل.

كل وردية ليها إعداداتها الخاصة — تطغى على الإعدادات العامة.

حقول الوردية الحالية + الجديدة:

كل الإعدادات بقت على مستوى الوردية — مش الشركة. كل وردية ليها قواعدها الخاصة.

المرونة (Flexibility):

الورديات متعددة الأيام:

مثال 1: hours_per_day = 6 ساعات

مثال 2: hours_per_day = 8 ساعات

لو الموظف تأخر أكتر من حد معين، يتحول من "متأخر" لـ "غائب".

القاعدة:

للورديات متعددة الأيام:

عند تسجيل الحضور (Check-in):

function calculateCheckIn(employee, shift, checkInTime):

  // 1. حساب السماح الإجمالي (كل الإعدادات من الوردية)
  grace = shift.late_threshold_minutes  // 60 (من الوردية مباشرة)

  if (shift.flexibility_minutes > 0):
    grace = shift.flexibility_minutes  // المرونة تحل محل السماح

  if (employee.is_nursing):
    grace += shift.nursing_extra_minutes  // +60 (من الوردية)

  if (employee.is_special_needs):
    grace += shift.special_needs_extra_minutes  // +60 (من الوردية)

  // 2. حساب التأخير
  diff = checkInTime - shift.start_time  // بالدقائق
  max_late = shift.max_late_before_absent  // 180 (من الوردية)

  if (diff <= grace):
    // ✅ حاضر — في حدود السماح
    status = PRESENT
    late_minutes = 0
    absent_days = 0

  else if (diff <= max_late):
    // ⚠️ متأخر — تجاوز السماح بس لسه في حدود التأخير
    status = LATE
    if (shift.late_counts_full):
      late_minutes = diff  // كل الوقت
    else:
      late_minutes = diff - grace
    absent_days = 0

  else:
    // ❌ غائب — تجاوز حد التأخير الأقصى
    status = ABSENT
    late_minutes = 0  // مش متأخر — غائب

    // للورديات متعددة الأيام:
    if (shift.equivalent_days > 1):
      absent_days = 1  // اليوم الأول بس غائب
      remaining_days = shift.equivalent_days - 1  // باقي الأيام حاضر
      // لو التأخير > 6 ساعات (deduction_base_hours):
      if (diff > shift.deduction_base_hours * 60):
        // التأخير يتوزع على اليوم التالي
        extra_late = diff - (shift.deduction_base_hours * 60)
        // اليوم الثاني = متأخر بالزيادة
    else:
      absent_days = 1  // وردية عادية — يوم واحد غائب

  // 3. حساب الانصراف المتوقع (لو مرونة)
  if (shift.flexibility_minutes > 0 && diff > 0 && diff <= shift.flexibility_minutes):
    expected_checkout = checkInTime + shift.working_hours
  else:
    expected_checkout = shift.end_time

  return { status, late_minutes, absent_days, expected_checkout }
    

عند تسجيل الانصراف (Check-out):

function calculateCheckOut(attendance, shift, checkOutTime):

  // 1. حساب سماح الانصراف (من الوردية)
  early_grace = shift.early_leave_threshold_minutes  // 30

  if (employee.is_special_needs):
    early_grace += shift.special_needs_extra_minutes  // +60

  // 2. حساب الانصراف المتوقع
  expected_end = attendance.expected_checkout ?? shift.end_time

  // 3. حساب الانصراف المبكر
  early_diff = expected_end - checkOutTime  // بالدقائق

  if (early_diff <= early_grace):
    early_leave_minutes = 0
  else:
    if (shift.early_leave_counts_full):
      early_leave_minutes = early_diff
    else:
      early_leave_minutes = early_diff - early_grace

  // 4. حساب ساعات العمل
  worked_hours = checkOutTime - attendance.check_in
  overtime = max(0, worked_hours - shift.working_hours)

  // 5. حساب أيام الحضور
  hours_per_day = shift.hours_per_day ?? 6
  equivalent_days = ceil(shift.working_hours / hours_per_day)  // محسوب تلقائي

  return { worked_hours, overtime, early_leave_minutes, equivalent_days }
    

A. إعدادات HR جديدة (Settings Seeder):

B. حقول جديدة على employees:

C. حقول جديدة على shifts (كل الإعدادات على مستوى الوردية):

D. حقل جديد على attendances:

E. تعديل AttendanceResource:

إضافة في الـ response: device_name, punch_type, expected_checkout, equivalent_days, early_leave_minutes

F. تعديل منطق AttendanceService::checkIn() و checkOut()

حسب الـ Algorithm في القسم 7 فوق.

1. شاشة الحضور: عرض المصدر (بصمة/ويب/يدوي) + اسم الجهاز + انصراف مبكر + أيام مكافئة
2. فورم الموظف: toggle مرضعة + تاريخ بداية + toggle ذوي همم + نوع الإعاقة
3. فورم الوردية: مرونة (دقائق) + أيام مكافئة + ساعات الخصم + سماح تأخير/انصراف خاص
4. شاشة الإعدادات: كل الإعدادات الجديدة الـ 13