Siro/docs/03_pricing/pricing_system_report.md

تقرير نظام التسعير الشامل

1. دورة حياة التسعير: كيف تتم عملية التسعير من البداية للنهاية؟

نظام التسعير هو نظام ديناميكي وذكي يعتمد على تحليل السوق باستمرار لضمان التنافسية والربحية. تمر العملية بالمراحل التالية:

المرحلة الأولى: جمع البيانات الحية
تقوم سكريبتات الجافاسكريبت بالعمل على مدار الساعة لجلب أسعار المنافسين من السوق وحالة الطلب في مناطق مختلفة، ويتم تغذية قاعدة البيانات بهذه الأرقام الأولية.

المرحلة الثانية: تحليل البيانات بالذكاء الاصطناعي
يعمل السكريبت المخصص للذكاء الاصطناعي على تحليل البيانات الواردة وفك تشفير معادلات التسعير الخاصة بالمنافسين (سعر الكيلومتر، سعر البداية) ويقوم بتخزين هذه المعادلات.

المرحلة الثالثة: محرك الثبات والاستقرار
وهو السكريبت الجديد، ومهمته الأساسية هي منع التذبذب العشوائي لأسعارنا.
- يقوم بمقارنة السعر الحالي للمنافس مع متوسط السعر في آخر 7 أيام.
- إذا قام المنافس بتنزيل السعر فجأة، يعتبره النظام عرضاً ترويجياً مؤقتاً ولا يغير سعرنا الأساسي، بل يقترح استخدام أكواد خصم.
- إذا استمر انخفاض أو ارتفاع السعر لفترة طويلة، يقرر النظام أن هذا تغيير حقيقي في السوق، ويقترح تعديل سعرنا بحد أقصى لضمان الاستقرار.
- (ملاحظة: هذا المحرك يعمل حالياً في وضع المراقبة ولا يقوم بتغيير الأسعار تلقائياً بل يسجل الاقتراحات).

المرحلة الرابعة: التسعير الموسمي
يتدخل سكريبت التسعير الموسمي في أوقات معينة (مثل أوقات الإفطار في رمضان، الأعياد، أو حالات الطقس السيئة) ليقوم برفع السعر تدريجياً وبنسبة مدروسة ليتناسب مع الطلب المتزايد.

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

---

2. تصحيح وقت وظيفة الجدولة الأخيرة

لقد قمت بإضافة الوظيفة الخاصة بمحرك الثبات والاستقرار في لوحة التحكم بالتوقيت التالي:

0 0 * * 0

(وهذا يعني أنه سيعمل مرة واحدة فقط في الأسبوع، يوم الأحد منتصف الليل).

التصحيح المطلوب:
بناءً على تصميم الكود، هذا السكريبت يجب أن يراقب الأسعار باستمرار بالتوازي مع محرك الذكاء الاصطناعي. المطور كتب في الكود ملاحظة صريحة أن الجدولة المقترحة هي كل 3 ساعات.

لذلك، يجب عليك حذفه وإضافته مرة أخرى بالتوقيت التالي:
الدقائق: 0
الساعات: */3
باقي الحقول: *
ليصبح الأمر كالتالي:

0 */3 * * * /usr/bin/php8.4 /home/intaleqapp-jordan-siro/htdocs/jordan-siro.intaleqapp.com/backend/bot/cron_pricing_stability_engine.php

---

3. شرح جدول الوظائف المجدولة بالكامل وتوقيتاتها

فيما يلي جدول يوضح وظيفة كل ملف والتوقيت الذي يعمل به:

التوقيت	الوظيفة
0 */3 * * *	cron_ai_engine.php: تحليل أسعار المنافسين بالذكاء الاصطناعي لاستنتاج معادلاتهم.
0 */3 * * *	cron_pricing_stability_engine.php: (الوقت المقترح) يراقب استقرار الأسعار ويقترح التعديلات دون تذبذب.
0 * * * *	cron_seasonal_pricing.php: يطبق زيادات الأسعار في المناسبات كل ساعة.
*/10 * * * *	cron_surge_opportunity.php: يكتشف مناطق الذروة النشطة بناءً على أسعار المنافسين الحية كل 10 دقائق.
*/5 * * * *	cron_kazan_adjuster.php: يعدّل عمولة التطبيق ويخفضها للسائقين في مناطق الذروة كل 5 دقائق.
*/16 * * * *	cron_generate_heatmap_cache.php: يولد خريطة حرارية لأماكن الطلب للسائقين كل 16 دقيقة.
0 */1 * * *	cron_predictive_demand.php: يتنبأ بأماكن الطلب المستقبلية بناءً على البيانات التاريخية كل ساعة.
0 * * * *	cron_empty_results_to_db.php: ينظف ويسجل نتائج البحث الفارغة لتحليلها لاحقاً كل ساعة.
0 10 * * *	cron_passenger_reengagement.php: يعيد استهداف الركاب الخاملين برسائل أو عروض يومياً الساعة 10 صباحاً.
0 * * * *	cron_auto_marketing_pusher.php: يرسل حملات التسويق الآلية للمستخدمين كل ساعة.
0 0 * * 0	cron_weekly_health_report.php: يرسل تقرير أسبوعي عن صحة وعمل النظام كل أحد في منتصف الليل.
0 */3 * * *	telegram_scraper.php: أداة تسويقية لاستخراج بيانات من المنصات الأخرى كل 3 ساعات.
0 10 * * 0	cron_weekly_report.php: يرسل تقرير أسبوعي إداري أو تسويقي كل أحد الساعة 10 صباحاً.
0 */4 * * *	cron_insert_task.php: يضيف مهام مجدولة للنظام كل 4 ساعات.
*/15 * * * *	generate_10_tasks_cli.php: يولد مهام مصغرة أو وهمية لأغراض الاختبار كل 15 دقيقة.

---

4. مهام الجافاسكريبت المستمرة

هذه المهام لا تعمل بنظام الجدولة المتقطعة، بل هي عمليات تعمل دائماً ولا تتوقف أبداً وتدار بواسطة أداة مدير العمليات:

1. التتبع الشامل: مهمته التتبع الشامل والمتواصل لأسعار المنافسين في جميع المناطق طوال الوقت.
2. اكتشاف الذروة السريع: متخصص في المراقبة السريعة جداً للمناطق لاكتشاف أي ارتفاع مفاجئ فور حدوثه لإرسال البيانات إلى السكريبتات الأخرى.
3. التقارير الحية: يقوم بمعالجة البيانات وتصدير التقارير الحية للوحة التحكم أولاً بأول.

هذه السكريبتات الثلاثة هي التي تجمع المواد الخام التي تقوم السكريبتات المذكورة في الأعلى بتحليلها واستخدامها لتحديد الأسعار النهائية للتطبيق.