# HackingFactory v2 - التطويرات الجديدة

## ملخص التحديثات

تم تطوير **HackingFactory** ليصبح نظاماً متقدماً لـ "الذكاء الاصطناعي ذاتي التحسين" مع المميزات التالية:

---

## 🎯 المميزات الرئيسية

### 1. **بيئة الفحص الديناميكية (Dynamic Sandbox)**
- تشغيل الأكواد المولدة في بيئة معزولة آمنة
- قياس الأداء والموارد المستخدمة
- اكتشاف الأخطاء والمشاكل قبل النشر
- **الملف:** `server/sandbox.ts`

### 2. **نظام التقييم المتعدد المعايير (Multi-Criteria Scoring)**
تقييم شامل للأكواد بناءً على:
- **التخفي (Stealth):** مدى إخفاء الأثر والكشف
- **الاستقرار (Stability):** معالجة الأخطاء والموارد
- **الكفاءة (Efficiency):** الأداء والسرعة
- **الموثوقية (Reliability):** معدل النجاح والتوافقية

### 3. **حلقة التكرار الذاتي (Self-Refining Loop)**
- توليد تلقائي للأكواد (Qwen)
- تقييم ذكي (DeepSeek)
- تحسين مستمر حتى الوصول للدرجة المستهدفة
- **الملف:** `server/factory.ts`

### 4. **الذاكرة المتجهة (Vector Memory)**
- تخزين الحلول الناجحة السابقة
- البحث الدلالي عن حلول مشابهة
- تسريع التوليد للمشاكل المتكررة
- **الملف:** `server/memory.ts`
- **التقنية:** ChromaDB

### 5. **محرك التشفير والتخفي (Obfuscation Engine)**
ثلاث مستويات من التشفير:
- **Low:** إعادة تسمية المتغيرات
- **Medium:** تشفير النصوص + كود وهمي
- **High:** تشفير متعدد المستويات
- **الملف:** `server/obfuscation.ts`

### 6. **لوحة التحكم المرئية (Visual Dashboard)**
- عرض إحصائيات المشاريع
- رسم بياني لتقدم التكرارات
- معلومات مفصلة عن كل مشروع
- **الملف:** `client/src/pages/Dashboard.tsx`

### 7. **محرر الأكواد المباشر (Live Code Editor)**
- تحرير الأكواد يدوياً
- نسخ وتحميل الأكواد
- تشغيل الأكواد مباشرة
- **الملف:** `client/src/components/CodeEditor.tsx`

### 8. **مكتبة القوالب (Payload Library)**
- مكتبة منظمة للحلول الناجحة
- البحث والتصفية حسب الوسوم
- تطبيق التشفير على القوالب
- **الملف:** `client/src/components/PayloadLibrary.tsx`

### 9. **نظام الإشعارات (Notifications)**
- إخطار المستخدمين بتقدم المشاريع
- تنبيهات الإكمال والأخطاء
- **الملف:** `server/notifications.ts`

---

## 📊 معمارية النظام

```
┌─────────────────────────────────────────────────────────┐
│                   User Interface                         │
│  (Dashboard | Chat | Code Editor | Payload Library)     │
└──────────────────────┬──────────────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────────┐
│                    tRPC API Layer                        │
│  (Projects Router | Chat Router | Payload Router)       │
└──────────────────────┬──────────────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────────┐
│              Self-Refining Loop Engine                   │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────┐   │
│  │ Generation  │→ │ Sandbox Test │→ │ Evaluation   │   │
│  │  (Qwen)     │  │ (Dynamic)    │  │ (DeepSeek)   │   │
│  └─────────────┘  └──────────────┘  └──────────────┘   │
└──────────────────────┬──────────────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────────┐
│              Data & Memory Layer                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │ MySQL DB     │  │ ChromaDB     │  │ Obfuscation  │  │
│  │ (Projects)   │  │ (Memory)     │  │ Engine       │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
└─────────────────────────────────────────────────────────┘
```

---

## 🚀 البدء السريع

### التثبيت
```bash
# استنساخ المستودع
cd /home/ubuntu/hacking_factory

# تثبيت المكتبات
npm install

# تثبيت ChromaDB
sudo pip3 install chromadb

# تشغيل الخادم
npm run dev
```

