عن المشروع

## ما هو World Monitor هي لوحة معلومات استخباراتية عالمية فورية تجمع بين تجميع الأخبار المدعوم بالذكاء الاصطناعي، والمراقبة الجيوسياسية، وتتبع البنية التحتية في واجهة واحدة للوعي الموقفي. تم بناؤها من قاعدة بيانات واحدة توفر عدة متغيرات للموقع: world، وtech، وfinance، وcommodity، وhappy، وenergy. ## القدرات الموثقة - تغذيات إخبارية منسقة عبر فئات عالمية وإقليمية، يتم تلخيصها بواسطة الذاء الاصطناعي في موجزات. - محرك خرائط مزدوج: كرة أرضية ثلاثية الأبعاد مبنية باستخدام globe.gl وخريطة مسطحة WebGL مبنية باستخدام deck.gl، يتشاركان في كتالوج طبقات الخرائط. - جرد للألواح مع تطبيقات ملموسة للألواح عبر المتغيرات المتخصصة. - ربط متبادل بين تدفقات الإشارات العسكرية والاقتصادية والكوارث والتصعيد. - مؤشر عدم استقرار الدول (CII): درجات CII v8 مباشرة، ونطاقات، وحركة تقريبية لمدة 24 ساعة لـ 31 دولة من الفئة الأولى. - رادار مالي يغطي البورصات والسلع والعملات الرقمية ومؤشر سوق مركب. - تشغيل الذكاء الاصطناعي محلياً عبر Ollama، دون الحاجة إلى مفاتيح API؛ كما يدعم Groq وOpenRouter بالإضافة إلى Transformers.js من جهة المتصفح. - تطبيق سطح مكتب أصلي (Tauri 2) لأنظمة macOS (Apple Silicon وIntel)، وWindows وLinux AppImage. يغطي ملف ثنائي واحد كل المتغيرات، مع إمكانية التبديل داخل التطبيق. - واجهة مستخدم متعددة اللغات مع تغذيات باللغات الأصلية ودعم للكتابة من اليمين إلى اليسار (RTL). ## التشغيل البداية السريعة الموثقة هي استنساخ المستودع، وتشغيل `npm install` و `npm run dev` ثم فتح localhost:3000 (يمكن تغيير المنفذ عبر `DEV_PORT`). يعمل التطبيق بدون متغيرات بيئية، رغم أن مصادر البيانات الخاصة بميزات معينة قد تتطلب بيانات اعتماد مدرجة في `.env.example`. توجد سكربتات تطوير خاصة بكل متغير (`dev:tech`, `dev:finance`, `dev:commodity`, `dev:happy`, `dev:energy`). تشمل خيارات الاستضافة الذاتية المذكورة Vercel وDocker والنشر الاستاتيكي. ## الوصول البرمجي بالإضافة إلى واجهة المتصفح، يوثق المشروع ما يلي: - خادم MCP على `https://worldmonitor.app/mcp` (Streamable HTTP)، مع `tools/list` عامة و `tools/call` موثقة، بالإضافة إلى مهارات الوكيل (Agent Skills) المنشورة عبر ملحق مهارات MCP مسودة. - واجهة برمجة تطبيقات REST على `https://api.worldmonitor.app` موصوفة بمواصفات OpenAPI. - واجهة سطر أوامر (CLI) رسمية لـ `worldmonitor` عبر npm يمكن تشغيلها عبر `npx` أو تثبيتها عالمياً كـ `worldmonitor` / `wm`. - حزم SDK رسمية بدون تبعيات لـ Python (`worldmonitor-sdk`) وRuby وGo. كما يتم نشر ملفات اكتشاف الوكيل مثل `llms.txt` وبيان مهارات الوكيل وكتالوج واجهة برمجة التطبيقات. ## ملاحظات حول الحزمة التقنية تذكر وثيقة README استخدام TypeScript وVite للواجهة الأمامية؛ وTauri 2 (Rust) مع Node.js sidecar لسطح المكتب؛ وOllama وGroq وOpenRouter وTransformers.js للذكاء الاصطناعي؛ وProtocol Buffers وتوصيفات sebuf HTTP لعقود API؛ وVercel Edge Functions وRailway relay وTauri وPWA للنشر؛ وRedis (Upstash) مع ذاكرة تخزين مؤقت ثلاثية الطبقات وCDN وservice worker للتخزين المؤقت. ## مصادر البيانات والإسناد يتم تجميع البيانات من مزودين خارجيين موثقين في مجالات الجيوسياسة والتمويل والطاقة والمناخ والطيران والأمن السيبراني والعسكرية والبنية التحتية واستخبارات الأخبار. تُنسب بيانات الرحلات الجوية إلى Wingbits. يوثق كتالوج مصادر البيانات المزود، ومستوى التغذية، ووضعية الترخيص، وطريقة الجمع. ## الترخيص وحالة المشروع كود المصدر مرخص بموجب AGPL-3.0-only؛ ويُسمح بالاستخدام الشخصي والبحثي والتعليمي والاستضافة الذاتية والتجارية عند استيفاء التزامات AGPL copyleft وتوافر المصدر، مع إذن تجاري أو علامة تجارية منفصل للمصادر الخاصة المملوكة. تُعتبر عمليات النشر العامة وملفات سطح المكتب مستقرة ومدعومة من نفس قائمة المهام. المشروع من تأليف Elie Habib ويرحب بالمساهمات وفقاً لدليل CONTRIBUTING الخاص به.