# Ajyal Desk — دليل النشر والاستخدام

> **النسخة:** 1.4.6+64
> **تاريخ البناء:** 2026-05-09
> **المنصة:** Windows x64

---

## 📦 الملفات الجاهزة

| الملف | المسار | الاستخدام |
|---|---|---|
| **AjyalDesk_Portable_v1.0.zip** (29 MB) | `D:\AjyalDesk_Portable_v1.0.zip` | للنشر على أجهزة الموظفين |
| **ajyaldesk.exe** | `D:\AjyalDesk\flutter\build\windows\x64\runner\Release\` | الملف التنفيذي |
| **مصدر الكود** | `D:\AjyalDesk\` (junction) → `D:\مشاريع كلاودي\AjyalDesk\AjyalDesk` | للتعديلات المستقبلية |

---

## 🖥️ تثبيت Ajyal Desk على جهاز موظف

### الطريقة 1 — Portable (لا يحتاج صلاحيات Admin)
```
1. انسخ AjyalDesk_Portable_v1.0.zip إلى الجهاز
2. فك الضغط في أي مجلد (مثل: C:\AjyalDesk)
3. اعمل Shortcut لـ ajyaldesk.exe على Desktop
4. شغّل ajyaldesk.exe
```

### الطريقة 2 — كخدمة (يحتاج Admin، تشغيل تلقائي عند الإقلاع)
```
1. ثبّت كما في الطريقة 1
2. شغّل CMD كـ Admin:
   ajyaldesk.exe --install-service
3. ابدأ الخدمة:
   sc start AjyalDesk
4. الخدمة ستعمل تلقائياً عند كل إقلاع
```

---

## 🌐 السيرفر الخاص

| المعلومة | القيمة |
|---|---|
| **IP** | `64.177.69.115` |
| **Location** | Tel Aviv, Israel (Vultr) |
| **OS** | Ubuntu 22.04 LTS |
| **مواصفات** | 1 vCPU, 1 GB RAM, 25 GB SSD |
| **التكلفة** | $5/شهر (~ 19 ريال) |
| **Public Key** | `aCYJS8Epjc7jPYshMdAs8W0JhgB8ns4BE4VvYD2wFAo=` |
| **Rendezvous** | `64.177.69.115:21116` |
| **Relay** | `64.177.69.115:21117` |

> ✅ **مُعدّ مسبقاً داخل ajyaldesk.exe** — لا يحتاج تكوين يدوي على أجهزة الموظفين

### إدارة السيرفر:
```bash
ssh root@64.177.69.115
# Password: [credentials must be supplied privately by the administrator]

# عرض الـ containers
docker ps

# إعادة تشغيل
docker restart hbbs hbbr

# عرض الـ logs
docker logs -f hbbs
docker logs -f hbbr
```

---

## 🔑 كيف يستخدمها الموظفون

### السيناريو 1: تحكم في جهاز الموظف عن بُعد

**على جهاز الموظف:**
1. شغّل ajyaldesk.exe
2. سيظهر **ID** (9 أرقام، مثلاً 123 456 789)
3. سيظهر **كلمة سر** مؤقتة (تتجدد كل اتصال)
4. أرسل الـ ID وكلمة السر لمدير الـ IT

**على جهاز الـ IT:**
1. شغّل ajyaldesk.exe
2. أدخل الـ ID
3. اضغط **Connect**
4. أدخل كلمة السر
5. ✅ متحكّم

### السيناريو 2: جلسات متعددة (multi-tab)
- افتح عدة tabs لأجهزة مختلفة في نفس الوقت
- التبديل بنقرة واحدة
- نقل ملفات بين أي جهازين

---

## 📱 على الجوال

### نُسخة جاهزة (تعمل اليوم):
1. نزّل **RustDesk** من Google Play / App Store
2. Settings → ID/Relay Server: `64.177.69.115`
3. Key: `aCYJS8Epjc7jPYshMdAs8W0JhgB8ns4BE4VvYD2wFAo=`
4. ادخل ID جهاز الكمبيوتر → اتصل

### نسخة مُخصّصة AjyalDesk APK (مشروع لاحق):
- يحتاج Android Studio + NDK (~ساعتان إعداد + ساعة بناء)
- النتيجة: APK باسم AjyalDesk وشعار AjyalDesk

---

## 🛡️ الأمان

- ✅ **تشفير E2E** بين الأجهزة
- ✅ **سيرفر خاص** — البيانات لا تمر على RustDesk
- ✅ **كلمة سر مؤقتة** على جهاز المتحكَّم به
- ✅ **2FA اختياري**

### توصيات:
1. لا تنشر كلمة سر السيرفر علناً
2. غيّر كلمة سر السيرفر دورياً (`passwd`)
3. اقفل ports غير المطلوبة (UFW مُعدّ مسبقاً)

---

## 🔧 الصيانة

### يومياً:
```powershell
Test-NetConnection -ComputerName 64.177.69.115 -Port 21116
```

### شهرياً:
- تحديث rustdesk-server image:
```bash
ssh root@64.177.69.115
docker pull rustdesk/rustdesk-server
docker restart hbbs hbbr
```
- مراجعة استخدام Bandwidth في Vultr Dashboard

---

## 🐛 حل المشاكل

### "Cannot connect"
- امسح cache: `rm -rf %APPDATA%\AjyalDesk\config`
- أعد تشغيل ajyaldesk.exe

### بطء الفيديو
- تحقق من سرعة الإنترنت (يحتاج 2 Mbps لكل جلسة)
- في الإعدادات: قلّل الجودة من Auto إلى Balanced

### Antivirus يحجب
- أضف استثناء لـ `ajyaldesk.exe` و `librustdesk.dll`

---

## 📊 المواصفات

**Client:**
- حجم EXE: 0.37 MB (مع DLLs ~67 MB)
- ذاكرة (idle): ~150 MB
- ذاكرة (جلسة): ~250-400 MB

**السيرفر:**
- قدرة استيعابية: ~50-100 جهاز متزامن (خطة $5)
- يمكن الترقية بنقرة في Vultr

---

## 🚀 إعادة البناء

```powershell
cd "D:\مشاريع كلاودي\AjyalDesk"
# بناء كامل (3 ساعات)
.\build_ajyaldesk.ps1

# أو سريع (تجاوز vcpkg، 30 دقيقة)
.\build_ajyaldesk.ps1 -SkipVcpkg -SkipVirtualDisplay
```

### تغيير سيرفر:
1. عدّل `D:\AjyalDesk\libs\hbb_common\src\config.rs` السطر 159
2. أعد البناء بـ `-SkipVcpkg -SkipVirtualDisplay`

---

**🎉 مبارك إطلاق Ajyal Desk!**

تحكم عن بُعد كامل، خاص بشركتك، عبر سيرفركم الخاص — كل ذلك بـ $5/شهر.