Thanks to visit codestin.com
Credit goes to github.com

Skip to content

README.ar.md

Latest commit

 

History

History
119 lines (90 loc) · 8.17 KB

README.ar.md

File metadata and controls

119 lines (90 loc) · 8.17 KB

نظام NextVault البيئي 🌌

نظام بيئي متكامل يعمل محلياً، يحول حاسوبك الشخصي إلى سيرفر ولوحة تحكم قوية، ويجعل جهاز الـ Android الخاص بك أداة متصلة كلياً دون الحاجة إلى أي اتصال بالإنترنت.

📖 مقدمة

NextVault هو نظام برمجي مبتكر مصمم لربط سيرفر (ومحطة عمل) محلي على الحاسوب مع تطبيق يعمل على الهواتف بمجرد الاتصال على نفس الشبكة المحلية. التطبيق يخلق منصة ووسيطاً للمجتمعات المحرومة من الإنترنت أو المعزولة، مما يتيح للمستخدمين مشاركة الوسائط، وإنشاء غرف دردشة، وتوزيع التطبيقات، ومراقبة المحتوى بفعالية ومجاناً.

تم بناء واجهاته بتركيز حاد على الاحترافية والتصميم بالغ الحداثة (يستلهم من أنماط Dark Neumorphism و Glassmorphism) ليمنح المستخدمين تجربة تفاعلية وبصرية لا تضاهى.

✨ أبرز المميزات

🎬 البث الإعلامي (Artplayer & Plyr)

  • تجربة Netflix المحلية: إمكانية تصفح وبث الأفلام المدمجة، المسلسلات، والموسيقى مباشرة من الحاسوب لشاشات الهواتف.
  • مشغّلات فائقة الحداثة: يعتمد النظام على اندماج مكتبات Artplayer و Plyr للتعامل مع الفيديوهات بسلاسة تامة أياً كانت ظروف الشبكة.

🏪 متجر تطبيقات بدون إنترنت (تثبيت الـ APK)

  • مخزن تطبيقات خاص بك: إمكانية تخصيص ورفع حزم وتطبيقات (.apk) من مجلد Android الموجود بداخل السيرفر وتوزيعها.
  • تثبيت بضغطة زر واحدة: تحميل مباشر من الشبكة المحلية ومطالبة تلقائية بنظام Android بالتثبيت عن طريق صلاحيات FileSystem و IntentLauncher الأصيلة.

🛡️ نظام الاعتدال "Tawasal"

  • تواصل لحظي وفعّال: نظام محادثة مغلق ومحلي مع أدوات إشرافية رائدة.
  • الرقابة الذكية للمحتوى: يمكنك كمسؤول إعداد قائمة "بالكلمات المحظورة" وسيقوم النظام أوتوماتيكياً بطمسها (***) أثناء الكتابة وإرسالها بالزمن الفعلي.
  • لوحة التحكم المركزية: يتمتع المسؤول بصلاحيات استبعاد وحظر المستخدمين، تتبع ورصد عمليات رفع الملفات واستهلاك الشبكة مباشرة من الحاسوب.

🎨 تجربة وتصميم المستخدم (UI/UX)

ينتقل مشروع NextVault بالتجربة البصرية لمستوى احترافي عالي من خلال تبني طيف النيومورفيزم المظلم (Dark Neumorphism) مع شظايا من الـ Glassmorphism.

  • لوحة التحكم (Dashboard): بُنيت باستخدام React و Vite لتقديم شبكة عصرية (Grid Layout) بألوان مظلمة أنيقة، وتدرجات ضوئية، ومؤثرات حركية دقيقة مدعومة بأيقونات Lucide وتقنيات Tailwind.
  • تطبيق الهواتف: واجهة داكنة مريحة للعين تستحوذ بكفاءة على مساحة الهاتف بفضل react-native-safe-area-context وتجعل التصفح مثالياً.

📂 هيكلية المشروع

