Files
urukprize/README.md
T

65 lines
2.9 KiB
Markdown

# منصة جائزة أوروك الدولية (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.