Initial commit: Uruk Prize Platform architecture, backend core, mobile app, gateway caller & deployment pipeline

2026-09-18 17:12:05 +03:00
commit 879dd36f1b
1149 changed files with 97122 additions and 0 deletions
@@ -0,0 +1,64 @@
+# منصة جائزة أوروك الدولية (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.