عن المشروع

يوفر هذا المشروع حلاً سحابياً آلياً يمكن نشره في مستودعات GitHub لتتبع مبيعات فعاليات توقيعات Ktown4u بشكل مستمر. يستخدم المشروع مهام GitHub Actions المجدولة للعمل كل 5 دقائق، حيث يقوم خلال كل دورة بجلب البيانات بفاصل زمني يبلغ حوالي 10 ثوانٍ، ثم يضيف النتائج إلى ملفات CSV في مجلد data، متضمنة حقول: الوقت (time)، العضو (member)، المبيعات (sales)، والتغير (delta). المكونات الرئيسية تشمل: - .github/workflows/track.yml: إعدادات سير العمل المجدول. - ktown4u_ci.py: سكربت الجلب. - track_config.json: إعدادات أرقام الفعاليات المراد مراقبتها، فترات الجلب، ومدة كل دورة. - data/: ملفات بيانات CSV التاريخية المولدة تلقائياً. تتضمن خطوات الاستخدام إنشاء مستودع عام، رفع الملفات المذكورة، تفعيل Actions، ثم ملء رقم الفعالية في track_config.json. يمكن للمستودعات العامة استخدام Actions مجاناً وبدون حدود، بينما تقتصر المستودعات الخاصة على 2000 دقيقة شهرياً. يمكن عرض البيانات أو تحميلها مباشرة من المستودع، أو استنساخها محلياً واستخدام سكربتات مرافقة لتقدير فترات المبيعات. توضح وثائق المشروع القيود التالية: دقة المهام المجدولة في GitHub هي 5 دقائق كحد أدنى وقد تواجه تأخيراً، لذا فهي ليست عملية جلب مستمرة كل 10 ثوانٍ بشكل فعلي؛ يمكن فقط تتبع الفعاليات الجارية أو التي انتهت للتو، ولا يمكن الوصول للفعاليات المؤرشفة القديمة؛ وللحصول على جلب مستمر بالثواني، يلزم استخدام خادم سحابي دائم.