# منصة جائزة أوروك الدولية (Uruk International Prize Platform)

منظومة البنية التحتية المتكاملة للتحقق الرقمي، إدارة العضويات الذكية، وأتمتة المدفوعات في جمهورية العراق.

## معمارية النظام (System Architecture)

يتكون المشروع من أربعة مكونات رئيسية مترابطة:

1. **`backend/`**: النواة الخلفية وخادم واجهات برمجة التطبيقات (REST API Core & Admin Engine) مبني بلغة PHP بدون أطر عمل ثقيلة لسرعة استجابة فائقة، مع نظام التوزيع التناوبي للمكالمات وإدارة الفواتير.
2. **`mobile/`**: تطبيق الهواتف الذكية متعدد المنصات (Flutter for iOS & Android) بنظام بطاقات العضوية الرقمية المشفرة (Dark Gold Luxury) والبصمة العتادية الأصلية ودعم أجهزة هواوي بدون خدمات جوجل.
3. **`gateway-caller/`**: ديمون الأندرويد الأصلي (Native Kotlin Caller Gateway) لإجراء الرنين العكسي الصامت (Flash Call) بتكلفة صفرية ومداورة الشرائح.
4. **`docs/`**: التوثيق المعماري، دراسات الجدوى التشغيلية، ومخطط قاعدة البيانات (`04_database_schema.sql`).

---

## إعداد السيرفر ونشر المنصة (Server Deployment via CloudPanel)

- **النطاق المعتمد (Domain):** `https://urukprize.intaleqapp.com`
- **مستخدم السيرفر (Site User):** `urukprize`
- **مسار المشروع على السيرفر:** `/home/urukprize/htdocs/urukprize.intaleqapp.com`
- **مستودع Git البعيد:** `https://git.intaleqapp.com/Hamza/urukprize.git`

### خطوات التثبيت لأول مرة على السيرفر (Initial Server Setup):

```bash
# 1. الدخول لمجلد الموقع
cd /home/urukprize/htdocs/urukprize.intaleqapp.com

# 2. سحب الكود من المستودع
git pull origin main

# 3. تثبيت حزم الموزع
cd backend
composer install --no-dev --optimize-autoloader

# 4. إعداد ملف البيئة
cp .env.example .env
nano .env

# 5. استيراد قاعدة البيانات
mysql -u [DB_USER] -p [DB_NAME] < ../docs/04_database_schema.sql

# 6. ضبط الصلاحيات لمجلد التخزين
chmod -R 775 storage
chown -R urukprize:urukprize .
```

---

## التحديث التلقائي (Ongoing Deployments)

من جهاز التطوير، قم بتشغيل سكريبت النشر المدمج:
```bash
./deploy.sh "وصف التحديث"
```

وعلى السيرفر، يتم جلب التحديثات فورياً عبر:
```bash
cd /home/urukprize/htdocs/urukprize.intaleqapp.com && git pull origin main
```

---
© 2026 Uruk International Prize. All rights reserved.
Developed by: Hamza Ayed (Founding Tech Architect) & Team.