دليل المستودع: مجموعة بيانات تخطيط الحملات للمناسبات الثقافية والدينية في MENA

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Build an open-source MENA commercial and cultural holiday dataset (2025-2028): 1) Machine-readable JSON and CSV detailing dates, shopping phase duration, and recommended creative lead times for all major Islamic and national holidays (Saudi National Day, Saudi Foundation Day, UAE National Day, Ramadan, Eid al-Fitr, Eid al-Adha, White Friday, Mother's Day, Back-to-School), 2) Importable .ics calendar file, 3) 52-week marketing flighting schedule.

لمن صُمم؟

الجمهور المحدد في README: BOTH operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

• calendar/mena_marketing_calendar.ics
• data/events_table.csv
• data/mena_marketing_events_2026_2027.json
• data/mena_marketing_holidays.csv
• data/mena_marketing_holidays_2025_2028.json
• docs/holiday-consumer-spending-profiles.md
• docs/retail-preparation-lead-times.md
• LICENSE
• README.md
• SOURCES.md
• templates/campaign-leadtime-planner.md
• tests/test_data_integrity.py

طريقة مراجعته واستخدامه

1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests

مستودعات مرتبطة

• قاموس المصطلحات التجارية والتسويقية باللهجة المصرية والخليجية
• دليل الامتثال لنظام موثوق واللوائح الإعلانية في السعودية
• حزمة تحسين أداء الخطوط وتحميلها لمواقع الويب العربية