C:\after
├── Server/                   # لوحة تحكم الحاسوب والواجهة الخلفية للمشروع 
│   ├── src/                  # واجهة React + Vite
│   ├── backend/              # سيرفر Express JS (المنفذ: 3000)
│   ├── main.js               # الواجهة البرمجية لتطبيق Electron
│   ├── Tawasal/              # ملفات نظام الدردشة المخصصة
│   ├── Android/              # مجلد التوزيع التلقائي لتطبيقات الـ APK
│   └── media/                # مجلد رفع الأفلام والمسلسلات والأغاني
│
└── android-client/           # تطبيق الهاتف (العميل)
    ├── App.js                # ملف البداية للـ React Native
    ├── src/                  # شاشات، واجهات المستخدم، الإعدادات
    └── android/              # إعدادات البناء الأصيلة (Native Build)

⚙️ المواصفات التقنية

  • الواجهة الأمامية للسيرفر: React 18, Vite, TailwindCSS, Lucide React.
  • الواجهة الخلفية للسيرفر: ExpressJS, Multer (لرفع الملفات), Cors.
  • حاوي التطبيق المكتبي: Electron (بواسطة utilityProcess لتفادي تجمد المعالج أثناء تشغيل أوامر Node.js).
  • تطبيق العميل: React Native (مع تخصيص Expo SDK 54 للإصدارات المستقلة عن الإنترنت).

مسارات الـ API الأساسية المعتمدة

  • GET /api/apps - التقاط وتوزيع ألعاب وتطبيقات من المجلدات الفرعية.
  • GET /api/media - فهرست الصوتيات والمرئيات وعرضها.
  • GET /api/posts و POST /api/posts - مسارات الدردشة ونشر المحتوى للـ Tawasal.
  • POST /api/upload - المسار الخاص باستقبال التطبيقات والأفلام.
  • POST /api/upload-audio - التقاط الملفات الصوتية بصيغة Base64 ورفعها وحفظها.
  • الملفات المقدمة كـ Static Files: /media, /apps, /voice, /tawasal.

🚀 طريقة التثبيت والتشغيل

1. سيرفر لوحة التحكم (Electron)

يجب تشغيل السيرفر على شبكة حاسوبك أولاً حتى يتمكن الهاتف من الربط.

للتشغيل في وضع المطور:

cd Server
npm install
npm run dev

لبناء الحزمة المغلقة للمستخدمين (.exe):

cd Server
npm run build:electron

المخرجات: توجه إلى المسار Server/release/. ستجد المجلد win-unpacked جاهزاً، أو بإمكانك تنصيب مثبت البرنامج الاحترافي NextVault Setup 1.0.0.exe. وبمجرد التشغيل، سيتكفل السيرفر ببناء كل المجلدات المفقودة للحفاظ على الخصوصية والمساحة.

2. تطبيق الهاتف المحمول (Android)

يُشترط ضرورة تواجد الجهازين على نفس شبكة التوجيه (الراوتر) المحلي.

لتحديث المسار المحلي الخاص بالسيرفر:

  1. توّجه للمسار: android-client/src/config/api.js.
  2. حدّث المتغير BASE_URL بالـ IP الخاص بحاسوبك (مثلاً: http://192.168.1.10:3000).

لبناء ملف التطبيق (APK):

cd android-client
npm install
# استخراج المشروع الأصيل لأندرويد
npx expo prebuild
# بدء بناء التحديث الإنتاجي الخاص بـ Release
cd android
./gradlew assembleRelease

المخرجات: ستعثر على تطبيق الـ apk الناجح في مسار الانتهاء: android-client/android/app/build/outputs/apk/release/app-release.apk.

👨‍💻 تنويه المطور

جرى تصميمُه، برمجتُه، وصيانتُه داخلياً بواسطة المطور الرئيسي المحترف Yasser (YASSER-27).

هذا الـ README يوثّق الهيكل المعماري والنجاح البرمجي في نسخته الإنتاجية، وهو بمثابة مرجع رسمي. يُحظر كلياً إعادة التوزيع دون إذن مسبق.