Imported from dev-KarimAhmed/smart-radar-core (
AGENTS.md). Install upstream withnpx skills add dev-KarimAhmed/smart-radar-core. Copyright stays with the author.
التقنية والمعمارية النسيجية الحافة (الإصدار الشامل الموحد V2.6-Secured)
- الإصدار: V2.6-Secured (مدمج ومحصن بناءً على دستور القوانين المختصر V5.5، وملحق المحكم السيادي OSRM، وبروتوكول العوامة الصامتة والانتظار المطلق للراكب).
- طبيعة الوثيقة: معمارية هندسية قطعية ومغلقة لحماية الموارد وصفرية التكلفة الحافة.
الباب الأول: معمارية النظام والمحددات الهندسية الكبرى (The Tech Stack)
- بيئة العمل والواجهات: تطبيق ويب تقدمي عالي الأداء (PWA) يعمل كواجهة مستقلة تماماً (Standalone) وبصيغة دون اتصال أولاً (Offline-First).
- معمارية الحافة وصفرية التكلفة (SC55): يُنقل كامل ثقل المعالجة الرياضية، والفرز، وعمليات مقارنة الأسعار، وحساب العدادات من السيرفر الأساسي لتتم داخل معالج هاتف المستخدم مباشرة (Client-Side).
- قواعد البيانات والتخزين المحلي: الاعتماد الكامل على الذاكرة المحلية المستقرة للمتصفح (IndexedDB المدار عبر مكتبات سريعة مثل Dexie.js أو LocalStorage).
- المحكم الرقمي القطعي (SSOT) والخرائط الحرة: تُستأصل واجهات جوجل المدفوعة استئصالاً جراحياً كاملاً. تُعتمد حسابات المسافة والوقت رياضياً على "حافة الشبكة" عبر مكتبات
MapLibre GL JSوh3-jsلتعمل على كرت الشاشة للحافة (GPU Vector Tiles). - خادم التوجيه الاستراتيجي المستقل (Self-Hosted OSRM): يتم ربط النظام بخادم افتراضي (VPS) مستقل ومقطوع التكلفة ومحمي بذاكرة مساندة (2GB Swap) يستضيف محرك
OSRMومحمل عليه ملف خريطة الأردن المدمج (25MB). يتصل التطبيق بالخادم عبر استعلامات HTTP REST API محلية فائقة السرعة، مغلفة بوكيل عكسي آمن (Nginx) وشهادة تشفير سيادية (HTTPS عبر Let's Encrypt) لمنع ثغرة الـMixed Content Block.
الباب الثاني: هندسة التسعير النسيجية وبروتوكول عوامة المسح وعروض الناقلين
يتم احتساب السعر بدقة متناهية عبر دمج ثلاثية: (إحداثيات الحافة + خلايا H3 النسيجية + مسافة شوارع OSRM الحقيقية) لمنع ظلم السائق أو إفساد مؤشر التوازن.
أولاً: ميكانيكية العوامة الصامتة للراكب (Rider Drop & Wait)
- تأكيد السيادة وصفر تعقيد: لا توجد أي حقول إدخال أسعار أو خيارات مفرطة في واجهة الراكب. الراكب يضغط زراً واحداً فقط: "اطلب الآن". الراكب لا يقدم أي أسعار، بل يرمي العوامة صامتاً وينتظر عروض السائقين.
- لحظة الارتكاز وتحويل الإحداثيات: يقوم هاتف الراكب محلياً بتحويل إحداثيات الـ GPS فوراً عبر مكتبة
h3-jsإلى الخلية السداسية المركزية الأساسية بدقة ريزولوشن 9 (Resolution 9) والتي تُمثّل "عوامة الارتكاز". - النبض البصري التركوازي الحاكم وعزل الإعلانات: بمجرد رمي العوامة، تنبثق شاشة الطلب كطبقة علوية كاملة (Fullscreen Modal) تحجب النهر الإعلاني تماماً لتركيز انتباه المستخدم، وتبث موجات دائرية مرسومة عبر كرت الشاشة (GPU) على شعاع 1.5 كم حتمي لإعطاء الراكب إيحاءً هادئاً بالمسح الجغرافي.
ثانياً: آلية الاحتساب والتسعير عند الناقل (السائق)
- يرى السائق طلب الراكب العائم في صالة المزاد إذا كان داخلاً في حلقة الزخم الجغرافي للمحيط.
- يتم جلب قيم وثيقة النبض العام للمنطقة المخزنة محلياً لمرة واحدة (1 Read) لتطبيق معادلة التسعير الأساسية:
$$\text{Fare} = \text{Base Fare} + (D_{\text{OSRM}} \times \text{Tariff Per Km}) + (T_{\text{OSRM}} \times \text{Tariff Per Min})$$
- يقدم السائق عرضه المالي، ويمر السعر فوراً عبر فلاتر "كوابح السوق" (مؤشر التوازن 15%):
- منطقة الانحراف (10% إلى 14.9%): وميض برتقالي حذر (
Amber Warning). تُخفض رتبة السائق آلياً، وتزاح الحزمة للاحتياط، ويظهر للراكب وسم "سعر محروق قد يؤثر على الجودة". - منطقة الحظر والمنع (15% فما فوق): الإغلاق القرمزي (
Crimson Block & Input Lockout). يُقفل حقل إدخال التسعير تماماً، ويتجمد زر "إرسال العرض" برمجياً لمنع النبض الزائف.
ثالثاً: بروتوكول الاستجابة الفورية عند انعدام الكباتن (The Zero-Captain Fallout)
- يستمر النظام في جلب وعرض عروض السائقين المتنافسين على شاشة الراكب على شكل بطاقات منبثقة متتالية يختار منها الأنسب له بصفر نقرات زائدة.
- إذا انتهت الـ 180 ثانية حتمية (3 دقائق) دون أن يقدم أي سائق عرضاً في هذا المحيط، يتم إغلاق الرادار ميكانيكياً، وتذوب العوامة، وتنبثق رسالة حازمة تعلو المسرح الإعلاني:
🛑 "لا يوجد سائقين متوفرين في محيطك الحالي، يرجى إعادة المحاولة بعد قليل."
- فوراً، تختفي الطبقة العلوية تماماً وتذوب في العدم البرمجي بصيغة النعومة الانسيابية (
Transition CSS)، ويعود الراكب تلقائياً لقرنية الشاشة الرئيسية مستمتعاً بالنهر الإعلاني دائم الدوران دون خيارات معقدة.
رابعاً: بروتوكول الهبوط الملاحي الآمن للتحكيم (Offline Fallback)
في حال حدوث خطأ شبكي أو عدم استجابة خادم OSRM في زمن يتجاوز 1500ms, ينشط فوراً محرك الطوارئ الحافة المتكامل رياضياً بحساب مسافة "الهرسين" (Haversine) الجغرافية بين نقطتي الانطلاق والوصول مباشرة على معالج الهاتف، ويتم تعديل المسافة بضربها في معامل شوارع المملكة الثابت (1.3) لضمان استمرار عملية استقبال وعرض العروض بصفر انقطاع.
الباب الثالث: المحركات الهندسية الخمسة المستردة
- محرك الشحن الجغرافي اللامركزي: الربط بقنوات الدفع الرقمية المحلية الأردنية (CliQ, زين كاش، أورنج ماني، إي فواتيركم) بناءً على حقل لواء الموطن (homeDistrict) وتأكيد المعاملة بنبضة واحدة (1 Write Only).
- محرك الارتحال والذوبان النسيجي: تحويل الإحداثيات محلياً إلى خلية H3 بدقة ريزولوشن 9. فور إنهاء الرحلة، يذوب حساب السائق في حلقة الزخم النسيجية لتلك المنطقة (currentH3Cell).
- معمارية حماية مساحة الـ PWA وقانون سقوط الأجل: مسح سجلات الرحلات إحصائياً من السيرفر كل 72 ساعة حتمية، وإعدام المواد الإعلانية المحفوظة في المتصفح ميكانيكياً بعد 30 يوماً حتمية مقفلة برمز ثابت (
USER_VAULT_LIFETIME_MS). - محرك الروابط العميقة والاستحواذ المباشر: حظر خروج المستخدم من التطبيق؛ وتفعيل أزرار الـ Zero-Click الذرية عبر بروتوكولات التشغيل القياسية (
tel:وhttps://wa.me/). - بنية الصندوق الأسود الإحصائية للمندوبين: جرد واستحقاق عمولة المندوبين الصافية مشروط بمرور 30 يوماً حتمية ومستقرة (
STABILITY_THRESHOLD_MS) لنشاط الحساب المجتلب دون حظر أو حذف.
الباب الرابع: جدار الحماية الجنائي وقفل الثغرات الثلاث (The Kernel Anti-Cheat)
- ثغرة التلاعب بالوقت المحلي للهاتف: حظر الاعتماد على ساعة الهاتف، واعتماد "النبض الشبكي التفاضلي" (
Network Time Delta) المقروء عند أول سحب لوثيقة النبض العام. - ثغرة التحديث الشبكي الأعمى عند انقطاع التغطية: حبس حالة العداد محلياً في ملف مشفر ومحمي بختم رقمي مجزأ (
Cryptographic Hash)، وحظر دخول صالة المزاد إلا بعد إتمام "المصافحة التصفوية الصامتة". - ثغرة إغراق خلايا H3 بطلبات وهمية: حظر بث أكثر من طلب نشط واحد متزامن للراكب. وتفعيل كبح الإلغاء المتتالي؛ إذا ألغى الراكب 3 مرات متتالية، يُخصم 0.5 من رصيد مناعته السلوكية، وإذا هبط عن 4.2 يُسقط حسابه كلياً بروتوكول التطهير التلقائي.