### إنشاء مشروع جديد
```typescript
const project = await trpc.projects.create.mutate({
  name: "My Security Project",
  mode: "loop",
  contentType: "code",
  originalPrompt: "Generate a secure authentication system",
});
```

### تشغيل المصنع
```typescript
await trpc.projects.runFactory.mutate({
  projectId: project.projectId,
  prompt: project.originalPrompt,
  targetScore: 90,
});
```

### مراقبة التقدم
```typescript
const iterations = await trpc.projects.getIterations.query({
  projectId: project.projectId,
});

// عرض الرسم البياني في Dashboard
```

---

## 📁 هيكل الملفات الجديدة

```
server/
├── sandbox.ts              # بيئة الفحص المعزولة
├── factory.ts              # محرك التكرار الذاتي
├── memory.ts               # الذاكرة المتجهة
├── obfuscation.ts          # محرك التشفير
├── notifications.ts        # نظام الإشعارات
└── routers/
    └── projects.ts         # مسارات المشاريع المحدثة

client/src/
├── components/
│   ├── IterationChart.tsx   # رسم بياني التكرارات
│   ├── CodeEditor.tsx       # محرر الأكواد
│   └── PayloadLibrary.tsx   # مكتبة القوالب
└── pages/
    └── Dashboard.tsx        # لوحة التحكم المحدثة
```

---

## 🔄 سير العمل الكامل

```
1. إنشاء مشروع جديد
   ↓
2. تشغيل المصنع (runFactory)
   ↓
3. البحث في الذاكرة عن حلول مشابهة
   ↓
4. توليد الكود الأول (Qwen)
   ↓
5. فحص ديناميكي (Sandbox)
   ↓
6. تقييم شامل (DeepSeek)
   ↓
7. حفظ النتيجة في قاعدة البيانات
   ↓
8. هل الدرجة ≥ الهدف؟
   ├─ نعم → حفظ في الذاكرة + إشعار النجاح
   └─ لا → العودة للخطوة 4 (تحسين الكود)
```

---

## 🎨 واجهة المستخدم

### لوحة التحكم (Dashboard)
- عرض إحصائيات المشاريع النشطة والمكتملة
- رسم بياني تفاعلي لتقدم التكرارات
- قائمة المشاريع مع الحالة والدرجات

### محرر الأكواد (Code Editor)
- تحرير الأكواد بصيغة Python/JavaScript
- نسخ سريع للأكواد
- تشغيل فوري للاختبار

### مكتبة القوالب (Payload Library)
- عرض الحلول الناجحة السابقة
- البحث والتصفية حسب الوسوم
- تطبيق التشفير بمستويات مختلفة

---

## 🔐 الأمان

- جميع الأكواد تُشغل في بيئة معزولة (Sandbox)
- لا توجد وصول مباشر للنظام الرئيسي
- التحقق من صلاحيات المستخدم على جميع المسارات
- تشفير الأكواد قبل التخزين (اختياري)

---

## 📈 الأداء

- استخدام الخيط الخلفي (Background) لتشغيل المصنع
- تخزين النتائج في الذاكرة المتجهة لتسريع البحث
- تقليل وقت التوليد للمشاكل المتكررة بـ 50-70%

---

## 🔮 التطويرات المستقبلية

- [ ] دعم نماذج استدلال متقدمة (OpenAI o1, DeepSeek-R1)
- [ ] تكامل Docker الكامل للفحص الديناميكي
- [ ] نظام التنبيهات عبر WebSocket
- [ ] تصدير النتائج بصيغ متعددة (PDF, JSON, CSV)
- [ ] واجهة إدارة متقدمة للمشاريع
- [ ] تحليل الأداء والإحصائيات المتقدمة

---

## 📞 الدعم

للمزيد من المعلومات، راجع:
- `DEVELOPMENT_GUIDE.md` - دليل التطوير الشامل
- `todo.md` - قائمة المهام والتقدم
- `server/` - كود الخادم
- `client/src/` - كود الواجهة الأمامية

---

**آخر تحديث:** 25 يناير 2026
**الإصدار:** v2.0