مدقق يكشف تكرار الموعد عند تغير التوقيت المحلي: مشاريع تخرج هندسة البرمجيات

يحدد فريق اجتماعاً أسبوعياً كل اثنين عند التاسعة صباحاً في توقيت عمّان، ثم يفتح عضواً التقويم في مدينة أخرى أو يعبر التطبيق فترة يتغير فيها فرق الساعة. تخزين الموعد كساعة ثابتة وحدها قد ينقل الاجتماع إلى وقت محلي غير مقصود. يمكن لمشاريع تخرج هندسة البرمجيات بناء مدقق يولد الوقائع التالية للسلسلة المتكررة، ويعرض الوقت المحلي وUTC والمنطقة المسماة لكل واحدة. لا يرسل المدقق دعوات ولا يقرر ما يفضله المشاركون؛ يكشف الغموض قبل الحفظ.

خزّن القاعدة لا إزاحة الساعة فقط

الفرق بين UTC والمنطقة الزمنية ليس ثابتاً دائماً. خزّن وقتاً محلياً ومنطقة معرفّة مثل Asia/Amman مع قاعدة recurrence، ثم احسب كل وقوع وفق بيانات IANA. لا تخزن +02:00 كأنها هوية المنطقة، لأن قواعد المنطقة قد تتغير وقد لا تنطبق الإزاحة نفسها طوال السنة. توفر وحدة zoneinfo في Python الوصول إلى قاعدة IANA ضمن نموذج اللغة، ويحدد RFC 5545 تمثيل أحداث التقويم والتكرار في iCalendar.

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

مثّل السلسلة ووقائعها منفصلتين

السلسلة تتكون من تاريخ بداية محلي ووقت ومنطقة وقاعدة مثل كل أسبوع في يوم محدد، وربما عدد الوقائع أو تاريخ نهاية. كل وقوع سجل مستقل يحمل local datetime وUTC instant وحالة الغموض. لا تخلط قائمة الوقائع المحسوبة مع تعريف السلسلة، لأن المستخدم قد يعدل وقوعاً واحداً أو يحول قاعدة الوقت. في النسخة الأولية اجعل تعديل استثناء منفرد خارج النطاق أو أضفه كنوع واضح منفصل.

احفظ أيضاً قاعدة التكرار كنص منضبط وافحص الصيغة. RFC 5545 يدعم تعبير recurrence أوسع من حاجة مشروع صغير؛ لا تنفذ كامل المواصفة إذا كان المطلوب موعداً أسبوعياً فقط. عند استيراد ملف تقويم، ارفض الخصائص التي لا تفهمها أو احتفظ بها في حقل منفصل، ولا تحولها إلى نتيجة ناقصة تبدو صحيحة.

مثال ساعة تنتقل إلى الأمام

جهز سلسلة تبدأ في يوم اثنين محدد عند 09:00 في منطقة اختبار تمر انتقالاً زمنياً. اعرض الوقائع قبل الانتقال وبعده. يجب أن يبقى العرض المحلي على 09:00 إذا كانت هذه نية المستخدم، حتى إن تغير instant UTC المقابل. ثم أنشئ حالة مختلفة تبدأ عند ساعة غير موجودة في يوم الانتقال؛ أظهر رسالة تشرح أن الساعة المحلية لم تقع، واسأل المراجع هل ينقلها للأمام أو يرفض الموعد. لا تعمم سياسة واحدة على جميع تطبيقات التقويم.

أنشئ أيضاً سلسلة داخل منطقة تعيد الساعة إلى الوراء. إذا تكرر 01:30، أظهر خيار التوقيت الأول أو الثاني أو اختيار المستخدم، واحتفظ بالاختيار مع الوقوع. قارن النتيجة بعد تحديث قاعدة IANA، ووضح أن موعداً بعيداً في المستقبل قد يتغير instant عند تحديث القواعد. الأمثلة بيانات اصطناعية في مجموعة اختبار وليست أحداثاً حقيقية.

اشرح التحويل للقارئ

في جدول النتائج اعرض التاريخ والوقت المحلي والمنطقة والإزاحة في تلك الواقعة وUTC عند الحاجة. لا تعرض أرقام UTC وحدها للمستخدم العادي. إذا كانت السلسلة خارج منطقة المستخدم، اكتب اسم المنطقة صريحاً بدلاً من عبارة مبهمة مثل «التوقيت المحلي». أضف زر مقارنة لا يغير البيانات، يعرض النتائج قبل وبعد تحديث ملف المنطقة الزمنية.

في API، لا تقبل وقتاً محلياً دون منطقة إلا إذا كانت خاصية المنتج تسمح بذلك. تحقق من أن instant محفوظ بصيغة واعية بالمنطقة أو UTC، وأن القيمة الأصلية لا تضيع. لا تعتمد على وقت جهاز العميل وحده لتفسير مواعيد مقررة في منطقة مؤسسة. لا يجعل المدقق التطبيق متوافقاً بالكامل مع كل تقويم ولا يستبدل مراجعة سياسة الجهة.

اختبر الانتقالات والاستثناءات

أنشئ اختبارات لتاريخ عادي، ووقت غير موجود، ووقت يظهر مرتين، سلسلة أسبوعية تعبر الانتقال، يوم 29 فبراير، نهاية سلسلة، منطقة غير معروفة، وتحديث قاعدة المنطقة. قارن النتائج مع مجموعة متوقعة مكتوبة يدوياً أو مع تنفيذ مرجعي مستقل. اختبر serializing and deserializing تعريف السلسلة كي لا تتغير المنطقة أو القاعدة. سجل نسخة النظام والبيانات الزمنية مع كل نتيجة.

كخط أساس، استخدم إضافة سبعة أيام إلى instant UTC ثم قارنها بإنشاء الوقائع في الوقت المحلي المقصود. هذه الطريقة البسيطة قد تحافظ على المسافة الزمنية لا الساعة المدنية؛ يوضح الفرق لماذا يحتاج النظام إلى تعريف واضح. لا تجعل اختباراً واحداً لتاريخ الأردن يثبت التعامل الصحيح مع كل مناطق العالم.

نطاق مشروع التخرج

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