GITHUB_SETUP_GUIDE.md

# ☁️ دليل إعداد البناء السحابي - GitHub Actions

## 🎯 **الهدف:** بناء APK تلقائياً في السحابة مجاناً!

---

## 📋 **الخطوات المطلوبة:**

### **الخطوة 1: إنشاء حساب GitHub** ⏱️ (2 دقيقة)

1. **اذهب إلى:** https://github.com
2. **اضغط "Sign up"** وأنشئ حساب جديد
3. **تأكد من البريد الإلكتروني**

### **الخطوة 2: إنشاء Repository جديد** ⏱️ (1 دقيقة)

1. **اضغط "New repository"** (الزر الأخضر)
2. **اسم المستودع:** `almada-unified-wallet`
3. **الوصف:** `محفظتي الموحدة - تطبيق المحافظ الإلكترونية اليمنية`
4. **اختر "Public"** (مجاني)
5. **فعل "Add a README file"**
6. **اضغط "Create repository"**

### **الخطوة 3: رفع الملفات** ⏱️ (5 دقائق)

#### **الطريقة الأسهل: عبر الموقع**

1. **في صفحة Repository، اضغط "uploading an existing file"**
2. **اسحب وأفلت الملفات التالية:**
   ```
   📁 .github/workflows/build-apk.yml
   📄 index.html
   📄 styles.css
   📄 app.js
   📄 auth.js
   📄 wallets.js
   📄 notifications.js
   📄 demo.html
   📄 package.json
   📄 capacitor.config.ts
   📄 .gitignore
   📁 src/manifest.json
   📁 android/ (كامل)
   ```
3. **اكتب رسالة:** `Initial commit - محفظتي الموحدة`
4. **اضغط "Commit changes"**

#### **الطريقة المتقدمة: Git Command Line**

```bash
# في مجلد المشروع
git init
git add .
git commit -m "Initial commit - محفظتي الموحدة"
git branch -M main
git remote add origin https://github.com/USERNAME/almada-unified-wallet.git
git push -u origin main
```

### **الخطوة 4: تشغيل البناء التلقائي** ⏱️ (10-15 دقيقة)

1. **اذهب إلى تبويب "Actions"** في Repository
2. **ستجد workflow اسمه:** `🚀 Build APK - محفظتي الموحدة`
3. **اضغط "Run workflow"** إذا لم يبدأ تلقائياً
4. **انتظر اكتمال البناء** (10-15 دقيقة)

### **الخطوة 5: تحميل APK** ⏱️ (1 دقيقة)

عند اكتمال البناء:

1. **اضغط على Build الناجح** (علامة ✅ خضراء)
2. **في الأسفل، ستجد "Artifacts"**
3. **اضغط على:** `almada-unified-wallet-apk`
4. **حمل ملف ZIP واستخرج APK منه**

---

## 🎯 **البدائل السحابية الأخرى:**

### **Ionic Appflow (مجاني للمشاريع الصغيرة):**

```bash
# تثبيت Ionic CLI
npm install -g @ionic/cli

# تسجيل الدخول
ionic login

# ربط المشروع
ionic link

# بناء في السحابة
ionic capacitor build android --prod
```

### **CodeMagic (مجاني 500 دقيقة/شهر):**

1. اذهب إلى: https://codemagic.io
2. ربط حساب GitHub
3. اختر Repository
4. إعداد workflow للأندرويد
5. بناء تلقائي

---

## 📱 **ما ستحصل عليه:**

### **من GitHub Actions:**
- ✅ **بناء تلقائي** عند كل تحديث
- ✅ **APK مجاني** بدون حدود
- ✅ **تاريخ الإصدارات** كامل
- ✅ **رابط تحميل** مباشر

### **معلومات APK:**
- 📱 **الاسم:** `app-debug.apk`
- 💾 **الحجم:** ~15-20 MB
- 🔧 **النوع:** Debug APK
- 📲 **جاهز للتثبيت** على أي هاتف أندرويد

---

## 🔄 **التحديثات المستقبلية:**

### **لإضافة ميزات جديدة:**
1. **عدل الملفات** في Repository
2. **Commit التغييرات**
3. **APK جديد** سيُبنى تلقائياً!

### **لإنشاء Release:**
```bash
# إنشاء tag جديد
git tag v1.0.1
git push origin v1.0.1

# سيُنشئ Release تلقائياً مع APK
```

---

## 🆘 **حل المشاكل:**

### **مشكلة: Build فشل**
```
الحل:
1. تحقق من logs في Actions
2. تأكد من رفع جميع الملفات
3. تحقق من package.json
```

### **مشكلة: لا يوجد Artifacts**
```
الحل:
1. تأكد من نجاح Build (علامة ✅)
2. انتظر اكتمال جميع الخطوات
3. حدث الصفحة
```

### **مشكلة: APK لا يعمل**
```
الحل:
1. تأكد من تفعيل "مصادر غير معروفة"
2. تحقق من توافق إصدار الأندرويد
3. أعد تحميل APK
```

---

## 💡 **نصائح مهمة:**

### **للنجاح:**
- 📁 **ارفع جميع الملفات** المطلوبة
- 🌐 **تأكد من اتصال الإنترنت** أثناء البناء
- ⏰ **انتظر اكتمال** جميع الخطوات

### **للأمان:**
- 🔒 **لا تشارك** معلومات حساسة في Repository العام
- 🔑 **استخدم Secrets** للمعلومات الحساسة
- 🛡️ **راجع الأذونات** بانتظام

### **للتطوير:**
- 📝 **اكتب وصف واضح** للـ commits
- 🏷️ **استخدم tags** للإصدارات
- 📚 **حدث README** بانتظام

---

## 🎉 **النتيجة النهائية:**

عند اكتمال هذه الخطوات، ستحصل على:

- ☁️ **نظام بناء سحابي** مجاني
- 🔄 **APK تلقائي** عند كل تحديث
- 📱 **رابط تحميل** مباشر
- 🌍 **متاح للعالم** عبر GitHub

---

## 📞 **تحتاج مساعدة؟**

إذا واجهت أي مشكلة:
1. **راجع logs** في GitHub Actions
2. **تحقق من الملفات** المرفوعة
3. **تواصل للمساعدة**

**🚀 مبروك! تطبيقك سيُبنى في السحابة!**

---

**💡 ملاحظة:** GitHub Actions مجاني للمشاريع العامة مع 2000 دقيقة/شهر للمشاريع الخاصة.