Skip to content

Digital-Warrior/-

Repository files navigation

🏰 asrar-mared-hub

مستودع القيادة السيبرانية – أسرار المارد الرقمي

License Build Status Version Arabic

هذا المستودع يمثل مركزًا موحدًا يربط بين مشاريع متعددة في مجالات الأمن السيبراني، تطوير الواجهات، سكربتات الحماية، والتوثيق الفني.
تم تصميمه ليكون نقطة انطلاق لأي مشروع يحمل توقيع المارد الرقمي، ويُنفذ عمليات CI/CD، تثبيت التبعيات، وإدارة الحركات التقنية باحترافية.


🎯 الهدف من المستودع

  • مركز قيادة موحد: إدارة جميع المشاريع من مكان واحد
  • أتمتة كاملة: سكربتات تلقائية لإصلاح الأخطاء والتحقق من السلامة
  • حماية قصوى: نظام حماية متقدم يمنع الحذف الخاطئ أو التعديلات الضارة
  • توثيق احترافي: كل عملية موثقة بالكامل

📦 المشاريع المرتبطة

asrar-mared-hub/
├── projects/
│   ├── nodejs-web/          # واجهة ويب متقدمة
│   ├── cpp-core/            # نواة C++ للأدوات الدفاعية
│   ├── security-scripts/    # سكربتات حماية وتحليل
│   └── docs/                # التوثيق الرسمي للحركات والتعديلات
├── scripts/
│   ├── setup.sh             # سكربت التثبيت الذكي
│   ├── fix-all.sh           # إصلاح شامل لجميع الأخطاء
│   ├── protect.sh           # نظام الحماية المتقدم
│   └── deploy.sh            # النشر التلقائي
├── .github/
│   └── workflows/           # CI/CD workflows
├── README.md
└── LICENSE

⚙️ التثبيت والتشغيل

المتطلبات الأساسية

  • Git 2.30+
  • Node.js 18+ (للمشاريع JavaScript)
  • GCC/Clang (للمشاريع C++)
  • Python 3.8+ (للسكربتات)
  • نظام Linux/Unix (موصى به)

التثبيت السريع

# استنساخ المستودع
git clone https://github.com/yourusername/asrar-mared-hub.git
cd asrar-mared-hub

# تشغيل سكربت التثبيت الذكي
bash scripts/setup.sh

ما الذي يفعله setup.sh؟

السكربت يقوم تلقائياً بـ:

  • ✅ فحص جميع التبعيات المطلوبة
  • ✅ تثبيت المكتبات اللازمة لكل مشروع
  • ✅ إصلاح الأخطاء الشائعة (أذونات، روابط معطلة، ملفات ناقصة)
  • ✅ تفعيل نظام الحماية التلقائي
  • ✅ إنشاء نسخ احتياطية تلقائية قبل أي تعديل
  • ✅ التحقق من سلامة الملفات الحساسة

⚠️ تحذير مهم: السكربت يحمي جميع الملفات من الحذف الخاطئ ويطلب تأكيد يدوي قبل أي عملية حذف!


🛡️ نظام الحماية المتقدم

الحماية التلقائية

# تفعيل الحماية الكاملة
bash scripts/protect.sh --enable

# التحقق من حالة الحماية
bash scripts/protect.sh --status

ميزات الحماية

  • 🔒 منع الحذف العرضي: أي أمر rm أو del يتطلب تأكيد مزدوج
  • 📸 النسخ الاحتياطي التلقائي: نسخة احتياطية قبل كل تعديل
  • 🔍 مراقبة التغييرات: تسجيل كامل لكل عملية
  • 🚨 تنبيهات فورية: إشعارات عند محاولة تعديل ملفات حساسة
  • ⏮️ استرجاع سريع: إمكانية العودة لأي نقطة زمنية

🔧 إصلاح الأخطاء التلقائي

إصلاح شامل

# إصلاح جميع المشاكل المحتملة
bash scripts/fix-all.sh

ما الذي يتم إصلاحه؟

  • ✔️ إصلاح أذونات الملفات والمجلدات
  • ✔️ إعادة تثبيت التبعيات المفقودة
  • ✔️ إصلاح روابط Git المعطلة
  • ✔️ تنظيف الملفات المؤقتة
  • ✔️ إصلاح مشاكل الترميز (encoding)
  • ✔️ التحقق من سلامة البنية الهيكلية

إصلاح مشروع محدد

# إصلاح مشروع Node.js فقط
bash scripts/fix-all.sh --project nodejs-web

# إصلاح مشروع C++ فقط
bash scripts/fix-all.sh --project cpp-core

🚀 الاستخدام المتقدم

إضافة مشروع جديد

# إنشاء مشروع جديد
bash scripts/create-project.sh --name my-new-project --type nodejs

النشر التلقائي

# نشر جميع المشاريع
bash scripts/deploy.sh --all

# نشر مشروع واحد
bash scripts/deploy.sh --project nodejs-web

التحديثات

# تحديث جميع المشاريع
bash scripts/update.sh

# التحقق من وجود تحديثات
bash scripts/update.sh --check-only

📚 التوثيق الكامل

للحصول على التوثيق الكامل، راجع مجلد projects/docs/:


🔐 الأمان

  • جميع السكربتات تعمل بأذونات محدودة
  • نظام تسجيل شامل لكل العمليات
  • تشفير للبيانات الحساسة
  • فحص دوري للثغرات الأمنية

الإبلاغ عن ثغرة: security@asrar-mared.local


🤝 المساهمة

نرحب بجميع المساهمات! يرجى قراءة دليل المساهمة قبل البدء.

خطوات المساهمة

  1. Fork المستودع
  2. إنشاء فرع جديد (git checkout -b feature/amazing-feature)
  3. Commit التغييرات (git commit -m 'إضافة ميزة رائعة')
  4. Push للفرع (git push origin feature/amazing-feature)
  5. فتح Pull Request

📝 الترخيص

هذا المشروع مرخص تحت MIT License - راجع ملف الترخيص للتفاصيل.


👨‍💻 المطور

المارد الرقمي - GitHub | Website


🌟 شكر خاص

شكراً لكل من ساهم في هذا المشروع وجعله ممكناً!


صُنع بـ ❤️ في مصر 🇪🇬

"الكود السليم في المستودع السليم"

About

يقوم بتتبع الفرع الرئيسي والمستودع الرئيسي الخاص

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published