عن المشروع

يجمع هذا المستودع بيانات شاغري مواقف السيارات التي تنشرها جامعة Monash. توفر الجامعة ملف JSON عاماً يسرد توفر المواقف لكل موقف سيارات في Monash مزود بمستشعرات، بما في ذلك جميع المواقف الرئيسية. يتم تحديث ملف JSON هذا كل دقيقتين وهو متاح عبر رابط URL عام، والذي يستخدمه المشروع كمصدر لبياناته. يرتكز المستودع على نص برمجى واحد بلغة Python وهو scraper.py، والذي يقرأ ملف JSON ويسجل النتائج في ملف CSV باسم monash_all_parking_availabilities.csv. من المفترض أن يعمل النص البرمجي تلقائياً بدلاً من التشغيل اليدوي: حيث يقوم ملف سير العمل scrape.yml بتشغيله عبر GitHub Actions، ويتم تحفيز عمليات التشغيل كل ست دقائق بواسطة خدمة الجدولة الخارجية cron-job.org. ويذكر المؤلف أن تجميع البيانات بدأ في 21 أغسطس 2026، ومن المتوقع أن يستمر ملف CSV في النمو في المستقبل المنظور، وأنه يمكن لأي شخص استخدام البيانات الناتجة كما يشاء، وبشكل قانوني. يتسم ملف README بالصراحة بشأن أصول المشروع؛ فهو أول مشروع للمؤلف على GitHub وتم القيام به إلى حد كبير كوسيلة لتعلم كيفية عمل GitHub. تمت كتابة معظم النصوص البرمجية بمساعدة المساعد Gemini تحت إشراف المؤلف، واتبع إعداد المستودع تعليمات المساعد. يشير المؤلف إلى أن البيانات ستكبر في النهاية: حيث يقول تحديث بتاريخ 29 أغسطس 2026 من المرجح الوصول إلى حدود حجم الملف في غضون خمسة أشهر تقريباً، ويسرد العمل المخطط له للمتابعة. وتتمثل هذه الخطط في تحليل جميع سلاسل البيانات؛ وقصر الجمع على السلاسل النشطة لموقف السيارات N1 (جميع التصاريح) بالإضافة إلى مواقف السيارات ذات التصاريح الزرقاء أو الحمراء الأخرى؛ وتخزين البيانات بتنسيق عريض، بناءً على أن البيانات يجب أن تكون كثيفة بدلاً من متفرقة نظراً لقلة السلاسل التي تتغير خلال عام؛ وربما نشر صفحة ويب على GitHub تعرض، بناءً على الاتجاهات التاريخية، ما إذا كان من المتوقع توفر مكان لركن السيارة قبل ساعة من الآن، إلى جانب عرض تفاعلي لبيانات CSV، والتي قد يتم تقسيمها إلى ملفات شهرية. في حالته الحالية، يعد المشروع خط أنابيب بسيط لجمع البيانات المجدولة: نقطة نهاية JSON مستضافة كمصدر، ونص برمجى Python للجلب والإضافة، وسير عمل GitHub Actions للتنفيذ، وخدمة cron خارجية للتوقيت. لا يصف ملف README تفاصيل المصادقة، أو تفاصيل التحليل، أو معالجة الأخطاء، أو أي أدوات تحليل، كما أن العناصر المستقبلية المدرجة مذكورة كنوايا وليست كميزات تم تنفيذها.