jordan_bot/backend/README.md

Jordan Bot - PHP Backend API

هذا هو الخادم (Backend) الخاص ببوت الأردن، مبني بلغة PHP الخالصة ليكون خفيفاً وسهلاً في الاستضافة على أي خادم (Shared Hosting) بدون تعقيدات Node.js.

الهيكل:

• config/db.php: ملف إعدادات قاعدة البيانات (PDO). يمكنك لاحقاً وضع بيانات الـ MySQL فيه.
• api/rides.php: يستقبل كل طلب رحلة يصله البوت لحفظ البيانات (السعر، المسافة، التطبيق) لغايات الدراسة الاقتصادية وتحديد أوقات الذروة.
• api/location.php: يستقبل تحديثات مواقع السائقين. طريقة العمل: يقوم تطبيق الأندرويد بجمع موقع السائق كل 3 ثوانٍ ويحفظها مؤقتاً في الذاكرة. كل 5 دقائق، يقوم التطبيق بإرسال "دفعة واحدة" (Bulk Upload) تحتوي على كل النقاط السابقة لتقليل استهلاك البطارية والإنترنت.

معرف الجهاز (Fingerprint):

يتم استخدام بصمة الجهاز (Android ID) لتمييز السائقين بدون الحاجة لتسجيل الدخول، مما يساعد في تتبع الاشتراكات مستقبلاً وبناء خريطة دقيقة لكل سائق.