كيف يعمل هذا المشروع

تنشر عُمان إحصاءات حقيقية — لكن دون طبقة تطويرية: لا واجهة برمجية موجّهة للمطوّرين ولا نسخ كاملة بإصدارات، ولا ضمانات للصيغ. هذا المشروع هو تلك الطبقة، بُني مكمِّلًا للبوابات الرسمية لا بديلًا عنها.

1. مصادر رسمية فقط. كل مجموعة بيانات تُجلب من ملف منشور رسميًا (المركز الوطني للإحصاء والمعلومات، الوزارات، الجهات التنظيمية). لا شيء يُستخرج من مصدر لم يُنشر عمدًا.
2. كل لقطة مؤرشفة. الملف المصدري لكل عملية جلب محفوظ في المستودع تحت raw/ — فكل رقم يمكن تتبّعه: JSON ← إيداع git ← اللقطة المؤرشفة. ومعظم اللقطات ملفات رسمية مباشرةً، وحيثما أُعيد بناء قيمة بدلًا من نشرها — كجزء من تاريخ أسعار الوقود الذي لا يوجد له أرشيف رسمي قابل للقراءة آليًا — فعمود source في الصف نفسه يصرّح بذلك.
3. التحقق يسبق النشر. تُفحص البنية والمدى ومنطقية عدد الصفوف قبل نشر أي شيء. تعطُّل المصدر لا يكسر البيانات المنشورة — تبقى آخر نسخة سليمة.
4. صراحة في الحداثة. أي مجموعة تجاوزت نافذة تحديثها تُعلَّم بـ"stale": true — لا تقادم صامت أبدًا.
5. ثنائية اللغة عقدًا لا خيارًا. كل مجموعة تحمل عنوانًا عربيًا وإنجليزيًا، والعربية مخزنة دون ترميز. ما لا يحمل اللغتين لا يُنشر.

استخدمه

curl https://omandata.dev/v1/datasets.json

JSON ثابت، CORS مفتوح، بلا مفاتيح ولا حدود استخدام سوى حدود شبكة التوزيع. البيانات الكاملة بصيغتي CSV وParquet في مستودع خط الأنابيب.

الترخيص والإسناد

الشيفرة برخصة MIT. كل مجموعة بيانات تحتفظ برخصة مصدرها الرسمي (رخصة الحكومة المفتوحة – عُمان للبيانات الحكومية). مشروع مستقل من ناصر البوسعيدي، غير تابع لأي جهة حكومية.