📍 VLoc App (v1.2.3)

محاكي مواقع افتراضي متقدم (GPS Spoofer) مهيأ بالكامل لنظام Android 15 وبيئات Windows المستقلة، يعتمد على معمارية Monorepo متقدمة للعمل المتوازي.

تطبيق VLoc هو أداة متطورة للمطورين تتيح تزييف الموقع الجغرافي بأداء عالٍ. يركز التحديث الجديد على معمارية Turborepo، وتوافقية أندرويد 35، واستخدام Specta لضمان أمان التخاطب بين لغتي Rust و TypeScript.

1. ✨ المميزات الرئيسية
2. 💻 التقنيات المستخدمة
3. 🚀 ابدأ الآن
4. 🧭 محرك الرياضيات للـ GPS
5. 📁 هيكلية المشروع (Monorepo)
6. 📜 التراخيص

• 🌍 توافقية متطورة (Android 15): مدعوم بالكامل ليعمل على أحدث أنظمة أندرويد (SDK 35) وتثبيت مستقل مع (WebView2) لنظام ويندوز.
• 📱 أمان التخاطب (Specta): عقد أمان (IPC Contracts) يربط واجهة TypeScript مباشرة مع الواجهة الخلفية في الرست لمنع أخطاء التخاطب الكارثية.
• 🔢 محاكاة حية متقدمة (Jitter): إضافة حركات ارتدادية عشوائية (0-50m+) لإعطاء طابع موقع طبيعي لا يمكن كشفه وتقليل الانحراف.
• ⚙️ تصميم عالي التباين (Glassmorphism): واجهة مستخدم تعتمد على الهيكل الذري (Atomic Design) مع أزرار بارزة وطبقات شفافة حديثة (Glassy overlays).

• Turborepo & pnpm: معمارية إدارة الحزم المتقدمة لبناء بيئات مشتركة.
• Tauri 2.0 & Rust: للوصول إلى العتاد الأصلي وبناء التطبيقات المستقلة بقوة Rust.
• Specta: لتوليد الواجهات البيانية من Rust إلى TypeScript.
• React & TypeScript: تصميم وإدارة تفاعلية فائقة.
• MapLibre GL: لاستعراض وتحكم بخرائط العالم بدقة.
• TailwindCSS: أدوات تنسيق الواجهة.

• Node.js (v18+)
• Rust (Stable)
• Android Studio & NDK (لترجمة تطبيق الهواتف - Build targets).
• pnpm (مثبت عالمياً)

1. استنساخ المستودع:

   git clone https://github.com/Ahmad-J-Bary/vloc-app-new.git
   cd VLoc-app-new

2. تثبيت الحزم:

   pnpm install

3. تشغيل وضع التطوير:

   pnpm tauri dev

4. استخراج وبناء المشروع:

   pnpm android:build # لإنشاء نسخة Android APK
   pnpm tauri build # لإنشاء نسخة Windows MSI/EXE

للخروج من نمط المحاكيات التقليدية، تم بناء محرك رياضيات داخلي مخصص في Rust. يقوم المحرك بتطبيق خوارزميات تسمح للموقع بالتحرك بسرعات ثابتة ومخصصة وإضافة ارتدادات عشوائية (Jitters) ليحاكي تماماً التذبذبات الطبيعية التي يحدثها مستشعر الـ GPS المادي الموجود بالهاتف.

VLoc-app-new/
├── apps/
│ └── desktop-mobile/ # التطبيق الأساسي (Tauri v2 + React)
├── packages/ # حزم الـ Frontend
│ ├── vloc-ui/ # مكونات الـ Atomic Design UI
│ ├── vloc-core/ # منطق العمل وإدارة الـ Zustand
│ └── vloc-api-bindings/ # الأنواع المولدة تلقائياً بواسطة Specta
└── crates/ # حزم الـ Backend
 ├── vloc-engine/ # محرك الرياضيات والفيزياء (Rust)
 └── vloc-os-mock/ # التخاطب منخفض المستوى مع أنظمة التشغيل (OS)

هذا المشروع مرخص بموجب رخصة GNU General Public License v3.0. راجع ملف LICENSE لمزيد من المعلومات.

تم التطوير بكل ❤️ بواسطة @Ahmad Abdelbary